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

一、库存单据生成接口库存单据生成接口功能用于把第三方中间表的数据批量生成GS库存单据。由于各项目中间表结构不同，需求不同。可通过少量的二次开发（主要是数据源获取视图和生成后回写存储过程），以及少量的数据预置，达到快速生成库存单据的目的。目前支持的移动类型有手工销售出库单、参照销售提单生成出库单、手工生产入库单、其它出库单、其它入库单。接口适用的环境：序号环境说明1中间表与GS在同一个数据库中正常运行，能够保证生成与回写同步建议2中间表与GS在同一个数据库服务，不同的数据库正常运行，能够保证生成与回写同步建议3中间表与GS在局域网不同的服务器正常运行，需要使用dblink，可能出现生成GS单据成功，但回写失败的情况不建议4中间表与GS在广域网不同的服务器暂不支持1.1、菜单位置供应链-库存管理-货物移动-库存单据生成接口。1.2、操作说明1)初始界面2)●在初始界面选择【公司】设置过滤条件，点击【EXCEL数据导入】按钮，进入数据导入界面。点击【上传】按钮，找到要导入的EXCEL文件。导入的数据会显示在当前列表中。●点击【保存】按钮进行数据检验和保存操作。检验通过的数据，会在错误信息栏以√显示，否则会提示出错误信息。如果所有的数据全部检查通过，系统会提示【保存成功，请返回主界面生成库存单据】，否则会提示【数据检验完毕，但存在不合法数据，请修改】。●对于检验未通过的数据，系统支持在界面对数据进行手工修改，修改完当前页的数据后，点击【GO】按钮进行刷新操作后，系统会保存用户修改后的数据，继续点击【保存】按钮进行数据检验，直到所有的数据全部检验通过。●如果选中【库存组织】和【仓库】前的复选框，系统会以用户选择的库存组织和仓库为准，进行数据检验并保存到中间表中。3)●回到主界面后，设置相应的过滤条件，点击【GO】按钮，进行数据刷新。●勾选要生成库存单据的数据，点击【数据检查】按钮，系统会对数据规性进行检查，并将检查结果显示在【信息】列。如果检查通过，以√显示。●检查不通过的数据，允许操作者在列表界面对数据进行修改或者维护补充，目前系统只支持自定义项字段修改。●点击【数据检查】按钮后，选择的数据将被锁定，只有点击【生成单据】后或者是点击【GO】按钮重新刷新数据后，才可以解锁。●当选择多条 记录 混凝土 养护记录下载土方回填监理旁站记录免费下载集备记录下载集备记录下载集备记录下载 时，系统会根据定义的规则进行对数据进行分组合并生成一或者几单据。4)●数据检查通过后，点击【生成单据】按钮，生成成功后，根据提示点击【是】进入单据制单界面可以对单据进行调整。●【指定单据生成日期】：选择此开关时，单据生成的日期以选择的单据生成日期为准。5)【生成状态】切换到已生成时，可以通过【联查单据】和【修改单据】查看和修改生成的库存单据。6)当点击【自动生成】后，系统将自动刷新数据，自动生成库存单据。1.3、界面格式设置用户可以自定义每一种移动类型的列表显示容。1.4、系统参数说明【采购入库自动生成批号】：采购入库单时如果批号不存在，则自动生成批号。【生产入库自动生成批号】：生成生产入库单时如果批号不存在，则自动生成批号。【库存单据生成业务日期】：库存单据生成时业务日期使用来源单据日期还是服务器日期【销售出库自动获取批号】:生成销售出库单时自动根据近失效日期先出的原则获取批号【单据保存控制】:当单据分录有错误时，是否允许剔除错误信息后保存单据【出库单价格计算规则】：生成销售出库单时价格和金额换算规则：,根据价格计算金额;1,根据金额计算单价【库存单据是否自动记账】：库存单据是否自动记账否是【自动生成时间间隔】：自动生成单据时的时间间隔，单位为秒【用户】：选择TY,通用即可。【EXCEL导入时覆盖已存在数据】：根据移动类型单据编号覆盖已存在的数据，如果已经生成GS库存单据，则不覆盖不导入。1.5、默认值设置暂时未提供前台定义功能，需要后台预置。按照公司移动类型进行预置，默认字段存放的均为码。CreatetableIMBillInterFaceDefault  (CompanyIDvarchar(30),/*公司*/MovetypeIDvarchar(10),/*移动类型*/DefaultOrgIDvarchar(20),/*默认库存组织*/DefaultWHIDvarchar(20),/*默认仓库*/DefaultBusinessTypevarchar(20),/*默认业务类型*/DefaultSalesOrgIDvarchar(20)/*默认销售组织*/)InsertintoIMBillInterFaceDefaultvalues('0101','201','003','077','019','001')1.6、单据生成分组规则●暂时未提供前台定义功能，需要后台预置。按照公司移动类型进行预置。●系统本身会强制根据移动类型、来源类型、红蓝标志、公司、组织、仓库，销售出库单会增加销售组织、部门、业务员、客户进行分组，如果项目有其它特殊要求，需要在分组依据表中进行预置，比如项目上要求按照源单据编号进行分组InsertintoIMBillInterFaceGroupRolevalues('0101','104','SourceBillCode')项目自行增加的分组字段，必须在表IMBillInterFaceTemp中存在，若是多个字段，使用“,”进行分割。/*分组依据表*/CreatetableIMBillInterFaceGroupRole(CompanyIDvarchar(30),/*公司*/MovetypeIDvarchar(10),/*移动类型*/GroupFieldvarchar(1000)/*分组字段*/)1.7、自定义项处理●库存单据表头、表体、分录各分别预留了4个字符型和4个数值型自定义项。命名规则为表头为H_Customfiled1~H_Customfiled8,表体为I_Customfiled1~I_Customfiled8，辅助为A_Customfiled1~A_Customfiled8。使用时，项目上通过自定义的视图赋予不同的自定义项含义，同时通过【界面格式设置】定义其显示名称。●如果需要把某个设置的自定义值保存到库存单据上，需要在【自定义项对应表】中设置对应关系。比如销售出库单把H_Customfield1的值存到GS库存单据表头自定义项Customfield2中，需要做如下预置：Insert intoIMBillInterFaceCustomFieldvalues('IMGM201','Goodsmovement','H_Customfield1','Customfield2')/*自定义项对应表*/CreatetableIMBillInterFaceCustomField(ClassSetCodevarchar(10),/*移动类型*/ActTablevarchar(60),/*所在表位置*/SourceNamevarchar(60),/*接口字段名称*/TargetNamevarchar(60)/*对应库存单据字段*/)1.8、项目自定义部分1、源数据视图支持针对每一种移动类型定义源数据视图，源数据视图定义好后，在表IMBillInterFaceMovetype中的ViewName字段中进行预制。2、存储过程ERP_IMBillInterFace_SetData：此过程用于获取生成库存单据所需的而中间表不能够提供的容，比如物料是否进行批次管理、税率、移动类型属性等基本信息，比如中间表提供了提单编号和提单分录，关联提单取客户、部门、业务员等。ERP_IMBillInterFace_WriteCheckInfo：点击【数据检查】按钮触发，用于把检查的结果，比如错误信息回写回中间表中。ERP_IMBillInterFace_WriteErrorInfo:用户回写保存过程中出现的错误。ERP_IMBillInterFace_DeleteData:删除数据的存储过程，项目自己定义，需要增加已生成单据的记录不允许删除。ERP_IMBillInterFace_ProcessDataEx0：项目上个性化的数据检查接口,在数据整理前调用。ERP_IMBillInterFace_ProcessDataEx：项目上个性化的数据检查接口,在数据整理后调用。ERP_IMBillInterFace_ProcessExcelEx0：EXCEL导入时给用户开放的自定义接口。ERP_IMBillInterFace_WriteInfo：单据正式生成后，回写中间表相关字段。Erp_IM_GMBillEx_WriteBackInfo:库存单据保存处理，从这里定义单据删除时同步源数据表相关标识。1.9、项目自增加字段如果需要增加标准视图没有提供的字段，一种简单的方式是直接借用某一个自定义字段。另一种方式是同步在【源数据视图】、【ERP_IMBillInterFace_GetSourceData数据列表获取存储过程】、【IMBillInterFaceTemp数据表】中增加相同名称的字段。同时预置一下列表显示字段。自定义项不支持分组；二、销售订单生成接口1.1、菜单位置供应链-销售管理-销售单据生成接口-销售订单生成。1.2、操作说明1)初始界面●点击【GO】按钮，进行数据刷新。●勾选要生成单据的数据，点击【数据检查】按钮，系统会对数据规性进行检查，并将检查结果显示在【信息】列。如果检查通过，以√显示。●检查不通过的数据，允许操作者在列表界面对数据进行修改或者维护补充，目前系统只支持自定义项字段修改。●点击【数据检查】按钮后，选择的数据将被锁定，只有点击【生成单据】后或者是点击【GO】按钮重新刷新数据后，才可以解锁。●当选择多条记录时，系统会根据定义的规则进行对数据进行分组合并生成一或者几单据。2)●数据检查通过后，点击【生成单据】按钮，生成成功后，根据提示点击【是】进入单据制单界面可以对单据进行调整。●【指定单据生成日期】：选择此开关时，单据生成的日期以选择的单据生成日期为准。3)【生成状态】切换到已生成时，可以通过【联查单据】和【修改单据】查看和修改生成的单据。4)当点击【自动生成】后，系统将自动刷新数据，自动生成销售订单。1.3、界面格式设置用户可以自定义列表显示容。1.4、系统参数说明【销售订单生成业务日期】：单据生成时业务日期使用来源单据日期还是服务器日期【单据保存控制】:当单据分录有错误时，是否允许剔除错误信息后保存单据【销售订单自动审核】：销售订单是否自动审核【自动生成时间间隔】：自动生成单据时的时间间隔，单位为秒1.5、单据生成分组规则●暂时未提供前台定义功能，需要后台预置。●系统本身会强制根据单据类型、公司、组织、渠道、部门、业务员、客户进行分组，如果项目有其它特殊要求，需要在分组依据表中进行预置，比如项目上要求按照源单据编号进行分组insertintoSalesOrderInterFaceGroupRole(CompanyID,GroupField)values('','SourceBillCode')项目自行增加的分组字段，必须在表SalesOrderInterFaceTemp中存在，若是多个字段，使用“,”进行分割。1.6、自定义项处理●销售订单表头、表体、分录各分别预留了5个字符型和4个数值型自定义项。命名规则为表头为HCustomfiled1~Hcustomfiled9,表体为ICustomfiled1~Icustomfiled9。使用时，项目上通过自定义的视图赋予不同的自定义项含义，同时通过【界面格式设置】定义其显示名称。●如果需要把某个设置的自定义值保存到销售订单上，需要在【自定义项对应表】中设置对应关系。比如把HCustomfield1的值存到GS销售订单表头自定义项Customfield2中，需要做如下预置：Insert intoIMBillInterFaceCustomFieldvalues('SalesOrder','SalesOrders','HCustomfield1','Customfield2')1.7、项目自定义部分1、存储过程ERP_SalesOrderInterFace_WriteCheckInfo：点击【数据检查】按钮触发，用于把检查的结果，比如错误信息回写回中间表中。ERP_SalesOrderInterFace_WriteErrorInfo:用户回写保存过程中出现的错误。ERP_SalesOrderInterFace_DeleteData:删除数据的存储过程，项目自己定义，需要增加已生成单据的记录不允许删除。ERP_SalesOrderInterFace_ProcessDataEx0：项目上个性化的数据检查接口,在数据整理前调用。ERP_SalesOrderFace_ProcessDataEx：项目上个性化的数据检查接口,在数据整理后调用。ERP_SalesOrderInterFace_WriteInfo：单据正式生成后，回写中间表相关字段。ERP_SalesOrderInterFace_CuExWR_WriteBackBills:销售订单保存处理，从这里定义单据删除时同步源数据表相关标识。ERP_SalesOrderInterFace_BeforeGetSourceData:获取销售订单列表前调用，用户可以对中间表未生成GS订单的数据进行预处理。