文档
测试

2.承运商上传各类消息

POST
https://b2btest.zte.com.cn/CommonWebServiceEnhance/ZTE_B2B_WebService_CommonInterface_Enhance.asmx

接口描述

承运商通过此接口上传各类消息给ZTE

消息类型说明:

```language 1.承运商主动调用ZTE此接口,按要求上传以下三类消息 (1)类型一:承运商所选线路方案消息 (2)类型二:物流跟踪节点消息 - 读【货运单下发消息】中要求反馈的节点,映射到对应节点进行反馈 - 读【新增节点反馈消息】中要求反馈的节点,映射到对应节点进行反馈 (3)类型三:实时经纬度消息 ``` ![中兴京东交互 4.png](https://cos.easydoc.net/48578360/files/lz6nd2me)

调用注意

```language 注1:HTTPS是SSL/TLS安全通道方式传输数据,需要使用中兴通讯的数字证书公钥,附中兴通讯证书 注2:ZTE B2B HTTPS方式使用端口号443,调用方服务器如果有防火墙策略需首先开通防火墙才能访问。 注3:URL后加?wsdl即可获得WSDL接口描述 ------------接口方法说明---------------------- 将JSON消息内容作为字符串类型的一个参数调用以下方法: string InputB2BFlatWebServiceEnhance(string strUUID, string strMessgeType, string strKeywords, string strToken, string strFlatMsgContent, string strReserve1, string strReserve2, string strReserve3, string strReserve4, string strReserve5) ```

接口传输机制及编码

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

接口编码说明

|编码信息|描述| |-|-|-| |Content-Type|applicaition/json| |Accept|XML| |Characterset|utf-8|

Request Body参数:

application/json
参数名
类型
必填
描述
示例值
strUUID
string
必填
唯一请求ID,此参数用于标识每次的调用请求,用于跟踪,建议使用全局唯一标识符GUID
strMessgeType
string
必填
消息类型标识符(物流跟踪节点上传:JD-ZTE-FreightTracking;经纬度上传:JD-ZTE-FreightLocation;承运商所选线路方案反馈:JD-ZTE-SolutionFeedback)
strKeywords
string
可选
货运单编号(如有多个,中间用波浪号~分隔)
1319082801~1319082802
strToken
string
必填
安全令牌,和strMessgeType参数是一对一关系,ZTE预先配置测试时提供,如消息请求中的安全令牌不匹配ZTE会直接拒绝消息,测试环境和生产环境安全令牌不一样
strFlatMsgContent
string
必填
业务参数封装
uuid
string
必填
唯一请求ID,与最外层strUUID值相同
563b5e588e9f4b48b5e519045c978991_route_std_fvpseq341seq736
messgeType
string
必填
消息类型,与最外层strMessgeType的值相同(物流跟踪节点上传:JD-ZTE-FreightTracking;经纬度上传:JD-ZTE-FreightTracking)
SF-ZTE-FreightTracking
freightTrackingList
array
可选
货运跟踪节点数据列表
nodeMainInfo
object
必填
货运单节点头数据集
waybillNo
varchar(50)
必填
货运单编号
SP-S2DS1-20240715000023
nodeId
varchar(50)
必填
节点id(更新节点信息时必填/创建节点时不填)
1811668358661419021
nodeCode
varchar(50)
必填
节点编码
dic_node_name_16
nodeName
varchar (50)
必填
节点名称
已签收
nodeOrder
varchar (50)
必填
节点序号
160
nodeTime
varchar (50)
可选
节点发生时间
1721218836000
nodeExceptTime
varchar (50)
可选
节点预计发生时间
nodeFieldCode
varchar (50)
可选
节点地点
countryNo
varchar (50)
可选
节点地点的国家
CN
provinceNo
varchar (50)
可选
节点地点的省份
360000
cityNo
varchar (50)
可选
节点地点的城市
360100
districtNo
varchar (50)
可选
节点地点的区(县)
360121
temporaryStoreFlag
varchar (50)
可选
货运单是否暂存:1是,0否
0
actualReceiverName
varchar (100)
可选
签收人姓名
陈福全
courierNo
varchar (50)
可选
快递单号
remark
varchar (200)
可选
备注
contactName
varchar (50)
可选
示例:
contactPhone
varchar (50)
可选
示例:
contactRole
varchar (50)
可选
示例:
hamb
varchar (100)
必填
示例:
mawb
varchar (100)
必填
示例:
nodeList
array
必填
货运单节点行数据集
opType
varchar(20)
必填
操作类型(新增1,修改2,删除3 )
carNo
varchar(50)
必填
车号/航班号/船名
updatedCarNo
varchar(50)
必填
被替换掉的车号/航班号/船名,仅限修改2类型时填写
batch
varchar(50)
可选
船次
palletNum
int (11)
必填
货运单上的托盘数合计,不同时以实际托盘数回传
boxNum
int (11)
必填
货运单上的箱件数合计,不同时以实际箱件数回传
boxItemNum
int (11)
必填
货运单上的箱明细数数合计,不同时以实际箱明细数回传
ccrn
varchar (50)
可选
CCRN
remark
varchar(200)
可选
备注
contactName
varchar(50)
可选
联系人
contactPhone
int(20)
可选
联系方式
driveridNum
int(20)
可选
司机身份证号
exceptionEventList
array
必填
异常事件数据集
waybillNo
varchar(50)
必填
货运单编号
nodeId
varchar(50)
必填
节点ID
eventTypeLevelOne
varchar(200)
必填
异常事件大类
eventTypeLevelTwo
varchar(200)
必填
异常事件小类
eventDescription
varchar(500)
必填
异常事件描述
eventTime
date (YYYY-MM-DD HH:mm:ss)
必填
异常事件发生时间
feedbackUserName
varchar(100)
必填
异常事件反馈人
freightLocationList
array
可选
货运经纬度数据列表
waybillNo
varcher(50)
必填
货运单号
carNo
varcher(50)
可选
车号/航班号/船名
longitude
Decimal(21,10)
可选
在途位置-GPS定位经度
latitude
Decimal(21,10)
可选
在途位置-GPS定位纬度
cityName
varcher(50)
可选
在途位置-GPS定位城市
nextCityName
varcher(50)
可选
在途位置反馈时的GPS对应经纬度所属城市时,预计到达的下一个城市
transferFlag
varcher(10)
可选
当前GPS所在城市是否为货物中转城市。(如果对货物产生了装卸操作,视为中转城市,其他则不在此范围内。)在途反馈,如有则必填。0否1是
createdTime
date (YYYY-MM-DD HH:mm:ss)
可选
经纬度数据生成时间
SenderID
string
可选
ReceiverID
string
可选
strReserve1
string
可选
保留参数
strReserve2
string
可选
保留参数
strReserve3
string
可选
保留参数
strReserve4
string
可选
保留参数
strReserve5
string
可选
保留参数

Reponse Body参数:

application/xml
参数名
类型
描述
必填
Result
object
返回结果集
必填
UUID
string
消息ID,入参数中的strUUID
必填
MessgeType
string
消息类型,入参数中的strMessgeType
必填
Keywords
string
消息关键字,入参数中的strKeywords
必填
Flag
string
返回结果标识(T/F,成功/失败标识)
必填
Description
string
返回结果描述
必填