浪潮GS接口程序操作说明书(20210412143243)

1、浪潮GS接口程序操作说明书库存单据生成接口库存单据生成接口功能用于把第三方中间表 的数据批量生成GS库存单据。由于各项目中间 表结构不同，需求不同。可通过少量的二次开发 （主要是数据源获取视图和生成后回写存储过 程），以及少量的数据预置，达到快速生成库存 单据的目的。目前支持的移动类型有手工销售出库单、参照 销售提单生成出库单、手工生产入库单、其它出 库单、其它入库单。接口适用的环境:序 号环境说明1中间表与GS在同 一个数据库中正常运行，能够 保证生成与回写 同步建议2中间表与GS在同 一个数据库服务， 不同的数据库正常运行，能够 保证生成与回写 同步建议3中间表与GS在局 域网内不同的服正

2、常运行，需要 使用dblink，可不建 议务器能出现生成GS 单据成功，但回 写失败的情况4中间表与GS在广域网不同的服务 器暂不支持1.1、菜单位置供应链-库存管理-货物移动-库存单据生成接 口。1.2、操作说明1）初始界面2)财|容口科:鴉:蚩 MB DU釧 W魅；Mim 4-K wur43hMW* 4ETF41Pt匹申H * i 鼻）贾LW: 理K J:f Em1iL 1HL2Di4?nff*養甬卫MnH-M*P虬却*MgIB*E弁培IP 卑层肛DDT rislW 嵐* iiiHMT2D14I mE 加訓 丄4押L 55 J在初始界面选择【公司】设置过滤条件，点击【EXCEL数据导入】按

3、钮，进入数据导入界面。 点击【上传】按钮，找到要导入的EXCELS件。 导入的数据会显示在当前列表中。点击【保存】按钮进行数据检验和保存操作。 检验通过的数据，会在错误信息栏以显示， 否则会提示出错误信息。如果所有的数据全部 检查通过，系统会提示【保存成功，请返回主 界面生成库存单据】，否则会提示【数据检验 完毕，但存在不合法数据，请修改】。对于检验未通过的数据，系统支持在界面对数 据进行手工修改，修改完当前页的数据后，点 击【GO按钮进行刷新操作后，系统会保存用 户修改后的数据，继续点击【保存】按钮进行数据检验，直到所有的数据全部检验通过。如果选中【库存组织】和【仓库】前的复选框， 系统会以

4、用户选择的库存组织和仓库为准，进 行数据检验并保存到中间表中。3)回到主界面后，设置相应的过滤条件，点击【GO按钮，进行数据刷新。勾选要生成库存单据的数据，点击【数据检查】 按钮，系统会对数据规范性进行检查，并将检 查结果显示在【信息】列。如果检查通过，以 显示。检查不通过的数据，允许操作者在列表界面对 数据进行修改或者维护补充，目前系统只支持自定义项字段修改。点击【数据检查】按钮后，选择的数据将被锁定，只有点击【生成单据】后或者是点击【GO按钮重新刷新数据后，才可以解锁。当选择多条记录时，系统会根据定义的规则进 行对数据进行分组合并生成一张或者几张单4)数据检查通过后，点击【生成单据】按钮，

5、生 成成功后，根据提示点击【是】进入单据制单 界面可以对单据进行调整。【指定单据生成日期】：选择此开关时，单据 生成的日期以选择的单据生成日期为准。5)【生成状态】切换到已生成时，可以通过【联查 单据】和【修改单据】查看和修改生成的库存单 据。6)当点击【自动生成】后，系统将自动刷新数据， 自动生成库存单据。1.3、界面格式设置削!林贰初iiia 幢辟歹口 -住曰击tthrSlE-鰹氏中出宾 PUft AH1A轉年酬淳韋垮TtfEM-应曰HM时刊VJIC 卡ML|I * 电 Bi ill用户可以自定义每一种移动类型的列表显示内 容。1.4、系统参数说明严I是冷代萃鷗z *affl*nw*r-.

6、hHLii* EWimnri-*irs0rtiwI讪石Ffi己列典Wi-EaUlHK-ii* Afiaujait 蚩弭H【米购入库自动生成批号】：米购入库单时如果 批号不存在，则自动生成批号。【生产入库自动生成批号】：生成生产入库单时 如果批号不存在，则自动生成批号。【库存单据生成业务日期】：库存单据生成时业 务日期使用来源单据日期还是服务器日期【销售出库自动获取批号】：生成销售出库单时自动根据近失效日期先出的原则获取批号【单据保存控制】：当单据分录有错误时，是否 允许剔除错误信息后保存单据【出库单价格计算规则】：生成销售出库单时价 格和金额换算规则：，根据价格计算金额;1,根据 金额计算单价

