【新增入库单】接口

一、说明

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

• 支持有来源单及无来源单；
• 支持按货品信息生成，或模拟条码扫码生成。

二、参数说明

1、请求方式

2、header参数

3、请求参数

4、返回参数

三、请求JSON范例

范例一：按货品信息生成

{
    "entry_confirm": {
        "ref_id": "T8", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "1", //生成方式，1.按货品信息生成、2.模拟条码扫码生成
        "owner_code": "OWNER", //货主编码
        "entry_confirm_date": "2024-10-23", //入库单日期，必填
        "order_type": "11", //业务类型，01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
        "transfer_bilid": "UO", //转入单据别，当“业务类型”=11时，则该栏位允许为空；反之，则必须赋值：当来源单为WMS入库通知单时，则赋值为UO，当来源单为WMS库存调拨单时，则赋值为IC
        "transfer_bilno": "UO241023000002", //转入单号，当“业务类型”=11时，则该栏位允许为空；反之，则必须赋值
        "warehouse_code": "000", //仓库编码，必填
        "department": "00000000", //部门，必填
        "supplier_code": "S01", //厂商代号
        "supplier_name": "S01供应商", //厂商名称
        "operator_code": "ADMIN", //制单人，必填
        "operate_time": "2024-10-23 10:22:51", //制单时间，必填
        "last_modified_date": "",
        "remark": "", //备注
        "extend_props": {} //扩展属性
    },
    "order_lines": [
        {
            "storage_code": "", //储位代号
            "item_code": "001", //货品代号，必填
            "item_name": "蓝牙耳机（A款）", //货品名称，必填
            "sku_property": "", //货品特征
            "batch_code": "", //批号
            "qty": 10, //数量，必填
            "qty1": , //数量(副)
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "transfer_bilid": "UO", //转入单据别
            "transfer_bilno": "UO241023000002", //转入单号
            "transfer_bilitm": "1", //转入单项次
            "remark": "", //备注
            "extend_props": {} //扩展属性
        },
        {
            "storage_code": "", //储位代号
            "item_code": "002", //货品代号，必填
            "item_name": "蓝牙耳机（B款）", //货品名称，必填
            "sku_property": "", //货品特征
            "batch_code": "", //批号
            "qty": 20, //数量，必填
            "qty1": , //数量(副)
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "transfer_bilid": "UO", //转入单据别
            "transfer_bilno": "UO241023000002", //转入单号
            "transfer_bilitm": "2", //转入单项次
            "remark": "", //备注
            "extend_props": {} //扩展属性
        }
    ]
}

范例二：模拟条码扫码生成

{
    "entry_confirm": {
        "ref_id": "T8", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "2", //生成方式，1.按货品信息生成、2.模拟条码扫码生成
        "owner_code": "OWNER", //货主编码
        "entry_confirm_date": "2024-10-23", //入库单日期，必填
        "order_type": "11", //业务类型，，01=进货入库，02=暂估入库，03=销货退回入库，04=自制产品入库，05=托外加工入库，06=生产退料入库，07=托工退料入库，08=库存调拨入库，09=非生产退料入库，10=报废入库，11=其他入库；
        "transfer_bilid": "UO", //转入单据别，当“业务类型”=11时，则该栏位允许为空；反之，则必须赋值：当来源单为WMS入库通知单时，则赋值为UO，当来源单为WMS库存调拨单时，则赋值为IC
        "transfer_bilno": "UO241023000002", //转入单号，当“业务类型”=11时，则该栏位允许为空；反之，则必须赋值
        "warehouse_code": "000", //仓库编码，必填
        "department": "00000000", //部门，必填
        "supplier_code": "S01", //厂商代号
        "supplier_name": "S01供应商", //厂商名称
        "operator_code": "ADIN", //制单人，必填
        "operate_time": "2024-10-23 10:22:51", //制单时间，必填
        "last_modified_date": "",
        "remark": "", //备注
        "extend_props": {} //扩展属性
    },
    "order_lines": [
        {
            "barcode": "@BC001", //条码必须以前缀开头：@BB为箱条码、@BC为货品条码、@BR为序列号
            "storage_code":"",    //储位代号
            "valid_date":"",      //有效日期
            "sc_date":"",      //生产日期
            "qty": "10" //当为箱条码、序列号时扫描数量默认为1
        }
    ]
}

四、返回JSON范例

{
    "entry_confirm_code": "RK241023000001",
    "code": 0,
    "message": "新增成功",
    "oth_task_id": "3a864e5d-d813-4f3f-9aa6-bfd343b2cb8b"
}