WMS与ERP接口通讯文档V0

1、物流接口说明文档Ver.2017年5月文档信息文档名称物流接口说明文档文件目的物流相关接口说明文档内容简介文件控制版本记录日期作者版本变更说明2017.05.12V1.0新增审阅记录日期审阅者意见分发记录日期接受人地点Ver.2017年5月1保密性错误！未定义书签1.系统介绍1.3背景目的接口开发规范接口方案.3 .传输内容介绍3.3.1 物流中心需求资料交换类别3.3.2 总部系统需求资料交换类别3.4 .接口业务流程4.4.1 存储进货流程4.4.2 存储出货流程5.4.3 直通进出货流程5.4.4 仓库退供应商.6.4.5 门店退货单据处理7.4.6 损益

2、处理8.5 .接口表结构定义9.5.1 商品分类表（ERP至WMS）.95.2 商品资料表（ERP至WMS）.95.3 商品条码表（ERP至WMS）1.15.4 供应商资料（ERP至WMS）1.15.5 门店资料表（ERP至WMS）1.35.6 进货通知单（ERP至WMS）145.7 验收确认单（WMS至ERP）1.55.8 出货通知单（ERP至WMS）165.9 配送确认单（WMS至ERP）1.75.10 出货单完验（WMS至ERP）1.95.11 返配通知单（ERP至WMS）205.12 退配确认单（WMS至ERP）225.13 退厂通知单（ERP至WMS）235.14 退厂确认单（WMS

3、至ERP）245.15 损溢单（WMS至ERP）251 .系统介绍1.1 背景WM系统与ERP*用不同的开发技术，在业务逻辑上有着一定的联系，这就需要定义接口来实现数据的交换。1.2 目的定义配送中心物流管理系统（以下简称为WM系统）与ERP的接口规范和实施细节。本文将阐述以下内容：接口开发规范接口方案接口数据格式定义本文将重点置于两套系统所关注的接口问题，对于接口数据是如何影响系统的内部运行不作描述。1.3 接口开发规范接口开发应符合以下规范：满足配送中心的业务需求，便于维护和操作确保数据的安全，WMSERP系统只以接口形式交互，不直接互相读取、修改数据尽可能以简便的方式达到目的WMSERP

4、S统内部应保留一定时期范围的历史传入传出数据接口必须在模拟环境中经过严格测试后才能正式使用使得WM系统和ERP的修改最小化，以保持其稳定性2 .接口方案所有接口数据以接口数据库形式生成,间定时传递。如下图：通过接口服务程序在WMSfERP系统之导入程序从接口数据库读取数据以后，应该将所读取的数据从接口数据库中删除，并做好备份。接口的几个核心处理原理说明：数据交互池。系统的作用是进行双方交互数据的存储，具就像一个水池，一方导入数据到水池中，一方导出数据到相应的系统中，从而完成数据交互工作。该数据交互池可以建立在WMS系统中，可以建立在ERP系统中，也可以建立在一个独立的数据库系统中；数据对象。数

5、据对象是双方进行数据交互的最小单位，由一方将数据对象生成，并导入数据交互池中，而另一方负责将数据对象进行导出，进入其系统生成相应的数据处理；数据对象可以设置为2种形式：XML文件形式或SQL数据形式；定时导入和定时导出。这是进行数据交互的操作，需要由一方导出生成数据对象，再由另外一方导入该数据对象进行数据处理。该操作可以根据双方定义的时间进行定期处理；数据监控中心。这是一个监控系统，所有在双方系统中进行交互的数据对象和数据操作都会经过其审核监控，一旦发现有异常数据或异常处理存在，其会立即进行报警，保证数据的完整性和实时性。3 .传输内容介绍3.1 物流中心需求资料交换类别NO.资料名称提供者发

