一、说明
当车间生产完产品与仓库进行交接时,原是通过在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"
}