文档中心 > API类目 > 淘宝小时达履约

taobao.shangou.open.cabinet.callback (自提柜取件码回传)

自提柜取件码回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
xsd_cabinet_callback_request XsdCabinetCallbackRequest 必须 自提柜码回传接口请求体
  • └ source_order_id
  • String
  • 必须
  • 3001415191101001
  • 淘宝订单ID
  • └ cabinet_address
  • String
  • 可选
  • 杭州市余杭区西溪印象城西楼1楼游泳柜台旁(正门进门后右转直达)
  • 柜机地址
  • └ status_time
  • Date
  • 必须
  • 2026-05-26 10:00:37
  • 自提柜操作时间
  • └ cabinet_code
  • String
  • 可选
  • 1234
  • 开柜码
  • └ shop_id
  • String
  • 必须
  • S001
  • 渠道店id
  • └ cabinet_door
  • String
  • 可选
  • 001
  • 格口号
  • └ cabinet_num
  • String
  • 可选
  • 001
  • 柜机号
  • └ status
  • String
  • 必须
  • save
  • 存柜状态 save:存柜/更换格口;cancel:取消存柜

响应参数

名称 类型 示例值 描述
result ResultDTO 出参返回对象
  • └ code
  • String
  • SYSTEM_ERROR
  • 状态码
  • └ success
  • Boolean
  • true
  • 请求是否成功
  • └ message
  • String
  • 系统错误
  • 状态描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ShangouOpenCabinetCallbackRequest req = new ShangouOpenCabinetCallbackRequest();
ShangouOpenCabinetCallbackRequest.XsdCabinetCallbackRequest obj1 = new ShangouOpenCabinetCallbackRequest.XsdCabinetCallbackRequest();
obj1.setSourceOrderId("3001415191101001");
obj1.setCabinetAddress("杭州市余杭区西溪印象城西楼1楼游泳柜台旁(正门进门后右转直达)");
obj1.setStatusTime(StringUtils.parseDateTime("2026-05-26 10:00:37"));
obj1.setCabinetCode("1234");
obj1.setShopId("S001");
obj1.setCabinetDoor("001");
obj1.setCabinetNum("001");
obj1.setStatus("save");
req.setXsdCabinetCallbackRequest(obj1);
ShangouOpenCabinetCallbackResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<shangou_open_cabinet_callback_response>
    <result>
        <code>SYSTEM_ERROR</code>
        <success>true</success>
        <message>系统错误</message>
    </result>
</shangou_open_cabinet_callback_response>

异常示例

  • XML示例
  • JSON示例
<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

FAQ

返回
顶部