一、说明
该接口为第三方系统提供，仅供AI-WMS PLUS使用，AI-WMS PLUS通过该接口，将出库单信息推送给第三方系统。
二、参数说明
1、请求方式
| 请求方式 |
POST |
| 接口地址 |
http://第三方系统API/CreateDeliveryConfirmation |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2、header参数
| KEY |
VALUE |
| 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"
}