文档中心 > API类目 > 魅力惠API

tmall.luxury.stock.out.order.confirm (天猫奢品B2B退货出库订单回传)

魅力惠wms通过该接口将退仓单出库确认信息同步给魅力惠scm,只写进来数据,无数据披露

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
return_out_store_confirm_order ReturnOutStoreConfirmOrder 必须 退货出库订单回传
  • └ tnum
  • Number
  • 可选
  • 1
  • 总箱数
  • └ order_code
  • String
  • 必须
  • 986504798855761920
  • 仓库订单编码
  • └ order_type
  • String
  • 必须
  • 901
  • 订单类型
  • └ order_source
  • String
  • 可选
  • 1
  • 订单来源
  • └ tweight
  • Number
  • 可选
  • 0
  • 总重量
  • └ tms_code
  • String
  • 可选
  • TMS001
  • 快递编码,出库方式为快递时,该字段值不为空
  • └ end_flag
  • String
  • 可选
  • 1
  • 标记位,单正常完成还是异常
  • order_items
  • OrderItem []
  • 必须
  • 订单商品信息
  • items
  • Item []
  • 可选
  • 商品属性列表
  • └ produce_date
  • String
  • 可选
  • 2018-04-04 00:00:00
  • 生产日期YYYY-MM-DD hh:mm:ss
  • └ type_name
  • String
  • 可选
  • 散箱出库
  • 类型名称
  • └ produce_code
  • String
  • 可选
  • Z020202001
  • 生产编码,同一商品可能因商家有不同编码。
  • └ produce_area
  • String
  • 可选
  • 广东广州
  • 生产地区
  • └ guarantee_unit
  • Number
  • 可选
  • 1
  • 保质期单位
  • └ guarantee_period
  • Number
  • 可选
  • 180
  • 保质期,默认以天为单位
  • └ due_date
  • String
  • 可选
  • 2020-11-21 00:00:00
  • 到货日期
  • └ batch_code
  • String
  • 可选
  • 1013329
  • 批次号
  • └ quantity
  • Number
  • 必须
  • 100
  • 数量
  • └ inventory_type
  • Number
  • 必须
  • 101
  • 库存类型
  • └ item_id
  • String
  • 必须
  • 981369542456774656
  • 商品编号
  • └ sl_tz
  • Number
  • 可选
  • 32
  • 发货数量
  • └ batch_id
  • String
  • 可选
  • 5325345
  • 批次号
  • └ stck_in_date
  • Date
  • 可选
  • 2019-12-01 00:00:00
  • 入库时间
  • └ receipt_number
  • String
  • 可选
  • 32323
  • 单据报名就安排
  • └ specification
  • String
  • 可选
  • 32323
  • 规格
  • └ item_code
  • String
  • 可选
  • 253345
  • 商品编码
  • └ remark
  • String
  • 可选
  • 这是备注
  • 备注
  • └ total_qty
  • Number
  • 可选
  • 23
  • 批次库存总量
  • └ item_line_no
  • Number
  • 可选
  • 1
  • 单据行号
  • └ diff_reason
  • String
  • 可选
  • 43434
  • 差异原因
  • └ sn_code
  • String
  • 可选
  • 32323
  • sn编码
  • └ is_completed
  • Boolean
  • 可选
  • true
  • 是否完成
  • └ own_user_id
  • String
  • 可选
  • 123456
  • 货主ID
  • └ order_item_id
  • String
  • 必须
  • 986504906230075392
  • order_item_id
  • └ length
  • Number
  • 可选
  • 32
  • 长 单位 mm 采购入库单、普通入库单必传
  • └ height
  • Number
  • 可选
  • 42
  • 高 单位 mm 采购入库单、普通入库单必传
  • └ weight
  • Number
  • 可选
  • 2
  • 宽 单位 mm 采购入库单、普通入库单必传
  • └ volume
  • Number
  • 可选
  • 14
  • 体积 单位立方厘米 采购入库单、普通入库单必传 向上取整
  • └ return_order_no
  • String
  • 可选
  • 111111
  • 待删除
  • └ logistics_code
  • String
  • 可选
  • 111111
  • 物流单号
  • └ po_no
  • String
  • 可选
  • poNo
  • poNo
  • └ own_user_id
  • String
  • 可选
  • 123456
  • 货主ID
  • └ out_mode
  • String
  • 可选
  • 1
  • 出库方式
  • └ targer_store_code
  • String
  • 可选
  • 1
  • 目标仓库(良品铺子在使用)
  • └ out_biz_code
  • String
  • 必须
  • RTMLH180418006053
  • 外部业务编码
  • └ order_confirm_time
  • String
  • 必须
  • 2018-04-19 17:14:31
  • 出库时间,格式:YYYY-MM-DD hh:mm:ss
  • └ confirm_type
  • Number
  • 必须
  • 0
  • 基本信息支持出入库单多次确认
  • └ customer_order_no
  • String
  • 可选
  • 2018041800001
  • 客户单号
  • └ time_zone
  • String
  • 可选
  • +8
  • 时区
  • package_infos
  • PackageInfo []
  • 可选
  • 包裹列表
  • └ tms_code
  • String
  • 可选
  • 2323
  • 快递公司服务编码
  • └ tms_order_code
  • String
  • 可选
  • 3232323
  • 运单编码
  • └ package_code
  • String
  • 可选
  • 32323
  • 包裹号
  • └ package_weight
  • Number
  • 可选
  • 12
  • 包裹质量,单位:克
  • └ package_length
  • Number
  • 可选
  • 21
  • 包裹长度,单位:毫米
  • └ package_width
  • Number
  • 可选
  • 12
  • 包裹宽度,单位:毫米
  • └ package_height
  • Number
  • 可选
  • 12
  • 包裹高度,单位:毫米
  • package_item_items
  • PackageItem []
  • 可选
  • 包裹里面的商品信息列表
  • └ item_id
  • String
  • 可选
  • 23232323
  • 商品ID
  • └ item_quantity
  • Number
  • 可选
  • 1
  • 此包裹里该商品的数量
  • check_items
  • StockOutCheckItem []
  • 可选
  • 出库单商品校验信息列表
  • └ order_item_id
  • String
  • 可选
  • 4343
  • 出库单明细id
  • └ quantity
  • Number
  • 可选
  • 12
  • 该商品实际出库总量

