文档中心 > API类目 > 奇门仓储API

taobao.qimen.returnorder.confirm (退货入库单确认接口)

taobao.qimen.returnorder.confirm

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request ReturnOrderConfirmRequest 可选
  • returnOrder
  • ReturnOrder
  • 可选
  • 退货单信息
  • └ returnOrderCode
  • String
  • 必须
  • R1234
  • ERP的退货入库单编码
  • └ returnOrderId
  • String
  • 可选
  • R1234
  • 仓库系统订单编码
  • └ warehouseCode
  • String
  • 必须
  • W1234
  • 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ outBizCode
  • String
  • 可选
  • OZ1234
  • 外部业务编码(消息ID;用于去重;ISV对于同一请求;分配一个唯一性的编码。用来保证因为网络等原因导致重复传输;请求不会 被重复处理)
  • └ orderType
  • String
  • 可选
  • THRK
  • 单据类型(THRK=退货入库;HHRK=换货入库;只传英文编码)
  • └ orderConfirmTime
  • String
  • 可选
  • 2016-09-09 12:00:00
  • 确认入库时间(YYYY-MM-DD HH:MM:SS)
  • └ logisticsCode
  • String
  • 必须
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他;只传英文编码)
  • └ logisticsName
  • String
  • 可选
  • 顺丰
  • 物流公司名称
  • └ expressCode
  • String
  • 可选
  • YD1234
  • 运单号
  • └ returnReason
  • String
  • 可选
  • 破损退货
  • 退货原因
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • senderInfo
  • SenderInfo
  • 可选
  • 发件人信息
  • └ company
  • String
  • 可选
  • 淘宝
  • 公司名称
  • └ name
  • String
  • 必须
  • 老王
  • 姓名
  • └ zipCode
  • String
  • 可选
  • 043300
  • 邮编
  • └ tel
  • String
  • 可选
  • 81020340
  • 固定电话
  • └ mobile
  • String
  • 必须
  • 13214567869
  • 移动电话
  • └ email
  • String
  • 可选
  • 345@gmail.com
  • 电子邮箱
  • └ countryCode
  • String
  • 可选
  • 051532
  • 国家二字码
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ town
  • String
  • 可选
  • 横加桥
  • 村镇
  • └ detailAddress
  • String
  • 必须
  • 杭州市余杭区989号
  • 详细地址
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ confirmType
  • Number
  • 可选
  • 0
  • 退货单多次入库
  • └ extendProps
  • Map
  • 可选
  • 退货单信息扩展字段
  • orderLines
  • OrderLine []
  • 可选
  • 订单信息
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ orderLineNo
  • String
  • 可选
  • D1234
  • 单据行号
  • └ sourceOrderCode
  • String
  • 可选
  • PD1224
  • 交易平台订单
  • └ subSourceOrderCode
  • String
  • 可选
  • PL1234
  • 交易平台子订单编码
  • └ ownerCode
  • String
  • 必须
  • HZ1234
  • 货主编码
  • └ itemCode
  • String
  • 必须
  • I1234
  • 商品编码
  • └ itemId
  • String
  • 可选
  • CK1234
  • 仓储系统商品编码(条件为提供后端(仓储系统)商品编码的仓储系统)
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
  • └ planQty
  • Number
  • 必须
  • 12
  • 应收商品数量
  • └ batchCode
  • String
  • 可选
  • P123
  • 批次编码
  • └ productDate
  • String
  • 可选
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2016-09-09
  • 过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • batchs
  • Batch []
  • 可选
  • 批次信息
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ batchCode
  • String
  • 可选
  • P1234
  • 批次编号
  • └ productDate
  • String
  • 可选
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2016-09-09
  • 过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
  • └ actualQty
  • Number
  • 可选
  • 12
  • 实收数量(要求batchs节点下所有的实收数量之和等于orderline中的实收数量)
  • └ extendProps
  • Map
  • 可选
  • 批次信息扩展属性
  • └ qrCode
  • String
  • 可选
  • 1;1;1
  • 商品的二维码(类似电子产品的SN码;用来进行商品的溯源;多个二维码之间用分号;隔开)
  • └ actualQty
  • String
  • 必须
  • 12
  • 实收商品数量
  • snList
  • SnList
  • 可选
  • sn列表
  • └ sn
  • String []
  • 可选
  • sn编码
  • └ extendProps
  • Map
  • 可选
  • 订单信息扩展字段
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
response Response
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
ReturnorderConfirmRequest req = new ReturnorderConfirmRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
ReturnOrder obj1 = new ReturnOrder();
obj1.setOwnerCode("奇门仓储字段,说明,string(50),,");
obj1.setReturnOrderStatus("奇门仓储字段,说明,string(50),,");
obj1.setOrderFlag("奇门仓储字段,说明,string(50),,");
obj1.setSourceOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setBuyerNick("奇门仓储字段,说明,string(50),,");
obj1.setRefOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setEarliestArrivalTime("奇门仓储字段,说明,string(50),,");
obj1.setPlanArrivalTime("奇门仓储字段,说明,string(50),,");
obj1.setActionType("奇门仓储字段,说明,string(50),,");
obj1.setPreDeliveryOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setPreDeliveryOrderId("奇门仓储字段,说明,string(50),,");
obj1.setSupplierCode("奇门仓储字段,说明,string(50),,");
obj1.setSupplierName("奇门仓储字段,说明,string(50),,");
obj1.setReturnOrderCode("R1234");
obj1.setReturnOrderId("R1234");
obj1.setWarehouseCode("W1234");
obj1.setOutBizCode("OZ1234");
obj1.setOrderType("THRK");
obj1.setOrderConfirmTime("2016-09-09 12:00:00");
obj1.setLogisticsCode("SF");
obj1.setLogisticsName("顺丰");
obj1.setExpressCode("YD1234");
obj1.setReturnReason("破损退货");
obj1.setRemark("备注信息");
SenderInfo obj2 = new SenderInfo();
obj2.setId("奇门仓储字段,说明,string(50),,");
obj2.setCarNo("奇门仓储字段,说明,string(50),,");
obj2.setFax("奇门仓储字段,说明,string(50),,");
obj2.setBirthDate("奇门仓储字段,说明,string(50),,");
obj2.setCareer("奇门仓储字段,说明,string(50),,");
obj2.setNick("奇门仓储字段,说明,string(50),,");
obj2.setIdType("奇门仓储字段,说明,string(50),,");
obj2.setIdNumber("奇门仓储字段,说明,string(50),,");
obj2.setCountryCodeCiq("奇门仓储字段,说明,string(50),,");
obj2.setCountryCodeCus("奇门仓储字段,说明,string(50),,");
obj2.setGender("奇门仓储字段,说明,string(50),,");
obj2.setCompany("淘宝");
obj2.setName("老王");
obj2.setZipCode("043300");
obj2.setTel("81020340");
obj2.setMobile("13214567869");
obj2.setEmail("345@gmail.com");
obj2.setCountryCode("051532");
obj2.setProvince("浙江省");
obj2.setCity("杭州");
obj2.setArea("余杭");
obj2.setTown("横加桥");
obj2.setDetailAddress("杭州市余杭区989号");
obj2.setRemark("备注");
obj1.setSenderInfo(obj2);
obj1.setConfirmType(0L);
req.setReturnOrder(obj1);
List<OrderLine> list4 = new ArrayList<OrderLine>();
OrderLine obj5 = new OrderLine();
list4.add(obj5);
obj5.setOrderSourceCode("奇门仓储字段,说明,string(50),,");
obj5.setSubSourceCode("奇门仓储字段,说明,string(50),,");
obj5.setItemName("奇门仓储字段,说明,string(50),,");
obj5.setSkuProperty("奇门仓储字段,说明,string(50),,");
obj5.setPurchasePrice("奇门仓储字段,说明,string(50),,");
obj5.setRetailPrice("奇门仓储字段,说明,string(50),,");
obj5.setExtCode("奇门仓储字段,说明,string(50),,");
obj5.setActualPrice("奇门仓储字段,说明,string(50),,");
obj5.setDiscountAmount("奇门仓储字段,说明,string(50),,");
obj5.setQuantity("奇门仓储字段,说明,string(50),,");
obj5.setOutBizCode("奇门仓储字段,说明,string(50),,");
obj5.setProductCode("奇门仓储字段,说明,string(50),,");
obj5.setStockInQty("奇门仓储字段,说明,string(50),,");
obj5.setStockOutQty("奇门仓储字段,说明,string(50),,");
obj5.setWarehouseCode("奇门仓储字段,说明,string(50),,");
obj5.setDeliveryOrderId("奇门仓储字段,说明,string(50),,");
obj5.setStatus("奇门仓储字段,说明,string(50),,");
obj5.setPayNo("奇门仓储字段,说明,string(50),,");
obj5.setTaobaoItemCode("奇门仓储字段,说明,string(50),,");
obj5.setDiscountPrice("奇门仓储字段,说明,string(50),,");
obj5.setColor("奇门仓储字段,说明,string(50),,");
obj5.setSize("奇门仓储字段,说明,string(50),,");
obj5.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj5.setReferencePrice("奇门仓储字段,说明,string(50),,");
obj5.setDiscount("奇门仓储字段,说明,string(50),,");
obj5.setStandardAmount("奇门仓储字段,说明,string(50),,");
obj5.setSettlementAmount("奇门仓储字段,说明,string(50),,");
obj5.setLocationCode("奇门仓储字段,说明,string(50),,");
obj5.setAmount("奇门仓储字段,说明,string(50),,");
obj5.setMoveOutLocation("奇门仓储字段,说明,string(50),,");
obj5.setMoveInLocation("奇门仓储字段,说明,string(50),,");
obj5.setExceptionQty("奇门仓储字段,说明,string(50),,");
obj5.setSubDeliveryOrderId("奇门仓储字段,说明,string(50),,");
obj5.setRemark("备注");
obj5.setOrderLineNo("D1234");
obj5.setSourceOrderCode("PD1224");
obj5.setSubSourceOrderCode("PL1234");
obj5.setOwnerCode("HZ1234");
obj5.setItemCode("I1234");
obj5.setItemId("CK1234");
obj5.setInventoryType("ZP");
obj5.setPlanQty(12L);
obj5.setBatchCode("P123");
obj5.setProductDate("2016-09-09");
obj5.setExpireDate("2016-09-09");
obj5.setProduceCode("P1234");
Batch obj7 = new Batch();
obj7.setQuantity("奇门仓储字段,说明,string(50),,");
obj7.setRemark("备注");
obj7.setBatchCode("P1234");
obj7.setProductDate("2016-09-09");
obj7.setExpireDate("2016-09-09");
obj7.setProduceCode("P1234");
obj7.setInventoryType("ZP");
obj7.setActualQty(12L);
list6.setBatchs(obj7);
obj5.setQrCode("1;1;1");
obj5.setActualQty("12");
SnList obj9 = new SnList();
obj9.setSn("");
list8.setSnList(obj9);
req.setOrderLines(list4);
ReturnorderConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
</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.http-connection-timeout
isp.http-read-timeout

API工具

如何获得此API

FAQ

返回
顶部