store.logistics.offline.send(订单发货接口（同步异步接口）数据获取队列（rpccallback）)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
tid	是	string	323423423428	交易ID
company_code	是	string	POST	物流公司代码.如'POST'就代表中国邮政,'ZJS'就代表宅急送.调用 store.logistics.companies.get 获取。如传入的代码非淘宝官方物流合作公司，默认是'其他'物流的方式，在淘宝不显示物流具体进度，故传入需谨慎。（京东SOPL商家该参数不需要填写）
logistics_no	是	string	F5257222	运单号。具体一个物流公司的真实运单号码。淘宝官方物流会校验，请谨慎传入；若company_code中传入的代码非淘宝官方物流合作公司，此处运单号不校验。（京东SOPL商家该参数不需要填写）
sender_id	是	number	1231234	卖家联系人地址库ID(不填为默认ID)。可以通过store.logistics.address.search接口查询到地址库ID。如果为空，取的卖家的默认取货地址
cancel_id	是	number	示例值	卖家联系人地址库ID。如果为空，取的卖家的默认退货地址
package_num	是	number	1	包裹数量
send_type	是	number	1	发货类型（京东LBP，SOPL商家出库需要填写该参数)默认值为1
company_name	是	string	顺丰快递	物流公司名称
ship_date	是	date	示例值	实际发货时间。格式:yyyy-MM-dd HH:mm:ss（亚马逊必填，默认为当前时间）
item_list	是	string	[{"oid":"123","itemId":"3","num":4},{"oid":"789","itemId":"1","num":2}]	发货单上的商品和数量（itemid为亚马逊订单上亚马逊指定商品编码，num为该商品数量）
oid_list	是	string	111,222,333	拆单子订单列表，对应的数据是：子订单号的列表。可以不传，但是如果传了则必须符合传递的规则。子订单必须是操作的物流订单的子订单的真子集
is_split	是	string	0	表明是否是拆单，默认值0，1表示拆单
node_id	是	string	11111_222222	节点信息
request_type	否	string	async	API请求方式同步：sync；异步：async，默认：async

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）3463421b2581604c74dcb9b74ffab2e4string data操作结果object shippingobject └ is_success发货请求返回结果标记，成功：truetruestring

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）3463421b2581604c74dcb9b74ffab2e4string

data操作结果object
- shippingobject
- - └ is_success发货请求返回结果标记，成功：truetruestring

响应示例

