文档中心 > API类目 > 电子面单API

taobao.wlb.waybill.i.fullupdate (面单信息更新接口v1.0)

商家更新电子面单号对应的订单信息。
a.涉及到订单信息(如拆/合单、取消订单等)、修改发货地的逻辑时候,需要使用CANCEL+GET组合操作。一般的面单信息更新使用该接口;
b.该接口是全量修改接口,对于不做更新的字段也要把原有的字段值传进去,否则做为修改为空处理。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
waybill_apply_full_update_request WaybillApplyFullUpdateRequest 必须 更新面单信息请求
  • └ consignee_name
  • String
  • 必须
  • 李四
  • 收件人姓名
  • └ consignee_phone
  • String
  • 必须
  • 1232112322
  • 收件人电话
  • └ cp_code
  • String
  • 必须
  • HTK
  • 快递服务商CODE
  • logistics_service_list
  • LogisticsService []
  • 可选
  • 物流服务能力集合
  • └ service_code
  • String
  • 可选
  • SVC-DELIVERY-ENV
  • 服务编码
  • └ service_value4_json
  • String
  • 可选
  • { "value": "100.00","currency": "CNY","ensure_type": "0"}
  • 服务类型值,json格式表示
  • └ product_type
  • String
  • 必须
  • Standard-Express
  • 快递服务产品类型编码
  • └ send_name
  • String
  • 可选
  • 王二
  • 发件人姓名
  • └ send_phone
  • String
  • 可选
  • 12324352324
  • 发件人联系方式
  • └ trade_order_list
  • String []
  • 必须
  • 12312,123123
  • 交易订单号(组合表示合并订单)
  • └ real_user_id
  • Number
  • 必须
  • 12321321
  • 使用者ID
  • └ weight
  • Number
  • 可选
  • 123
  • 包裹重量 单位为G(克)
  • consignee_address
  • WaybillAddress
  • 必须
  • 收\发货地址
  • └ address_detail
  • String
  • 必须
  • 文一西路淘宝城969号
  • 详细地址
  • └ area
  • String
  • 可选
  • 余杭区
  • 区名称(三级地址)
  • └ city
  • String
  • 可选
  • 杭州市
  • 市名称(二级地址)
  • └ province
  • String
  • 必须
  • 浙江省
  • 一级地址(省、直辖市
  • └ town
  • String
  • 可选
  • 五常街道
  • 街道\镇名称(四级地址)
  • └ order_channels_type
  • String
  • 必须
  • TB
  • 订单渠道类型
  • package_items
  • PackageItem []
  • 必须
  • 包裹里面的商品名称
  • └ count
  • Number
  • 必须
  • 123
  • 商品数量
  • └ item_name
  • String
  • 必须
  • 衣服
  • 商品名称
  • └ volume
  • Number
  • 可选
  • 123
  • 包裹体积 单位为ML(毫升)或立方厘米
  • └ waybill_code
  • String
  • 必须
  • 12321323
  • 电子面单单号
  • └ package_id
  • String
  • 可选
  • E12321321-1234567
  • ERP 订单号或包裹号

响应参数

名称 类型 示例值 描述
waybill_apply_update_info WaybillApplyUpdateInfo 更新接口出参
  • └ short_address
  • String
  • 余杭
  • 挑拣规则(大头笔信息)
  • └ consignee_branch_name
  • String
  • 223232
  • 收货网点编码
  • └ consignee_branch_code
  • String
  • 余杭一部
  • 收货网点信息
  • trade_order_info
  • TradeOrderInfo
  • --
  • consignee_address
  • WaybillAddress
  • 收货人地址
  • └ address_detail
  • String
  • 朝阳路高井,财满街,财经中心9号楼21单元6013
  • 详细地址
  • └ address_non_code_format
  • String
  • demo
  • 地址信息系统标准格式
  • └ area
  • String
  • 朝阳区
  • 区名称(三级地址)
  • └ city
  • String
  • 北京市
  • 市名称(二级地址)
  • └ province
  • String
  • 北京
  • 省名称(一级地址)
  • └ town
  • String
  • 八里庄
  • 街道\镇名称(四级地址)
  • └ consignee_name
  • String
  • 张三
  • 收货人
  • └ consignee_phone
  • String
  • 13242422352
  • 收货人联系方式
  • logistics_service_list
  • LogisticsService []
  • 物流服务能力集合
  • └ service_code
  • String
  • SVC-DELIVERY-ENV
  • 服务编码
  • └ service_value4_json
  • String
  • { "value": "100.00","currency": "CNY","ensure_type": "0"}
  • 服务类型值,json格式表示
  • └ order_channels_type
  • String
  • TB
  • 订单渠道
  • package_items
  • PackageItem []
  • 包裹中的商品类型
  • └ count
  • Number
  • 123
  • 商品数量
  • └ item_name
  • String
  • 衣服
  • 商品名称
  • └ product_type
  • String
  • STANDARD_EXPRESS
  • 快递服务产品类型编码
  • └ send_name
  • String
  • 李四
  • 发货人姓名
  • └ send_phone
  • String
  • 13242422352
  • 发货人联系方式
  • └ trade_order_list
  • String []
  • 12321321,12321321
  • 交易订单列表
  • └ real_user_id
  • Number
  • 123232
  • 使用者ID
  • └ volume
  • Number
  • 123
  • 包裹体积(立方厘米)
  • └ weight
  • Number
  • 123
  • 包裹重量(克)
  • └ package_id
  • String
  • E12321321-1234567
  • 包裹号(或者ERP订单号)
  • └ waybill_code
  • String
  • 322323
  • --
  • └ package_center_name
  • String
  • 浙江杭州
  • 集包地、目的地中心名称
  • └ package_center_code
  • String
  • 123456
  • 集包地、目的地中心代码。打印时根据该 code 生成目的地中心的条码,条码生成的算法与对应的电子面单条码一致

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWaybillIFullupdateRequest req = new WlbWaybillIFullupdateRequest();
WlbWaybillIFullupdateRequest.WaybillApplyFullUpdateRequest obj1 = new WlbWaybillIFullupdateRequest.WaybillApplyFullUpdateRequest();
obj1.setConsigneeName("李四");
obj1.setConsigneePhone("1232112322");
obj1.setCpCode("HTK");
List<WlbWaybillIFullupdateRequest.LogisticsService> list3 = new ArrayList<WlbWaybillIFullupdateRequest.LogisticsService>();
WlbWaybillIFullupdateRequest.LogisticsService obj4 = new WlbWaybillIFullupdateRequest.LogisticsService();
list3.add(obj4);
obj4.setServiceCode("SVC-DELIVERY-ENV");
obj4.setServiceValue4Json("{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}");
obj1.setLogisticsServiceList(list3);
obj1.setProductType("Standard-Express");
obj1.setSendName("王二");
obj1.setSendPhone("12324352324");
obj1.setTradeOrderList("12312,123123");
obj1.setRealUserId(12321321L);
obj1.setWeight(123L);
WlbWaybillIFullupdateRequest.WaybillAddress obj5 = new WlbWaybillIFullupdateRequest.WaybillAddress();
obj5.setAddressDetail("文一西路淘宝城969号");
obj5.setArea("余杭区");
obj5.setCity("杭州市");
obj5.setProvince("浙江省");
obj5.setTown("五常街道");
obj1.setConsigneeAddress(obj5);
obj1.setOrderChannelsType("TB");
List<WlbWaybillIFullupdateRequest.PackageItem> list7 = new ArrayList<WlbWaybillIFullupdateRequest.PackageItem>();
WlbWaybillIFullupdateRequest.PackageItem obj8 = new WlbWaybillIFullupdateRequest.PackageItem();
list7.add(obj8);
obj8.setCount(123L);
obj8.setItemName("衣服");
obj1.setPackageItems(list7);
obj1.setVolume(123L);
obj1.setWaybillCode("12321323");
obj1.setPackageId("E12321321-1234567");
req.setWaybillApplyFullUpdateRequest(obj1);
WlbWaybillIFullupdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<wlb_waybill_i_fullupdate_response>
    <waybill_apply_update_info>
        <short_address>余杭</short_address>
        <consignee_branch_name>223232</consignee_branch_name>
        <consignee_branch_code>余杭一部</consignee_branch_code>
        <trade_order_info>
            <consignee_address>
                <address_detail>朝阳路高井,财满街,财经中心9号楼21单元6013</address_detail>
                <address_non_code_format>demo</address_non_code_format>
                <area>朝阳区</area>
                <city>北京市</city>
                <province>北京</province>
                <town>八里庄</town>
            </consignee_address>
            <consignee_name>张三</consignee_name>
            <consignee_phone>13242422352</consignee_phone>
            <logistics_service_list>
                <logistics_service>
                    <service_code>SVC-DELIVERY-ENV</service_code>
                    <service_value4_json>{ &quot;value&quot;: &quot;100.00&quot;,&quot;currency&quot;: &quot;CNY&quot;,&quot;ensure_type&quot;: &quot;0&quot;}</service_value4_json>
                </logistics_service>
            </logistics_service_list>
            <order_channels_type>TB</order_channels_type>
            <package_items>
                <package_item>
                    <count>123</count>
                    <item_name>衣服</item_name>
                </package_item>
            </package_items>
            <product_type>STANDARD_EXPRESS</product_type>
            <send_name>李四</send_name>
            <send_phone>13242422352</send_phone>
            <trade_order_list>
                <string>12321321</string>
                <string>12321321</string>
            </trade_order_list>
            <real_user_id>123232</real_user_id>
            <volume>123</volume>
            <weight>123</weight>
            <package_id>E12321321-1234567</package_id>
        </trade_order_info>
        <waybill_code>322323</waybill_code>
        <package_center_name>浙江杭州</package_center_name>
        <package_center_code>123456</package_center_code>
    </waybill_apply_update_info>
</wlb_waybill_i_fullupdate_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

返回
顶部