一、说明
主要给予第三方系统，通过调用AI-WMS PLUS的【查询入库通知单】接口，将在AI-WMS PLUS系统生成的【入库通知单】信息查询出来。
二、参数说明
1、请求方式
| 请求方式 |
POST |
| 接口地址 |
http://服务器IP或机器名或域名/WMS/API/SYS/QueryEntryOrder |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2、header参数
| KEY |
VALUE |
| Content-Type |
application/json |
| Authorization |
token值 |
说明：授权接口所获取的值 |
3、请求参数
| 字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
| ref_id |
第三方系统标识 |
String |
20 |
是 |
由第三方系统定义，用于区分第三方系统标识；如T8 |
| oth_task_id |
第三方任务单号 |
String |
100 |
|
与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值； |
| entry_order_code |
WMS入库通知单号 |
|
|
|
与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值； |
| request_id |
申请单 ID |
String |
10 |
|
申请单单据别，如无，则可不填； |
| request_code |
申请单号 |
|
|
|
与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值； |
| warehouse_code |
仓库编码 |
|
|
|
与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值； |
| owner_code |
货主编码 |
string |
30 |
是 |
不启用货主功能时，默认为OWNER，启用货主后，根据实际的货主编码 |
4、返回参数
| 字段 |
字段名 |
字段类型 |
长度 |
说明 |
| code |
成功标识 |
string |
10 |
返回0则表示成功，其他则为失败 |
| message |
返回信息 |
string |
200 |
|
| oth_task_id |
第三方任务ID |
string |
100 |
|
| request_id |
来源申请ID |
string |
10 |
|
| request_code |
来源申请单号 |
string |
100 |
|
| warehouse_code |
来源单仓库代号 |
string |
30 |
|
| entry_order_code |
WMS入库通知单号 |
string |
100 |
|
| owner_code |
货主编码 |
string |
30 |
|
| data |
返回入库通知单明细 |
string |
|
|
三、请求JSON范例
{
"ref_id":"SUNLIKE ERP", //第三方系统标识
"oth_task_id":"", //第三方任务单号,与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值；
"entry_order_code":"", //WMS入库通知单号,与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值；
"owner_code":"OWNER",
"request_id":"TI", //申请单ID,与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值；
"request_code":"TI33010001", //申请单号,与“第三方任务单号”、“WMS入库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值；
"warehouse_code":"A"
}
四、返回JSON范例
{
"code": 0,
"message": "",
"oth_task_id": "",
"entry_order_code": "",
"request_id": "TI",
"request_code": "TI33010001",
"warehouse_code": "A",
"data": {
"entry_order": {
"oth_task_id": "8042cc34-2243-4156-8bef-54252c9b89d6",
"ref_id": "SUNLIKE ERP",
"entry_order_date": "2023-03-01T00:00:00",
"request_id": "TI",
"request_code": "TI33010001",
"warehouse_code": "A",
"owner_code": "OWNER",
"generate_id": "",
"order_type": "01",
"expect_start_time": "2023-03-02T00:00:00",
"department": "00000000",
"bill_type": "",
"supplier_code": "SUP01",
"supplier_name": "厂商SUP01",
"operate_time": "2023-03-01T15:45:32",
"operator_code": "ADMIN",
"last_modified_date": "2023-03-01T15:45:32",
"remark": "",
"closing_mark": false, //结案标识
"total_order_lines": 1,
"extend_props": {}
},
"order_lines": [
{
"item_code": "P001",
"item_name": "P001货品P",
"sku_property": "",
"batch_code": "23010101",
"qty": 100.0,
"qty1": 0.0,
"qty_rk": 0.0,
"qty1_rk": 0.0,
"rem": "",
"request_id": "TI",
"request_code": "TI33010001",
"request_itm": "1",
"source_bilid": "PO",
"source_bilno": "PO33010001",
"source_bilitm": "1",
"extend_props": {}
}
]
}
}