AI-WMS PLUS 标准API平台

【推送第三方入库单】接口

一、说明

该接口为第三方系统提供，仅供AI-WMS PLUS使用，AI-WMS PLUS通过该接口，将入库单信息推送给第三方系统。

二、参数说明

1、请求方式

请求方式 POST
接口地址 http://第三方系统API/CreateEntryConfirmation
格式 JSON
编码类型 UTF-8

2、header参数

KEY VALUE
Content-Type application/json
Authorization token值 授权接口所获取的值，由第三方提供授权方法

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
表头entry_order
ref_id WMS系统标识 String 20 是 自定义一个系统标识，如WMS
entry_code WMS入库单号 String 100 是 WMS入库单号，必须唯一
entry_date 入库日期 Datatime   是 单据日期，精确到日
owner_code 货主编码 String 30 是 未启用货主编码时，则固定传入OWNER；
order_type 业务类型 String 10 是 提供类型如下：
01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
department 部门 String 30 是  
bill_type 单据类别 String 10    
supplier_code 供应商代号 String 30   厂商代号
supplier_name 供应商名称 String 100   厂商名称
operate_time 操作时间 Datatime   是 制单时间，精确到秒
operator_code 操作员编码 String 30 是 制单人
remark 备注 String      
totalorderlines 单据总行数 int      
extend_props 扩展属性        
表身order_lines
entry_code 入库单号 String 100 是 WMS入库单号
entry_code_itm 入库单项次 Integer   是 即WMS入库单唯一项次
item_code 货品代号 String 50 是 货品代号
item_name 货品名称 String 160 是 货品名称
sku_property 特征 String 255   货品特征值
batch_code 批号 String 40   批号
warehouse_code 仓库 String 30 是 实际入库的仓库代号
qty 数量 FLOAT   是 数量
qty1 数量(副) FLOAT     数量(副)
rem 备注 String      
request_id 申请单ID String 10 是 即ERP申请单ID，如无，可不填；
request_code 申请单号 String 100 是 即ERP申请单号，与表头必须一致；
request_itm 申请单项次 String 100 是 即ERP申请单的转单唯一项次；
source_bilid 业务单 ID String 10   即申请单的来源单ID
source_bilno 业务单号 String 100   即申请单的来源单号；
source_bilitm 业务单项次 String 100   即申请单对应来源单的项次
extend_props 扩展属性        

4、返回参数

  字段 字段名 字段类型 长度 说明
code 成功标识 string 10 返回0则表示成功，其他则为失败
message 返回信息 string 200  
bil_id 第三方单据ID string 10 必须返回
bil_no 第三方单据别 string 100 必须返回

三、请求JSON范例

{
  "entry_order": {
    "ref_id": "Other",
    "entry_code": "RK230302000001",
    "entry_date": "2023-03-02",
    "owner_code": "OWNER",
    "order_type": "01",
    "department": "00000000",
    "bill_type": "",
    "supplier_code": "SUP01",
    "supplier_name": "厂商SUP01",
    "operate_time": "2023-03-02 11:25:13",
    "operator_code": "ADMIN",
    "last_modified_date": null,
    "remark": "",
    "total_order_lines": 1,
    "extend_props": {}
  },
  "order_lines": [
    {
      "entry_code": "RK230302000001",
      "entry_code_itm": 1,
      "item_code": "P001",
      "item_name": "P001货品P",
      "sku_property": "",
      "batch_code": "",
      "warehouse_code": "A",
      "qty": 100.0,
      "qty1": 0.0,
      "rem": "",
      "request_id": "TI",
      "request_code": "TI33010001",
      "request_itm": "1",
      "source_bilid": "PO",
      "source_bilno": "PO33010001",
      "source_bilitm": "1",
      "extend_props": {}
    }
  ]
}

四、返回JSON范例

{
    "code":0,
    "message":"新增成功",
    "bil_id":"PC",
    "bil_no":"PC230301001"
}