浪潮GS接口程序操作说明书.docx
《浪潮GS接口程序操作说明书.docx》由会员分享，可在线阅读，更多相关《浪潮GS接口程序操作说明书.docx（11页珍藏版）》请在冰点文库上搜索。
一、库存单据生成接口
库存单据生成接口功能用于把第三方中间表的数据批量生成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、默认值设置
暂时未提供前台定义功能，需要后台预置。
按照公司+移动类型进行预置，默认字段存放的均为内码。
CreatetableIMBillInterFaceDefault
（
CompanyIDvarchar（30）,/*公司*/
MovetypeIDvarchar（10）,/*移动类型*/
DefaultOrgIDvarchar（20）,/*默认库存组织*/
DefaultWHIDvarchar（20）,/*默认仓库*/
DefaultBusinessTypevarchar（20）,/*默认业务类型*/
DefaultSalesOrgIDvarchar（20）/*默认销售组织*/
）
InsertintoIMBillInterFaceDefaultvalues（'0101','201','00000000000000000003','00000000000000000077','00000000000000000019','00000000000000000001'）
1.6、单据生成分组规则
l暂时未提供前台定义功能，需要后台预置。
按照公司+移动类型进行预置。
l系统本身会强制根据移动类型、来源类型、红蓝标志、公司、组织、仓库，销售出库单会增加销售组织、部门、业务员、客户进行分组，如果项目有其它特殊要求，需要在分组依据表中进行预置，比如项目上要求按照源单据编号进行分组
InsertintoIMBillInterFaceGroupRolevalues（'0101','104','SourceBillCode'）
项目自行增加的分组字段，必须在表IMBillInterFaceTemp中存在，若是多个字段，使用“,”进行分割。
/*分组依据表*/
CreatetableIMBillInterFaceGroupRole
（
CompanyIDvarchar（30）,/*公司*/
MovetypeIDvarchar（10）,/*移动类型*/
GroupFieldvarchar（1000）/*分组字段*/
）
1.7、自定义项处理
l库存单据表头、表体、分录各分别预留了4个字符型和4个数值型自定义项。
命名规则为表头为H_Customfiled1~H_Customfiled8,表体为I_Customfiled1~I_Customfiled8，辅助为A_Customfiled1~A_Customfiled8。
使用时，项目上通过自定义的视图赋予不同的自定义项含义，同时通过【界面格式设置】定义其显示名称。
l如果需要把某个设置的自定义值保存到库存单据上，需要在【自定义项对应表】中设置对应关系。
比如销售出库单把H_Customfield1的值存到GS库存单据表头自定义项Customfield2中，需要做如下预置：
InsertintoIMBillInterFaceCustomFieldvalues（'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、菜单位置
供应链-销售管理-销售单据生成接口-销售订单生成。
1.2、操作说明
1）初始界面
l点击【GO】按钮，进行数据刷新。
l勾选要生成单据的数据，点击【数据检查】按钮，系统会对数据规范性进行检查，并将检查结果显示在【信息】列。
如果检查通过，以√显示。
l检查不通过的数据，允许操作者在列表界面对数据进行修改或者维护补充，目前系统只支持自定义项字段修改。
l点击【数据检查】按钮后，选择的数据将被锁定，只有点击【生成单据】后或者是点击【GO】按钮重新刷新数据后，才可以解锁。
l当选择多条记录时，系统会根据定义的规则进行对数据进行分组合并生成一张或者几张单据。
2）
l数据检查通过后，点击【生成单据】按钮，生成成功后，根据提示点击【是】进入单据制单界面可以对单据进行调整。
l【指定单据生成日期】：
选择此开关时，单据生成的日期以选择的单据生成日期为准。
3）
【生成状态】切换到已生成时，可以通过【联查单据】和【修改单据】查看和修改生成的单据。
4）
当点击【自动生成】后，系统将自动刷新数据，自动生成销售订单。
1.3、界面格式设置
用户可以自定义列表显示内容。
1.4、系统参数说明
【销售订单生成业务日期】：
单据生成时业务日期使用来源单据日期还是服务器日期
【单据保存控制】:
当单据分录有错误时，是否允许剔除错误信息后保存单据
【销售订单自动审核】：
销售订单是否自动审核
【自动生成时间间隔】：
自动生成单据时的时间间隔，单位为秒
1.5、单据生成分组规则
l暂时未提供前台定义功能，需要后台预置。
l系统本身会强制根据单据类型、公司、组织、渠道、部门、业务员、客户进行分组，如果项目有其它特殊要求，需要在分组依据表中进行预置，比如项目上要求按照源单据编号进行分组
insertintoSalesOrderInterFaceGroupRole（CompanyID,GroupField）values（'','SourceBillCode'）
项目自行增加的分组字段，必须在表SalesOrderInterFaceTemp中存在，若是多个字段，使用“,”进行分割。
1.6、自定义项处理
l销售订单表头、表体、分录各分别预留了5个字符型和4个数值型自定义项。
命名规则为表头为HCustomfiled1~Hcustomfiled9,表体为ICustomfiled1~Icustomfiled9。
使用时，项目上通过自定义的视图赋予不同的自定义项含义，同时通过【界面格式设置】定义其显示名称。
l如果需要把某个设置的自定义值保存到销售订单上，需要在【自定义项对应表】中设置对应关系。
比如把HCustomfield1的值存到GS销售订单表头自定义项Customfield2中，需要做如下预置：
InsertintoIMBillInterFaceCustomField
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订单的数据进行预处理。
升级会员 