7、【库存单据是否自动记账】：库存单据是否自动 记账否是【自动生成时间间隔】：自动生成单据时的时间 间隔，单位为秒【用户】：选择TY,通用即可。【EXCEL导入时覆盖已存在数据】：根据移动类 型+单据编号覆盖已存在的数据，如果已经生成 GS库存单据，则不覆盖不导入。1.5、默认值设置暂时未提供前台定义功能，需要后台预置。按照 公司+移动类型进行预置，默认字段存放的均为 内码。Create table IMBilllnterFaceDefault(CompanyID varchar (30),/* 公司 */MovetypeID varchar (10),/* 移动类型 */DefaultOrgID

8、 varchar (20),/* 默认库存组织 */DefaultWHID varchar (20),/* 默认仓库 */DefaultBusinessType varchar (20),/* 默认业务类型 */DefaultSalesOrgID varchar (20 )/* 默认销售组织 */Insert into IMBilllnterFaceDefaultvalues (0101，201 ,00000000000000000003，00000000000000000077，00000000000000000019 ,00000000000000000001)1.6、单据生成分组规则暂时

9、未提供前台定义功能，需要后台预置。按 照公司+移动类型进行预置。系统本身会强制根据移动类型、来源类型、红 蓝标志、公司、组织、仓库，销售出库单会增 加销售组织、部门、业务员、客户进行分组， 如果项目有其它特殊要求，需要在分组依据表 中进行预置，比如项目上要求按照源单据编号 进行分组Insert into IMBilllnterFaceGroupRole values (0101，104 ,SourceBillCode ) 项目自行增加的分组字段，必须在表 IMBillInterFaceTemp 中存在，若是多个字段，使用“，”进行分割。/*分组依据表*/Create table IMBilll

10、nterFaceGroupRole(CompanyID varchar (30 ),/* 公司 */MovetypeID varchar (10),/* 移动类型 */GroupField varchar (1000 ) /* 分组字段 */)1.7、自定义项处理库存单据表头、表体、分录各分别预留了 4个 字符型和4个数值型自定义项。命名规则为表头为 H_Customfiled1H_Customfiled8,表体为 l_Customfiled1 l_Customfiled8 ，辅助为 A Customfiled1 A Customfiled8 。使用时，项目上通过自定义的视图赋予不同的自定 义

11、项含义，同时通过【界面格式设置】定义其 显示名称。如果需要把某个设置的自定义值保存到库存单据上，需要在【自定义项对应表】中设置对应关系。比如销售出库单把 H_Customfield1的值存到GS库存单据表头自定义项Customfield2中，需要做如下预置：Insert into IMBilllnterFaceCustomFieldvalues (IMGM201 ,Goodsmovement ,H_Customfield1 ,Customfield2 )/*自定义项对应表*/Create table IMBilllnterFaceCustomField(ClassSetCode varchar

12、 (10),/* 移动类型 */ActTable varchar (60 ),/* 所在表位置 */SourceName varchar (60),/* 接口字段名称 */TargetName varchar (60 ) /* 对应库存单据字段 */)1.8、项目自定义部分1、源数据视图支持针对每一种移动类型定义源数据视图，源数据视图定义好后，在表IMBillInterFaceMovetype中的ViewName 字段中进行预制。2、存储过程ERP_IMBilllnterFace_SetData :此过程用于获取生成库存单据所需的而中间表不能够提供的内容， 比如物料是否进行批次管理、税率、移动

13、类型属性等基本信息，比如中间表提供了提单编号和提单分 录，关联提单取客户、部门、业务员等。ERP_IMBilllnterFace_WriteChecklnfo:点击【数据检查】按钮触发，用于把检查的结果，比如错误信息回写回中间表中。ERP_IMBilllnterFace_WriteErrorlnfo:用户回写保存过程中岀现的错误。ERP_IMBilllnterFace_DeleteData:录不允许删除。删除数据的存储过程，项目自己定义，需要增加已生成单据的记ERP_IMBilllnterFace_ProcessDataExO :项目上个性化的数据检查接口 ，在数据整理前调用 ERP_IMBi

14、lllnterFace_ProcessDataEx :项目上个性化的数据检查接口 ，在数据整理后调用。 ERP IMBilllnterFace ProcessExcelExO : EXCEL 导入时给用户开放的自定义接口。ERP_IMBilllnterFace_Writelnfo:单据正式生成后，回写中间表相关字段。Erp_IM_GMBillEx_WriteBacklnfo:识。库存单据保存处理，从这里定义单据删除时同步源数据表相关标1.9、项目自增加字段如果需要增加标准视图没有提供的字段，一种 简单的方式是直接借用某一个自定义字段。另一种方式是同步在【源数据视图】、【ERP_IMBillln

15、terFace_GetSourceData数据列表获取存储过程】、【IMBilllnterFaceTemp数据表】中增加相同名称的字段。同时预置一下列表显示字段。自定义项不支持分组;销售订单生成接口菜单位置供应链-销售管理-销售单据生成接口 -销售订 单生成1.2、操作说明1）初始界面点击【GO按钮，进行数据刷新。勾选要生成单据的数据，点击【数据检查】按 钮，系统会对数据规范性进行检查，并将检查 结果显示在【信息】列。如果检查通过，以 显/示。检查不通过的数据，允许操作者在列表界面对 数据进行修改或者维护补充，目前系统只支持 自定义项字段修改。点击【数据检查】按钮后，选择的数据将被锁 定，只有

16、点击【生成单据】后或者是点击【GO 按钮重新刷新数据后，才可以解锁。当选择多条记录时，系统会根据定义的规则进 行对数据进行分组合并生成一张或者几张单2)W*-：上科览壮盂：I iKviflnm囱皿1虫| - 血“加 也卧#：1=tv-f牌paa L1J_RTxirrtjMrtifl蚱*眄mm irwwiwa |mm |mh-Fl*l ?1EJ4-LL33kihk.女 *h jjBEOcLDamJftSTRdi* 数据检查通过后，点击【生成单据】按钮，生 成成功后，根据提示点击【是】进入单据制单 界面可以对单据进行调整。【指定单据生成日期】：选择此开关时，单据 生成的日期以选择的单据生成日期为准

