AI-WMS PLUS 标准API平台

新增入库通知变更单接口

一、说明

主要用于第三方系统通过调用AI-WMS PLUS的【新增入库通知变更单】接口，从而生成AI-WMS PLUS系统的【入库通知变更单】。

  • 支持变更入库通知单表头：即结案通知单
  • 支持变更入库通知单表身：可以修改货品、数量、特征、批号、备注等资料，也可以删除表身某笔资料
  • 产生【入库通知变更单】同时会自动执行变更，所以通过此接口产生的【入库通知变更单】不支持删除单据。

二、参数说明

1、请求方式

请求方式 POST
接口地址 http://服务器IP或机器名或域名/WMS/API/SYS/CreateEntryChangeOrder
格式 JSON
编码类型 UTF-8

2、header参数

KEY VALUE
Content-Type application/json
Authorization token值 说明：授权接口所获取的值

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
<entry_change_order>表头
ref_id 第三方系统标识 string 20 是 自定义一个系统标识，如MES
oth_task_id 第三方任务单号 string 100 是 唯一单号
owner_code 货主编码 string 30   未启用货主编码时，默认为空；
启用多货主编码时，则需传货主编码
change_date 变更单日期 datatime   是 单据日期，精确到日
change_type 变更类型 string 1 是 H变更表头资料、B变更表身资料
department 部门 string 30 是  
order_type 业务类型 string 10 是 01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库
operator_code 操作员编码 string 30 是 制单人
operate_time 操作时间 datatime   是 制单时间，精确到秒
executor 执行人 string 30 是  
execution_time 执行时间 datatime    是  
remark 备注 string      
<order_lines> 变更类型=H变更表头资料时
change_method 变更方式 string 1 是 A结案
change_reason 变更原因说明 string   是  
entry_order_code 通知单号 string 100 是  
<order_lines> 变更类型=B变更表身资料时
change_method 变更方式 string 1 是 C变更、D删除
change_reason 变更原因说明 string   是  
entry_order_code 通知单号 string 100 是  
entry_order_itm 通知单项次 integer   是  
warehouse_code_old 原仓库代号 string 30    
warehouse_code_new 新仓库代号 string 30    
item_code_old 原货品代号 string  50    
item_code_new 新货品代号 string 50    
item_name_old 原货品名称 string 160    
item_name_new 新货品名称 string 160    
sku_property_old 原特征 string 255    
sku_property_new 新特征 string 255    
qty_old 原数量 float      
qty_new 新数量 float      
qty1_old 原数量（副） float      
qty1_new 新数量（副） float      
batch_code_old 原批号 string 40    
batch_code_new 新批号 string 40    
clear_batch_code 无批号 string 1   T，即清空原批号，与新批号互斥
valid_date_old 原有效日期 datatime      
valid_date_new 新有效日期 datatime      
inspection_date_old 原最近检验日期 datatime      
inspection_date_new 新最近检验日期 datatime      
remark_old 原备注 string      
remark_new 新备注 string      

4、返回参数

  字段 字段名 字段类型 长度 说明
code 处理结果 string 10 返回0则表示成功，其他则为失败
message 返回信息 string 200  
oth_task_id 第三方任务单号 string 100  
entry_change_code WMS变更单号 string 100  

三、请求JSON范例

范例一：变更表头资料

{
    "entry_change_order": {
        "ref_id": "MES", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "owner_code": "OWNER", //货主编码
        "change_date": "2024-11-27", //变更单日期，必填
        "change_type": "H", //变更类型，必填，H代表变更表头资料，B代表变更表身资料
        "department": "00000000", //部门，必填
        "order_type": "01", //业务类型，提供类型如下：01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
        "operator_code": "001", //制单人，必填
        "operate_time": "2024-11-27 10:22:51", //制单时间，必填
        "executor": "001", //执行人，必填
        "execution_time": "2024-11-27 10:22:51", //执行时间，必填
        "remark": "rem-11" //备注
    },
    "order_lines": [
        {
            "change_method": "A", //变更方式：A结案，必填
            "change_reason": "结案单据", //变更原因说明，必填
            "entry_order_code": "UO241127000001" //通知单号,必填
        }
    ]
}

范例二：变更表身资料

