WMS与ERP接口通讯文档V10.docx
《WMS与ERP接口通讯文档V10.docx》由会员分享,可在线阅读,更多相关《WMS与ERP接口通讯文档V10.docx(46页珍藏版)》请在冰豆网上搜索。
WMS与ERP接口通讯文档V10
物流接口说明文档
Ver.2017年5月
文档信息
文档名称
物流接口说明文档
文件目的
物流相关接口说明文档
内容简介
文件控制
版本记录
日期
作者
版本
变更说明
2017.05.12
V1.0
新增
审阅记录
日期
审阅者
意见
分发记录
日期
接受人
地点
目 录
1.系统介绍
1.1背景
WMS系统与ERP采用不同的开发技术,在业务逻辑上有着一定的联系,这就需要定义接口来实现数据的交换。
1.2目的
定义配送中心物流管理系统(以下简称为WMS系统)与ERP的接口规范和实施细节。
本文将阐述以下内容:
●接口开发规范
●接口方案
●接口数据格式定义
本文将重点置于两套系统所关注的接口问题,对于接口数据是如何影响系统的内部运行不作描述。
1.3接口开发规范
接口开发应符合以下规范:
●满足配送中心的业务需求,便于维护和操作
●确保数据的安全,WMS与ERP系统只以接口形式交互,不直接互相读取、修改数据
●尽可能以简便的方式达到目的
●WMS与ERP系统内部应保留一定时期范围的历史传入传出数据
●接口必须在模拟环境中经过严格测试后才能正式使用
●使得WMS系统和ERP的修改最小化,以保持其稳定性
2.接口方案
所有接口数据以接口数据库形式生成,通过接口服务程序在WMS与ERP系统之间定时传递。
如下图:
导入程序从接口数据库读取数据以后,应该将所读取的数据从接口数据库中删除,并做好备份。
接口的几个核心处理原理说明:
⏹数据交互池。
系统的作用是进行双方交互数据的存储,其就像一个水池,一方导入数据到水池中,一方导出数据到相应的系统中,从而完成数据交互工作。
该数据交互池可以建立在WMS系统中,可以建立在ERP系统中,也可以建立在一个独立的数据库系统中;
⏹数据对象。
数据对象是双方进行数据交互的最小单位,由一方将数据对象生成,并导入数据交互池中,而另一方负责将数据对象进行导出,进入其系统生成相应的数据处理;数据对象可以设置为2种形式:
XML文件形式或SQL数据形式;
⏹定时导入和定时导出。
这是进行数据交互的操作,需要由一方导出生成数据对象,再由另外一方导入该数据对象进行数据处理。
该操作可以根据双方定义的时间进行定期处理;
⏹数据监控中心。
这是一个监控系统,所有在双方系统中进行交互的数据对象和数据操作都会经过其审核监控,一旦发现有异常数据或异常处理存在,其会立即进行报警,保证数据的完整性和实时性。
3.
传输内容介绍
3.1物流中心需求资料交换类别
NO.
资料名称
提供者
发单周期
编码
备注
1.
商品资料
总部系统
30分钟
P
有异动才传
2.
商品条码资料
总部系统
30分钟
L
有异动才传
3.
商品类别资料
总部系统
30分钟
B
有异动才传
4.
供货商资料
总部系统
30分钟
S
有异动才传
5.
门店资料
总部系统
30分钟
C
有异动才传
6.
进货通知单
总部系统
5分钟
I
7.
出货通知单
总部系统
5分钟
E
8.
返配通知单
总部系统
5分钟
B
9.
退厂单
总部系统
5分钟
R
10.
3.2总部系统需求资料交换类别
NO.
资料名称
提供者
发单周期
编码
备注
1.
验收(进货)确认单
配送中心
5分钟
I
2.
配送(出库)确认单
配送中心
5分钟
O
3.
出货单完验确认单
配送中心
5分钟
OC
4.
验收(返仓)确认单
配送中心
5分钟
R
5.
配送(返厂)确认单
配送中心
5分钟
F
6.
损溢确认单
配送中心
5分钟
SM
7.
8.
9.
4.接口业务流程
1
2
3
4
4.1存储进货流程
ERP下传至存储进货单至WMS系统,wms系统根据常温及生鲜系统不同的配置对验收数量进行确认。
在生鲜系统这一块,对计重商品允许超量验收。
常温商品不允许超量验收。
系统验收结案后,只允许一张通知单结案一次。
4.2
存储出货流程
ERP下传存储出货单至WMS系统,WMS系统根据常温及生鲜系统不同的配置走不同的作业流程。
系统允许一张出货通知单多次产生配送单,但出货通知单完结只能回传一次。
4.3直通进出货流程
ERP系统需要同时直通收货通知单及直通分配通知单同时下传至WMS系统,WMS验收完成之后自动建立对应的分播单,分播完成之后装车。
系统回传时直通收货验收单及配送单信息。
4.4仓库退供应商
仓库退供应商由业务中心系统发起,WMS收到退厂单,不允许超出供应商应退货数量。
退货审核完成之后上传至ERP系统,并且退厂单只能回传一次。
4.5
门店退货单据处理
门店退货单由门店发起,WMS收到门店退货单,允许修改通知单数量。
验收结案之后上传至ERP系统。
并且门店退货单只能回传一次,对于差异部分,由物流生成门店虚配单上传至总部系统处理。
4.6
损益处理
损益包括盘点损益和手工损益
盘点作业由WMS发起,盘点结案之后,系统产生全库库存上传ERP系统
5.接口表结构定义
2
3
4
5
5.1商品分类表(ERP至WMS)
对应的接口数据库表名:
SDWMS_SGROUP
NO.
Field
Type
Bytes
Name
Description
Memo
IsNull
PK
1.
SheetID
Varchar
20
*单据号
N
√
2.
CustomID
Varchar
10
主客户编码
默认001
N
√
3.
SgroupID
Varchar
20
*分类编码
1.部类2.课类3大类,4中类,5小类
N
√
4.
SgroupName
Varchar
50
品类名称
N
5.
FgroupID
Varchar
20
父分类编码
Y
6.
Status
Number
4
单据状态
0转入1转出
默认0
Y
7.
Send_Ddate
Date
传入时间
默认sysdate
Y
5.2商品资料表(ERP至WMS)
对应的接口数据库表名:
SDWMS_GOODS
NO.
Field
Type
Bytes
Name
Description
Memo
IsNull
PK
1.
Sheetid
Varchar
20
单据号
N
√
2.
Goodsid
Varchar
20
商品编码
商品编码
不可重复
N
√
3.
CustomID
Varchar
10
主客户编码
默认001
N
√
4.
Sgroupid
Varchar
20
类别编码
此处下传小类代码
N
5.
Barcodeid
Varchar
20
条形码
商品主条形码
N
6.
Name
Varchar
100
品名
商品名称
N
7.
Ename
Varchar
100
英文名称
商品英文名称
Y
8.
ABCID
Varchar
1
ABC
ABC分级
默认为C
Y
9.
UnitName
Varchar
20
单位
商品最小单位
销售包装
N
10.
PKName
Varchar
20
*包装单位
商品主包装单位
采购包装
N
11.
PKNum
Number
12,3
*包装数量
商品主包装数量
采购包装数量
N
12.
Spec
Varchar
60
*规格
商品规格
N
13.
PKSpec
Varchar
60
*包装规格
包装规格
物流维护
14.
ZBNum
Number
12,3
标准栈版数量
标准栈版数量
物流维护
Y
15.
Length
Number
11,2
长
cm
物流维护
Y
16.
Width
Number
11,2
宽
cm
物流维护
Y
17.
Height
Number
11,2
高
cm
物流维护
Y
18.
Weigth
Number
11,2
重量
KG
物流维护
Y
19.
KeepDays
int
5
保质天数
单位:
天
N
20.
Price
Number
16,4
价格
销售价格
N
21.
SupNO
Varchar
20
*供货商编号
供货商编号
主供应商
N
22.
Notes
Varchar
255
备注
Y
23.
STATUS
Number
4
*单据状态
0转入1转出
默认0
Y
24.
Freshday
Number
10
保鲜期
保鲜期天数(单位:
天)
默认为0
Y
25.
PLU_NO
Varchar
20
PLU码
Y
26.
Send_Date
Date
传入日期
sysdate
Y
5.3商品条码表(ERP至WMS)
对应的接口数据库名:
SDWMS_BARCODE
NO.
Field
Type
Bytes
Name
Description
Memo
IS
Null
PK
1.
Sheetid
Varchar
20
单据号
N
√
2.
Goodsid
Varchar
20
商品编码
不可重复
N
3.
CustomID
Varchar
10
主客户编码
默认为001
N
√
4.
Barcodeid
Varchar
20
条形码
商品条形码
N
√
5.
PKNum
Number
12,3
包装数量
N
6.
Status
Number
4
单据状态
0转入1转出
Y
7.
Send_Date
Date
传入日期
Y
5.4供应商资料(ERP至WMS)
对应的接口数据库表名:
SDWMS_VENDER
NO.
Field
Type
Bytes
Name
Description
Memo
IS
Null
PK
1.
Sheetid
Varchar
20
单据号
N
√
2.
Venderid
Varchar
20
供货商编号
不可重复
N
√
3.
CustomID
Varchar
10
主客户编码
默认为001
N
√
4.
Venderid_M
Varchar
20
主供应商编码
暂不用
Y
5.
Venderid_MName
Varchar
20
主供应商编码
暂不用
Y
6.
Name
Varchar
100
供货商名称
N
7.
Manager
Varchar
10
负责人
Y
8.
LinkMan
Varchar
20
联络人
Y
9.
Address
Varchar
160
地址
Y
10.
Zipcode
Varchar
12
邮编
Y
11.
Tele
Varchar
36
电话
联络电话
Y
12.
Fax
Varchar
36
传真
传真号码
Y
13.
E_mail
Varchar
60
E-Mail
Y
14.
Notes
Varchar
255
说明
Y
15.
Orderflag
Number
4
是否约仓
0约仓1不约仓
默认为1
Y
16.
Invoice_NO
Varchar
20
发票号
Y
17.
Invoice_Addr
Varchar
100
发票地址
Y
18.
Invoice_Header
Varchar
50
发票抬头
Y
19.
Lawvalistart
Date
营业执照开始日期
Y
20.
Lawvaliend
Date
营业执照结束日期
Y
21.
Lawcode
Varchar
20
营业执照代码
Y
22.
Taxvalistart
Date
税务登记证开始
Y
23.
Taxvaliend
Date
税务登记证结束
Y
24.
Taxcode
Varchar
20
税务登记证代码
Y
25.
Sanvalistart
Date
卫生许可证开始
Y
26.
Sanvaliend
Date
卫生许可证结束
Y
27.
Sancode
Varchar
20
卫生许可证代码
Y
28.
Status
Number
4
单据状态
0转入1转出
默认为0
Y
5.5门店资料表(ERP至WMS)
对应的接口数据库表名:
SDWMS_SHOP
NO.
Field
Type
Bytes
Name
Description
Memo
IS
Null
PK
1.
Sheetid
Varchar
20
单据号
N
√
2.
Shopid
Varchar
10
门店编号
不可重复
N
√
3.
CustomID
Varchar
10
主客户编码
默认为001
N
√
4.
Name
Varchar
50
门店名称
门店名称
N
5.
Shoptype
Number
4
门店类型
0自营、1加盟
N
6.
Shopflag
Char
1
门店标记
大卖场(M/X)、标超(B/C/D)、食品店F
N
7.
Manager
Varchar
10
负责人
门店负责人名称
Y
8.
LinkMan
Varchar
20
联络人
门店联络人名称
Y
9.
Address
Varchar
160
地址
门店地址
Y
10.
Delivery_Address
Varchar
100
送货地址
门店送货地址
Y
11.
zipcode
Varchar
12
邮编
门店邮编
Y
12.
Tele1
Varchar
36
电话1
联络电话1
Y
13.
Tele2
Varchar
36
电话2
联络电话2
Y
14.
Fax1
Varchar
36
传真1
传真号码1
Y
15.
Fax2
Varchar
36
传真2
传真号码2
Y
16.
E_mail
Varchar
60
E-Mail
联络人E-Mail
Y
17.
Notes
Varchar
255
说明
Y
18.
Status
Number
4
单据状态
0转入1转出
Y
5.6进货通知单(ERP至WMS)
对应的接口数据库表名:
SDWMS_PURCHASE
NO.
Field
Type
Bytes
Name
Description
Memo
IS
Null
PK
1.
Sheetid
Varchar
20
进货通知单号
不可重复
N
√
2.
CustomID
Varchar
10
主客户编码
默认为001
N
√
3.
PalletZone
Varchar
10
仓库编码
收货仓库编码
(上位机机构编码)
N
√
4
Serialid
Number
5
单内序号
商品于单据上的序号
1~9999
N
√
5.
SheetType
Number
4
进货单类型
0.正常订货单
3.长期订单
4.赠品订单
5.促销品订单
9.空进订货单
N
6.
DeptID
Varchar
10
部门
Y
7.
purFlag
Number
4
自采标记
0:
正常订货1:
自采
暂不用,默认为0
Y
8.
Goodsid
Varchar
20
商品编码
N
9.
GoodsType
Number
4
商品类型
0:
正常
1:
赠品
默认为0
N
10
Venderid
Varchar
20
供货商编码
供货商编码
N
11
Refsheetid
Varchar
10
原单据号码
N
12
Sdate
Date
采购日期
原采购单据日期
YYYY/MM/DD
N
13
Checker
Varchar
20
采购员工姓名
原采购员工姓名
Y
14
Type
Char
1
类型
存储型=’0’
直通型=’1’
默认为‘0’
N
15
PurDate
Date
预定进货日期
本单据预定进货日期
YYYY/MM/DD
N
16
validDate
Date
单据有效日期
本单据之有效日期,超过此日则失效
YYYY/MM/DD
N
17
Receivetype
Number
1
长期订单
0:
普通1:
长期
N
18
Pkcount
Number
12,3
包装数量
订货商品的包装系数
N
19
Qty
Number
12,3
进货总量
进A赠A=A+A
N
20
Zp_Qty
Number
12,3
赠品数量
9999999999999
N
21
Cost
Number
16,4
单价
99999999.9999
进价(含税)
Y
22
TaxRate
Number
5,2
税率
Y
23
Notes
Varchar
255
说明
单据说明字段
Y
24
Status
Number
4
单据状态
0转入1转出
Y
25
Send_Date
Date
传入时间
默认sysdate
Y
5.7验收确认单(WMS至ERP)
对应的接口数据库表名:
FR_RECEIPT
NO.
Field
Type
Bytes
Name
Description
Memo
IS
Null
PK
1.
PalletZone
Varchar
10
仓库编码
收货仓库编码
N
√
2.
CustomID
Varchsr
10
主客户编码
N
√
3.
Sheetid
Varchar
20
验收单号
WMS的验收单号
N
√
4.
Serialid
Number
20
单内序号
999999999999999999
N
√
5.
Refsheetid
Varchar
20
原进货通知单号
N
6.
DeptID
Varchar
10
部门
Y
7.
Sdate
Date
验收日期
yyyy-mm-dd
N
8.
Pdate
Date
生产日期
yyyy-mm-dd
N
9.
Goodsid
Varchar
20
商品编码
商品编码
N
10.
Venderid
Varchar
20
供货商编号
供货商编码
N
11.
LotNo
Varchar
20
批次号
Y
12.
Orderqty
Number
12,3
订货数量
999999999.999
N
13.9
Qty
Number
12,3
验收数量
WMS实际收货数量
N
14.
Zp_Qty
Number
12,3
赠品数量
999999999.999
N
15.
Cost
Number
16,6
单价
99999999.9999
此价格已经核算过
Y
16.
BadQty
Number
12,3
其中坏货数量
999999999.999
默认为0
Y
17.
Operator
Varchar
20
执行人
作业执行人员中文姓名
N
18.
Is_Done
CHAR
1
Erp是否已处理
0未处理1已处理
默认0
Y
5.8出货通知单(ERP至WMS)
对应的接口数据库表名:
SDWMS_RATIONNOTE
NO.
Field
Type
Bytes
Name
Description
Memo
IS
Null
PK
1
PalletZone
Varchar
10
*仓库编码
发货仓库编码
N
√
2
CustomID
Varchar
10
*主客户编码
默认为001
N
√
3
Sheetid
Varchar
20
*出货通知单号
ERP出货通知单号
N
√
4
Serialid
Numbe