一、说明
主要给予第三方系统,通过调用AI-WMS PLUS的【查询出库通知单】接口,将在AI-WMS PLUS系统生成的【出库通知单】信息查询出来。
二、参数说明
1、请求方式
请求方式 |
POST |
接口地址 |
http://服务器IP或机器名或域名/WMS/API/SYS/QueryDeliveryOrder |
格式 |
JSON |
编码类型 |
UTF-8 |
2、header参数
KEY |
VALUS |
Content-Type |
application/json |
Authorization |
token值 |
说明:授权接口所获取的值 |
3、请求参数
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
ref_id |
第三方系统标识 |
String |
20 |
是 |
由第三方系统定义,用于区分第三方系统标识;如T8 |
oth_task_id |
第三方任务单号 |
String |
100 |
|
与“第三方任务单号”、“WMS出库通知单号”、“申请单ID+申请单号+仓库”任意条件必须有值; |
|
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 |
|
|
WMS出库通知单号 |
string |
100 |
|
owner_code |
货主编码 |
string |
30 |
|
data |
返回入库通知单明细 |
string |
三、请求JSON范例
{
"ref_id":"SUNLIKE ERP", //第三方系统标识
"oth_task_id":"", //优先判断“第三方任务单号”,无值则再判断“WMS出库通知单号”,无值再判断“申请单ID+申请单号+仓库”
"delivery_order_code":"", //优先判断“第三方任务单号”,无值则再判断“WMS出库通知单号”,无值再判断“申请单ID+申请单号+仓库”
"owner_code":"OWNER",
"request_id":"CK", //优先判断“第三方任务单号”,无值则再判断“WMS出库通知单号”,无值再判断“申请单ID+申请单号+仓库”
"request_code":"CK33010001", //优先判断“第三方任务单号”,无值则再判断“WMS出库通知单号”,无值再判断“申请单ID+申请单号+仓库”
"warehouse_code":"A" //优先判断“第三方任务单号”,无值则再判断“WMS出库通知单号”,无值再判断“申请单ID+申请单号+仓库”
}
四、返回JSON范例
{
"code": 0,
"message": "",
"oth_task_id": "",
"entry_order_code": "",
"request_id": "CK",
"request_code": "CK33010001",
"warehouse_code": "A",
"data": {
"delivery_order": {
"oth_task_id": "f53a4a19-39fd-438f-9ef9-6becdd0462b6",
"ref_id": "SUNLIKE ERP",
"delivery_order_date": "2023-03-01T00:00:00",
"request_id": "CK",
"request_code": "CK33010001",
"warehouse_code": "A",
"owner_code": "OWNER",
"generate_id": "",
"order_type": "01",
"schedule_date": "2023-03-11T00:00:00",
"department": "00000000",
"bill_type": "",
"cus_no": "C001",
"cus_name": "客户C001",
"operator_code": "ADMIN",
"operate_time": "2023-03-01T08:00:00",
"last_modified_date": "2023-03-01T09:00:00",
"waiting_notice": "",
"area_sh": "A区",
"est_dh_dd": "2023-03-11T00:00:00",
"logistics_code": "0000001",
"logistics_name": "天心物流公司",
"name": "张三",
"zip_code": "123456",
"mobile": "13012345678",
"country_code": 86,
"area": 440000,
"detail_address": "广东省珠海市香洲区吉大水湾大厦",
"remark": "水果",
"total_order_lines": 1,
"extend_props": {}
},
"order_lines": [
{
"item_code": "P001",
"item_name": "P001码货品P",
"sku_property": "",
"batch_code": "230301001",
"qty": 100.0,
"qty1": 0.0,
"rem": "",
"request_id": "CK",
"request_code": "CK33010001",
"request_itm": "1",
"source_bilid": "SO",
"source_bilno": "SO33010001",
"source_bilitm": "1",
"extend_props": {}
}
]
}
}