6、单周期编码备注1.商品资料总部系统30分钟P有异动才传2.商品条码资料总部系统30分钟L有异动才传3.商品类别资料总部系统30分钟B有异动才传4.供货商资料总部系统30分钟S有异动才传5.门店资料总部系统30分钟C有异动才传6.进货通知单总部系统5分钟I7.出货通知单总部系统5分钟E8.返配通知单总部系统5分钟B9.退厂单总部系统5分钟R10.3.2 总部系统需求资料交换类别NO.资料名称提供者发单周期编码备注1.验收（进货）确认单配送中心5分钟I2.配送（出库）确认单配送中心5分钟O3.出货单完验确认单配送中心5分钟OC4.验收（饭仓）确认单配送中心5分钟R5.配送.（返厂）确认单配送中心5

7、分钟F6.损溢确认单配送中心5分钟SM .接口业务流程4.1 存储进货流程ERP下传至存储进货单至WMS系统，wms系统根据常温及生鲜系统不同的配置对验收数量进行确认。在生鲜系统这一块，对计重商品允许超量验收。常温商品不允许超量验收。系统验收结案后，只允许一张通知单结案一次。4.2 存储由货流程ERP下传存储出货单至WMS系统，WMS系统根据常温及生鲜系统不同的配置走不同的作业流程。系统允许一张出货通知单多次产生配送单，但出货通知单完结只能回传一次。4.3 直通进由货流程ERP系统需要同时直通收货通知单及直通分配通知单同时下传至WMS系统,WMS验收完成之后自动建立对应的分播单，

8、分播完成之后装车。系统回传时直通收货验收单及配送单信息。4.4 仓库退供应商仓库退供应商由业务中心系统发起，WMS收到退厂单，不允许超出供应商应退货数量。退货审核完成之后上传至ERP系统，并且退厂单只能回传一次。4.5 门店退货单据处理门店退货单由门店发起，WMS收到门店退货单，允许修改通知单数量。验收结案之后上传至ERP系统。并且门店退货单只能回传一次，对于差异部分,由物流生成门店虚配单上传至总部系统处理。4.6损益处理损益包括盘点损益和手工损益5 .接口表结构定义5.1 商品分类表（ERP至WMS）对应的接口数据库表名：SDWMS_SGROUPNO.FieldTypeBytesNameDe

9、scriptionMemoIsNullPK1.SheetIDVarchar20*单据号NV2.CustomIDVarchar10主客户编码默认001NV3.SgroupIDVarchar20*分类编码1.部类2.课类3大类,4中类,5小类NV74.SgroupNameVarchar50品类名称N5.FgroupIDVarchar20父分类编码Y6.StatusNumber4单据状态0转入1转出默认0Y7.Send_DdateDate传入时间默认sysdateY5.2 商品资料表（ERP至WMS）对应的接口数据库表名：SDWMS_GOODSNO.FieldTypeBytesNameDescrip

10、tionMemoIsNullPK1.SheetidVarchar20单据号NV2.GoodsidVarchar20商品编码商品编码不可重复NV3.CustomIDVarchar10主客户编码默认001NV74.SgroupidVarchar20类别编码此处下传小类代码N5.BarcodeidVarchar20条形码商品主条形码N6.NameVarchar100品名商品名称N7.EnameVarchar100英义名称商品英义名称Y8.ABCIDVarchar1ABCABC分级默认为CY9.UnitNameVarchar20单位商品最小单位销售包装N10.PKNameVarchar20*包装单位商

11、品主包装单位采购包装N11.PKNumNumber12,3*包装数量商品主包装数量采购包装数量N12.SpecVarchar60*规格商品规格N13.PKSpecVarchar60*包装规格包装规格物流维护14.ZBNumNumber12,3标准栈版数量标准栈版数量物流维护Y15.LengthNumber11,2长cm物流维护Y16.WidthNumber11,2宽cm物流维护Y17.HeightNumber11,2高cm物流维护Y18.WeigthNumber11,2KG物流维护Y19.KeepDaysint5保质天数单位：天N20.PriceNumber16,4价格销售价格N21.SupN

