淘宝开放平台

登录
文档中心 > API类目 > 交易API

交易API

qimen.alibaba.uni.trade.state.drive (全域收单交易状态推进接口)

全域收单交易驱动接口，可通过该接口实现配货发货确认收货

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
storeId String 必须 100004 零售核心门店ID
tradeNo String 可选 20180111000001595051 零售核心订单号，和外部订单号不能同时为空
outTradeNo String 可选 OT39472389645 业务方自有订单号，和零售核心订单号不能同时为空
action String 必须 DELIVER 驱动动作，配发货：DELIVER， 确认收货：CONFIRM
logisticsInfo LogisticsInfo 可选 物流信息
  • └ receiver
  • String
  • 可选
  • 齐天大圣
  • 收货人，当ACTION为CONFIRM时可不填
  • └ address
  • String
  • 可选
  • 江苏省连云港市花果山水帘洞齐天大圣秘书处
  • 收货人地址，当ACTION为CONFIRM时可不填
  • └ phoneNo
  • String
  • 可选
  • 13812345678
  • 收货人电话，当ACTION为CONFIRM时可不填
  • logisticsInfoDetails
  • LogisticsInfoDetail []
  • 必须
  • 物流明细
  • └ goodsIds
  • String
  • 可选
  • 1321432:2,342354:3
  • 商品列表 模型(商品标识:商品数量:商品类型) 商品类型:UNIQUE：唯一码；ITEM_SKU：sku模式；CUSTOM商家
  • └ logisticsNo
  • String
  • 必须
  • XTQ4235436
  • 物流单号
  • └ logisticsCompany
  • String
  • 必须
  • 哮天犬物流
  • 物流公司
storeIdType String 必须 RPLUS 门店Id类型，RPLUS：零售+门店ID; PLACE：商户中心门店ID; CUSTOM：自有门店ID，须在商户中心有映射关系

响应参数

名称 类型 示例值 描述
success Boolean true 业务成功标识 true|false
errCode String 601 错误码
errMsg String 无效参数 错误描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlibabaUniTradeStateDriveRequest req = new AlibabaUniTradeStateDriveRequest();
req.setStoreId("100004");
req.setTradeNo("20180111000001595051");
req.setOutTradeNo("OT39472389645");
req.setAction("DELIVER");
AlibabaUniTradeStateDriveRequest.LogisticsInfo obj1 = new AlibabaUniTradeStateDriveRequest.LogisticsInfo();
obj1.setReceiver("齐天大圣");
obj1.setAddress("江苏省连云港市花果山水帘洞齐天大圣秘书处");
obj1.setPhoneNo("13812345678");
List<AlibabaUniTradeStateDriveRequest.LogisticsInfoDetail> list3 = new ArrayList<AlibabaUniTradeStateDriveRequest.LogisticsInfoDetail>();
AlibabaUniTradeStateDriveRequest.LogisticsInfoDetail obj4 = new AlibabaUniTradeStateDriveRequest.LogisticsInfoDetail();
list3.add(obj4);
obj4.setGoodsIds("1321432:2,342354:3");
obj4.setLogisticsNo("XTQ4235436");
obj4.setLogisticsCompany("哮天犬物流");
obj1.setLogisticsInfoDetails(list3);
req.setLogisticsInfo(obj1);
req.setStoreIdType("RPLUS");
AlibabaUniTradeStateDriveResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
<success>true</success>
<errCode>601</errCode>
<errMsg>无效参数</errMsg>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部