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

wdk.dms.center.jd.trace.push (京东物流轨迹推送)

京东物流轨迹推送

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_jd_trace_push_param JdTracePushParam 必须 物流轨迹推送对象
  • └ cancel_reason
  • String
  • 可选
  • 商家超时未准备好货物
  • 取消原因
  • └ category
  • Number
  • 必须
  • 690
  • 一级分类编码
  • └ category_name
  • String
  • 必须
  • 已取消
  • 一级分类名称
  • └ new_waybill_code
  • String
  • 可选
  • JDVF01768216292
  • 京东换单新运单号
  • └ operate_site
  • String
  • 可选
  • 杭州东洲分拣中心
  • 机构编码名称
  • └ operate_site_id
  • String
  • 必须
  • 822956
  • 机构编码,操作该全程跟踪的站点ID
  • └ operation_remark
  • String
  • 必须
  • 您的快件取消成功
  • 节点描述
  • └ operation_time
  • Date
  • 必须
  • 2022-05-16 13:24:36
  • 操作时间
  • └ operation_title
  • String
  • 必须
  • 取消完成
  • 节点名称
  • └ operator_name
  • String
  • 可选
  • 孙文
  • 小哥名称
  • └ operator_phone
  • String
  • 可选
  • 15100000001
  • 小哥电话
  • └ order_id
  • String
  • 必须
  • SO111111
  • 商家订单号
  • └ route_address
  • String
  • 可选
  • 首钢八角路小区16号楼对面平房
  • 路由详细地址
  • └ route_city_name
  • String
  • 可选
  • 石家庄市
  • 路由 市
  • └ route_district_name
  • String
  • 可选
  • 桥西区
  • 路由 区
  • └ route_province_name
  • String
  • 可选
  • 河北省
  • 路由 省
  • └ route_street_name
  • String
  • 可选
  • 五常街道
  • 路由 街道
  • └ sign_type_name
  • String
  • 可选
  • 快递驿站代收
  • 签收类型;妥投节点返回
  • └ state
  • String
  • 可选
  • 200010
  • 节点编码,长度1-10
  • └ waybill_code
  • String
  • 必须
  • JDVA10000001
  • 京东物流运单号

响应参数

名称 类型 示例值 描述
result Result 接口返回Result
  • └ error_code
  • String
  • 400
  • 业务错误码
  • └ error_message
  • String
  • 参数不能为空
  • 业务错误信息描述
  • └ module
  • Boolean
  • true
  • 接口具体返回的业务数据对象
  • └ success
  • Boolean
  • true
  • 接口调用是否成功 接口调用是否成功 true:可达 false:失败

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WdkDmsCenterJdTracePushRequest req = new WdkDmsCenterJdTracePushRequest();
WdkDmsCenterJdTracePushRequest.JdTracePushParam obj1 = new WdkDmsCenterJdTracePushRequest.JdTracePushParam();
obj1.setCancelReason("商家超时未准备好货物");
obj1.setCategory(690L);
obj1.setCategoryName("已取消");
obj1.setNewWaybillCode("JDVF01768216292");
obj1.setOperateSite("杭州东洲分拣中心");
obj1.setOperateSiteId("822956");
obj1.setOperationRemark("您的快件取消成功");
obj1.setOperationTime(StringUtils.parseDateTime("2022-05-16 13:24:36"));
obj1.setOperationTitle("取消完成");
obj1.setOperatorName("孙文");
obj1.setOperatorPhone("15100000001");
obj1.setOrderId("SO111111");
obj1.setRouteAddress("首钢八角路小区16号楼对面平房");
obj1.setRouteCityName("石家庄市");
obj1.setRouteDistrictName("桥西区");
obj1.setRouteProvinceName("河北省");
obj1.setRouteStreetName("五常街道");
obj1.setSignTypeName("快递驿站代收");
obj1.setState("200010");
obj1.setWaybillCode("JDVA10000001");
req.setParamJdTracePushParam(obj1);
WdkDmsCenterJdTracePushResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
<wdk_dms_center_jd_trace_push_response>
    <result>
        <error_code>400</error_code>
        <error_message>参数不能为空</error_message>
        <module>true</module>
        <success>true</success>
    </result>
</wdk_dms_center_jd_trace_push_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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

返回
顶部