12、OVarchar20*供货商编号供货商编号主供应商N22.NotesVarchar255备注Y23.STATUSNumber4*单据状态0转入1转出默认0Y24.FreshdayNumber10保鲜期保鲜期天数（单位：天）默认为0Y25.PLUNOVarchar20PLU码Y26.Send_DateDate传入日期sysdateY5.3 商品条码表（ERP至WMS）对应的接口数据库名：SDWMS_BARCODENO.FieldTypeBytesNameDescriptionMemoISNullPK1.SheetidVarchar20单据号NV2.GoodsidVarchar20商品编码不可重复

13、N3.CustomIDVarchar10主客户编码默认为001NV4.BarcodeidVarchar20条形码商品条形码NV75.PKNumNumber12,3包装数量N6.StatusNumber4单据状态0转入1转出Y7.Send_DateDate传入日期Y5.4 供应商资料（ERP至WMS）对应的接口数据库表名：SDWMS_VENDERNO.FieldTypeBytesNameDescriptionMemoISNullPK1.SheetidVarchar20单据号NV2.VenderidVarchar20供货商编号不可重复NV3.CustomIDVarchar10主客户编码默认为001

14、NV74.Venderid_MVarchar20主供应商编码暂不用Y5.Venderid_MNameVarchar20主供应商编码暂不用Y6.NameVarchar100供货商名称N7.ManagerVarchar10负责人Y8.LinkManVarchar20联络人Y9.AddressVarchar160地址Y10.ZipcodeVarchar12邮编Y11.TeleVarchar36电话联络电话Y12.FaxVarchar36传真传真号码Y13.E_mailVarchar60E-MailY14.NotesVarchar255说明Y15.OrderflagNumber4是否约仓0约仓1不约仓

15、默认为1Y16.Invoice_NOVarchar20反东PY17.Invoice_AddrVarchar100发票地址Y18.Invoice_HeaderVarchar50发票抬头Y19.LawvalistartDate营业执照开始日期Y20.LawvaliendDate营业执照结束日期Y21.LawcodeVarchar20营业执照代码Y22.TaxvalistartDate税务登记证开始Y23.TaxvaliendDate税务登记证结束Y24.TaxcodeVarchar20税务登记证代码Y25.SanvalistartDate卫生许可证开始Y26.SanvaliendDate卫生许可证

16、结束Y27.SancodeVarchar20卫生许可证代码Y28.StatusNumber4单据状态0转入1转出默认为0Y5.5 门店资料表（ERP至WMS）对应的接口数据库表名：SDWMS_SHOPNO.FieldTypeBytesNameDescription腌NullPK1.SheetidVarchar20单据号NV2.ShopidVarchar10门店编R不可重复NV3.CustomIDVarchar10主客户编码默认为001NV74.NameVarchar50门店名称门店名称N5.ShoptypeNumber4门店类型0自营、1加盟N6.ShopflagChar1门店标记大卖场（M/

17、X）、标超（B/C/D）、食品店FN7.ManagerVarchar10负责人门店负责人名称Y8.LinkManVarchar20联络人门店联络人名称Y9.AddressVarchar160地址门店地址Y10.Delivery_AddressVarchar100送货地址门店送货地址Y11.zipcodeVarchar12邮编门店邮编Y12.Tele1Varchar36电话1联络电话1Y13.Tele2Varchar36电话2联络电话2Y14.Fax1Varchar36传真1传真号码1Y15.Fax2Varchar36传真2传真号码2Y16.E_mailVarchar60E-Mail联络人E-M

