【新增车间入库单】接口

一、说明

当车间生产完产品与仓库进行交接时,原是通过在PDA操作【车间入库单】扫描容器条码、或箱条码、或序列号、或制令单号进行交接货物,现客户希望在产生ERP的制令信息后,由第三方调该单据接口自动产生WMS的【车间入库单】,因此,增加了【新增车间入库单】接口,具体参数如下说明!

二、参数说明

1、请求方式

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

 2、header参数

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

3、请求参数

  字段 字段名 字段类型 长度 必填 说明
entry_order<表头>
ref_id 第三方系统标识 string 20 自定义一个系统标识,如SUNLIKE
oth_task_id 第三方任务单号 string 100 唯一单号
entry_type 入库类型 string 1 必填,1.按容器条码入库 2.按箱条码入库 3.按序列号入库4.按制令单装箱入库
entry_date 入库时间 datatime   必填,入库时间
warehouse_code 预入仓库 string 30 预入仓库
owner_code 货主编码 string 30 必填,货主编码,未启用多货主时,固定传入OWNER
operate_time 制单时间 datatime   必填,制单时间
operator_code 操作员 string 30 必填,操作员
order_lines<表身>
barcode 条码 string 200   条码:当入库类型=1.按容器条码入库,则该栏为容器条码;当入库类型=2.按箱条码入库,则该栏位为箱条码 当入库类型=3.按序列号入库,则该栏位为序列号;当入库类型=4.按制令单装箱入库,则该栏位为空(条码不可带前缀,条码必须在对应条码库存在);当入库类型<>4时才为必填,反之,则为空
mo_no 制令单号 string 100   制令单号:当入库类型=4.按制令单装箱入库,该栏位为必填,即制令单号,与SUNLIKE对接时才生效
item_code 货品代号 string 50   货品代号:当入库类型=4.按制令单装箱入库,该栏位为必填,反之,则为空
sku_property 货品特征 string 255   货品特征:当入库类型=4.按制令单装箱入库时使用
batch_code 批号 string 40   批号:当入库类型=4.按制令单装箱入库时使用
qty 数量 float   必填,数量:当入库类型=4.按制令单装箱入库时使用,其他【入库类型】时默认为1即可
qty1 副数量 float     副数量:当入库类型=4.按制令单装箱入库时使用
valid_date 有效日期 datatime     有效日期:当入库类型=4.按制令单装箱入库时使用
sc_date 生产日期 datatime     生产日期:当入库类型=4.按制令单装箱入库时使用

4、返回参数

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

三、请求JSON范例

{
    “entry_order”: {
        “ref_id”: “SUNLIKE”, //必填,第三方系统标识,如MES
        “oth_task_id”: {{$guid}}, //必填,第三方任务代号,必须唯一
        “entry_type”: “2”, //必填,入库类型,1.按容器条码入库 2.按箱条码入库 3.按序列号入库4.按制令单装箱入库
        “entry_date”: {{YMD}}, //必填,入库时间;
        “warehouse_code”: “MJLK2”, //预入仓库;
        “owner_code”: “OWNER”, //必填,货主编码,未启用多货主时,固定传入OWNER;
        “operate_time”: {{DATA}}, //必填,制单时间
        “operator_code”: “1001” //必填,操作员
  },
    “order_lines”: [
      {
            “barcode”: “00072511240100005”, //条码:不可带前缀,条码必须在对应条码库存在;当入库类型<>4时才为必填,反之,则为空;
            “mo_no”: “”, //制令单号:当入库类型=4.按制令单装箱入库,该栏位为必填,即制令单号,与SUNLIKE对接时才生效。
            “item_code”: “”, //货品代号:当入库类型=4.按制令单装箱入库,该栏位为必填,反之,则为空;
            “sku_property”: “”, //货品特征:当入库类型=4.按制令单装箱入库时使用
            “batch_code”: “”, //批号:当入库类型=4.按制令单装箱入库时使用;
            “qty”: “1”, //必填,数量:当入库类型=4.按制令单装箱入库时使用;
            “qty1”: “”, //副数量:当入库类型=4.按制令单装箱入库时使用;
            “valid_date”: “”, //有效日期:当入库类型=4.按制令单装箱入库时使用;
            “sc_date”: “” //生产日期:当入库类型=4.按制令单装箱入库时使用;
      },
      {
            “barcode”: “100100026”, //条码:不可带前缀,条码必须在对应条码库存在;当入库类型<>4时才为必填,反之,则为空;
            “mo_no”: “”, //制令单号:当入库类型=4.按制令单装箱入库,该栏位为必填,即制令单号,与SUNLIKE对接时才生效。
            “item_code”: “”, //货品代号:当入库类型=4.按制令单装箱入库,该栏位为必填,反之,则为空;
            “sku_property”: “”, //货品特征:当入库类型=4.按制令单装箱入库时使用
            “batch_code”: “”, //批号:当入库类型=4.按制令单装箱入库时使用;
            “qty”: “1”, //必填,数量:当入库类型=4.按制令单装箱入库时使用;
            “qty1”: “”, //副数量:当入库类型=4.按制令单装箱入库时使用;
            “valid_date”: “”, //有效日期:当入库类型=4.按制令单装箱入库时使用;
            “sc_date”: “” //生产日期:当入库类型=4.按制令单装箱入库时使用;
      }
  ]
}

四、返回JSON范例

{
    "workshop_entry_code": "CJ251125000002;CJ251125000003",
    "code": 0,
    "message": "新增成功",
    "oth_task_id": "cfec4dfd-c84a-4cef-ae85-7182e9e921f6"
}