文档中心 > API类目 > 奇门POS接口

qimen.taobao.pos.return.create (退仓单创建接口)

POS创建退货单,通知ERP退货。(该接口也可以允许ERP发起,通知POS退仓)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
orderInfo Struct 可选
  • └ orderCode
  • String
  • 必须
  • applyorder28525
  • 退仓申请单单据编码
  • └ storeCode
  • String
  • 必须
  • TERMINAL2425
  • 提出申请的门店编码
  • └ orgCode
  • String
  • 可选
  • hz0001
  • 组织编码
  • └ orderType
  • String
  • 必须
  • TH=退仓单
  • 单据类型
  • └ targetStoreCode
  • String
  • 必须
  • warehouse326592
  • 申请退入的目标仓库(门店)编码
  • operator
  • Struct []
  • 可选
  • └ type
  • String
  • 可选
  • CJ=创建人SP =审批人ZZ=终止人
  • 操作员类型
  • └ operatorCode
  • String
  • 可选
  • operator005
  • 操作员编码
  • └ operatorName
  • String
  • 可选
  • 圆圆
  • 操作员名称
  • └ operateTime
  • String
  • 可选
  • YYYY-MM-DD HH:MM:SS
  • 操作时间
  • └ totalPlanQty
  • Number
  • 可选
  • 20
  • 总数量
  • └ totalAmount
  • String
  • 可选
  • 1000
  • 总金额
  • └ orderCreateTime
  • String
  • 可选
  • YYYY-MM-DD HH:MM:SS
  • 单据创建时间
orderLine Struct 可选
  • └ orderLineNo
  • String
  • 可选
  • 1479247
  • 单据行号
  • └ productCode
  • String
  • 可选
  • SPU178673
  • 商品spu编码
  • └ itemCode
  • String
  • 必须
  • SKUEWRYU178673
  • 商品sku编码
  • └ skuProperty
  • String
  • 必须
  • 如红色XXL
  • 商品属性
  • └ color
  • String
  • 可选
  • red
  • 颜色编码
  • └ size
  • String
  • 可选
  • XXL
  • 尺码编码
  • └ itemName
  • String
  • 可选
  • 女夏季短袖
  • 商品名称
  • └ standardPrice
  • String
  • 必须
  • 200
  • 标准价
  • └ referencePrice
  • String
  • 必须
  • 150
  • 参考价
  • └ retailPrice
  • String
  • 必须
  • 120
  • 零售价
  • └ discount
  • String
  • 必须
  • 0.9000
  • 折扣
  • └ planQty
  • Number
  • 必须
  • 10
  • 计划的商品数量
  • └ amount
  • String
  • 可选
  • 1000
  • 商品总金额
customerid String 必须 A12345
  • 最大长度:50
  • 指定路由参数

    响应参数

    名称 类型 示例值 描述
    flag String success|failure 响应结果
    code String errorcode 响应码
    message String msg 响应信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    TaobaoPosReturnCreateRequest req = new TaobaoPosReturnCreateRequest();
    TaobaoPosReturnCreateRequest.Struct obj1 = new TaobaoPosReturnCreateRequest.Struct();
    obj1.setOrderCode("applyorder28525");
    obj1.setStoreCode("TERMINAL2425");
    obj1.setOrgCode("hz0001");
    obj1.setOrderType("TH=退仓单");
    obj1.setTargetStoreCode("warehouse326592");
    List<TaobaoPosReturnCreateRequest.Struct> list3 = new ArrayList<TaobaoPosReturnCreateRequest.Struct>();
    TaobaoPosReturnCreateRequest.Struct obj4 = new TaobaoPosReturnCreateRequest.Struct();
    list3.add(obj4);
    obj4.setType("CJ=创建人SP =审批人ZZ=终止人");
    obj4.setOperatorCode("operator005");
    obj4.setOperatorName("圆圆");
    obj4.setOperateTime("YYYY-MM-DD HH:MM:SS");
    obj1.setOperator(list3);
    obj1.setTotalPlanQty(20L);
    obj1.setTotalAmount("1000");
    obj1.setOrderCreateTime("YYYY-MM-DD HH:MM:SS");
    req.setOrderInfo(obj1);
    TaobaoPosReturnCreateRequest.Struct obj5 = new TaobaoPosReturnCreateRequest.Struct();
    obj5.setOrderLineNo("1479247");
    obj5.setProductCode("SPU178673");
    obj5.setItemCode("SKUEWRYU178673");
    obj5.setSkuProperty("如红色XXL");
    obj5.setColor("red");
    obj5.setSize("XXL");
    obj5.setItemName("女夏季短袖");
    obj5.setStandardPrice("200");
    obj5.setReferencePrice("150");
    obj5.setRetailPrice("120");
    obj5.setDiscount("0.9000");
    obj5.setPlanQty(10L);
    obj5.setAmount("1000");
    req.setOrderLine(obj5);
    req.setCustomerid("A12345");
    TaobaoPosReturnCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <flag>success|failure</flag>
    <code>errorcode</code>
    <message>msg</message>
    

    异常示例

    • 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

    返回
    顶部