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

taobao.xsd.order.logistics.track.callback (淘宝小时达物流轨迹回传)

淘宝小时达物流轨迹回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
xsd_fulfill_logistics_track_request XsdFulfillLogisticsTrackRequest 可选 请求入参
  • └ source_order_id
  • String
  • 可选
  • 311300018198101
  • 淘宝订单ID
  • └ remind_distance
  • String
  • 可选
  • 1400
  • 距离, 单位:米 骑手未到店, 表示骑手到店剩余距离 骑手未到店, 表示骑手到用户剩余距离
  • └ arrival_status
  • Boolean
  • 可选
  • true
  • 骑手到店状态
  • └ remind_time
  • Number
  • 可选
  • 120
  • 剩余时长, 单位: 秒 骑手未到店, 表示骑手到店剩余时间 骑手未到店, 表示骑手到用户剩余时间
  • └ latitude
  • String
  • 可选
  • 24.190
  • 骑手位置纬度
  • └ update_time
  • Date
  • 可选
  • 2024-07-01 10:00:00
  • 轨迹变更时间戳
  • └ shop_id
  • String
  • 可选
  • S001
  • 渠道店ID
  • └ longitude
  • String
  • 可选
  • 231.1470
  • 骑手位置经度

响应参数

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

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XsdOrderLogisticsTrackCallbackRequest req = new XsdOrderLogisticsTrackCallbackRequest();
XsdOrderLogisticsTrackCallbackRequest.XsdFulfillLogisticsTrackRequest obj1 = new XsdOrderLogisticsTrackCallbackRequest.XsdFulfillLogisticsTrackRequest();
obj1.setSourceOrderId("311300018198101");
obj1.setRemindDistance("1400");
obj1.setArrivalStatus(true);
obj1.setRemindTime(120L);
obj1.setLatitude("24.190");
obj1.setUpdateTime(StringUtils.parseDateTime("2024-07-01 10:00:00"));
obj1.setShopId("S001");
obj1.setLongitude("231.1470");
req.setXsdFulfillLogisticsTrackRequest(obj1);
XsdOrderLogisticsTrackCallbackResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xsd_order_logistics_track_callback_response>
    <result>
        <code>SUCCESS</code>
        <success>true</success>
        <message>成功</message>
    </result>
</xsd_order_logistics_track_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

返回
顶部