一、说明

二、参数说明

三、请求JSON范例

四、返回JSON范例

1、请求方式

2、header参数

3、请求参数

4、返回参数

1、按货品信息生成方式

2、模拟条码扫描生成方式

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

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

字段	字段名	字段类型	长度	必填	说明
<表头：inventory_loss>
ref_id	第三方系统标识	String	20	是	自定义一个系统标识，如MES
oth_task_id	第三方任务单号	String	10	是	任务唯一ID
generate_mode	生成单据方式	String	10	是	1.按货品信息生成、2.模拟条码扫码生成
owner_code	货主编码	string	30		中研默认为空
bill_date	单据日期	Datatime		是	单据日期，精确到日
warehouse_code	仓库编码	String	30	是	仓库代号
department	部门	String	30	是
order_type	业务类型	String	10	是	默认11
bill_type	单据类别	String	10
ij_reason	调整原因代号	String	12
operator_code	制单人	String	30	是	制单人
operate_time	制单时间	Datatime		是	制单时间，精确到秒
remark	备注	String
total_order_lines	单据总行数	int
extend_props	扩展属性
<表身明细：order_lines，当“生成单据方式”=1按货品信息生成，则按下面参数赋值>
item_code	货品代号	String	50	是	货品代号
item_name	货品名称	String	160	是	货品名称
sku_property	特征	String	255		货品特征值
batch_code	批号	String	40		批号
storage_code	储位代号	String	60
qty	数量	Float		是	数量
qty1	数量(副)	Float			数量(副)
remark	备注	String
extend_props	扩展属性
<表身明细：order_lines，当“生成单据方式”=2模拟条码扫码生成，则按下面参数赋值>
barcode	条码	String	80	是	即条码以@BB开头
storage_code	储位代号	String	60
break_up_flag	散出标记	String	1		当为箱码时，则栏位必须赋值，T为散出，F为整出；
qty	数量	Float		是	当为箱码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1；
valid_date	有效日期	Datatime
sc_date	生产日期	Datatime
<单据属性：propertys>
no_push	不推送第三方	String			表示单据不推送给第三方：T为不推送，F或空或不传为推送

字段	字段名	字段类型	长度	必填	说明
code	处理结果				0视为成功，其他视为失败
message	处理说明
oth_task_id	第三方任务 ID	String	100
inventory_loss_code	WMS盘亏单号	String	100

{
    "inventory_loss": {
        "ref_id": "MES", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "1",   //单据生成方式
        "bill_date": "2024-01-26", //盘亏单日期，必填
        "owner_code": "OWNER", //货主编码
        "warehouse_code": "A1", //仓库编码，必填
        "department": "00000000", //部门，必填
        "order_type": "11", //业务类型，默认为11
        "operator_code": "1001", //制单人，必填
        "operate_time": "2024-01-26 10:22:51", //制单时间，必填
        "remark": "rem-盘亏", //备注
        "total_order_lines": "2", //单据总行数
        "extend_props": {} //扩展属性
    },
    "order_lines": [
        {
            "item_code": "0008", //货品代号，必填
            "item_name": "批号货品0008", //货品名称，必填
            "sku_property": "", //货品特征
            "batch_code": "240126CA", //批号
            "storage_code": "A1-01-01-01",
            "qty": 30, //数量，必填
            "qty1": 6, //数量(副)
            "remark": "test", //备注
            "extend_props": {} //扩展属性
        }
    ],
"propertys": 
  {
    "no_push": "T" //表示单据不推送给第三方：T为不推送，F或空或不传为推送
  }
}

{
    "inventory_loss": {
        "ref_id": "MES", //第三方系统标识，必填
        "oth_task_id": "{{$guid}}", //第三方任务单号，唯一值，必填
        "generate_mode": "2",   //生成方式
        "owner_code": "OWNER", //货主编码
        "bill_date": "2024-01-26", //盘亏单日期，必填
        "warehouse_code": "A1", //仓库编码，必填
        "department": "00000000", //部门，必填
        "order_type": "11", //业务类型，默认为11
        "operator_code": "1001", //制单人，必填
        "operate_time": "2024-01-26 11:22:51", //制单时间，必填
        "remark": "rem-盘亏", //备注
        "total_order_lines": "2", //单据总行数
        "extend_props": {} //扩展属性
    },
    "order_lines": [
        {
            "barcode": "@BC000824012605", //带有前缀的条码
            "storage_code":"",    //储位代号
            "valid_date":"",      //有效日期
            "sc_date":"",         //生产日期
            "break_up_flag": "F", //当为箱码时，则栏位必须赋值，T为散出，F为整出; 
            "qty": "20" //当为箱码时，散出标记=T，则数量为散出数量；当散出标记=F时，则数量默认为1；
        }
    ],
 "propertys": 
    {
       "no_push": "T" //表示单据不推送给第三方：T为不推送，F或空或不传为推送
    }
}

http://服务器IP或机器名或域名/WMS/API/SYS/CreateInventoryLoss

{
    "inventory_loss_code": "KU240126000002",
    "code": 0,
    "message": "新增成功",
    "oth_task_id": "01a7ed85-9c7c-45b0-b7e3-a8b54b5d32f1"
}