一、说明
该接口为第三方系统提供,仅供AI-WMS PLUS使用,AI-WMS PLUS通过该接口,将出库单信息推送给第三方系统。
二、参数说明
1、请求方式
请求方式 |
POST |
接口地址 |
http://第三方系统API/CreateDeliveryConfirmation |
格式 |
JSON |
编码类型 |
UTF-8 |
2、header参数
KEY |
VALUS |
Content-Type |
application/json |
Authorization |
token值 |
说明:授权接口所获取的值 |
3、请求参数
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
表头delivery_order |
ref_id |
WMS系统标识 |
String |
20 |
是 |
自定义一个系统标识,如WMS |
delivery_code |
WMS入库单号 |
String |
100 |
是 |
WMS出库单号,必须唯一 |
delivery_date |
入库日期 |
Datatime |
|
是 |
单据日期,精确到日 |
owner_code |
货主编码 |
String |
30 |
是 |
未启用货主编码时,则固定传入OWNER; |
order_type |
业务类型 |
String |
10 |
是 |
提供类型如下:
01=销货出库,02=进货退回出库,03=暂估退回出库,04=托工退回出库,05=生产领料出库,06=生产补料出库,07=托工领料出库,08=托工补料出库,09=原料调拨出库,10=库存调拨出库,11=非生产领料出库,12=报废出库,13=其他出库,14=配送出库,15=配送退回出库,16=客户调货出库 |
department |
部门 |
String |
30 |
是 |
|
bill_type |
单据类别 |
String |
10 |
|
|
cus_code |
供应商代号 |
String |
30 |
|
客户代号 |
cus_name |
供应商名称 |
String |
100 |
|
客户名称 |
operate_time |
操作时间 |
Datatime |
|
是 |
制单时间,精确到秒 |
operator_code |
操作员编码 |
String |
30 |
是 |
制单人 |
last_modified_date |
最近修改时间 |
Datatime |
|
|
|
area_sh |
收货点 |
String |
60 |
|
|
logistics_code |
物流公司编码 |
String |
30 |
|
|
logistics_name |
物流公司名称 |
String |
100 |
|
|
name |
收货人姓名 |
String |
40 |
|
|
zip_code |
邮编 |
String |
10 |
|
|
mobile |
手机 |
String |
40 |
|
|
country_code |
国家 |
int |
|
|
|
area |
省市区代号 |
int |
|
|
|
detail_address |
详细地址 |
String |
1000 |
|
|
remark |
备注 |
String |
|
|
|
totalorderlines |
单据总行数 |
int |
|
|
|
extend_props |
扩展属性 |
|
|
|
|
表身order_lines |
delivery_code |
入库单号 |
String |
100 |
是 |
WMS出库单号 |
delivery_code_itm |
入库单项次 |
Integer |
|
是 |
即WMS出库单唯一项次 |
item_code |
货品代号 |
String |
50 |
是 |
货品代号 |
item_name |
货品名称 |
String |
160 |
是 |
货品名称 |
sku_property |
特征 |
String |
255 |
|
货品特征值 |
batch_code |
批号 |
String |
40 |
|
批号 |
warehouse_code |
仓库代号 |
string |
30 |
是 |
|
qty |
数量 |
FLOAT |
|
是 |
数量 |
qty1 |
数量(副) |
FLOAT |
|
|
数量(副) |
rem |
备注 |
String |
|
|
|
request_id |
申请单ID |
String |
10 |
是 |
即ERP申请单ID,如无,可不填; |
request_code |
申请单号 |
String |
100 |
是 |
即ERP申请单号,与表头必须一致; |
request_itm |
申请单项次 |
String |
100 |
是 |
即ERP申请单的转单唯一项次; |
source_bilid |
业务单 ID |
String |
10 |
|
即申请单的来源单ID |
source_bilno |
业务单号 |
String |
100 |
|
即申请单的来源单号; |
source_bilitm |
业务单项次 |
String |
100 |
|
即申请单对应来源单的项次 |
extend_props |
扩展属性 |
|
|
|
|
4、返回参数
字段 |
字段名 |
字段类型 |
长度 |
说明 |
code |
成功标识 |
string |
10 |
返回0则表示成功,其他则为失败 |
message |
返回信息 |
string |
200 |
|
bil_id |
第三方单据ID |
string |
10 |
必须返回 |
bil_no |
第三方单据别 |
string |
100 |
必须返回 |
三、请求JSON范例
{
"delivery_order": {
"ref_id": "Other",
"delivery_code": "CK230302000001",
"delivery_date": "2023-03-02",
"owner_code": "OWNER",
"order_type": "01",
"department": "00000000",
"bill_type": "",
"cus_code": "C001",
"cus_name": "客户C001",
"operate_time": "2023-03-02 11:35:16",
"operator_code": "ADMIN",
"last_modified_date": null,
"area_sh": "A区",
"logistics_code": null,
"logistics_name": null,
"name": null,
"zip_code": null,
"mobile": null,
"country_code": null,
"area": null,
"detail_address": null,
"remark": "水果",
"total_order_lines": 1,
"extend_props": null
},
"order_lines": [
{
"delivery_code": "CK230302000001",
"delivery_code_itm": 1,
"item_code": "P001",
"item_name": "P001原料(贸易10)",
"sku_property": "",
"batch_code": "",
"warehouse_code": "A",
"qty": 100.0,
"qty1": 0.0,
"est_dh_dd": null,
"rem": "",
"request_id": "CK",
"request_code": "CK33010001",
"request_itm": "1",
"source_bilid": "SO",
"source_bilno": "SO33010001",
"source_bilitm": "1",
"extend_props": null
}
]
}
四、返回JSON范例
{
"code":0,
"message":"新增成功",
"bil_id":"SA",
"bil_no":"SA230301001"
}