文档中心 > API类目 > 菜鸟仓配API

alibaba.cainiao.whc.warehouse.return.confirm (退货)

退货

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
return_warehouse_result ReturnWarehouseResult 可选 返回结果
  • └ warehouse_code
  • String
  • 可选
  • DRF3454
  • 仓编码,由基础店仓维护,盒马全域统一
  • └ return_warehouse_bill_id
  • String
  • 可选
  • 71234324213521
  • 入库单号
  • └ package_quality
  • String
  • 可选
  • 1
  • 0:包裹完整 1:包裹破损
  • sku_info_list
  • SkuInfoList []
  • 可选
  • {}
  • 子订单信息列表
  • └ warehouse_loss_stock_quantity
  • String
  • 可选
  • 1
  • 仓内报损数量(退仓数量-实际入库数量)
  • └ actual_in_bound_stock_quantity
  • String
  • 可选
  • 1
  • 实际入库数量(库存单位)
  • └ sku_code
  • String
  • 可选
  • 0102010001
  • 商品编码
  • └ reverse_fulfill_order_id
  • String
  • 可选
  • 34453543
  • 逆向履约单号
  • └ reverse_fulfill_sub_order_id
  • String
  • 可选
  • 12141
  • 逆向履约子单号
  • └ related_fulfill_order_id
  • String
  • 可选
  • 1
  • 关联的正向履约主单号
  • └ related_fulfill_sub_order_id
  • String
  • 可选
  • 1
  • 关联的正向履约子单号
  • warehouse_loss_reason_list
  • WarehouseLossReason []
  • 可选
  • {}
  • 仓内报损原因列表
  • └ warehouse_loss_reason
  • String
  • 可选
  • 报损原因描述
  • 商品破损
  • └ warehouse_loss_reason_code
  • String
  • 可选
  • 1001
  • 报损原因编码
  • └ warehouse_loss_stock_quantity
  • String
  • 可选
  • 1
  • 仓内报损数量

响应参数

名称 类型 示例值 描述
result Result 结果
  • └ error_desc
  • String
  • 系统异常
  • 返回码含义描述
  • └ error_code
  • String
  • 1001
  • 返回码(success=false时不能为空): SYSTEM_ERROR :系统异常(指令可重发) PARAM_ERROR :参数错误(指令不可重发,监控报警) BUSINESS_ERROR:业务异常(指令不可重发,监控报警)
  • └ success
  • Boolean
  • true
  • 成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaCainiaoWhcWarehouseReturnConfirmRequest req = new AlibabaCainiaoWhcWarehouseReturnConfirmRequest();
AlibabaCainiaoWhcWarehouseReturnConfirmRequest.ReturnWarehouseResult obj1 = new AlibabaCainiaoWhcWarehouseReturnConfirmRequest.ReturnWarehouseResult();
obj1.setWarehouseCode("DRF3454");
obj1.setReturnWarehouseBillId("71234324213521");
obj1.setPackageQuality("1");
List<AlibabaCainiaoWhcWarehouseReturnConfirmRequest.SkuInfoList> list3 = new ArrayList<AlibabaCainiaoWhcWarehouseReturnConfirmRequest.SkuInfoList>();
AlibabaCainiaoWhcWarehouseReturnConfirmRequest.SkuInfoList obj4 = new AlibabaCainiaoWhcWarehouseReturnConfirmRequest.SkuInfoList();
list3.add(obj4);
obj4.setWarehouseLossStockQuantity("1");
obj4.setActualInBoundStockQuantity("1");
obj4.setSkuCode("0102010001");
obj4.setReverseFulfillOrderId("34453543");
obj4.setReverseFulfillSubOrderId("12141");
obj4.setRelatedFulfillOrderId("1");
obj4.setRelatedFulfillSubOrderId("1");
List<AlibabaCainiaoWhcWarehouseReturnConfirmRequest.WarehouseLossReason> list7 = new ArrayList<AlibabaCainiaoWhcWarehouseReturnConfirmRequest.WarehouseLossReason>();
AlibabaCainiaoWhcWarehouseReturnConfirmRequest.WarehouseLossReason obj8 = new AlibabaCainiaoWhcWarehouseReturnConfirmRequest.WarehouseLossReason();
list7.add(obj8);
obj8.setWarehouseLossReason("报损原因描述");
obj8.setWarehouseLossReasonCode("1001");
obj8.setWarehouseLossStockQuantity("1");
list5.setWarehouseLossReasonList(list7);
obj1.setSkuInfoList(list3);
req.setReturnWarehouseResult(obj1);
AlibabaCainiaoWhcWarehouseReturnConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_cainiao_whc_warehouse_return_confirm_response>
    <result>
        <error_desc>系统异常</error_desc>
        <error_code>1001</error_code>
        <success>true</success>
    </result>
</alibaba_cainiao_whc_warehouse_return_confirm_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

返回
顶部