浪潮GS接口程序操作说明指导书.docx

一、 库存单据生成接口库存单据生成接口功效用于把第三方中间表数据批量生成GS库存单据。因为各项目中间表结构不一样，需求不一样。可经过少许二次开发（关键是数据源获取视图和生成后回写存放过程），和少许数据预置，达成快速生成库存单据目标。现在支持移动类型有手工销售出库单、参考销售提单生成出库单、手工生产入库单、其它出库单、其它入库单。接口适用环境：序号环境说明1中间表和GS在同一个数据库中正常运行，能够确保生成和回写同时提议2中间表和GS在同一个数据库服务，不一样数据库正常运行，能够确保生成和回写同时提议3中间表和GS在局域网内不一样服务器正常运行，需要使用dblink，可能出现生成GS单据成功，但回写失败情况不提议4中间表和GS在广域网不一样服务器暂不支持1.1、 菜单位置供给链-库存管理-货物移动-库存单据生成接口。1.2、 操作说明1) 初始界面2)l 在初始界面选择【企业】设置过滤条件，点击【EXCEL数据导入】按钮，进入数据导入界面。点击【上传】按钮，找到要导入EXCEL文件。导入数据会显示在目前列表中。l 点击【保留】按钮进行数据检验和保留操作。检验经过数据，会在错误信息栏以显示，不然会提醒犯错误信息。假如全部数据全部检验经过，系统会提醒【保留成功，请返回主界面生成库存单据】，不然会提醒【数据检验完成，但存在不正当数据，请修改】。l 对于检验未经过数据，系统支持在界面对数据进行手工修改，修改完目前页数据后，点击【GO】按钮进行刷新操作后，系统会保留用户修改后数据，继续点击【保留】按钮进行数据检验，直到全部数据全部检验经过。l 假如选中【库存组织】和【仓库】前复选框，系统会以用户选择库存组织和仓库为准，进行数据检验并保留到中间表中。3)l 回到主界面后，设置对应过滤条件，点击【GO】按钮，进行数据刷新。l 勾选要生成库存单据数据，点击【数据检验】按钮，系统会对数据规范性进行检验，并将检验结果显示在【信息】列。假如检验经过，以显示。l 检验不经过数据，许可操作者在列表界面对数据进行修改或维护补充，现在系统只支持自定义项字段修改。l 点击【数据检验】按钮后，选择数据将被锁定，只有点击【生成单据】后或是点击【GO】按钮重新刷新数据后，才能够解锁。l 当选择多条统计时，系统会依据定义规则进行对数据进行分组合并生成一张或几张单据。4)l 数据检验经过后，点击【生成单据】按钮，生成成功后，依据提醒点击【是】进入单据制单界面能够对单据进行调整。l 【指定单据生成日期】：选择此开关时，单据生成日期以选择单据生成日期为准。5)【生成状态】切换到已生成时，能够经过【联查单据】和【修改单据】查看和修改生成库存单据。6)当点击【自动生成】后，系统将自动刷新数据，自动生成库存单据。1.3、 界面格式设置用户能够自定义每一个移动类型列表显示内容。1.4、 系统参数说明【采购入库自动生成批号】：采购入库单时假如批号不存在，则自动生成批号。【生产入库自动生成批号】：生成生产入库单时假如批号不存在，则自动生成批号。【库存单据生成业务日期】：库存单据生成时业务日期使用起源单据日期还是服务器日期【销售出库自动获取批号】: 生成销售出库单时自动依据近失效日期先出标准获取批号【单据保留控制】: 当单据分录有错误时，是否许可剔除错误信息后保留单据【出库单价格计算规则】：生成销售出库单时价格和金额换算规则：,依据价格计算金额;1,依据金额计算单价【库存单据是否自动记账】：库存单据是否自动记账否是【自动生成时间间隔】：自动生成单据时时间间隔，单位为秒【用户】：选择TY,通用即可。【EXCEL导入时覆盖已存在数据】：依据移动类型+单据编号覆盖已存在数据，假如已经生成GS库存单据，则不覆盖不导入。1.5、 默认值设置临时未提供前台定义功效，需要后台预置。根据企业+移动类型进行预置，默认字段存放均为内码。Create table IMBillInterFaceDefault(CompanyID varchar(30),/*企业*/MovetypeID varchar(10),/*移动类型*/DefaultOrgID varchar(20),/*默认库存组织*/DefaultWHID varchar(20),/*默认仓库*/DefaultBusinessType varchar(20),/*默认业务类型*/DefaultSalesOrgID varchar(20)/*默认销售组织*/)Insert into IMBillInterFaceDefault values(0101,201,00000003,00000077,00000019,00000001)1.6、 单据生成份组规则l 临时未提供前台定义功效，需要后台预置。根据企业+移动类型进行预置。l 系统本身会强制依据移动类型、起源类型、红蓝标志、企业、组织、仓库，销售出库单会增加销售组织、部门、员工、用户进行分组，假如项目有其它特殊要求，需要在分组依据表中进行预置，比如项目上要求根据源单据编号进行分组Insert into IMBillInterFaceGroupRole values(0101,104,SourceBillCode)项目自行增加分组字段，必需在表IMBillInterFaceTemp中存在，若是多个字段，使用“,”进行分割。/*分组依据表*/Create table IMBillInterFaceGroupRole(CompanyID varchar(30),/*企业*/MovetypeID varchar(10),/*移动类型*/GroupField varchar(1000) /*分组字段*/)1.7、 自定义项处理l 库存单据表头、表体、分录各分别预留了4个字符型和4个数值型自定义项。命名规则为表头为H_Customfiled1H_Customfiled8,表体为I_Customfiled1 I_Customfiled8，辅助为A_Customfiled1 A_Customfiled8。使用时，项目上经过自定义视图给予不一样自定义项含义，同时经过【界面格式设置】定义其显示名称。l 假如需要把某个设置自定义值保留到库存单据上，需要在【自定义项对应表】中设置对应关系。比如销售出库单把H_Customfield1值存到GS库存单据表头自定义项Customfield2中，需要做以下预置：Insert into IMBillInterFaceCustomField values(IMGM201,Goodsmovement,H_Customfield1,Customfield2)/*自定义项对应表*/Create table IMBillInterFaceCustomField(ClassSetCode varchar(10),/*移动类型*/ActTable varchar(60),/*所在表位置*/SourceName varchar(60),/*接口字段名称*/TargetName varchar(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、 菜单位置供给链-销售管理-销售单据生成接口-销售订单生成。1.2、 操作说明1) 初始界面l 点击【GO】按钮，进行数据刷新。l 勾选要生成单据数据，点击【数据检验】按钮，系统会对数据规范性进行检验，并将检验结果显示在【信息】列。假如检验经过，以显示。l 检验不经过数据，许可操作者在列表界面对数据进行修改或维护补充，现在系统只支持自定义项字段修改。l 点击【数据检验】按钮后，选择数据将被锁定，只有点击【生成单据】后或是点击【GO】按钮重新刷新数据后，才能够解锁。l 当选择多条统计时，系统会依据定义规则进行对数据进行分组合并生成一张或几张单据。2)l 数据检验经过后，点击【生成单据】按钮，生成成功后，依据提醒点击【是】进入单据制单界面能够对单据进行调整。l 【指定单据生成日期】：选择此开关时，单据生成日期以选择单据生成日期为准。3)【生成状态】切换到已生成时，能够经过【联查单据】和【修改单据】查看和修改生成单据。4)当点击【自动生成】后，系统将自动刷新数据，自动生成销售订单。1.3、 界面格式设置用户能够自定义列表显示内容。1.4、 系统参数说明【销售订单生成业务日期】：单据生成时业务日期使用起源单据日期还是服务器日期【单据保留控制】: 当单据分录有错误时，是否许可剔除错误信息后保留单据【销售订单自动审核】：销售订单是否自动审核【自动生成时间间隔】：自动生成单据时时间间隔，单位为秒1.5、 单据生成份组规则l 临时未提供前台定义功效，需要后台预置。l 系统本身会强制依据单据类型、企业、组织、渠道、部门、员工、用户进行分组，假如项目有其它特殊要求，需要在分组依据表中进行预置，比如项目上要求根据源单据编号进行分组insert into SalesOrderInterFaceGroupRole(CompanyID,GroupField) values(,SourceBillCode)项目自行增加分组字段，必需在表SalesOrderInterFaceTemp中存在，若是多个字段，使用“,”进行分割。1.6、 自定义项处理l 销售订单表头、表体、分录各分别预留了5个字符型和4个数值型自定义项。命名规则为表头为HCustomfiled1Hcustomfiled9,表体为ICustomfiled1 Icustomfiled9。使用时，项目上经过自定义视图给予不一样自定义项含义，同时经过【界面格式设置】定义其显示名称。l 假如需要把某个设置自定义值保留到销售订单上，需要在【自定义项对应表】中设置对应关系。比如把HCustomfield1值存到GS销售订单表头自定义项Customfield2中，需要做以下预置：Insert into IMBillInterFaceCustomField values( 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订单数据进行预处理。