用户调用该接口可实现自己联系发货(线下物流),使用该接口发货,交易订单状态会直接变成卖家已发货。不支持货到付款、在线下单类型的订单。
支持平台: 淘宝, 拍拍, 京东, QQ网购, 当当, 亚马逊
用户调用该接口可实现自己联系发货(线下物流),使用该接口发货,交易订单状态会直接变成卖家已发货。不支持货到付款、在线下单类型的订单。
支持平台: 淘宝, 拍拍, 京东, QQ网购, 当当, 亚马逊
需授权
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
method | String | 是 | API接口名称 |
certi_id | Number | 否 | 分配给应用的证书ID |
from_node_id | String | 是 | API调用的来源节点ID,对于第三方开发者来说,此id即为申请应用颁发的APP KEY |
from_api_v | String | 否 | 请求方版本号 |
to_node_id | String | 否 | API调用的目的节点ID(除了基础服务类api,其他接口必传此参数) |
to_api_v | String | 否 | 接收方版本号 |
callback_url | String | 否 | 响应回调地址,带http路径的标准URL。(调用异步接口此参数必填) |
v | String | 是 | 矩阵API协议版本,可选值:1.0 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟 |
format | String | 是 | 可选,指定响应格式。默认JSON ,目前支持格式为JSON |
sign | String | 是 | 对调用API时所有输入参数(包括应用级参数)进行签名结果 |
名称 | 类型 |
|
示例值 | 默认值 | 描述 |
---|---|---|---|---|---|
tid | Number |
淘宝(必填) 拍拍(可选) 京东(可选) QQ网购(必填) 当当(可选) 亚马逊(可选) |
200002 |
交易ID |
|
company_code | String |
淘宝(可选) 拍拍(可选) 京东(可选) QQ网购(必填) 当当(可选) 亚马逊(可选) |
POST |
物流公司代码.如"POST"就代表中国邮政,"ZJS"就代表宅急送.调用 store.logistics.companies.get 获取。如传入的代码非淘宝官方物流合作公司,默认是“其他”物流的方式,在淘宝不显示物流具体进度,故传入需谨慎。 (京东SOPL商家该参数不需要填写) |
|
logistics_no | String |
淘宝(可选) 拍拍(可选) 京东(可选) QQ网购(必填) 当当(可选) 亚马逊(可选) |
F5257222 |
运单号。具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入;若company_code中传入的代码非淘宝官方物流合作公司,此处运单号不校验。 (京东SOPL商家该参数不需要填写) |
|
sender_id | Number |
淘宝(可选) 拍拍(可选) 京东(不支持) QQ网购(不支持) 当当(可选) 亚马逊(可选) |
654321 |
卖家联系人地址库ID。可以通过store.logistics.address.search接口查询到地址库ID。如果为空,取的卖家的默认取货地址 |
|
cancel_id | Number |
淘宝(可选) 拍拍(可选) 京东(不支持) QQ网购(不支持) 当当(可选) 亚马逊(可选) |
123456 |
卖家联系人地址库ID。可以通过store.logistics.address.search接口查询到地址库ID。如果为空,取的卖家的默认退货地址 |
|
package_num | Number |
淘宝(不支持) 拍拍(不支持) 京东(可选) QQ网购(不支持) 当当(可选) 亚马逊(可选) |
12 |
包裹数量(京东LBP,SOPL商家出库需要填写该参数) |
|
send_type | Number |
淘宝(不支持) 拍拍(不支持) 京东(可选) QQ网购(必填) 当当(可选) 亚马逊(可选) |
1 |
1 |
发货类型(京东LBP,SOPL商家出库需要填写该参数)默认值为1 当用户为QQ网购商家时,包裹物流方式 1:第三方快递 2:自建物流 3:EMS发货 4:用户自取 |
company_name | String |
淘宝(不支持) 拍拍(不支持) 京东(可选) QQ网购(可选) 当当(可选) 亚马逊(可选) |
物流公司中文名 |
||
ship_date | Date |
淘宝(不支持) 拍拍(不支持) 京东(不支持) QQ网购(不支持) 当当(不支持) 亚马逊(可选) |
实际发货时间。格式:yyyy-MM-dd HH:mm:ss(亚马逊必填,默认为当前时间) |
||
item_list | String |
淘宝(不支持) 拍拍(不支持) 京东(不支持) QQ网购(不支持) 当当(必填) 亚马逊(必填) |
[{"oid":"123","itemId":"3","num":4},{"oid":"789","itemId":"1","num":2}] |
发货单上的商品和数量(itemid为亚马逊订单上亚马逊指定商品编码,num为该商品数量) |
|
oid_list | String |
淘宝(可选) 拍拍(不支持) 京东(不支持) QQ网购(不支持) 当当(不支持) 亚马逊(不支持) |
111,222,333 |
拆单子订单列表,对应的数据是:子订单号的列表。可以不传,但是如果传了则必须符合传递的规则。子订单必须是操作的物流订单的子订单的真子集! |
|
is_split | String |
淘宝(可选) 拍拍(不支持) 京东(不支持) QQ网购(不支持) 当当(不支持) 亚马逊(不支持) |
0 |
表明是否是拆单,默认值0,1表示拆单 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
shipping | Shipping | 是 | 返回发货是否成功is_success |
{ "rsp":"succ", "msg_id":3463421b2581604c74dcb9b74ffab2e4, "data":{ "shipping":{ "is_success": true, } } }
错误码 | 错误描述 | 解决方案 |
---|