物流接口说明文档Ver.2017年5月23 / 26文档信息文档名称物流接口说明文档文件目的物流相关接口说明文档内容简介文件控制版本记录日期作者版本变更说明2017.05.12V1.0新增审阅记录日期审阅者意见分发记录日期接受人地点目 录Ver.2017年5月1##性21.系统介绍11.1背景11.2目的11.3接口开发规范12.接口方案23.传输内容介绍33.1 物流中心需求资料交换类别33.2总部系统需求资料交换类别34.接口业务流程44.1存储进货流程44.2存储出货流程54.3直通进出货流程54.4仓库退供应商64.5门店退货单据处理74.6损益处理85.接口表结构定义95.1商品分类表95.2商品资料表95.3商品条码表115.4供应商资料115.5门店资料表135.6进货通知单145.7验收确认单155.8出货通知单165.9配送确认单175.10出货单完验185.11返配通知单195.12退配确认单215.13退厂通知单225.14退厂确认单235.15损溢单241. 系统介绍1.1 背景WMS系统与ERP采用不同的开发技术,在业务逻辑上有着一定的联系,这就需要定义接口来实现数据的交换.1.2 目的定义配送中心物流管理系统〔以下简称为WMS系统〕与ERP的接口规范和实施细节.本文将阐述以下内容：l 接口开发规范l 接口方案l 接口数据格式定义本文将重点置于两套系统所关注的接口问题,对于接口数据是如何影响系统的内部运行不作描述.1.3 接口开发规范接口开发应符合以下规范：l 满足配送中心的业务需求,便于维护和操作l 确保数据的安全,WMS与ERP系统只以接口形式交互,不直接互相读取、修改数据l 尽可能以简便的方式达到目的l WMS与ERP系统内部应保留一定时期范围的历史传入传出数据l 接口必须在模拟环境中经过严格测试后才能正式使用l 使得WMS系统和ERP的修改最小化,以保持其稳定性2. 接口方案所有接口数据以接口数据库形式生成,通过接口服务程序在WMS与ERP系统之间定时传递.如下图：导入程序从接口数据库读取数据以后,应该将所读取的数据从接口数据库中删除,并做好备份.接口的几个核心处理原理说明：n 数据交互池.系统的作用是进行双方交互数据的存储,其就像一个水池,一方导入数据到水池中,一方导出数据到相应的系统中,从而完成数据交互工作.该数据交互池可以建立在WMS系统中,可以建立在ERP系统中,也可以建立在一个独立的数据库系统中；n 数据对象.数据对象是双方进行数据交互的最小单位,由一方将数据对象生成,并导入数据交互池中,而另一方负责将数据对象进行导出,进入其系统生成相应的数据处理；数据对象可以设置为2种形式：XML文件形式或SQL数据形式；n 定时导入和定时导出.这是进行数据交互的操作,需要由一方导出生成数据对象,再由另外一方导入该数据对象进行数据处理.该操作可以根据双方定义的时间进行定期处理；n 数据监控中心.这是一个监控系统,所有在双方系统中进行交互的数据对象和数据操作都会经过其审核监控,一旦发现有异常数据或异常处理存在,其会立即进行报警,保证数据的完整性和实时性.3. 传输内容介绍3.1 物流中心需求资料交换类别NO.资料名称提供者发单周期编码备注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分钟F6.损溢确认单配送中心5分钟SM7.8.9.4. 接口业务流程1.1 存储进货流程ERP下传至存储进货单至WMS系统,wms系统根据常温与生鲜系统不同的配置对验收数量进行确认.在生鲜系统这一块,对计重商品允许超量验收.常温商品不允许超量验收.系统验收结案后,只允许一张通知单结案一次.1.2 存储出货流程ERP下传存储出货单至WMS系统,WMS系统根据常温与生鲜系统不同的配置走不同的作业流程.系统允许一张出货通知单多次产生配送单,但出货通知单完结只能回传一次.1.3 直通进出货流程ERP系统需要同时直通收货通知单与直通分配通知单同时下传至WMS系统,WMS验收完成之后自动建立对应的分播单,分播完成之后装车.系统回传时直通收货验收单与配送单信息.1.4 仓库退供应商仓库退供应商由业务中心系统发起,WMS收到退厂单,不允许超出供应商应退货数量.退货审核完成之后上传至ERP系统,并且退厂单只能回传一次.1.5 门店退货单据处理门店退货单由门店发起,WMS收到门店退货单,允许修改通知单数量.验收结案之后上传至ERP系统.并且门店退货单只能回传一次,对于差异部分,由物流生成门店虚配单上传至总部系统处理.1.6 损益处理损益包括盘点损益和手工损益盘点作业由WMS发起,盘点结案之后,系统产生全库库存上传ERP系统5. 接口表结构定义1.4 商品分类表对应的接口数据库表名：SDWMS_SGROUPNO.FieldTypeBytesNameDescriptionMemoIs NullPK1.SheetIDVarchar20*单据号N√2.CustomIDVarchar10主客户编码默认001N√3.SgroupIDVarchar20*分类编码1.部类2.课类3大类,4中类,5小类N√4.SgroupNameVarchar50品类名称N5.FgroupIDVarchar20父分类编码Y6.StatusNumber4单据状态0转入 1转出默认 0 Y7.Send_DdateDate传入时间默认sysdateY1.5 商品资料表对应的接口数据库表名：SDWMS_GOODSNO.FieldTypeBytesNameDescriptionMemoIs NullPK1.SheetidVarchar20单据号N√2.GoodsidVarchar20商品编码商品编码不可重复N√3.CustomIDVarchar10主客户编码默认001N√4.SgroupidVarchar20类别编码此处下传小类代码N5.BarcodeidVarchar20条形码商品主条形码N6.NameVarchar100品名商品名称N7.EnameVarchar100英文名称商品英文名称Y8.ABCIDVarchar1ABCABC分级默认为CY9.UnitNameVarchar20单位商品最小单位销售包装N10.PKNameVarchar20*包装单位商品主包装单位采购包装N11.PKNumNumber12,3*包装数量商品主包装数量采购包装数量N12.SpecVarchar60*规格商品规格N13.PKSpecVarchar60*包装规格包装规格物流维护14.ZBNumNumber12,3标准栈版数量标准栈版数量物流维护Y15.LengthNumber11,2长cm物流维护Y16.WidthNumber11,2宽cm物流维护Y17.HeightNumber11,2高cm物流维护Y18.WeigthNumber11,2重量KG物流维护Y19.KeepDaysint5保质天数单位：天N20.PriceNumber16,4价格销售价格N21.SupNOVarchar20*供货商编号供货商编号主供应商N22.NotesVarchar255备注Y23.STATUSNumber4*单据状态0转入 1转出默认 0 Y24.FreshdayNumber10保鲜期保鲜期天数〔单位：天〕默认为0Y25.PLU_NOVarchar20PLU码Y26.Send_DateDate传入日期sysdateY1.6 商品条码表对应的接口数据库名：SDWMS_BARCODENO.FieldTypeBytesNameDescriptionMemoISNullPK1.SheetidVarchar20单据号N√2.GoodsidVarchar20商品编码不可重复N3.CustomIDVarchar10主客户编码默认为001N√4.BarcodeidVarchar20条形码商品条形码N√5.PKNumNumber12,3包装数量。