18、ailY17.NotesVarchar255说明Y18.StatusNumber4单据状态0转入1转出Y5.6 进货通知单（ERP至WMS）对应的接口数据库表名：SDWMS_PURCHASENO.FieldTypeBytesNameDescriptionMemoISNullPK1.SheetidVarchar20进货通知单号不可重复NV2.CustomIDVarchar10主客户编码默认为001NV3.PalletZoneVarchar10仓库编码收货仓库编码（上位机机构编码）NV4SerialidNumber5单内序号商品于单据上的序号19999NV75.SheetTypeNumber4进货

19、单类型0.正常订货单3 .长期订单4 .赠品订单5 .促销品订单9 .空进订货单N6.DeptIDVarchar10部门Y7.purFlagNumber4自采标记0:正常订货1:自采暂不用，默认为0Y8.GoodsidVarchar20商品编码N9.GoodsTypeNumber4商品类型0:正常1:赠品默认为0N10IVenderidVarchar20供货商编码供货商编码N11RefsheetidVarchar10原单据号码N12SdateDate采购日期原采购单据日期YYYY/MM/DDN13CheckerVarchar20采购员工姓名原采购员工姓名Y14ITypeChar1存储型=0直通

20、型=1默认为0N15PurDateDate预定进货日期本单据预定进货日期YYYYN/MM/DD16validDateDate单据有效日期本单据之有效日期，超过此日则失效YYYY/MM/DDN17ReceivetypeNumber1长期订单0:普通1:长期N18PkcountNumber12,3包装数量订货商品的包装系数N19QtyNumber12,3进货总量进A赠A=A+AN20Zp_QtyNumber12,3赠品数量9999999999999N21CostNumber16,4单价99999999.9999进价（含税）Y22TaxRateNumber5,2税率Y23NotesVarchar25

21、5说明单据说明字段Y24StatusNumber4单据状态0转入1转出Y25Send_DateDate传入时间默认sysdateY5.7 验收确认单（WM畦ERP）对应的接口数据库表名：FR_RECEIPTNO.FieldTypeBytesNameDescriptionMemoISNullPK1.PalletZoneVarchar10仓库编码收货仓库编码NV2.CustomIDVarchsr10主客户编码NV3.SheetidVarchar20验收单号WMS的验收单号NV4.SerialidNumber20单内序号999999999999999999NV75.RefsheetidVarchar

22、20原进货通知单号N6.DeptIDVarchar10部门Y7.SdateDate验收日期yyyy-mm-ddN8.PdateDate生产日期yyyy-mm-ddN9.GoodsidVarchar20商品编码商品编码N10.VenderidVarchar20供货商编号供货商编码N11.LotNoVarchar20批次号Y12.OrderqtyNumber12,3订货数量999999999.999N13.9QtyNumber12,3验收数量WMS实际收货数量N14.Zp_QtyNumber12,3赠品数量999999999.999N15.CostNumber16,6单价99999999.9999

23、此价格已经核算过Y16.BadQtyNumber12,3其中坏货数量999999999.999默认为0Y17.OperatorVarchar20执行人作业执行人员中文姓名N18.Is_DoneCHAR1Erp是否已处理0未处理1已处理默认0Y5.8 由货通知单（ERP至WMS）对应的接口数据库表名：SDWMS_RATIONNOTENO.FieldTypeBytesNameDescriptionMemoISNullPK1PalletZoneVarchar10*仓库编码发货仓库编码NV2CustomIDVarchar10*主客户编码默认为001NV3SheetidVarchar20*出货通知单号E

24、RP出货通知单号NV4SerialidNumber5单内序号商品于单据上的序号19999NV75DEPTIDVarchar10部门对应ERP的存货地Y6RefsheetidVarchar20*原单据号码物流模式为直通时，此处对应进货通知单N号7ShopidVarchar10*门店编码出货门店编码N8TypeNumber4*旧保管型=0通过型=1N9sheetTypeNumber4*出货单类型0、正常出货1、紧急出货3、批发出货单4:行政领用出库9、虚出通知单N10SdateDate*预定出货日期本单据预定出货日期yyyy-mm-ddN11GoodsidVarchar20*商品编码商品编码N12

