store.logistics.offline.send 自己联系物流(线下物流)发货 (同步和异步)

详细描述

用户调用该接口可实现自己联系发货(线下物流),使用该接口发货,交易订单状态会直接变成卖家已发货。不支持货到付款、在线下单类型的订单。

支持平台: 淘宝, 拍拍, 京东, QQ网购, 当当, 亚马逊

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
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

XML数据格式:

			
JSON数据格式:
{
    "rsp":"succ",
    "msg_id":3463421b2581604c74dcb9b74ffab2e4,
    "data":{
       "shipping":{
          "is_success": true,
        }
     }
}
XML数据格式:

			
JSON数据格式:

		

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2014-07-25 10:38:11