17、。3)中着 环二丘牛二Wftvtiwa 盟僵_ tihta* 曲I - MliMLJL 磁.J wH! _二 iink_ *= _阳 .b專畫 iEfl- EU十段记期甬fc ； i i. 口 闌椁.函t Mum M科叮tjCh葩tvwip沙1.-M&tBHS-WrCTff!?iBL*WKtLl HiitaAuliiMk!陆电仃事m也可HT-tiT*234WMLff-aaL413ZLPtflT*1HHL4I1LMErttn*315耳皿：IHLr-dQ【生成状态】切换到已生成时，可以通过【联查单据】和【修改单据】查看和修改生成的单据4):中有C fVJ-RT If-nfi4?乏宝哥旦 |T出忡只

18、鼻二5& HLn?= I.*畀u环 尹mar: | _ 严.4.11 工 腔.IMWhi 事 | “ 耳 o W V$l : M解叱i A- i- / I 口 汕,当点击【自动生成】后，系统将自动刷新数据，自动生成销售订单。1.3、界面格式设置唔V Ot-!ay临*扈-存址|?坦誣丹 皿僧區理-；理活订里a -iMiT# ihT愛理轉h耶胃4 4WTWTV)* MMTIMI -iM订甲抄ELIHtilSWLl Ml* I4K#S林E1山窖户咚青-Stt Mb出-理用户可以自定义列表显示内容。1.4、系统参数说明* MiTrirnT)賂曽1甲0则It崛褐倍寺皐【销售订单生成业务日期】：单据生成时

19、业务日 期使用来源单据日期还是服务器日期【单据保存控制】：当单据分录有错误时，是否 允许剔除错误信息后保存单据【销售订单自动审核】：销售订单是否自动审核 【自动生成时间间隔】：自动生成单据时的时间 间隔，单位为秒1.5、单据生成分组规则暂时未提供前台定义功能，需要后台预置。 系统本身会强制根据单据类型、公司、组织、 渠道、部门、业务员、客户进行分组，如果项 目有其它特殊要求，需要在分组依据表中进行 预置，比如项目上要求按照源单据编号进行分 组insert into SalesOrderlnterFaceGroupRole (CompanylD ,GroupField )values (，Sou

20、rceBillCode )项目自行增加的分组字段，必须在表SalesOrderlnterFaceTemp中存在，若是多个字段，使用进行分割1.6、自定义项处理销售订单表头、表体、分录各分别预留了 5个 字符型和4个数值型自定义项。命名规则为表 头为 HCustomfiled1Hcustomfiled9, 表体为ICustomfiled1 Icustomfiled9 。使用时，项 目上通过自定义的视图赋予不同的自定义项含义，同时通过【界面格式设置】定义其显示名称如果需要把某个设置的自定义值保存到销售订单上，需要在【自定义项对应表】中设置对应关系。比如把 HCustomfieldl的值存到GS销售订单表头自定