25、CostNumber16,6单价99999999.9999配送价格Y13PKcountNumber12,3包装N14planqtyNumber12,3*预定出货数量9999999.999N15GoodstypeNumber4*商品类型默认为0N16NotesVarchar255说明单据说明字段Y17StatusNumber4单据状态0转入1转出默认0Y18Send_DateDATE传入日期Y5.9 配送确认单（WM畦ERP）对应的接口数据库表名：FR_RATIONNOTENO.FieldTypeBytesNameDescriptionMemoISNullPK1.PalletZoneVarcha

26、r10*仓库编码发货仓库编码NV2.CustomIDVarchar10*主客户编码NV3.SheetidVarchar20*配送单号wms生成单号NV4.ShopidVarchar10*门店编码NV5.GoodsidVarchar20*商品编码商品编码NV76.SerialidNumber20单内序号999999999999999999N7.refSheetidVarchar20*相关单号ERP原始出货通知单N8.DeptIDVarchar10部门对应ERP的存货地Y9.sheetTypeNUMBER出货单类型0、正常出货1、紧急出货3、批发出货单4:行政领用出库9、虚出通知单N10.Pdat

27、eDate生产日期yyyy-mm-ddY11.VenderidVarchar20供货商编号供货商编码默认为空Y12.LotNoINT4批次号默认为0Y13.realqtyNumber12,3*实际数量99999999.999N14.BadQtyNumber12,3其中坏货数量999999999.999默认为0N15.SdateDate*配送日期yyyy-mm-ddN16.OperatorVarchar20执行人单据执行人员中文姓名N17.Is_DoneCHAR1Erp是否已处理0未处理1已处理默认0Y5.10 配送批次追溯确认单（WM畦ERP）对应的接口数据库表名:FR_RATIONNOTE_

28、LOTNO.FieldTypeBytesNameDescriptionMemoISNullPK17.PalletZoneVarchar10*仓库编码发货仓库编码NV18.CustomIDVarchar10*主客户编码Nv719.SheetidVarchar20*配送单号wms生成单号NV20.ShopidVarchar10*门店编码NV21.GoodsidVarchar20*商品编码商品编码NV722.SerialidNumber20单内序号999999999999999999N23.refSheetidVarchar20*相关单号ERP原始出货通知单N24.DeptIDVarchar10部门

29、对应ERP的存货地Y25.sheetTypeNUMBER出货单类型0、正常出货1、紧急出货3、批发出货单4:行政领用出库9、虚出通知单N26.PdateDate生产日期yyyy-mm-ddY27.VenderidVarchar20供货商编号供货商编码默认为空Y28.LotNoINT4批次号默认为0Y29.realqtyNumber12,3*实际数量99999999.999N30.BadQtyNumber12,3其中坏货数量999999999.999默认为0N31.SdateDate*配送日期yyyy-mm-ddN32.OperatorVarchar20执行人单据执行人员中文姓名N17.Is_D

30、oneCHAR1Erp是否已处理0未处理1已处理默认0Y5.11 由货单完验（WM畦ERP）对应的接口数据库表名：FR_RATIONNOTE_CLOSENO.FieldTypeBytesNameDescriptionMemoISPKNull1.PalletZoneVarchar10*仓库编码仓库编码NV2.SheetidVarchar20*出货通知单号MIS出货通知单NV3.CustomIDVarchar10主客户编码NV4.SerialidNumber20单内序号NV75.DeptIDVarchar10部门对应ERP的存货地Y6.CustomidVarchar10*主客户编码默认为001Y7

