运单同步API

对接规范

接口编码:/api/PostSynchro.shtml

接口名称:PostSynchro

1.1. 功能描述

订单发货后由客户方向平台发送运单同步请求,平台接收到请求后返回信息。

1.2.接口参数

1.2.1. 输入参数

序号 名称 类型 示例 是否必须 是否重复 更多限制 描述
1 OrderNosReqs 订单列表
2 IsSearchByChildNo String 0 选填 不可重复 默认:0 是否按子订单号查询

0:否

1:是

3 v String 1 选填 不可重复 版本(1-表示

新版)

OrderNosReqs
序号 名称 类型 示例 是否必须 是否重复 更多限制 描述
1 OrderNo String AO201610196365 必须 不可重复 最长32位字符 订单流水号

1.2.2. 输出参数

序号 名称 类型 示例 描述
1 OrderPostReqs 回执运单
OrderPostReqs
序号 名称 类型 示例 描述
1 OrderNo String AO20161018060 订单流水号
2 SendDate String 2019-05-28
10:58:54,2019-
05-28 11:25:20
发货时间(逗号分隔不同子订单的发货时间,订单内有多个包裹取其中最晚的发货时间。新版逗号分隔发货时间,与快递单号一一对应)
3 PostCode String zhongtong,yunda 快递公司编码(逗号分隔不同子订单的快递公司编码,订单内有多个包裹取最晚的发货时间包裹的快递公司编码。新版逗号分隔快递公司编码,与快递单号一一对应)
4 PostNo String 76120129891643,
76120247780844
快递单号(逗号分隔不同包裹)
5 PostNos String 76120129891643,
76120247780844;
76120247780848
快递单号(逗号分隔不同子订单,分号分隔不同包裹)
6 IsSend String 1 订单发送标识(拆单/无拆单)

0:部分发出/未发出

1:全部发出/已发出

7 SkuNo String DEC0908;BIO5451,TES0996;TES0998 商品编码(逗号分隔不同包裹,分号分隔不同商品)

8 Num String 1;2,1;3 发货商品数量(逗号分隔不同包裹,分号分隔不同商品)
9 TradeStatus String TRADE_STATUS_CONFIRM_WAIT, TRADE_STATUS_DELIVERY_FINISHED 订单状态(逗号分隔不同子订单)

注:新版只适用于2019-05-26号之后的订单,旧版适用所有时间段的订单。如果按照原始订单号查询,则会返回所有存在于系统订单的运单信息,不存在的订单不会返回,如果订单存在但无运单信息,则对应的SendDate、PostCode、PostNo、PostNos为空字符串;如果按照子订单号查询,有运单信息则返回,否则不返回

1.2.3. JSON示例

RequestJSON:

/*请求参数示例1*/ { "OrderNosReqs": ["wizy19041001", "wyz19041501"] } /*请求参数示例2*/ { "OrderNosReqs":["wyz19052701","wyz19041501"], "v":"1" }

ResponseJSON:

/*返回结果示例1*/ [{ "OrderNo": "wizy19041001", "SendDate": "2019-04-10 15:21:30", "SkuNo": "SOS0115;KOW1901", "Num": "1;1", "TradeStatus":"TRADE_STATUS_DELIVERY_FINISHED", "PostCode": "ems", "PostNo": "772019041025", "PostNos": "772019041025", "IsSend": "1" }, { "OrderNo": "wyz19041501", "SendDate": "2019-04-15 15:19:24,2019-04-15 15:19:27", "SkuNo": "MUJ8358,QTL5851;TOM7010", "Num": "2,1;2", "TradeStatus":"TRADE_STATUS_FINISHED, TRADE_STATUS_FINISHED ", "PostCode": "yunda,zhongtong", "PostNo": "21201904150011,21201904150015", "PostNos": "21201904150011,21201904150015", "IsSend": "1" }] /*返回结果示例2*/ [{ "OrderNo": "wyz19041501", "SendDate": "2019-05-28 10:58:54,2019-05-28 11:25:20", "SkuNo": "MUJ8358,QTL5851;TOM7010", "Num": "2,1;2", "PostCode": "zhongtong,yunda", "PostNo": "ZT20190528003,YD20190528001", "PostNos": "ZT20190528003,YD20190528001", "IsSend": "1" }, { "OrderNo": "wyz19052701", "SendDate": "2019-05-28 11:36:51", "SkuNo": "NS117243", "Num": "1", "PostCode": "zhongtong", "PostNo": "ZT20190528002", "PostNos": "ZT20190528002", "IsSend": "1" }]

API测试工具

测试接口