采购单

1、业务场景

采购是指对商品的库存进行增加,入库操作。例如:商家对自己的实际库存进行统计后,来补进缺货的货品保证库存充足。

2、接口名

taobao.qimen.entryorder.create

奇门接口链接:https://open.taobao.com/api.htm?cid=20725&docId=25991&docType=2

3、字段映射

参数名 参数类型 是否必填
(Y-是;N-否)
示例 描述
entryOrderCode String Y OCG201803150006 入库单号,ERP内的外部单号
purchaseOrderCode String Y OCG201803150006 采购单号,ERP内的外部单号
warehouseCode String Y BJ001 仓库编码,需要WMS提供
ownerCode String Y HZ01 货主编码,相关信息是需要WMS提供
orderCreateTime String Y 2020-11-30 15:50:45 订单创建时间,ERP内建单时间
orderType String Y CGRK 单据类型,采购单固定“CGRK”
expectStartTime String N 2020-12-03 15:50:45 预期到货时间
supplierCode String N CGZY001 供应商编码。商家可自定义
supplierName String N 北京供货商 供应商名称
remark String N 注意分两批到货 备注。remark拼接空格再拼接ERP系统内的采购单号
senderInfo节点 发件人信息(值固定,不支持自定义)
company String N 不详 公司名称,固定值“不详”
name String N 不详 姓名,固定值“不详”
province String N 浙江 省份,固定值“浙江”
city String N 杭州 城市,固定值“杭州”
area String N 上城区 地区,固定值“上城区”
detailAddress String N 浙江 杭州 上城区 详细地址,固定值“浙江 杭州 上城区”
extendProps节点 扩展节点。若WMS不需要获取以下字段,直接跳过解析即可
purchase_wms_add String N 湖北省宜昌市远安县稻香村25号 收货地址。商家开单时填写的地址
oms_purchase_no String N CG202011250001 采购单号。ERP系统采购单号
extendProps1 String N 小件称重 自定义属性1。ERP采购单自定义属性1
extendProps2 String N 大件计数 自定义属性2。ERP采购单自定义属性2
purchaserName String N 张三 采购员。ERP采购单对应的采购员
orderLines-orderline节点 商品明细节点
orderLineNo String N 1479768 行号。ERP系统唯一
itemCode String Y SKU001 商品编码(SKU编码),对应ERP内商家编码
itemId String N WMS001 仓储系统商品sku编码
ownerCode String Y HZ01 货主编码,相关信息是需要WMS提供
planQty String N 120 采购数量。计划采购数量
purchasePrice String Y 30.58 采购价。ERP采购开单的采购价
inventoryType String N ZP 商品库存类型。采购固定为“ZP”-正品类型
remark String N 小件 SKU备注
extendProps 扩展节点。若WMS不需要获取以下字段,直接跳过解析即可
prop1 String N 易碎 SKU自定义属性1
prop2 String N 尽快入库 SKU自定义属性2

4、报文示例

1)ERP请求报文示例

<request>
  <entryOrder>
      <entryOrderCode>OCG202011300029</entryOrderCode>
      <purchaseOrderCode>OCG202011300029</purchaseOrderCode>
      <warehouseCode>BJ001</warehouseCode>
      <ownerCode>HZ001</ownerCode>
      <orderCreateTime>2020-11-30 17:18:05</orderCreateTime>
      <orderType>CGRK</orderType>
      <expectStartTime>2020-11-30 17:18:05</expectStartTime>
      <supplierCode>T01</supplierCode>
      <supplierName>北京供应商</supplierName>
      <remark>热销商品</remark>
      <senderInfo>
          <company>不详</company>
          <name>不详</name>
          <province>浙江</province>
          <city>杭州</city>
          <area>上城区</area>
          <detailAddress>浙江 杭州 上城区</detailAddress>
      </senderInfo>
      <extendProps>
          <purchase_wms_add>北京市海淀区花园路</purchase_wms_add>
          <oms_purchase_no>CG202011300013</oms_purchase_no>
          <extendProps1/>
          <extendProps2/>
          <purchaserName>天天</purchaserName>
      </extendProps>
  </entryOrder>
  <orderLines>
      <orderLine>
          <orderLineNo>90551</orderLineNo>
          <itemCode>SKU001</itemCode>
          <itemId>SKU001</itemId>
          <ownerCode>HZ001</ownerCode>
          <planQty>60</planQty>
          <purchasePrice>0</purchasePrice>
          <inventoryType>ZP</inventoryType>
          <remark/>
          <extendProps>
              <prop1/>
              <prop2/>
          </extendProps>
      </orderLine>
  </orderLines>
</request>

2)WMS响应回执示例

<?xml version=“1.0” encoding=“UTF-8” standalone=“yes”?>

<response>
  <flag>success</flag>
  <code>5000</code>
  <message>入库单创建成功</message>
  <entryOrderId>WMS202011300031</entryOrderId>
</response>