第三方订单通知
订单信息进入每刻有两种方式:
- 每天的定时任务;
- 第三方主动发起回调, 告诉每刻变更的 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
}