运单信息下发接口

基本信息

接口名称	TMS_WAYBILL_NOTIFY
请求方式	post application/x-www-form-urlencoded
功能描述	商家将运单信息推送给菜鸟速递EDI
编码	UTF-8

入参

项目	名称	类型	必填	描述
对接码	logistic_provider_id	String	是	菜鸟侧提供
签名	data_digest	String	是	Base64(Md5(logistics_interface+双方约定的secretKey)),0.2 签名方法
业务报文	logistics_interface	String	是	JSON

logistics_interface内容

项目	名称	类型	必填	描述
运单信息	waybills	List<Waybill>	是	运单信息

Waybill内容

项目	名称	类型	必填	描述	备注
收货方信息	receiver	Receiver	是	收货方信息，具体参见公共组件部分
服务产品	serviceProductCode	String	否	服务产品code
时效产品	timingServiceCode	String	否	时效产品code
增值服务列表	valueAddedServiceList	List<String>	否	增值服务code
发货方信息	sender	Sender	是	发货方信息，具体参见公共组件部分
包裹信息	packageInfo	PackageInfo	是	包裹信息，具体参见公共组件部分	包裹里边可以是商品,也可以是包裹
预分拣信息	sortingInfo	SortingInfo	否	预分拣信息，具体参见公共组件部分
订单信息	order	Order	是	订单信息，具体参见公共组件部分
扩展信息	extendFields	List<ExtendField>	否	扩展信息
备注	remark	String(2000)	否	备注信息

出参

项目	名称	类型	必填
成功标识	success	boolean	是
错误码	errorCode	String	否
错误说明	errorMsg	String	否

注意: 一单多件的场景给相同的logisticsId,不同的mailNo

示例报文

测试URL

http://edi-daily.xpm.cainiao.com/ext/gateway/ediReceive/ediStandardReceive/api

入参

仅供参考，实际测试账号需联系菜鸟速递开发提供

logistic_provider_id: edi_test_json

logistics_interface:

{"waybills":[{"order":{"customerCode":"edi_test_json","deliveryType":"1","distributionType":"1","logisticsId":"TEST210311001","mailNo":"TEST210311001","orderCreateTime":"2018-10-10 12:20:02","planReceiveAmount":"0.00","storeOrderCode":"TEST210311001"},"packageInfo":{"packageNums":"1","weight":"3400"},"receiver":{"receiverAddress":"长江路99号","receiverArea":"玄武区","receiverCity":"南京市","receiverDistrict":"","receiverName":"张三","receiverPhone":"13000000000","receiverProvince":"江苏省"},"sender":{"senderAddress":"中节能西溪首座","senderArea":"西湖区","senderCity":"杭州市","senderMobile":"13222222222","senderName":"测试","senderProvince":"浙江省"},"sortingInfo":{"scheduleType":"10101"}}]}

data_digest: gXMIrptR+En4rGBjpKW6bQ==

出参

{
    "success": true,
    "errorCode": "00",
    "errorMsg": "成功"
}