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

taobao.wlb.waybill.i.cancel (商家取消获取的电子面单号v1.0)

面单号有误需要取消的时候,调用该接口取消获取的电子面单。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
waybill_apply_cancel_request WaybillApplyCancelRequest 必须 取消接口入参
  • └ cp_code
  • String
  • 必须
  • EMS
  • CP快递公司编码
  • └ trade_order_list
  • String []
  • 必须
  • SW-20140403-14060502,SW-20140403-14060501
  • 交易订单列表
  • └ real_user_id
  • Number
  • 可选
  • 2134234234
  • 面单使用者编号
  • └ waybill_code
  • String
  • 必须
  • 1100222969702
  • 电子面单号码
  • └ package_id
  • String
  • 可选
  • E12321321-1234567
  • ERP订单号或包裹号

响应参数

名称 类型 示例值 描述
cancel_result Boolean false 调用取消是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWaybillICancelRequest req = new WlbWaybillICancelRequest();
WlbWaybillICancelRequest.WaybillApplyCancelRequest obj1 = new WlbWaybillICancelRequest.WaybillApplyCancelRequest();
obj1.setCpCode("EMS");
obj1.setTradeOrderList("SW-20140403-14060502,SW-20140403-14060501");
obj1.setRealUserId(2134234234L);
obj1.setWaybillCode("1100222969702");
obj1.setPackageId("E12321321-1234567");
req.setWaybillApplyCancelRequest(obj1);
WlbWaybillICancelResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<wlb_waybill_i_cancel_response>
    <cancel_result>false</cancel_result>
</wlb_waybill_i_cancel_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>

错误码解释

错误码 错误描述 解决方案
isp.cancel count over the limit 接口进行了限流 请接口调用速度减缓
isv.invalid detail status 面单号状态非法 请校验入参
isv.cancel detail is not found! 入参错误 对入参进行校验
isv.trade order is not matched 订单号不匹配 请确保订单号和面单号是匹配关系
isv.waybill service cannot open 电子面单服务不可用 请校验cpCode是否传错

API工具

如何获得此API

FAQ

返回
顶部