文档中心 > API类目 > 淘天物流API

taobao.logistics.express.packageweight.sync (TMS包裹重量回传)

TMS包裹重量回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tms_package_weight_request TmsPackageWeightRequest 必须 包裹重量信息
  • └ mail_no
  • String
  • 必须
  • SF1234343
  • 运单号
  • └ biz_code
  • String
  • 可选
  • 2343243242
  • 单据标识
  • └ weight
  • String
  • 可选
  • 2342
  • 包裹重量(单位:g),小数点后2位。若无重量,则需要通过abnormal_type字段给出原因
  • └ tms_cp_code
  • String
  • 可选
  • SF
  • 快递公司资源编码
  • └ abnormal_type
  • String
  • 可选
  • 0
  • 无包裹重量或者包裹不准确的类型 0-包裹重量有效(默认有效) 1-无包裹重量 2-包裹重量不准确。若存在weight,则不需要传该值
  • └ abnormal_desc
  • String
  • 可选
  • 无称重记录
  • 无包裹重量或者包裹不准确的原因。若存在weight,则不需要传该值
  • └ charging_weight
  • String
  • 可选
  • 23.33
  • 服务商侧计费重量(单位:g),小数点后2位
  • └ throwing_weight
  • String
  • 可选
  • 23.33
  • 计抛重量(单位:g),小数点后2位
  • └ length
  • String
  • 可选
  • 23.33
  • 包裹长度(单位:cm),小数点后2位
  • └ width
  • String
  • 可选
  • 23.33
  • 包裹宽度(单位:cm),小数点后2位
  • └ height
  • String
  • 可选
  • 23.33
  • 包裹高度(单位:cm),小数点后2位
  • └ volume
  • String
  • 可选
  • 23.123456
  • 包裹体积(单位:立方厘米),小数点后6位
  • └ throwing_ratio
  • String
  • 可选
  • 1000
  • 计抛比,比例,整数,不支持小数回传。条件必填,如果回传计抛重量,需回传计抛比(代表每xxx立方厘米换算为1克计抛重量)
  • └ phase
  • String
  • 可选
  • TMS_COLLECT
  • 重量回告的阶段,配揽收:TMS_COLLECT,驿站揽收:SITE_COLLECT,首分拨:FIRST_ALLOCATE,末分拨:LAST_ALLOCATE,默认为TMS_COLLECT
  • └ feature
  • String
  • 可选
  • {"package_security_flag":"1"}
  • 扩展字段
  • └ service_type
  • String
  • 可选
  • 1
  • 服务类型

响应参数

名称 类型 示例值 描述
suc Boolean true 校验成功或者异常
biz_error_message String 单据不存在 错误码描述
biz_error_code String 10000 错误码标识
retry Boolean true 是否可重试

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsExpressPackageweightSyncRequest req = new LogisticsExpressPackageweightSyncRequest();
LogisticsExpressPackageweightSyncRequest.TmsPackageWeightRequest obj1 = new LogisticsExpressPackageweightSyncRequest.TmsPackageWeightRequest();
obj1.setMailNo("SF1234343");
obj1.setBizCode("2343243242");
obj1.setWeight("2342");
obj1.setTmsCpCode("SF");
obj1.setAbnormalType("0");
obj1.setAbnormalDesc("无称重记录");
obj1.setChargingWeight("23.33");
obj1.setThrowingWeight("23.33");
obj1.setLength("23.33");
obj1.setWidth("23.33");
obj1.setHeight("23.33");
obj1.setVolume("23.123456");
obj1.setThrowingRatio("1000");
obj1.setPhase("TMS_COLLECT");
obj1.setFeature("{\"package_security_flag\":\"1\"}");
obj1.setServiceType("1");
req.setTmsPackageWeightRequest(obj1);
LogisticsExpressPackageweightSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_express_packageweight_sync_response>
    <suc>true</suc>
    <biz_error_message>单据不存在</biz_error_message>
    <biz_error_code>10000</biz_error_code>
    <retry>true</retry>
</logistics_express_packageweight_sync_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

返回
顶部