{
  "rsp": "succ",
  "msg_id": "3463421b2581604c74dcb9b74ffab2e4",
  "data": {
    "shipping": {
      "is_success": "true"
    }
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.items.quantity.list.update(批量库存更新接口（条数小于20）（接口只支持异步方式）数据获取队列（rpccallback）)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
list_quantity	是	object		list_quantity中包含3个参数bn:外部商家编码；quantity：库存数；memo:备注;数据传递为json格式，一次包含数据条数上限20条。
list_quantityobject └ bn货号（sku对应的商家编码）ad11string └ quantity库存总数13string └ memo备注string
node_id	是	string	111111_22222	节点信息
request_type	否	string	async	API请求方式同步：sync；异步：async，默认：async

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）3463421b2581604c74dcb9b74ffab2e4string data操作结果object └ true_bn已更新库存的BNarray └ error_bn更新失败的BNarray └ no_bn不存在的BNarray

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）3463421b2581604c74dcb9b74ffab2e4string

data操作结果object
- └ true_bn已更新库存的BNarray
- └ error_bn更新失败的BNarray
- └ no_bn不存在的BNarray

响应示例

{
  "rsp": "succ",
  "msg_id": "3463421b2581604c74dcb9b74ffab2e4",
  "data": {
    "true_bn": [],
    "error_bn": [],
    "no_bn": []
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.logistics.pub(订阅快递单物流流转信息（同步异步接口）数据获取队列（hqepaylogistics）)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
logistic_code_list	是	string	333,444,555,666	运单号,多个用逗号分隔
company_code	是	string	POST	物流公司代码.如'POST'就代表中国邮政,'ZJS'就代表宅急送一次请求只支持一家物流公司
node_id	是	string	111111_222222	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）5745484FC0A817126DB34333****D82Fstring data操作结果object └ update_time更新时间格式 yyyy-MM-dd HH:mm:ssdatetime └ reason备注string └ success表示请求成功或者失败成功：true 失败：falsestring

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）5745484FC0A817126DB34333****D82Fstring

data操作结果object
- └ update_time更新时间格式 yyyy-MM-dd HH:mm:ssdatetime
- └ reason备注string
- └ success表示请求成功或者失败成功：true 失败：falsestring

响应示例

{
  "rsp": "succ",
  "msg_id": "5745484FC0A817126DB34333****D82F",
  "data": {
    "update_time": "",
    "reason": "",
    "success": ""
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

logistics.trace.detail.get(获取快递单物流流转信息（同步异步接口）数据获取队列（hqepaylogistics）)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
tid	是	string	323423423428	交易ID
company_code	是	string	POST	物流公司代码.如'POST'就代表中国邮政,'ZJS'就代表宅急送
logistic_code	是	string	F5257222	运单号。具体一个物流公司的真实运单号码
node_id	是	string	111111_222222	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）5745484FC0A817126DB34333**D82Fstring data操作结果object └ logistic_code运单号。具体一个物流公司的真实运单号码330*3134955string └ company_code物流公司代码.如'POST'就代表中国邮政,'ZJS'就代表宅急送stostring └ state表示快递单状态在途中：2，签收：3，问题件：42string └ success表示请求成功或者失败成功：true 失败：falsetruestring traces快递物流流转信息详情object └ accept_station描述收件】【浙江瑞安公司】的收件员【卡贝卫浴】已收件string └ accept_time时间2016-05-09 16:59:28datetime

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）5745484FC0A817126DB34333****D82Fstring

data操作结果object
- └ logistic_code运单号。具体一个物流公司的真实运单号码330***3134955string
- └ company_code物流公司代码.如'POST'就代表中国邮政,'ZJS'就代表宅急送stostring
- └ state表示快递单状态在途中：2，签收：3，问题件：42string
- └ success表示请求成功或者失败成功：true 失败：falsetruestring
- traces快递物流流转信息详情object
- - └ accept_station描述收件】【浙江瑞安公司】的收件员【卡贝卫浴】已收件string
  - └ accept_time时间2016-05-09 16:59:28datetime

响应示例

{
  "rsp": "succ",
  "msg_id": "5745484FC0A817126DB34333****D82F",
  "data": {
    "logistic_code": "330***3134955",
    "company_code": "sto",
    "state": "2",
    "success": "true",
    "traces": {
      "accept_station": "收件】【浙江瑞安公司】的收件员【卡贝卫浴】已收件",
      "accept_time": "2016-05-09 16:59:28"
    }
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.tmc.group.add(订阅发票信息（专供淘宝）)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
group_name	是	string	einvocie	订阅分组名
node_id	是	string	111111_222222	节点信息
tb_nickname	是	string	你好	用户名（淘宝nickname）
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）5745484FC0A817126DB34333string dataobject └ success表示请求成功或者失败成功：true 失败：falsetruestring

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）5745484FC0A817126DB34333string

dataobject
- └ success表示请求成功或者失败成功：true 失败：falsetruestring

响应示例

{
  "rsp": "succ",
  "msg_id": "5745484FC0A817126DB34333",
  "data": {
    "success": "true"
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.tmc.group.delete(取消订阅)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
group_name	是	string	einvocie	订阅分组名
tb_nickname	是	string	你好	用户名（淘宝nickname）
node_id	是	string	111111_222222	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）5745484FC0A817126DB34333string dataobject └ success表示请求成功或者失败成功：true 失败：falsetruestring

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）5745484FC0A817126DB34333string

dataobject
- └ success表示请求成功或者失败成功：true 失败：falsetruestring

响应示例

{
  "rsp": "succ",
  "msg_id": "5745484FC0A817126DB34333",
  "data": {
    "success": "true"
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.einvoice.apply.get(开票申请数据获取接口)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
platform_tid	是	string	1231321344123	平台订单号
apply_id	是	string	sdfsfsdf12313	开票申请ID，跟消息中的apply_id对应，传入applyId后，只会返回一条开票申请消息
node_id	是	string	111111_222222	节点信息

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）5745484FC0A817126DB34333string dataobject └ is_success请求成功truestring apply_list开票明细object └ platform_code电商平台代码,TB,TM,ALIPAY,JDstring └ status开票申请状态，0=已拒绝，1=申请中，2=已同意string └ memo买家备注备注string └ payer_name买家抬头string └ platform_tid电商平台对应的订单号string └ payer_register_no买家税号string └ trigger_status开票申请的触发类型，buyer_payed=卖家已付款，sent_goods=卖家已发货，buyer_confirm=买家确认收货，refund_seller_confirm=卖家同意退款，invoice_supply=买家申请补开发票，invoice_change=买家申请改抬头string └ invoice_kind发票种类，0=电子发票，1=纸质发票，2=专票，现在默认是0string └ business_type抬头类型，0=个人，1=企业string └ invoice_type发票(开票)类型，蓝票blue,红票red，默认bluestring └ invoice_amount开票金额string └ sum_price不含税总金额string └ sum_tax总税额string invoice_items发票明细object └ item_name发票项目名称（或商品名称）string └ amount价税合计。(等于sumPrice和tax之和)string └ row_type发票行性质。0表示正常行，1表示折扣行，2表示被折扣行。比如充电器单价100元，折扣10元，则明细为2行，充电器行性质为2，折扣行性质为1。如果充电器没有折扣，则值应为0string └ specification规格型号,可选string └ sum_price总价，格式：100.00(不含税)string └ tax税额string └ price单价，格式：100.00(不含税)string └ quantity数量string └ tax_rate税率。税率只能为0或0.03或0.04或0.06或0.11或0.13或0.17string └ unit单位string

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）5745484FC0A817126DB34333string

dataobject
- └ is_success请求成功truestring
- apply_list开票明细object
- - └ platform_code电商平台代码,TB,TM,ALIPAY,JDstring
  - └ status开票申请状态，0=已拒绝，1=申请中，2=已同意string
  - └ memo买家备注备注string
  - └ payer_name买家抬头string
  - └ platform_tid电商平台对应的订单号string
  - └ payer_register_no买家税号string
  - └ trigger_status开票申请的触发类型，buyer_payed=卖家已付款，sent_goods=卖家已发货，buyer_confirm=买家确认收货，refund_seller_confirm=卖家同意退款，invoice_supply=买家申请补开发票，invoice_change=买家申请改抬头string
  - └ invoice_kind发票种类，0=电子发票，1=纸质发票，2=专票，现在默认是0string
  - └ business_type抬头类型，0=个人，1=企业string
  - └ invoice_type发票(开票)类型，蓝票blue,红票red，默认bluestring
  - └ invoice_amount开票金额string
  - └ sum_price不含税总金额string
  - └ sum_tax总税额string
  - invoice_items发票明细object
  - - └ item_name发票项目名称（或商品名称）string
    - └ amount价税合计。(等于sumPrice和tax之和)string
    - └ row_type发票行性质。0表示正常行，1表示折扣行，2表示被折扣行。比如充电器单价100元，折扣10元，则明细为2行，充电器行性质为2，折扣行性质为1。如果充电器没有折扣，则值应为0string
    - └ specification规格型号,可选string
    - └ sum_price总价，格式：100.00(不含税)string
    - └ tax税额string
    - └ price单价，格式：100.00(不含税)string
    - └ quantity数量string
    - └ tax_rate税率。税率只能为0或0.03或0.04或0.06或0.11或0.13或0.17string
    - └ unit单位string

响应示例

{
  "rsp": "succ",
  "msg_id": "5745484FC0A817126DB34333",
  "data": {
    "is_success": "true",
    "apply_list": {
      "platform_code": "",
      "status": "",
      "memo": "备注",
      "payer_name": "",
      "platform_tid": "",
      "payer_register_no": "",
      "trigger_status": "",
      "invoice_kind": "",
      "business_type": "",
      "invoice_type": "",
      "invoice_amount": "",
      "sum_price": "",
      "sum_tax": "",
      "invoice_items": {
        "item_name": "",
        "amount": "",
        "row_type": "",
        "specification": "",
        "sum_price": "",
        "tax": "",
        "price": "",
        "quantity": "",
        "tax_rate": "",
        "unit": ""
      }
    }
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.confirm.delivery(确认某一条出仓单(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	11111_2222	节点信息
vendor_id	是	string	111231313	供应商ID
storage_no	是	string	12323123	入库单号
store_sn	否	string		门店编码(门店必写)

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.create.delivery(用于用户创建出仓单(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	111111_222222	节点信息
vendor_id	是	string		供应商ID
po_no	是	string		po号
delivery_no	是	string		运单号
warehouse	是	string		送货仓库
delivery_time	否	string	2014-07-01 10:00:00	送货时间
arrival_time	是	string	2014-07-01 09:00:00	要求到货时间；空运(delivery_method=2)可选的时间段：9:00:00,16:00:00,18:00:00，23:59:00 ；汽运（delivery_method=1)可选的时间段：9:00:00,16:00:00,20:00:00,22:00:00，23:59:00
race_time	否	string	2014-07-01 10:00:00	预计收货时间
carrier_name	是	string		承运商名称
tel	否	string		联系电话
driver	否	string		司机姓名
driver_tel	否	string		司机联系电话
plate_number	否	string		车牌号
page	否	string		页码
limit	否	string		每页记录数(如果超过100,也只返回100条记录)
delivery_method	否	string	1	配送方式 1：汽运,2：空运;默认值：1
store_sn	否	string		门店编码
carrier_code	否	string		承运商编码

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）string dataobject └ delivery_id出库单Idstring └ storage_no入库单号string

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）string

dataobject
- └ delivery_id出库单Idstring
- └ storage_no入库单号string

响应示例

{
  "rsp": "succ",
  "msg_id": "",
  "data": {
    "delivery_id": "",
    "storage_no": ""
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.create.pick(创建拣货单信息(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	11111_2222	节点信息
po_no	是	string		po单编号,多po用英文逗号分隔
vendor_id	是	string		供应商ID
co_mode	否	string		合作模式
warehouse	否	string		送货仓库

响应参数

字段	类型	示例值	字段描述
└ rsp接口请求的成功succsuccstring └ msg_id接口任务号（唯一）string dataobject └ pick_no拣货单编号，正常拣货单：PICK- 补货单：BHPICK- 多po拣货单：MULPICK-string └ pick_type拣货单类别: JIT分销：jit_4a 普通jit：jitstring └ warehouse送货仓库string └ store_sn门店编码string └ jit_typejit类型，1：OXO ，2：仓中仓，返回空时，则为普通jitstring

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）string

dataobject
- └ pick_no拣货单编号，正常拣货单：PICK- 补货单：BHPICK- 多po拣货单：MULPICK-string
- └ pick_type拣货单类别: JIT分销：jit_4a 普通jit：jitstring
- └ warehouse送货仓库string
- └ store_sn门店编码string
- └ jit_typejit类型，1：OXO ，2：仓中仓，返回空时，则为普通jitstring

响应示例

{
  "rsp": "succ",
  "msg_id": "",
  "data": {
    "pick_no": "",
    "pick_type": "",
    "warehouse": "",
    "store_sn": "",
    "jit_type": ""
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.delete.deliverydetail(接口用于用户删除指定单号的出仓明细(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	11111_222222	节点信息
vendor_id	是	string		供应商ID
storage_no	是	string		入库单号
po_no	否	string		po订单号(多个po用英文逗号隔开）

响应参数

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）string

dataobject
- └ delivery_no入库单号,对应创建出仓单返回的编码storage_nostring
- └ barcode条形码string

响应示例

{
  "rsp": "succ",
  "msg_id": "",
  "data": {
    "delivery_no": "",
    "barcode": ""
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.get.pickdetail(获取指定拣货单明细信息(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	11111111_222222	节点信息
po_no	是	string		po单编号
vendor_id	是	string		供应商ID
pick_no	是	string		拣货单编号
page	否	string		页码参数
limit	否	string		每页记录条数，默认50，最大100
co_mode	否	string		合作模式 JIT分销：jit_4a 普通JIT：jit

响应参数

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）string

dataobject
- └ po_nopo单编号string
- └ sell_st_time档期开始销售时间2014-07-01 10:00:00string
- └ sell_et_time档期结束销售时间2014-07-01 10:00:00string
- └ export_time导出时间2014-07-01 10:00:00string
- └ export_num导出次数string
- └ warehouse送货仓库string
- └ order_cate订单类别 Normalstring
- └ total总记录string
- └ store_snstring
- └ jit_typejit类型，1：OXO ，2：仓中仓，返回空时，则为普通jitstring
- pick_product_listobject
- - └ stock商品拣货数量string
  - └ barcode商品条码string
  - └ art_no货号string
  - └ product_name商品名称string
  - └ size尺码string
  - └ actual_unit_price供货价（不含税）；已下架，请从getSkuPriceInfo获取string
  - └ actual_market_price供货价（含税）；已下架，请从getSkuPriceInfo获取string
  - └ not_delivery_num未送货数(海淘模式特有信息)string

响应示例

{
  "rsp": "succ",
  "msg_id": "",
  "data": {
    "po_no": "",
    "sell_st_time": "2014-07-01 10:00:00",
    "sell_et_time": "2014-07-01 10:00:00",
    "export_time": "2014-07-01 10:00:00",
    "export_num": "",
    "warehouse": "",
    "order_cate": "",
    "total": "",
    "store_sn": "",
    "jit_type": "",
    "pick_product_list": {
      "stock": "",
      "barcode": "",
      "art_no": "",
      "product_name": "",
      "size": "",
      "actual_unit_price": "",
      "actual_market_price": "",
      "not_delivery_num": ""
    }
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.get.picklist(获取指定供应商下拣货单列表信息(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string		节点信息
vendor_id	是	string		供应商ID
po_no	否	string		po订单号,支持批量，用英文逗号分隔
pick_no	否	string		拣货单编号
warehouse	否	string		送货仓库
co_mode	否	string		合作模式 JIT分销：jit_4a 普通JIT：jit
order_cate	否	string		订单类别 normal
st_create_time	否	string	2014-07-01 10:00:00	开始创建日期
et_create_time	否	string	2014-07-01 10:00:00	结束创建日期
st_sell_time_from	否	string	2014-07-01 10:00:00	开始开售日期
et_sell_time_from	否	string	2014-07-01 10:00:00	结束开售日期
is_export	否	string		导出状态
page	否	string		页码
limit	否	string		每页记录数(如果超过100,也只返回100条记录)
store_sn	否	string		门店编码

响应参数

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）string

dataobject
- pick拣货单信息列表object
- - └ po_nopo单编号string
  - └ pick_no拣货单编号string
  - └ co_mode合作模式 JIT分销：jit_4a 普通JIT：jitstring
  - └ sell_site送货仓库string
  - └ order_cate订单类别 normalstring
  - └ pick_num拣货数量string
  - └ create_time拣货单创建时间string
  - └ first_export_time首次导出时间string
  - └ export_num导出次数string
  - └ delivery_status送货状态string
  - └ store_sn门店编码string
  - └ delivery_num发货数string
- └ total记录总条数string

响应示例

{
  "rsp": "succ",
  "msg_id": "",
  "data": {
    "pick": {
      "po_no": "",
      "pick_no": "",
      "co_mode": "",
      "sell_site": "",
      "order_cate": "",
      "pick_num": "",
      "create_time": "",
      "first_export_time": "",
      "export_num": "",
      "delivery_status": "",
      "store_sn": "",
      "delivery_num": ""
    },
    "total": ""
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.import.deliverydetail(将出仓明细信息导入到出仓单中（目前该接口明细信息最大导入量在500条SKU信息)(唯品会JIT))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	字段描述
node_id	是	string	节点信息
vendor_id	是	string	供应商ID
po_no	是	string	po单编号,多po用逗号隔开
storage_no	是	string	入库单号
store_sn	否	string	门店编码，OXO业务要求填写，非OXO业务不用填写
delivery_list	是	object	出仓产品列表
└ vendor_type供应商类型：只可传：COMMON或3PLstring └ barcode条形码string └ box_no供应商箱号string └ pick_no拣货单号(后期会改为必填，建议现在就传入)string └ amount商品数量string └ po_nopo（对于多po生成的送货单必填）string

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.trade.shippingaddress.update(编辑交易的收货地址（仅限淘宝）)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string		节点信息
tid	是	string		订单号
receiver_name	否	string		收货人全名
receiver_phone	否	string		固定电话
receiver_mobile	否	string		移动电话
receiver_state	否	string	浙江	省份
receiver_city	否	string	杭州	城市
receiver_district	否	string	西湖区	区/县
receiver_address	否	string		收货地址
receiver_zip	否	string		邮政编码
request_type	否	string		API请求方式同步：sync；异步：async，默认：async

响应参数

字段

类型

示例值

字段描述

└ rsp接口请求的成功succsuccstring

└ msg_id接口任务号（唯一）string

dataobject
- └ tid交易编号 (父订单的交易编号)string
- └ modified交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ssstring

响应示例

{
  "rsp": "succ",
  "msg_id": "",
  "data": {
    "tid": "",
    "modified": ""
  }
}

异常返回

错误码	错误描述

API工具

API测试工具

store.o2o.trade.get(o2o获取到店自提订单信息(有赞))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
code	是	string		提货码
node_id	是	string		节点信息(店铺ID)
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.o2o.trade.apply(o2o核销到店自提订单(有赞))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
code	是	string		消费者端的到店自提订单提货码
extra_info	否	string		核销人（开发者根据自己业务规则传，一般为网点号或手机号）
node_id	是	string		节点信息(店铺ID)
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.o2o.stores.get(o2o获取网点门店列表(有赞))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
page_no	是	string		当前页
page_size	是	string		每页条数
node_id	是	string		节点信息(店铺ID)
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.bind.url(获取绑定url)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
code	否	string
callback	否	string
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.item.sku.list(获取商品sku列表(抖音))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string		节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
iid	是	string		product_id

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.item.sku.get(获取商品sku详情(抖音))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string		节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
sku_id	否	string		sku id

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.items.list.get(获取商品列表信息(抖音))

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string		节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
status	否	string		指定状态返回商品列表：0上架 1下架
check_status	否	string		指定审核状态返回商品列表：1未提审 2审核中 3审核通过 4审核驳回 5封禁 7审核通过，待上架状态
product_type	否	string		0-普通，3-虚拟，6玉石闪购，7云闪购
start_time	否	string		创建开始时间，格式为unix时间戳
end_time	否	string		创建结束时间，格式为unix时间戳
page	否	string		页码
size	否	string		每页返回条数，最多支持100条

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.trade.rate.get(淘宝商品评价接口)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
rate_type	否	string	get	评价类型。可选值:get(得到),give(给出)
role	否	string	buyer	评价者角色即评价的发起方。可选值:seller(卖家),buyer(买家)。当 give buyer 以买家身份给卖家的评价；当 get seller 以买家身份得到卖家给的评价；当 give seller 以卖家身份给买家的评价；当 get buyer 以卖家身份得到买家给的评价。
start_time	否	string	2022-09-21 00:00:00	评价开始时。如果只输入开始时间，那么能返回开始时间之后的评价数据。
end_time	否	string	2022-09-22 00:00:00	评价结束时间。如果只输入结束时间，那么全部返回所有评价数据。
page_no	否	string	1	页码。取值范围:大于零的整数最大限制为200; 默认值:1
page_size	否	string	150	每页获取条数。默认值40，最小值1，最大值150。
tid	否	string	123456	交易订单id，可以是父订单id号，也可以是子订单id号
result	否	string	good	评价结果,可选值:good(好评),neutral(中评),bad(差评)

响应示例(自定义结构)

{
  "data": {
    "has_next": true,
    "trade_rate": [
      {
        "content": "从小刷涂料，听大人说就是刷立邦漆，那时候我还以为是所有的涂料都是立邦呢，现在才知道立邦是一个品牌，现在我自己的房子装饰果断选择立邦，大品牌值得信赖 ",
        "created": "2022-09-21 15:14:52",
        "item_title": "立邦竹炭瓷净抗甲醛五合一室内家用墙面白色乳胶漆涂料油漆同城",
        "nick": "~La+CBGKlwcx0+c925akPCQ==~TYKwfj+wW46l~1~~",
        "oid": "2901870759322510351",
        "ouid": "AAEOAVLVAADVO0YAAfQJkc41",
        "rated_nick": "~xFbf4Np5fmfMhwww02/A9wOE4U/r8gyk9AvFoq4wFdQ=~W46l5nS1UrrQRL190ZO9C/wL~1~~",
        "result": "good",
        "role": "buyer",
        "tid": "2901870759322510351",
        "valid_score": false
      },
      {
        "content": "家里该装修了，油工师傅推荐用立邦，这个也是老牌子，之前用过，效果不错。家里有小孩子，还是用个环保系数高的。期待效果，到时候追评。",
        "created": "2022-09-21 15:14:01",
        "item_title": "立邦竹炭防霉抗菌无添加室内家用墙面白色漆乳胶漆涂料油漆同城",
        "nick": "~ynMOdeEdklWHYZ+FltpJCg==~t6uJtE6grNLu5C0+pM8/51aV+cD8~1~~",
        "oid": "2901837855523262740",
        "ouid": "AAEdAVLVAADVO0YAAfTeXv9x",
        "rated_nick": "~xFbf4Np5fmfMhwww02/A9wOE4U/r8gyk9AvFoq4wFdQ=~W46l5nS1UrrQRL190ZO9C/wL~1~~",
        "result": "good",
        "role": "buyer",
        "tid": "2901837855523262740",
        "valid_score": true
      },
      {
        "content": "好评！",
        "created": "2022-09-21 12:10:45",
        "item_title": "【99价】立邦防水防霉美缝贴厨房水池水槽卫生间马桶密封条缝隙填补胶条",
        "nick": "~IE0dxmfglE34ipexQO+YWg==~BblpYLbq~1~~",
        "oid": "2871099828375424261",
        "ouid": "AAFNAVLVAADVO0YAAfRAEBj0",
        "rated_nick": "~xFbf4Np5fmfMhwww02/A9wOE4U/r8gyk9AvFoq4wFdQ=~W46l5nS1UrrQRL190ZO9C/wL~1~~",
        "result": "good",
        "role": "buyer",
        "tid": "2871099828375424261",
        "valid_score": true
      }
    ]
  },
  "msg_id": "632C0A8AC0A8009A4734C7C43EE04504",
  "res": "",
  "rsp": "succ"
}

异常返回

错误码	错误描述

API工具

API测试工具

shopex.taobao.open.decrypt(淘宝解密接口)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
data	是	string	{"2741061531293572620":{"ship_name":"安>>1T6IwoAJRy4u5LpWRC5TZqog0AyLK2k9OZ2pYID7NJicwS1814FYU8PdXJwfd7ibIJes30Nb","ship_mobile":"***6112>>1T6IwoAJRy4u5LpWRC5TZqog0AyLK2k9OZ2pYID7NJicwS1814FYU8PdXJwfd7ibIJes30Nb","ship_addr":"虹街道路号上海普天信息园栋路号楼**层>>1T6IwoAJRy4u5LpWRC5TZqog0AyLK2k9OZ2pYID7NJicwS1814FYU8PdXJwfd7ibIJes30Nb"}}	密文数据
fields	否	string	{"ship_name":"ship_name","ship_mobile":"ship_mobile","ship_addr":"ship_addr"}	解密字段
oaid	是	string	oaid	oaid
tids	是	string	2741061531293572620	交易订单号
version	是	string	2.0	版本号淘宝解密必须传2.0

响应示例(自定义结构)

{
  "data": {
    "yuchenghe_log": "[{'yuchenghe_status': 'true', 'yuchenghe_params': 'appKey=68757809&orderId=2741061531293572620&decryptTime=2022-09-22+15%3A33%3A35&appName=https%3A%2F%2Foms-test.ex-sandbox.com%2Findex.php%2Fapi&url=https%3A%2F%2Fgw.api.taobao.com%2Frouter%2Frest&userId=1033393833&ati=8330120497490&action=1007&logTime=2022-09-22+15%3A33%3A35&time=2022-09-22+15%3A33%3A35&userIp=172.18.3.47&sign=7e704e976728f55ed6f6f022b18bde9c&topAppKey=10011902&topRequestId=16milh9jxjgkb', 'yuchenghe_msg': '{\"result\":\"success\",\"errMsg\":\"\"}'}]",
    "yuchenghe_url": "http://gw.ose.aliyun.com/event/Decrypt",
    "2741061531293572620": {
      "secret_no_expire_time": "",
      "ship_mobile": "17821516112",
      "uname": "",
      "privacy_protection": false,
      "ship_tel": "",
      "error_msg": "",
      "matched": true,
      "buyer_alipay_no": "",
      "name": "安嘉鑫",
      "ship_name": "安嘉鑫",
      "ship_addr": "虹梅路街道宜山路700号 上海普天信息产业园C1栋宜山路700号C1楼12层",
      "email": ""
    }
  },
  "msg_id": "632C0FCFAC12032F1741ECE5C30AE3F1",
  "err_msg": "",
  "rsp": "succ",
  "res": ""
}

异常返回

错误码	错误描述

API工具

API测试工具

store.sms.oaid.message.send(淘宝oaid发短信)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
extend_name	否	string	12345	拓展Name
order_id	是	string	1590159531380428537	订单号
extend_code	否	string	12345	拓展Code
sms_free_sign_name	是	string	聚石塔测试签名	短信签名
template_code	是	string	SMS_12345	短信模板
params	否	string	{"content":"您好! "}	短信占位符，替换短信模板里的占位符
extend	否	string	123	拓展信息
oaid	是	string	3mwdUE03cfGGuH4A4DrWWjcL8lxkl3bH29SM1RHqDNo5RgXYTdCQj1ZMN8wbv7qnLeiX6Dr	oaid
additional_info	否	string	true	是否需要返回附加信息

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.sms.template.create(淘宝短信模板创建)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
template_infos	否	string	[{"file_name":"fileName","file_suffix":"png","file_contents":"/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCASAAhQDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/","file_size":10}]	上传文件
template_type	是	string	1	0--验证码 1--短信通知 2-- 推广短信 3--国际/港澳台消息
template_type_class	是	string	NORMAL	NORMAL -- 普通模板 DIGITAL--数字短信模板
remark	是	string	使用场景说明	使用场景说明
template_name	是	string	模板名称	模板名称
template_content	是	string	您好，你的验证码为${code}	模板内容，占位符用${}标识

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.sms.template.modify(淘宝短信模板修改)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
template_type	是	string	1	不能修改
remark	是	string	场景说明	使用场景说明，可以修改
template_code	是	string	SMS_100001	不能修改
template_name	是	string	测试模板	模板名称，可以修改
template_content	是	string	您好，你的验证码为${code}	模板内容，占位符用${}标识，可以修改

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.sms.template.query(淘宝短信模板查询)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
template_code	是	string	SMS_100001	要查询的模板CODE

响应示例(自定义结构)

异常返回

错误码	错误描述

API工具

API测试工具

store.logistics.dummy.send(淘宝无需物流发货接口)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
tid	是	string	tid	淘宝交易ID

响应示例(自定义结构)

{
  "data": {
    "is_success": true
  },
  "err_msg": "",
  "msg_id": "636B0166C0A802864F70650D1BFF59FB",
  "res": "",
  "rsp": "succ"
}

异常返回

错误码	错误描述

API工具

API测试工具

store.logistics.consign.resend(修改物流公司和运单号)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
tid	是	string	tid	淘宝交易ID
out_sid	是	string	SF1387781288087	运单号
company_code	是	string	SF	物流公司代码
sub_tid	否	string	123,456	拆单子订单列表

响应示例(自定义结构)

{
  "data": {
    "result": {
      "success": true
    },
    "request_id": "16krht583e046"
  },
  "msg_id": "656FCC37C0A80287CEAF806C88A7B97B",
  "res": "",
  "rsp": "succ"
}

异常返回

错误码	错误描述

API工具

API测试工具

store.invoice.status.update(开通发票回传接口)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
invoice_memo	否	string	备注	备注信息
invoice_no	是	string	24332000025568029	发票号
created	是	string	2024-07-31	开票时间
invoice_title	是	string	个人	开票抬头
business_type	否	string	抬头类型：0-个人，1-企业	注: 拼多多必传
invoice_type	否	string	发票类型 1-蓝票 2-红票	注: 拼多多只支持蓝票（京东、拼多多必传）
invoice_kind	否	string	3	(注: 小红书必传) 0:发票类型未知;1:增值税专用发票；2:增值税纸质普通发票；3:增值税电子普通发票；4:形式发票
payee_name	否	string	XX电动工具（中国）有限公司	注：京东必传销货方公司名称
payee_register_no	是	string	91330700239132724K	税号
upload_file	否	string	发票内容	pdf格式url路径(抖音/京东必传)
invoice_file_content	否	string	发票内容	base64格式(小红书、拼多多必传)
taxfree_amount	否	string	99.9	开票金额(京东、拼多多必填)
tid	是	string	240720-650956061091209	订单号
sum_price	否	string	1000	注: 拼多多必传不含税金额，整数，单位：分
sum_tax	否	string	1000	注: 拼多多必传总税额，整数，单位：分
tax_rate	否	string	13	注: 拼多多必传税率,整数
payee_operator	是	string	赵唯	开票人
order_type	否	string	10001	订单类型 21-SOPL 22-SOP 23-LBV(京东平台非必传)
payee_address	否	string	杭州市滨江区滨康路999号	销货方公司地址(京东平台非必传)
payee_bankaccount	否	string	3511163015	销货方公司银行账户(京东平台非必传)
payee_bankname	否	string	德意志银行（中国）有限公司上海分行	销货方公司开户行(京东平台非必传)
payee_receiver	否	string	Jackie	收款人(京东平台非必传)
blue_invoice_no	否	string	24332000025568029	(注：京东当invoice_type=2必传) 提供原蓝票发票号码
invoice_code	否	string	032002300000	发票代码
payee_phone	否	string	1388888888	（企业抬头）电话
invoice_items	否	object		开票商品信息
invoice_itemsarray 0object └ item_noSKU编号789798string └ item_nameSKU名称牙膏string └ num数量1string └ price单价18.8number └ spec规格白色-XLstring └ unit单位件string └ tax_rate税率0.13number └ tax_categroy_code税收分类编码string └ is_tax_discount优惠政策标识 0-不使用 1-使用0string └ tax_discount_content增值税特殊管理当优惠政策标识为1时填写string └ zero_tax零税率标识空-非零税率 0-出口退税 1-免税 2-不征收 3-普通零税率string └ deductions扣除额两位小数string └ imei商品IMEI码string └ discount折扣0number └ freight运费0number

响应示例(自定义结构)

{
  "data": {
    "results": {
      "code": 10000,
      "log_id": "202408091101063C89521FCD397A8BE8A8",
      "msg": "success",
      "sub_code": "",
      "sub_msg": ""
    }
  },
  "msg_id": "66B5947FC0A802868A85B121F30535EE",
  "res": "",
  "rsp": "succ"
}

异常返回

错误码	错误描述

API工具

API测试工具

store.trade.invoice.amount.get(查询订单的应开发票)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1976120933_1033393833	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
tid	否	string	123456789	订单号

响应示例(自定义结构)

{
  "data": {
    "queryamountforown_result": {
      "message": "退款完成，无需开票",
      "success": false
    },
    "code": "0",
    "result": "success",
    "request_id": "3503686.39587.17244102463569311"
  },
  "msg_id": "66C86986C0A8028681BF4B5095528D9A",
  "res": "",
  "rsp": "succ"
}

异常返回

错误码	错误描述

API工具

API测试工具

shopex.jd.decrypt(京东SDK解密接口)

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://apigateway.shopex.cn/router	https://apigateway.shopex.cn/router
沙箱环境	xx	xx

公共请求参数：

名称	类型	是否必须	描述
method	String	是	方法名
app_key	String	是	app_key
sign_time	String	是	签名时间
sign	String	是	签名

请求参数

名称	是否必须	类型	示例值	字段描述
node_id	是	string	1088888888_169999999	节点信息
request_type	否	string	sync	API请求方式同步：sync；异步：async，默认：sync
data	是	string	[{\"uName\":\"密文数据\",\"telNo\":\"密文数据\",\"certNo\":\"密文数据\"}]	请求解密数据json字符串格式(注:字段名可以自定义如：[{"a":"密文数据"}])

响应示例(自定义结构)

{
  "rsp": "succ",
  "err_msg": "",
  "data": [
    {
      "uName": "焦某某",
      "telNo": "18999999999",
      "from_node_id": "169999999",
      "certNo": "610509999999999433"
    }
  ],
  "res": ""
}

异常返回

错误码	错误描述

API工具

API测试工具

云收订服务

store.logistics.offline.send(订单发货接口（同步异步接口）数据获取队列（rpccallback）)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.items.quantity.list.update(批量库存更新接口（条数小于20）（接口只支持异步方式）数据获取队列（rpccallback）)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.logistics.pub(订阅快递单物流流转信息（同步异步接口）数据获取队列（hqepaylogistics）)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

logistics.trace.detail.get(获取快递单物流流转信息（同步异步接口）数据获取队列（hqepaylogistics）)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.tmc.group.add(订阅发票信息（专供淘宝）)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.tmc.group.delete(取消订阅)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.einvoice.apply.get(开票申请数据获取接口)

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.confirm.delivery(确认某一条出仓单(唯品会JIT))

公共参数

请求参数

响应示例(自定义结构)

异常返回

API工具

store.create.delivery(用于用户创建出仓单(唯品会JIT))

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.create.pick(创建拣货单信息(唯品会JIT))

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.delete.deliverydetail(接口用于用户删除指定单号的出仓明细(唯品会JIT))

公共参数

请求参数

响应参数

响应示例

异常返回

API工具

store.get.pickdetail(获取指定拣货单明细信息(唯品会JIT))

公共参数

请求参数