AI-WMS PLUS 标准API平台

【新增其他出库单（无来源）】接口

一、说明

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

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

二、参数说明

1、请求方式

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

2、header参数

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

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
delivery_confirm<表头>
ref_id 第三方系统标识 string 20 是 自定义一个系统标识，如T8
oth_task_id 第三方任务单号 string 100 是 唯一单号
generate_mode 生成单据方式 string 10 是 1.按货品信息生成、2.模拟条码扫码生成
owner_code 货主编码 string 30 是 未启用货主编码时，则固定传入OWNER
delivery_confirm_date 出库日期 datatime   是 单据日期，精确到日
order_type 业务类型 string 10 是 默认16其他出库
warehouse_code 仓库编码 string 30 是 仓库代号，即入库仓库
department 部门 string 30 是  
operate_time 操作时间 datatime   是 制单时间，精确到秒
operator_code 操作员编码 string 30 是 制单人
last_modified_date 最近修改时间 datatime      
remark 备注 string      
extend_props 扩展属性       自定义字段
<表身明细：order_lines，当“生成单据方式”=1按货品信息生成，则按下面参数赋值>
storage_code 储位代号 string 60    
item_code 货品代号 string 50 是 货品代号
item_name 货品名称 string 160 是 货品名称
sku_property 特征 string 255   货品特征值
batch_code 批号 string 40   批号
qty 数量 float   是 数量
qty1 数量(副) float     数量(副)
valid_date 有效日期 Datatime      
sc_date 生产日期 Datatime      
remark 备注 string      
extend_props 扩展属性       自定义字段
<表身明细：order_lines，当“生成单据方式”=2模拟条码扫码生成，则按下面参数赋值>
barcode 条码 String 80 是

条码必须以前缀开头：

@BB为箱条码、@BC为货品条码、@BR为序列号
storage_code 储位代号 String 60  

 
break_up_flag 散出标记 String 1  

当为箱码时，则栏位必须赋值，T为散出，F为整出
qty 数量 Float   是

当为箱条码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1；

当为条码时，则数量为实际出库数量；

当为序列号时，则数量默认为1。
valid_date 有效日期 Datatime    

 
sc_date 生产日期 Datatime    

 

4、返回参数

  字段 字段名 字段类型 长度 说明
code 成功标识 string 10 返回0则表示成功，其他则为失败
message 返回信息 string 200  
oth_task_id 第三方任务单号 string 100  
delivery_confirm_code WMS出库单号 string 100  

三、请求JSON范例

范例一：按货品信息生成

{
    "delivery_confirm": {
        "ref_id": "T8", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "1", //生成方式，1.按货品信息生成、2.模拟条码扫码生成
        "owner_code": "OWNER", //货主编码
        "delivery_confirm_date": "2024-10-23", //入库单日期，必填
        "order_type": "16", //业务类型，默认为16
        "warehouse_code": "000", //仓库编码，必填
        "department": "00000000", //部门，必填
        "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": "", //生产日期
            "remark": "", //备注
            "extend_props": {} //扩展属性
        },
        {
            "storage_code": "", //储位代号
            "item_code": "002", //货品代号，必填
            "item_name": "蓝牙耳机（B款）", //货品名称，必填
            "sku_property": "", //货品特征
            "batch_code": "", //批号
            "qty": 11, //数量，必填
            "qty1": , //数量(副)
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "remark": "", //备注
            "extend_props": {} //扩展属性
        }
    ]
}

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

{
    "delivery_confirm": {
        "ref_id": "T8", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "2", //生成方式，1.按货品信息生成、2.模拟条码扫码生成
        "owner_code": "OWNER", //货主编码
        "delivery_confirm_date": "2024-10-23", //入库单日期，必填
        "order_type": "16", //业务类型，默认为16
        "warehouse_code": "000", //仓库编码，必填
        "department": "00000000", //部门，必填
        "operator_code": "ADMIN", //制单人，必填
        "operate_time": "2024-09-02 10:22:51", //制单时间，必填
        "last_modified_date": "", //最近修改时间
        "remark": "", //备注
        "extend_props": {} //扩展属性
    },
    "order_lines": [
        {
            "barcode": "@BC001", //条码必须以前缀开头：@BB为箱条码、@BC为货品条码、@BR为序列号
            "storage_code": "", //储位代号
            "valid_date": "", //有效日期
            "sc_date": "", //生产日期
            "break_up_flag": "F", //当为箱码时，则栏位必须赋值，T为散出，F为整出; 
            "qty": "20" //当为箱码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1；
        }
    ]
}

四、返回JSON范例

{
    "delivery_confirm_code": "CK241023000001",
    "code": 0,
    "message": "新增成功",
    "oth_task_id": "6b864e5d-d813-4d3f-3a26-bfd343b2c628"
}