订单报销状态通知
- 接口(建议后缀):/order/reimburse/state
- Method:POST
- 数据格式:Json
- 调用方:每刻
- 接口说明:生态平台发起对TMC接口的调用,通知订单的报销状态
请求参数
字段 |
类型 |
必填 |
描述 |
externalCorpCode |
String |
Y |
企业在 TMC 中的唯一标识 |
orderId |
String |
Y |
订单在 TMC 中的唯一标识 |
operationId |
String |
[1] |
订单操作号 |
subsidiary |
Subsidiary |
N |
承担子公司 |
department |
Department |
N |
承担部门 |
invoiceTitle |
InvoiceTitle |
N |
开票抬头 |
costCenterList |
List<CostCenter> |
N |
报销成本中心 |
chargeEmployee |
ChargeEmployee |
N |
承担人 |
reimburseCode |
String |
N |
报销单号 |
reimburseStatus |
String |
Y |
报销状态 |
payType |
String |
Y |
支付方式 [2]:CORP_ACCOUNT_PAY / PERSONAL_PAY |
settledTime |
String |
N |
结算时间 [3](如:2020-05-01 22:00:00) |
[info] 说明:
[1] 该字段按照供应商类型来决定是否必填,如果供应商退订与改签 orderId 不同,该字段不填,如果退订与改签 orderId 不变,则需要通过 operationId 辨别。
[2] 混合支付的订单可能存在两笔费用(企业支付/个人支付)分开报销。
[3] 该字段是报销单被标记为已支付的时间。
Subsidiary
字段 |
类型 |
必填 |
描述 |
subsidiaryCode |
String |
Y |
子公司唯一标识 |
subsidiaryName |
String |
N |
子公司名称 |
Department
字段 |
类型 |
必填 |
描述 |
departmentCode |
String |
Y |
部门唯一标识 |
departmentName |
String |
N |
部门名称 |
InvoiceTitle
字段 |
类型 |
必填 |
描述 |
invoiceTitleCode |
String |
Y |
开票抬头唯一标识 |
invoiceTitleName |
String |
N |
开票抬头名称 |
taxNo |
String |
N |
税号 |
CostCenter
字段 |
类型 |
必填 |
描述 |
costCenterCode |
String |
N |
成本中心唯一标识 |
costCenterName |
String |
N |
成本中心名称 |
ChargeEmployee
字段 |
类型 |
必填 |
描述 |
externalEmployeeCode |
String |
Y |
员工在TMC唯一编码 |
employeeName |
String |
Y |
姓名 |
employeeId |
String |
Y |
工号 |
报销状态
code |
定义 |
OPEN |
未报销(如报销后召回,此时reimburseCode会没有值) |
PROCESSING |
报销中 |
COMPLETED |
已完成 |
REJECTED |
驳回 |
响应结构
字段 |
类型 |
必填 |
描述 |
code |
String |
Y |
请求是否成功 (ACK/NACK) |
message |
String |
N |
调用详情(当 success 为 false 时,调用详情为必填, 表示失败信息) |
示例
[warning] 重要:
示例维护并非和文档字段维护一样频繁,如果遇到示例和文档不一致,请以文档为准
请求头:
{
"tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}
请求示例:
{
"externalCorpCode": "EC21256V8515",
"orderId": "13656122075",
"operationId": "13656122075",
"subsidiary": {
"subsidiaryCode": "SI2021561984980",
"subsidiaryName": "天津狗不理杭州分公司"
},
"department": {
"departmentCode": "DHDI20210801001",
"departmentName": "售后服务部"
},
"chargeEmployee": {
"externalEmployeeCode": "EMP20210801001",
"employeeName": "王小明",
"employeeId": "10086"
},
"reimburseCode": "MK20210801001",
"reimburseStatus": "COMPLETED",
"settledTime": "2021-08-01 12:34:56"
}
响应示例:
{
"success": true,
"message": "处理成功"
}