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

qimen.taobao.pos.salesorder.synchronize (销售单同步接口)

ERP与POS之间将期间内的销售单进行同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
orderInfo Struct 可选
  • └ orderCode
  • String
  • 必须
  • SALESCODE9728578
  • 销售单编码
  • └ posCode
  • String
  • 必须
  • TERMINAL2425
  • POS终端编码
  • └ storeCode
  • String
  • 必须
  • STORECODE03275083
  • 门店编码
  • └ orgCode
  • String
  • 可选
  • hz0001
  • 组织编码
  • operator
  • Struct []
  • 可选
  • └ type
  • String
  • 可选
  • CJ=创建人SP =审批人ZZ=终止人
  • 操作员类型
  • └ operatorCode
  • String
  • 可选
  • operator005
  • 操作员编码
  • └ operatorName
  • String
  • 可选
  • 圆圆
  • 操作员名称
  • └ operateTime
  • String
  • 可选
  • YYYY-MM-DD HH:MM:SS
  • 操作时间
  • └ totalAmount
  • String
  • 必须
  • 1000
  • 整单金额
  • └ totalQty
  • Number
  • 必须
  • 2
  • 整单的商品总数
  • └ orderCreateTime
  • String
  • 可选
  • YYYY-MM-DD HH:MM:SS
  • 单据时间
orderLine Struct [] 可选
  • 最大列表长度:20
    • └ orderLineNo
    • String
    • 可选
    • 1479247
    • 单据行号
    • └ productCode
    • String
    • 可选
    • SPU178673
    • 商品spu编码
    • └ itemCode
    • String
    • 必须
    • SKUEWRYU178673
    • 商品sku编码
    • └ itemName
    • String
    • 可选
    • 女夏季短袖
    • 商品名称
    • └ skuProperty
    • String
    • 必须
    • 如红色 XXL
    • 商品属性
    • └ color
    • String
    • 可选
    • red
    • 颜色编码
    • └ size
    • String
    • 可选
    • XXL
    • 尺码编码
    • └ standardPrice
    • String
    • 必须
    • 200
    • 标准价
    • └ referencePrice
    • String
    • 必须
    • 150
    • 参考价
    • └ retailPrice
    • String
    • 可选
    • 120
    • 零售价
    • └ discount
    • String
    • 可选
    • 0.9000
    • 折扣
    • └ quantity
    • Number
    • 必须
    • 50
    • 销售数量
    • └ standardAmount
    • String
    • 必须
    • 1000
    • 标准金额
    • └ settlementAmount
    • String
    • 可选
    • 900
    • 结算金额
    payment Struct 可选
    • └ paymentType
    • String
    • 必须
    • CASH=现金 ALIPAY=支付宝 WECHATPAY=微信支付 UNIONPAY=银联 OTHER=其他
    • 支付类型
    • └ amount
    • String
    • 必须
    • 900
    • 结算金额
    • └ paidAmount
    • String
    • 必须
    • 900
    • 收款金额
    • └ currency
    • String
    • 可选
    • RMB=人民币USD=美元
    • 币制
    customerid String 必须 A123456
  • 最大长度: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);
    TaobaoPosSalesorderSynchronizeRequest req = new TaobaoPosSalesorderSynchronizeRequest();
    TaobaoPosSalesorderSynchronizeRequest.Struct obj1 = new TaobaoPosSalesorderSynchronizeRequest.Struct();
    obj1.setOrderCode("SALESCODE9728578");
    obj1.setPosCode("TERMINAL2425");
    obj1.setStoreCode("STORECODE03275083");
    obj1.setOrgCode("hz0001");
    List<TaobaoPosSalesorderSynchronizeRequest.Struct> list3 = new ArrayList<TaobaoPosSalesorderSynchronizeRequest.Struct>();
    TaobaoPosSalesorderSynchronizeRequest.Struct obj4 = new TaobaoPosSalesorderSynchronizeRequest.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.setTotalAmount("1000");
    obj1.setTotalQty(2L);
    obj1.setOrderCreateTime("YYYY-MM-DD HH:MM:SS");
    req.setOrderInfo(obj1);
    List<TaobaoPosSalesorderSynchronizeRequest.Struct> list6 = new ArrayList<TaobaoPosSalesorderSynchronizeRequest.Struct>();
    TaobaoPosSalesorderSynchronizeRequest.Struct obj7 = new TaobaoPosSalesorderSynchronizeRequest.Struct();
    list6.add(obj7);
    obj7.setOrderLineNo("1479247");
    obj7.setProductCode("SPU178673");
    obj7.setItemCode("SKUEWRYU178673");
    obj7.setItemName("女夏季短袖");
    obj7.setSkuProperty("如红色 XXL");
    obj7.setColor("red");
    obj7.setSize("XXL");
    obj7.setStandardPrice("200");
    obj7.setReferencePrice("150");
    obj7.setRetailPrice("120");
    obj7.setDiscount("0.9000");
    obj7.setQuantity(50L);
    obj7.setStandardAmount("1000");
    obj7.setSettlementAmount("900");
    req.setOrderLine(list6);
    TaobaoPosSalesorderSynchronizeRequest.Struct obj8 = new TaobaoPosSalesorderSynchronizeRequest.Struct();
    obj8.setPaymentType("CASH=现金 ALIPAY=支付宝 WECHATPAY=微信支付 UNIONPAY=银联 OTHER=其他");
    obj8.setAmount("900");
    obj8.setPaidAmount("900");
    obj8.setCurrency("RMB=人民币USD=美元");
    req.setPayment(obj8);
    req.setCustomerid("A123456");
    TaobaoPosSalesorderSynchronizeResponse 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

    返回
    顶部