运单同步API

对接规范

接口编码：/api/PostSynchro.shtml

接口名称：PostSynchro

1.1. 功能描述

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

1.2.接口参数

1.2.1. 输入参数

序号 名称 类型 示例 是否必须 是否重复 更多限制 描述
1 OrderNosReqs 订单列表(限制最多100)
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 订单状态（逗号分隔不同子订单）
10 PostName String 顺丰 快递公司中文名称

注：新版只适用于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测试工具

测试接口