# TMS对接模块
API域名以及签名 统一签名
统一响应:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 响应码 0:成功,其他:错误 |
| message | String | 错误描述 |
| data | Object | 响应对象,可为空 |
统一Request参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| method | String | 方法名,详见具体接口 |
# 1、物流回调和签收拒收
(1)接口地址:/bridge/tms/execute?method=请求method
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求method:tms.logistics.back
(6)请求参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| requestId | String | 请求id, 防止因网络原因产生的重复请求,幂等使用 |
| deliveryOrderCode | String | 单据号 |
| deliveryOrderType | String | 单据类型(OMS推送时传的类型):2B销售出库=B2BCK,jit发货单=JITCK,调拨出库单=DBCK、2B退货单=B2BRK |
| details | List | 快递列表 |
| └ receiveType | String | 接收类型 1:提货 2:签收 |
| └ logisticsCode | String | 物流公司编码 |
| └ logisticsName | String | 物流公司名称 |
| └ expressCode | String | 运单号 |
| └ tmsExpressId | String | tms运单ID |
| └ qty | Integer | 件数 |
| └ fydt | String | 发运时间,格式:yyyy-MM-dd HH:mm:ss |
| └ skus | List | 商品明细列表 |
| └ skuCode | String | 规格编码 sku条码 |
| └ signTime | String | 签收时间,格式:yyyy-MM-dd HH:mm:ss |
| └ signQty | Integer | 签收数量 |
| └ rejectQty | Integer | 拒收数量 |
| └ pickQty | Integer | 提货数量 |
(7)请求示例:
{
"requestId": "可以是uuid,保证请求唯一",
"deliveryOrderCode": "O2022051300021",
"deliveryOrderType": "B2BCK",
"details": [
{
"receiveType": "1",
"logisticsCode": "AAA",
"logisticsName": "AAA车队",
"expressCode": "SF000001",
"tmsExpressId": "11121414",
"qty": "1000",
"fydt": "2022-06-13 13:28:30",
"skus": [
{
"skuCode": "6937025181001",
"signTime": "2022-11-10 08:01:02",
"signQty": 10,
"rejectQty": 0,
"pickQty": 1
},
{
"skuCode": "6937025181002",
"signTime": "2022-11-11 08:01:02",
"signQty": 13,
"rejectQty": 2,
"pickQty": 1
}
]
},
{
"receiveType": "2",
"logisticsCode": "BBB",
"logisticsName": "BBB车队",
"expressCode": "SF000002",
"tmsExpressId": "78617414",
"qty": "2000",
"fydt": "2022-05-13 13:28:30",
"skus": [
{
"skuCode": "6937025181003",
"signTime": "2022-11-13 08:01:02",
"signQty": 20,
"rejectQty": 5,
"pickQty": 1
}
]
}
]
}
(8)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 响应码 0:成功,其他:错误 |
| message | String | 错误描述 |
| data | Object | 响应对象,可为空 |
(9)响应示例:
{
"code": 0,
"data": null,
"message": ""
}