同步订单信息接口(DMS->TMS)

描述

DMS系统把订单信息同步到TMS系统。

正向单和逆向单是一个接口去做同步,可以用接口中的WorkType字段去做归属。

服务名称

服务名称:RequestOrdersToTMS

请求字段

  • 基础参数
名称 类型 可选/必选 备注
RequestName String(64) 必选 服务名称RequestOrdersToTMS
DelveryCode String(64) 必选 TMS承运商编码(该参数由DMS系统指定,请向相关人员索取)
Sign String(64) 必选 签名内容,即密钥
TimeStamp String 必选 时间戳
Content String 必选 消息内容

以上参数用于确保通讯正常

  • 业务参数(以下参数是TMS收到的订单相关参数)
名称 类型 可选/必选 备注
ClientCode String(64) 必选 DMS订单号
WorkCode String(64) 必选 运单号
SubCodeList String 必选 子单号,若无传null
RWorkCode String(64) 可选 退货号
HYWorkCode String(64) 可选 原运单号
WorkType Int(11) 可选 运单类型
OrderCount String(5) 必选 运单数量
ReplCost Decimal(9,2) 必选 应收金额,单位(元)
IsRecInvoices Integer(5) 可选 退单是否回收发票
GetPerson String(100) 必选 收货人名称
GetZip String(10) 可选 收货人邮编
GetProvice String(64) 必选 收货人省份
GetCity String(64) 必选 收货人城市
GetCounty String(64) 必选 收货人(地区/县)
GetAddress String(255) 必选 收货人详细地址
GetPhone String(32) 可选 收货人手机
GetTel String(32) 可选 收货人座机
PackageHav Decima(9,2) 可选 包裹重量,单位是kg
PackageSize Decima(18,2) 可选 包裹体积,单位是立方厘米
WMSCode String(64) 必选 仓库编码(唯一标示仓库)
TrustPerson String(100) 必选 寄件人名称
TrustZip String(10) 可选 寄件人邮编
TrustProvince String(64) 必选 寄件人省份
TrustCity String(64) 必选 寄件人城市
TrustCounty String(64) 必选 寄件人(地区/县)
TrustAddress String(255) 必选 寄件人详细地址
TrustPhone String(32) 可选 寄件人手机
TrustTel String(32) 可选 寄件人座机
DeliveryType Stirng(32) 可选 配送类型
IsIimitSchedule Int(5) 必选 是否限时配送
ScheduleType String 可选 投递时延要求(限时配送标记为0限时,该字段有效)
ScheduleStart String 可选 送达开始时间
ScheduleEnd String 可选 送达结束时间
  • SubCodeList内容
名称 类型 可选/必选 备注
SubCode String(64) 可选 子运单号,规则主运单号-包裹数-包裹号

JSON样例

  • DMS下发:
{"RequestName":"RequestOrdersToTMS","DelveryCode":"EMS","TimeStamp":"2335452133","Sign":"ss454d5dfd4gf54gf5fg45","Content":{"ClientCode":"201410310002","WorkCode":"JY0001860329","SubCodeList":[{"SubCode":"JY0001860329-2-1"},{"SubCode":"JY0001860329-2-2"}],"RWorkCode":"","HYWorkCode":"","WorkType":0,"OrderCount":"","ReplCost":100.00,"DelveryCode":"EMS","IsRecInvoices":0,"GetPerson":"王先生","GetZip":"100107","GetProvice":"北京市","GetCity":"北京市","GetCounty":"朝阳区","GetAddress":"明天第一城","GetTel":"","GetPhone":"13210054312","PackageHav":0.00,"PackageSize":0.00,"WMSCode":"SP","TrustPerson":"测试","TrustZip":"100111","TrustProvince":"北京市","TrustCity":"北京市","TrustCounty":"朝阳区","TrustAddress":"","TrustTel":"","TrustPhone":"","IsIimitSchedule":0,"ScheduleType":"1","ScheduleStart":"2014-12-0309:00:00","ScheduleEnd":"2014-12-0317:00:00"}}
  • TMS返回:
  • 成功:
{"RequestName":"RequestOrdersToTMS",
"Partner":"",
"Success":true,
"Msg":"成功",
"Count":0,
"Code":"0",
"Content":null
}
  • 失败:
{"RequestName":"RequestOrdersToTMS",
"Partner":"",
"Success":fasle,
"Msg":"系统错误",
"Count":0,
"Code":"100",
"Content":null
}