31、.ShopidVarchar10*门店编码N8.GoodsidVarchar20*商品编码商品编码N9.PdateDate生产日期Yyyy-mm-ddY10.PlanqtyNumber12,3*原始数量99999999.999N11.RealqtyNumber12,3*实际数量99999999.999N12.1*s_DoneCHAR1Erp是否已处理0未处理1已处理默认0Y5.12 返配通知单（ERP至WMS）对应的接口数据库表名：SDWMS_RETRATIONNO.FieldTypeBytesNameDescriptionMemoISNullPK1.PalletZoneVarchar10*仓

32、库编码退货仓库编码NV2.CustomidVarchar10*主客户编码默认为001NV3.SheetidVarchar20*退货单#NV4.SerialidNumber4*单内序号商品于单据上的序号19999NV75.DeptIDVarchar10部门Y6.SheetTypeNumber4单据类型0=门店返配单1=行政领用退货2=批发退货单3=配送返配单（配送差异）N4=虚拟返配单7.shopidVarchar10*门店编码门店编码N8.SdateDate*预定退货日期本单据预定退货日期yyyy-mm-ddN9.GoodsidVarchar20*商品编码退货商品编码N10.PkcountNu

33、mber12,3*包装数量订货商品的包装系数取商品的主包装N11.planQtyNumber12,3*进货总量99999999999999N12.VenderidVarchar20*供货商编码进货供货商编码N13.CostNumber16,6单价99999999.9999含税的成本价Y14.TaxRateNumber4,2税率Y15.ReasontypeidNumber4退货商品原因自己可以设置例01滞销02残缺预留Y16.BadflagNumber4商品好坏货口0良品1不良品默认为0N17.LabelVarchar30箱标签号返配商品打包对应箱号暂不用Y18.Exp_NOVARCHAR220

34、原出库单号Y19.Sourceerp_NOVARCHAR220ERP原始单号Y20.NotesVarchar255说明单据说明字段Y21.Send_DateDATE传入日期Y22.StatusNumber4*单据状态0转入1转出Y5.13 退配确认单（WM畦ERP）对应的接口数据库表名：FR_RETRATIONNO.FieldTypeBytesNameDescriptionMemoISNullPK1.PalletZoneVarchar10*仓库编码退货仓库编码NV2.CustomidVarchar10*主客户编码默认为001NV3.SheetidVarchar20*验收单号返配验收单号NV4.

35、SERIALIDNumber20单内序号999999999999999999NV75.DEPTIDVarchar10部门对应ERP的机构号Y6.SheetTypeNumber4单据类型0=门店返配单1=行政领用退货2=批发退货单3=配送返配单（配送差异）4=虚拟返配单N7.RefSheetIDVarchar20返配单号对应门店返配单号N8.ShopidVarchar10*门店编码N9.GoodsidVarchar20*商品编码退货商品编码N10.VenderidVarchar20供货商编号供货商编码（不口重复）默认为空Y11.LotNoINT4批次号默认为0Y12.realqtyNumber1

36、2,3*实际退货数量99999999.999N13.BadQtyNumber12,3*其中坏货数量999999999.999N14.SdateDate验收日期yyyy-mm-ddN15.OperatorVarchar20执行人单据执行人员中文姓名N17.Is_DoneCHAR1Erp是否已处理0未处理1已处理默认0Y5.14 退厂通知单（ERP至WMS）对应的接口数据库表名：SDWMS_RETNO.FieldTypeBytesNameDescriptionMemoISNullPK1.PalletZoneVarchar6仓库编码退货仓库编码NV2.CustomIDVarchar3主客户编码默认为001NV3.SheetidVarchar20退货单号MIS退货通知单号（不可重复）NV4.SerialidNumber5单内序号商品于单据上的序号19999NV75.DeptIDVarchar10部门对应ERP的机构号Y6.SheettypeNumber4退货单类型0:正常退厂1:虚拟退供应商N7.VenderidVarchar20供货商编码N8.RetdateDate预定退货日期本单据预定退货日期yyyy-mm-ddN9.GoodsidVarchar20商品编码退货商品编码N10.planqtyNumber12,3预定退货数量9999999