{
    "entry_change_order": {
        "ref_id": "MES", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "owner_code": "", //货主编码
        "change_date": "2024-11-27", //变更单日期，必填
        "change_type": "B", //变更类型，必填，H代表变更表头资料，B代表变更表身资料
        "department": "00000000", //部门，必填
        "order_type": "01", //业务类型，提供类型如下：01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
        "operator_code": "ADMIN", //制单人，必填
        "operate_time": "2024-11-27 10:22:51", //制单时间，必填
        "executor": "ADMIN", //执行人，必填
        "execution_time": "2024-11-27 10:22:51", //执行时间，必填
        "remark": "rem-22" //备注
    },
    "order_lines": [
        {
            "change_method": "C", //变更方式：C变更、D删除，必填
            "change_reason": "变更数量", //变更原因说明，必填
            "entry_order_code": "UO241127000001", //通知单号,必填
            "entry_order_itm": "1", //通知单唯一项次，必填
            "warehouse_code_old": "", //原仓库代号
            "warehouse_code_new": "", //新仓库代号
            "item_code_old": "", //原货品代号
            "item_code_new": "", //新货品代号
            "item_name_old": "", //原货品名称
            "item_name_new": "", //新货品名称
            "sku_property_old": "", //原特征
            "sku_property_new": "", //新特征
            "qty_old": "100", //原数量
            "qty_new": "90", //新数量
            "qty1_old": "", //原数量（副）
            "qty1_new": "", //新数量（副）
            "batch_code_old": "", //原批号
            "batch_code_new": "", //新批号
            "clear_batch_code": "", //无批号
            "valid_date_old": "", //原有效日期
            "valid_date_new": "", //新有效日期
            "inspection_date_old": "", //原检验日期
            "inspection_date_new": "", //新检验日期
            "remark_old": "", //原摘要
            "remark_new": "" //新摘要
        },
        {
            "change_method": "C", //变更方式：C变更、D删除，必填
            "change_reason": "清空批号", //变更原因说明，必填
            "entry_order_code": "UO241127000001", //通知单号,必填
            "entry_order_itm": "2", //通知单唯一项次，必填
            "warehouse_code_old": "", //原仓库代号
            "warehouse_code_new": "", //新仓库代号
            "item_code_old": "", //原货品代号
            "item_code_new": "", //新货品代号
            "item_name_old": "", //原货品名称
            "item_name_new": "", //新货品名称
            "sku_property_old": "", //原特征
            "sku_property_new": "", //新特征
            "qty_old": "", //原数量
            "qty_new": "", //新数量
            "qty1_old": "", //原数量（副）
            "qty1_new": "", //新数量（副）
            "batch_code_old": "", //原批号
            "batch_code_new": "", //新批号
            "clear_batch_code": "T", //无批号
            "valid_date_old": "", //原有效日期
            "valid_date_new": "", //新有效日期
            "inspection_date_old": "", //原检验日期
            "inspection_date_new": "", //新检验日期
            "remark_old": "", //原摘要
            "remark_new": "" //新摘要
        },
        {
            "change_method": "D", //变更方式：C变更、D删除，必填
            "change_reason": "删除此笔记录", //变更原因说明，必填
            "entry_order_code": "UO241127000001", //通知单号,必填
            "entry_order_itm": "3", //通知单唯一项次，必填
            "warehouse_code_old": "", //原仓库代号
            "warehouse_code_new": "", //新仓库代号
            "item_code_old": "", //原货品代号
            "item_code_new": "", //新货品代号
            "item_name_old": "", //原货品名称
            "item_name_new": "", //新货品名称
            "sku_property_old": "", //原特征
            "sku_property_new": "", //新特征
            "qty_old": "", //原数量
            "qty_new": "", //新数量
            "qty1_old": "", //原数量（副）
            "qty1_new": "", //新数量（副）
            "batch_code_old": "", //原批号
            "batch_code_new": "", //新批号
            "clear_batch_code": "", //无批号
            "valid_date_old": "", //原有效日期
            "valid_date_new": "", //新有效日期
            "inspection_date_old": "", //原检验日期
            "inspection_date_new": "", //新检验日期
            "remark_old": "", //原摘要
            "remark_new": "" //新摘要
        }
    ]
}

四、返回JSON范例

{
    "entry_change_code": "RG241127000001",
    "code": 0,
    "message": "新增成功",
    "oth_task_id": "4c64e44a-ffa4-43ee-a545-8909bf38f459"
}