文档中心 > API类目 > 盒马配送API

wdk.dms.center.common.trace.push (3PL通用物流轨迹回传)

3PL通用物流轨迹回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
logistics_common_push_param LogisticsCommonPushParam 必须 轨迹回传DTO
  • └ cp_code
  • String
  • 必须
  • STO
  • 承运商code
  • └ is_reverse_status
  • String
  • 可选
  • 1是,0不是,默认0
  • 是否是逆向状态
  • └ order_id
  • String
  • 可选
  • SO111111
  • 商家订单号
  • └ op_time
  • String
  • 必须
  • 2022-05-16 13:24:36
  • 操作时间
  • └ op_message
  • String
  • 必须
  • 快件已于【】揽收
  • 节点描述
  • └ new_waybill_code
  • String
  • 可选
  • STO10000002
  • 拒收换单和拦截换单时必传;
  • └ op_desc
  • String
  • 必须
  • 已揽收
  • 物流状态描述:如:"已揽收"
  • └ waybill_code
  • String
  • 必须
  • STO10000001
  • 物流运单号
  • └ extend_attr_json
  • String
  • 可选
  • {"key":"value","key2":"value2"}
  • 扩展字段,json格式的字符串
  • └ op_code
  • String
  • 必须
  • ACCEPT
  • 物流状态code
  • └ operator_phone
  • String
  • 可选
  • 15100000001
  • 小哥电话
  • └ operator_name
  • String
  • 可选
  • 孙文
  • 小哥名称

响应参数

名称 类型 示例值 描述
result Boolean true 返回请求结果
response_msg String 系统异常 错误描述
response_code String 500 错误编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WdkDmsCenterCommonTracePushRequest req = new WdkDmsCenterCommonTracePushRequest();
WdkDmsCenterCommonTracePushRequest.LogisticsCommonPushParam obj1 = new WdkDmsCenterCommonTracePushRequest.LogisticsCommonPushParam();
obj1.setCpCode("STO");
obj1.setIsReverseStatus("1是,0不是,默认0");
obj1.setOrderId("SO111111");
obj1.setOpTime("2022-05-16 13:24:36");
obj1.setOpMessage("快件已于【】揽收");
obj1.setNewWaybillCode("STO10000002");
obj1.setOpDesc("已揽收");
obj1.setWaybillCode("STO10000001");
obj1.setExtendAttrJson("{\"key\":\"value\",\"key2\":\"value2\"}");
obj1.setOpCode("ACCEPT");
obj1.setOperatorPhone("15100000001");
obj1.setOperatorName("孙文");
req.setLogisticsCommonPushParam(obj1);
WdkDmsCenterCommonTracePushResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<wdk_dms_center_common_trace_push_response>
    <result>true</result>
    <response_msg>系统异常</response_msg>
    <response_code>500</response_code>
</wdk_dms_center_common_trace_push_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

返回
顶部