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

taobao.xsd.order.work.update (淘宝小时达履约状态商家ERP回传)

淘宝小时达履约状态商家ERP回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tb_fulfill_callback_request XsdFulfillCallbackRequest 必须 请求入参对象
  • └ source_order_id
  • String
  • 必须
  • 3001415191101001
  • 淘宝订单ID
  • └ status_time
  • Date
  • 必须
  • 2024-07-01 10:00:00
  • 状态变更时间
  • └ status_remark
  • String
  • 可选
  • 商品缺货
  • 状态备注
  • └ shop_id
  • String
  • 必须
  • S001
  • 渠道店ID
  • sub_orders
  • XsdFulfillCallbackSubOrderInfo []
  • 可选
  • []
  • 子单列表
  • └ sn_code
  • String
  • 可选
  • 17777011,177770112
  • SN码串 多个用,分隔
  • └ pick_sale_quantity
  • String
  • 可选
  • 1.0
  • 销售单位拣货数量
  • └ source_sub_order_id
  • String
  • 可选
  • 3001415191101001
  • 淘宝子订单ID
  • └ pick_stock_quantity
  • String
  • 可选
  • 1.0
  • 库存单位拣货数量
  • └ status
  • String
  • 必须
  • PICKED
  • PICKED=拣货完成 / PACKAGED=打包出库 / SHIPPING=开始配送/SIGN=用户签收/REFUSED=用户拒收
  • └ deliverer_name
  • String
  • 可选
  • 张师傅
  • 骑手名称
  • └ deliverer_phone
  • String
  • 可选
  • 13371829102
  • 骑手联系方式
  • └ deliverer_company
  • String
  • 可选
  • SF
  • 骑手配送公司
  • └ logistics_no
  • String
  • 可选
  • SF2024071009
  • 配送物流单号

响应参数

名称 类型 示例值 描述
api_result ResultDTO 返回结果
  • └ return_code
  • String
  • SUCCESS
  • 返回码
  • └ return_msg
  • String
  • 调用成功
  • 返回码说明
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XsdOrderWorkUpdateRequest req = new XsdOrderWorkUpdateRequest();
XsdOrderWorkUpdateRequest.XsdFulfillCallbackRequest obj1 = new XsdOrderWorkUpdateRequest.XsdFulfillCallbackRequest();
obj1.setSourceOrderId("3001415191101001");
obj1.setStatusTime(StringUtils.parseDateTime("2024-07-01 10:00:00"));
obj1.setStatusRemark("商品缺货");
obj1.setShopId("S001");
List<XsdOrderWorkUpdateRequest.XsdFulfillCallbackSubOrderInfo> list3 = new ArrayList<XsdOrderWorkUpdateRequest.XsdFulfillCallbackSubOrderInfo>();
XsdOrderWorkUpdateRequest.XsdFulfillCallbackSubOrderInfo obj4 = new XsdOrderWorkUpdateRequest.XsdFulfillCallbackSubOrderInfo();
list3.add(obj4);
obj4.setSnCode("17777011,177770112");
obj4.setPickSaleQuantity("1.0");
obj4.setSourceSubOrderId("3001415191101001");
obj4.setPickStockQuantity("1.0");
obj1.setSubOrders(list3);
obj1.setStatus("PICKED");
obj1.setDelivererName("张师傅");
obj1.setDelivererPhone("13371829102");
obj1.setDelivererCompany("SF");
obj1.setLogisticsNo("SF2024071009");
req.setTbFulfillCallbackRequest(obj1);
XsdOrderWorkUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xsd_order_work_update_response>
    <api_result>
        <return_code>SUCCESS</return_code>
        <return_msg>调用成功</return_msg>
        <success>true</success>
    </api_result>
</xsd_order_work_update_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

返回
顶部