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

taobao.qimen.pos.replenish.notice (进仓通知单创建接口)

POS向ERP发起补货申请后,ERP配货需要一段时间才能到店铺,通过通知单提前告知店铺配货的情况。(该接口只能ERP发起)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request Request 可选
  • orderInfo
  • OrderInfo
  • 可选
  • 单据信息
  • └ orderCode
  • String
  • 必须
  • C123
  • 进仓通知单单据编码
  • └ originalNo
  • String
  • 必须
  • G123
  • 关联原单据号(即补货申请单号)
  • └ storeCode
  • String
  • 必须
  • M123
  • 通知申请的门店编码
  • └ orgCode
  • String
  • 可选
  • Z123
  • 组织编码(门店所属的组织编码)
  • └ orderType
  • String
  • 必须
  • BH
  • 单据类型(BH=补货通知单(仓库配货通知);DB=调拨通知单(店铺调拨通知))
  • └ targetStoreCode
  • String
  • 必须
  • P123
  • 配货通知单仓库(门店)编码
  • operators
  • Operator []
  • 可选
  • 操作者信息
  • └ type
  • String
  • 可选
  • CJ
  • 操作员类型(CJ=创建人;SP =审批人;ZZ=终止人)
  • └ operatorCode
  • String
  • 可选
  • Y123
  • 操作员编码
  • └ operatorName
  • String
  • 可选
  • M123
  • 操作员名称
  • └ operateTime
  • String
  • 可选
  • 2017-01-11 00:00:00
  • 操作时间(YYYY-MM-DD HH:MM:SS)
  • └ totalPlanQty
  • Number
  • 可选
  • 12
  • 总数量
  • └ totalAmount
  • String
  • 可选
  • 12
  • 总金额
  • └ orderCreateTime
  • String
  • 可选
  • 2017-01-11 00:00:00
  • 单据创建时间(YYYY-MM-DD HH:MM:SS)
  • orderLines
  • OrderLine []
  • 可选
  • 订单列表
  • └ orderLineNo
  • String
  • 可选
  • H123
  • 单据行号
  • └ productCode
  • String
  • 可选
  • SPU123
  • 商品spu编码
  • └ itemCode
  • String
  • 必须
  • SKU123
  • 商品sku编码
  • └ skuProperty
  • String
  • 必须
  • XXL
  • 商品属性(如红色; XXL)
  • └ color
  • String
  • 可选
  • Y123
  • 颜色编码
  • └ size
  • String
  • 可选
  • C123
  • 尺码编码
  • └ itemName
  • String
  • 可选
  • SN123
  • 商品名称
  • └ standardPrice
  • String
  • 必须
  • St123
  • 标准价
  • └ referencePrice
  • String
  • 可选
  • St123
  • 参考价
  • └ retailPrice
  • String
  • 必须
  • St123
  • 零售价
  • └ discount
  • String
  • 可选
  • 0.9
  • 折扣(如9折为0.9000)
  • └ planQty
  • Number
  • 必须
  • 12
  • 配货通知的商品数量
  • └ amount
  • String
  • 必须
  • 12
  • 商品总金额
  • └ 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);
PosReplenishNoticeRequest req = new PosReplenishNoticeRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
OrderInfo obj1 = new OrderInfo();
obj1.setOrderCode("C123");
obj1.setOriginalNo("G123");
obj1.setStoreCode("M123");
obj1.setOrgCode("Z123");
obj1.setOrderType("BH");
obj1.setTargetStoreCode("P123");
Operator obj2 = new Operator();
obj2.setType("CJ");
obj2.setOperatorCode("Y123");
obj2.setOperatorName("M123");
obj2.setOperateTime("2017-01-11 00:00:00");
obj1.setOperators(obj2);
obj1.setTotalPlanQty(12L);
obj1.setTotalAmount("12");
obj1.setOrderCreateTime("2017-01-11 00:00:00");
req.setOrderInfo(obj1);
OrderLine obj3 = new OrderLine();
obj3.setOrderLineNo("H123");
obj3.setProductCode("SPU123");
obj3.setItemCode("SKU123");
obj3.setSkuProperty("XXL");
obj3.setColor("Y123");
obj3.setSize("C123");
obj3.setItemName("SN123");
obj3.setStandardPrice("St123");
obj3.setReferencePrice("St123");
obj3.setRetailPrice("St123");
obj3.setDiscount("0.9");
obj3.setPlanQty(12L);
obj3.setAmount("12");
req.setOrderLines(obj3);
PosReplenishNoticeResponse 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部