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

alibaba.xsd.logistics.order.status.callback (配送单状态回传)

配送单状态回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
delivery_order_callback_status_req DeliveryOrderCallbackStatusReq 必须 配送状态对象
  • └ delivery_order_no
  • String
  • 必须
  • 300112412401001
  • 淘宝近场运力单号
  • └ delivery_person_lat
  • BigDecimal
  • 可选
  • 120.12
  • 骑手坐标纬度(高德坐标数据)
  • └ delivery_person_phone
  • String
  • 可选
  • 13319820910
  • 骑手电话
  • └ delivery_person_name
  • String
  • 可选
  • 张三
  • 骑手名称
  • └ delivery_person_lng
  • BigDecimal
  • 可选
  • 120.12
  • 骑手坐标经度(高德坐标数据)
  • └ business_time
  • Number
  • 必须
  • 1728454087000
  • 配送状态变化时间,毫秒级时间戳
  • └ status
  • String
  • 必须
  • SUCCESS
  • 当前物流状态 ACCEPTED:骑手接单 ARRIVAL:骑手到店(可跳过) SHIPPING:骑手揽收【发货】 RDC_DISPATCH:分拨发货 SITE_ARRIVE_SITE:到达派送网点 SITE_ORDER_PICK:派送中 SUCCESS:用户签收 GOODS_RETURN:货物退回
  • └ complete_pics
  • String []
  • 可选
  • ["https://xxxxx"]
  • 送达照片 用户签收时骑手拍照表明已送达
  • └ complete_type
  • Number
  • 可选
  • 1
  • 签收方式 1. 送货上门 2. 放代收点 不传默认=1
  • └ complete_receiver_type
  • Number
  • 可选
  • 1
  • 签收方式为送货上门时 签收人类型 1 本人签收 2 他人代收
  • └ shipping_station_name
  • String
  • 可选
  • 揽收站点名称
  • 揽收站点名称 RDC_DISPATCH状态回传
  • └ site_phone
  • String
  • 可选
  • 131109201980
  • 网点联系方式 SITE_ARRIVE_SITE状态回传
  • └ site_name
  • String
  • 可选
  • 配送站点名
  • 配送站点名称 SITE_ARRIVE_SITE/SITE_ORDER_PICK状态回传
  • └ goods_total_weight
  • Number
  • 可选
  • 1000
  • 商品总重量,单位:g小数点后2位,在SHIPPING阶段回传
  • └ collection_point_name
  • String
  • 可选
  • 代收点名称
  • 签收方式为放代收点时 代收点名称

响应参数

名称 类型 示例值 描述
result ApiResult 返回对象
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ code
  • String
  • SUCCESS
  • 错误码
  • └ message
  • String
  • 调用成功
  • 错误码说明

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaXsdLogisticsOrderStatusCallbackRequest req = new AlibabaXsdLogisticsOrderStatusCallbackRequest();
AlibabaXsdLogisticsOrderStatusCallbackRequest.DeliveryOrderCallbackStatusReq obj1 = new AlibabaXsdLogisticsOrderStatusCallbackRequest.DeliveryOrderCallbackStatusReq();
obj1.setDeliveryOrderNo("300112412401001");
obj1.setDeliveryPersonLat("120.12");
obj1.setDeliveryPersonPhone("13319820910");
obj1.setDeliveryPersonName("张三");
obj1.setDeliveryPersonLng("120.12");
obj1.setBusinessTime(1728454087000L);
obj1.setStatus("SUCCESS");
obj1.setCompletePics(""https://xxxxx"");
obj1.setCompleteType(1L);
obj1.setCompleteReceiverType(1L);
obj1.setShippingStationName("揽收站点名称");
obj1.setSitePhone("131109201980");
obj1.setSiteName("配送站点名");
obj1.setGoodsTotalWeight(1000L);
obj1.setCollectionPointName("代收点名称");
req.setDeliveryOrderCallbackStatusReq(obj1);
AlibabaXsdLogisticsOrderStatusCallbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_xsd_logistics_order_status_callback_response>
    <result>
        <success>true</success>
        <code>SUCCESS</code>
        <message>调用成功</message>
    </result>
</alibaba_xsd_logistics_order_status_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

返回
顶部