天猫寄送类服务对接外部物流服务商回传物流状态信息
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
volume | Number | 可选 | 1000000 | 体积 单位 立方毫米 | |
weight | Number | 可选 | 111111 | 重量 单位 克 | |
comment | String | 可选 | 消费者不在家,所以取消 | 备注说明 | |
express_code | String | 可选 | SF11232222 | 物流单号(展示给消费者) | |
express_company | String | 可选 | 顺丰快递 | 物流公司名词(展示给消费者) | |
courier_mobile | String | 可选 | 13455655544 | 小件员手机号码 | |
courier_name | String | 可选 | 测试小件员 | 小件员姓名 | |
got_code | String | 可选 | 2333 | 取件码 | |
logistics_order_id | Number | 必须 | 222233333 | 物流订单号 | |
cost | Number | 可选 | 22 | 金额 单位分 | |
goods_info | String | 可选 | [{ "name": "上衣", "count": 1 }, { "name": "裤子", "count": 2 }] | 1、以下状态时必填: 包裹已揽收完成 2、字符串格式为:json 串 例子: [{ "name": "上衣", "count": 1 }, { "name": "裤子", "count": 2 }] | |
status_code | String | 必须 | create | 物流创建 :create 物流取消 :cancel 分派小件员:assign 已经分派小件员: assigned 包裹上门揽收: pickup_door 包裹已揽收完成: pickup_finished 包裹派送中: dispatching 包裹已签收: signed | |
sub_express_codes | String [] | 可选 | 2233332222 |
|
物流子单号 |
delivery_time | Date | 可选 | 2020-02-26 17:15:28 | 预计送达时间 dispatching节点时必填 | |
sign_time | Date | 可选 | 2020-02-26 17:15:28 | 签收时间 signed节点时必填 | |
pickup_finish_time | Date | 可选 | 2020-02-26 17:15:28 | 揽收完成时间 pickup_finished节点时必填 | |
pickup_door_time | Date | 可选 | 2020-02-26 17:15:28 | 上门揽收时间 pickup_door节点时必填 | |
new_logistics | Boolean | 可选 | true | 是否更新新物流数据 | |
extend_info | String | 可选 | {"key":"value"} | 扩展属性 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | FulfilplatformResult | result | 系统自动生成 |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); TmallServicecenterWorkcardLogisticsorderUpdateRequest req = new TmallServicecenterWorkcardLogisticsorderUpdateRequest(); req.setVolume(1000000L); req.setWeight(111111L); req.setComment( "消费者不在家,所以取消" ); req.setExpressCode( "SF11232222" ); req.setExpressCompany( "顺丰快递" ); req.setCourierMobile( "13455655544" ); req.setCourierName( "测试小件员" ); req.setGotCode( "2333" ); req.setLogisticsOrderId(222233333L); req.setCost(22L); req.setGoodsInfo( "[{ \"name\": \"上衣\", \"count\": 1 }, { \"name\": \"裤子\", \"count\": 2 }]" ); req.setStatusCode( "create" ); req.setSubExpressCodes( "2233332222" ); req.setDeliveryTime(StringUtils.parseDateTime( "2020-02-26 17:15:28" )); req.setSignTime(StringUtils.parseDateTime( "2020-02-26 17:15:28" )); req.setPickupFinishTime(StringUtils.parseDateTime( "2020-02-26 17:15:28" )); req.setPickupDoorTime(StringUtils.parseDateTime( "2020-02-26 17:15:28" )); req.setNewLogistics( true ); req.setExtendInfo( "{\"key\":\"value\"}" ); TmallServicecenterWorkcardLogisticsorderUpdateResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 | < tmall_servicecenter_workcard_logisticsorder_update_response > < result > < display_msg >更新失败</ display_msg > < msg_code >12233</ msg_code > < success >false</ success > </ result > </ tmall_servicecenter_workcard_logisticsorder_update_response > |
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 > |
错误码 | 错误描述 | 解决方案 |
---|