文档
测试

1.下发消息给承运商

POST

接口描述

通过此接口下发各类消息给承运商

消息类型说明

```language 1.承运商按照ZTE要求开发此接口供ZTE调用 2.ZTE调用此接口下发两类消息 (1)类型一:下发货运单据消息 - 货运单信息 - 货运单托盘信息 - 货运单线路方案 - 货运单需反馈物流节点信息 (2)类型二:下发单据新增的需增加反馈的物流跟踪节点消息 ``` ![ZTEJD 4.png](https://cos.easydoc.net/48578360/files/lz29963r.png)

接口传输机制及编码

|传输机制|描述| |-|-|-| |接口类型|REST API/WebService| |传输方向|中兴 --> 京东| |传输频次|定时(间隔1小时)| |是否批量|批量,每次请求不超过5单,超过5单则间隔30秒继续发起新的请求| |Content-Type|applicaition/json| |Accept|XML| |Characterset|utf-8|

签名算法

```json ```

Request Body参数:

application/json
参数名
类型
必填
描述
示例值
UUID
string
必填
唯一请求ID
15e60dcc-3ff3-4084-a4e8-c0be7a0d1f81
MessgeType
string
必填
消息类型标识符(货运单业务数据:ZTE-JD-Waybill;需新增反馈节点消息:ZTE-JD-FreightNewNode)
MsgContent
string
必填
业务消息封装
uuid
string
必填
唯一请求ID,与输入参数UUID值一致
15e60dcc-3ff3-4084-a4e8-c0be7a0d1f81
messageType
string
必填
消息类型,与接口输入参数MessgeType的值相同
compositedWaybillInfo
object
必填
货运单业务数据字典
waybill
object
必填
货运单主体信息
waybillNo
varchar (50)
必填
货运单编号
示例:SP-S1DL1-2024032100028
agreementNo
varchar (50)
必填
货运协议号
ZYF202306150000623
orderNo
varchar(50)
必填
来源单号
IHJNS2403210023
contractNo
varchar(50)
可选
合同号
carrierNo
varchar (50)
必填
承运商
85862350
shippingTypeLevelOne
varchar (50)
必填
运输方式大类
汽运
shippingTypeLevelTwo
varchar(50)
必填
运输方式小类
零担
shippingServiceLevel
varchar(50)
必填
运输服务等级
shippingEffectivePeriodLevel
varchar(50)
必填
运输时效等级
totalPalletNum
decimal (21,2)
必填
总托盘数
44
totalBoxNum
decimal (21,2)
必填
总箱数
33
totalMaterialNum
decimal (21,2)
必填
总装箱数量
10
weight
decimal (21,2)
必填
总重量
33.0000
volume
decimal (21,2)
必填
总体积
3.000000
planDeliverDate
date
必填
计划发运日期
2024-03-19T00:00:00+08:00
planArrivalDate
date
必填
计划到货日期
2024-03-22T00:00:00+08:00
standarTransportDate
date
必填
标准起运时间
2024-03-21 18:00:00
standarArriveDate
date
必填
标准送达时间
2024-04-14 18:00:00
reamark
varchar (200)
可选
备注
specialRequirement
varchar (200)
可选
特殊要求
consignorName
varchar (50)
必填
始发-发货人
consignorMobile
varchar (50)
必填
始发-发货人联系方式
shippingFromPlaceNo
varchar (50)
必填
始发地编码
PN2024011100000001
shippingFromPlaceName
varchar (50)
必填
始发地名称
中华人民共和国-北京市-北京市-海淀区20240111001
shippingFromCountry
varchar (50)
必填
始发地-国家
0001
shippingFromProvince
varchar (50)
必填
始发地-省
00010002
shippingFromCity
varchar (50)
必填
始发地-市
000100020077
shippingFromDistrict
varchar (50)
可选
始发地-区(县)
000100020011
shippingFromPlacePostalCode
varchar (50)
可选
始发地-邮编
shippingFromPlaceAddress
varchar (200)
可选
始发地-详细地址
中华人民共和国-北京市-北京市-海淀区20240111001
consigneeName
varchar (50)
必填
目的-收货人
唐晓东
consigneeMobile
varchar (50)
必填
目的-收货人联系方式
17877783675
shippingToPlaceNo
varchar (50)
必填
目的地编码
PN2023110100000002
shippingToPlaceName
varchar (50)
必填
目的地名称
中华人民共和国-广东省-梅州市-梅江区广东省梅州市梅江区长沙镇圩镇长沙物流园(206国道旁长沙中心小学侧)
shippingToCountry
varchar (50)
必填
目的-国家
0001
shippingToProvince
varchar (50)
必填
目的-省
00010005
shippingToCity
varchar (50)
必填
目的-市
000100050026
shippingToDistrict
varchar (50)
可选
目的-区(县)
000100050113
shippingToPlacePostalCode
varchar (50)
可选
目的地-邮编
shippingToPlaceAddress
varchar (200)
可选
目的-详细地址
中华人民共和国-广东省-梅州市-梅江区广东省梅州市梅江区长沙镇圩镇长沙物流园(206国道旁长沙中心小学侧)
receiverUnit
varchar(50)
必填
货运单运输状态
waybillStatus
varchar(50)
必填
货运单状态
已发货
createdBy
varchar(50)
必填
制单人
10307313
createdDate
varchar(50)
必填
制单时间
2024-03-2116:17:44
bookingNo
varchar (50)
可选
预订舱需求编号
size
varchar (50)
可选
柜形尺寸
tradeTerms
varchar(50)
可选
贸易术语
customerName
varchar(50)
可选
客户名称
projectName
varchar(50)
可选
项目名称
emergencyFlag
varchar(50)
可选
是否紧急
dangerousFlag
varchar (2)
可选
是否危险品
shakeFlag
string
可选
是否有震动标签
0
isHighEndEquipment
varchar(50)
可选
是否为高端设备
dumpFlag
varchar(50)
可选
是否含倾倒标签
nodeList
array
必填
货运单需反馈节点列表
solutionId
string
必填
线路方案ID
nodeId
string
必填
节点ID
1770726471698518018
nodeNo
string
必填
节点编码
dic_node_name_1
nodeName
string
必填
节点名称
PlacedOrder
nodeOrder
string
必填
节点序列
1
requirementFlag
string
必填
是否为必要节点(0-否;1-是)
1
maintainExceptTimeFlag
string
必填
palletList
array
可选
货运单托盘信息
containerNo
int(11)
必填
托盘号
palletFlag
varchar(2)
必填
是否托盘(1-是;2-否)
length
decimal (21,2)
必填
托盘长
width
decimal (21,2)
必填
托盘宽
height
decimal (21,2)
必填
托盘高
bulkWeight
decimal (21,2)
必填
毛重量
bulkVolume
decimal (21,2)
必填
毛体积
realWeight
decimal (21,2)
必填
净重量
realVolume
int(11)
可选
净体积
boxNum
int(11)
可选
箱数
pieceNum
varchar (50)
必填
装箱数量
packageType
varchar (50)
必填
包装类型
status
varchar (200)
可选
状态
remark
varchar (50)
可选
备注
shippingFromPlace
varchar (50)
可选
起运地
boxNo
varchar (50)
必填
装箱箱号
description
varchar (200)
必填
装箱描述
taskNo
varchar (50)
可选
任务号
storeName
varchar (50)
可选
库位名称
storeAddress
varchar (200)
必填
库位地址
fileUrl
varchar (200)
必填
附件下载地址
fileType
varchar (50)
可选
附件类型
dumpFlag
varchar (2)
可选
是否含倾倒标签
shakeFlag
varchar (2)
可选
是否含震动标签
dangerousContainerFlag
varchar (2)
可选
是否含危险品
solutionList
array
可选
货运单线路信息
solutionId
varchar (1000)
必填
线路方案ID
shippingFromPlaceName
varchar (50)
必填
始发地
shippingTransferPlaceOneName
varchar (50)
可选
中转地1
shippingTransferPlaceTwoName
varchar (50)
可选
中转地2
shippingTransferPlaceThreeName
varchar (50)
可选
中转地3
shippingTransferPlaceFourName
varchar (50)
可选
中转地4
shippingTransferPlaceFiveName
varchar (50)
可选
中转地5
shippingTransferPlaceSixName
varchar (50)
可选
中转地6

Reponse Body参数:

application/xml
参数名
类型
描述
必填
result
object
返回结果
必填
UUID
唯一请求ID,值与请求中UUID相同
必填
MessgeType
消息类型
必填
Flag
返回结果标识(T-成功/F-失败)
必填
description
返回结果描述
必填