# 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": ""
}