第三方订单通知

订单信息进入每刻有两种方式:

  1. 每天的定时任务;
  2. 第三方主动发起回调, 告诉每刻变更的 orderId 和 operationId, 每刻会实时根据这些信息, 继续调用订单拉取接口, 拉取订单信息,适用于有订单实时性要求的企业;


  • 接口:/incoming/order/signal
  • Method:POST
  • 数据格式:Json
  • 调用方:第三方
  • 接口说明:TMC 发起的订单推送,每刻会实时发起订单拉取

请求参数

字段 类型 必填 描述
externalCorpCode String Y 企业在 TMC 中的唯一标识
externalApprovalNo String N 申请单号
externalEmployeeCode String N 员工在第三方中的账号
orderId String Y 订单在 TMC 中的唯一标识
operationId String Y 操作在第三方的唯一编码
orderType String Y 订单类型
status String N 订单状态
approvingInfo ApprovingInfo N 待审批信息,允许为空,表示订单无需审批(无审批需求不要对接该字段)
useStatus OrderUseStatus N (要传该字段请和每刻确认)订单使用状态,不为空时将不会拉取订单,而是更新已进入每刻订单的已使用状态

订单类型

code 定义
hotel 酒店
flight 机票
train 火车票
car 用车
meal 餐饮

ApprovingInfo

字段 类型 必填 描述
approvingType ApprovingType Y 审批类型
exceedingDetails String N 超标审批事由(仅超标审批有,表示具体超标信息)
exceedingReason String N 超标审批理由(仅超标审批有,预定人解释为什么会超标)
expiredTime String N 审批超时时间(接收到审批请求时,截止有效时间,yyyy-MM-dd HH:mm:ss)

ApprovingType

code 定义
EXCEEDING 超标审批
IN_PROCESS 事中审批
BUDGET_OCCUPY 预算占用

响应结构

字段 类型 必填 描述
code String Y 请求是否成功 (ACK/NACK)
message String N 调用详情(当 success 为 false 时,调用详情为必填, 表示失败信息)

示例

[warning] 重要:
示例维护并非和文档字段维护一样频繁,如果遇到示例和文档不一致,请以文档为准

请求头:

{
  "tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}

请求示例:

{
  "externalCorpCode": "0123456",
  "orderId": "13406390267",
  "operationId": "13406390267",
  "orderType": "FLIGHT"
}

响应示例:

{
  "code": "ACK",
  "message": null
}

results matching ""

    No results matching ""