响应参数

名称 类型 示例值 描述
module Boolean true 同步成功或失败

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallLuxuryStockOutOrderConfirmRequest req = new TmallLuxuryStockOutOrderConfirmRequest();
TmallLuxuryStockOutOrderConfirmRequest.ReturnOutStoreConfirmOrder obj1 = new TmallLuxuryStockOutOrderConfirmRequest.ReturnOutStoreConfirmOrder();
obj1.setTnum(1L);
obj1.setOrderCode("986504798855761920");
obj1.setOrderType("901");
obj1.setOrderSource("1");
obj1.setTweight(0L);
obj1.setTmsCode("TMS001");
obj1.setEndFlag("1");
List<TmallLuxuryStockOutOrderConfirmRequest.OrderItem> list3 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.OrderItem>();
TmallLuxuryStockOutOrderConfirmRequest.OrderItem obj4 = new TmallLuxuryStockOutOrderConfirmRequest.OrderItem();
list3.add(obj4);
List<TmallLuxuryStockOutOrderConfirmRequest.Item> list7 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.Item>();
TmallLuxuryStockOutOrderConfirmRequest.Item obj8 = new TmallLuxuryStockOutOrderConfirmRequest.Item();
list7.add(obj8);
obj8.setProduceDate("2018-04-04 00:00:00");
obj8.setTypeName("散箱出库");
obj8.setProduceCode("Z020202001");
obj8.setProduceArea("广东广州");
obj8.setGuaranteeUnit(1L);
obj8.setGuaranteePeriod(180L);
obj8.setDueDate("2020-11-21 00:00:00");
obj8.setBatchCode("1013329");
obj8.setQuantity(100L);
obj8.setInventoryType(101L);
obj8.setItemId("981369542456774656");
obj8.setSlTz(32L);
obj8.setBatchId("5325345");
obj8.setStckInDate(StringUtils.parseDateTime("2019-12-01 00:00:00"));
obj8.setReceiptNumber("32323");
obj8.setSpecification("32323");
obj8.setItemCode("253345");
obj8.setRemark("这是备注");
obj8.setTotalQty(23L);
obj8.setItemLineNo(1L);
obj8.setDiffReason("43434");
obj8.setSnCode("32323");
list5.setItems(list7);
obj4.setIsCompleted(true);
obj4.setOwnUserId("123456");
obj4.setOrderItemId("986504906230075392");
obj4.setLength(32L);
obj4.setHeight(42L);
obj4.setWeight(2L);
obj4.setVolume(14L);
obj1.setOrderItems(list3);
obj1.setReturnOrderNo("111111");
obj1.setLogisticsCode("111111");
obj1.setPoNo("poNo");
obj1.setOwnUserId("123456");
obj1.setOutMode("1");
obj1.setTargerStoreCode("1");
obj1.setOutBizCode("RTMLH180418006053");
obj1.setOrderConfirmTime("2018-04-19 17:14:31");
obj1.setConfirmType(0L);
obj1.setCustomerOrderNo("2018041800001");
obj1.setTimeZone("+8");
List<TmallLuxuryStockOutOrderConfirmRequest.PackageInfo> list10 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.PackageInfo>();
TmallLuxuryStockOutOrderConfirmRequest.PackageInfo obj11 = new TmallLuxuryStockOutOrderConfirmRequest.PackageInfo();
list10.add(obj11);
obj11.setTmsCode("2323");
obj11.setTmsOrderCode("3232323");
obj11.setPackageCode("32323");
obj11.setPackageWeight(12L);
obj11.setPackageLength(21L);
obj11.setPackageWidth(12L);
obj11.setPackageHeight(12L);
List<TmallLuxuryStockOutOrderConfirmRequest.PackageItem> list14 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.PackageItem>();
TmallLuxuryStockOutOrderConfirmRequest.PackageItem obj15 = new TmallLuxuryStockOutOrderConfirmRequest.PackageItem();
list14.add(obj15);
obj15.setItemId("23232323");
obj15.setItemQuantity(1L);
list12.setPackageItemItems(list14);
obj1.setPackageInfos(list10);
List<TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem> list17 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem>();
TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem obj18 = new TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem();
list17.add(obj18);
obj18.setOrderItemId("4343");
obj18.setQuantity(12L);
obj1.setCheckItems(list17);
req.setReturnOutStoreConfirmOrder(obj1);
TmallLuxuryStockOutOrderConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_luxury_stock_out_order_confirm_response>
    <module>true</module>
</tmall_luxury_stock_out_order_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

返回
顶部