YS费控服务与U8C总账集成操作手册一、集成说明1集成方式注意事项：YS总账凭证传到U8C总账，无法逆流程，删除凭证，要保持数据一致性，需手工两边同步删除。YonSuite交付事业部2YS基础数据档案和U8C数据档案基础数据无法自动同步，需要手工维护。（基础数据档案编码必须保持一致）U8C部分数据字典：U8C部分档案编码.docx二、配置流程1费控服务配置费控服务配置.pptxYonSuite交付事业部2总账服务配置总账服务配置.pptx3友企连配置3.1开通连接数据集成3.1.1连接集成服务，混合云网关，新建U8C网关，输入网关编码和网关名称。（如连接集成服务中没有方案、连接等菜单配置，需在我的应用->应用市场->搜索友企连->进行开通）默认没有集成方案配置，启动方案配置，需要按照以下步骤开通YonSuite交付事业部YonSuite交付事业部3.1.2应用市场中搜索友企连，购买友企连_YonBIP免费版YonSuite交付事业部3.1.30元购买后，重新点击连接集成服务YonSuite交付事业部3.1.4方案管理模块正常显示，说明开通成功。重新刷新界面，方案管理模块正常显示，说明开通成功。YonSuite交付事业部YonSuite交付事业部YonSuite交付事业部3.2混合云网关配置YonSuite交付事业部3.3下载友企连网关，在BIP【连接集成服务】->【数据集成】->【混合云网关】节点界面，下载网关密钥和网关安装包，在U8C所在企业环境安装友企连网关并启动。网关启动成功显示【已启动】（如之前集成友企连，此步骤可忽略）YonSuite交付事业部YonSuite交付事业部3.4连接集成服务中【连接配置】，添加连接【非ERP连接配置】YonSuite交付事业部YonSuite交付事业部新图片账套编码:U8cloud集团编码:0001ERP地址:U8C地址YonSuite交付事业部连接名称和编码自行定义网关选择新建的网关新建时集成系统不用选择。3.5连接集成服务中【集成系统配置】，新建系统关联连接选择新建的连接YonSuite交付事业部3.6连接集成服务中【启动方案配置】，点击初始化功能，选择对应的来源系统（当前YonBIP集成系统）和目标系统，上传对应的集成方案压缩包。初始化成功后会在【集成方案】【启动方案】生成对应的集成方案与启动方案。YonSuite交付事业部YonSuite交付事业部数据同步任务中搜索【voucher_scheme_u8c】或【总账集成U8C】3.7连接集成服务中【集成对象】的配置。方案初始化后，即可查看集成方案的配置及操作。其中需要注意的是接口地址及请求参数配置。https://open-api-daily.yyuap.com【daily环境】https://open-api-pre.diwork.com【预发环境】https://api.diwork.com【生成环境】YonSuite交付事业部https://open-api-dbox.yyuap.com【沙箱环境】YonSuite交付事业部请求参数因总账接口，此处是账簿Code。具体可以通过凭证查询进行查看。YonSuite交付事业部3.8连接集成服务中【数据同步任务】，生成对应的数据同步任务通过立即执行或者定时任务可以进行触发ys总账到u8c数据同步任务，通过查看日志查看同步情况YonSuite交付事业部YonSuite交付事业部YonSuite交付事业部如需创建定时任务，定时执行，可以通过创建定时任务，按照需求自行定义定时任务时间进行执行。YonSuite交付事业部三、多账簿配置如没有多账簿情况，本章节忽略有多账簿情况，需要另外新建来源系统，YonSuite交付事业部1、新建来源系统在连接集成服务中，【集成系统配置】中新增系统，选择当前连接为当前BIPYonSuite交付事业部YonSuite交付事业部2、初始化启动方案在连接集成服务中【启动方案配置】点击初始化功能，选择对应的来源系统（当前YonBIP集成系统）和目标系统，上传对应的集成方案压缩包。初始化成功后会在【集成方案】【启动方案】生成对应的集成方案与启动方案。YonSuite交付事业部点击初始化，系统会自动生成一个新的启动方案YonSuite交付事业部关闭后建议可将此启动方案名称修改加上对应的账簿名YonSuite交付事业部复制此处的启动方案编码BIP2_voucher_scheme_u8c_fgYonSuite交付事业部3、修改集成对象参数在连接集成服务中【集成对象配置】中按照上一步复制的编码找到对应的集成对象result点击编辑（注意选择本次新建的系统里查找）YonSuite交付事业部点击‘操作’页签，在query查询操作行点击编辑YonSuite交付事业部在请求参数中找到accbookcode账簿编码，修改引号中的数字改为对应的账簿编码，点击确定保存YonSuite交付事业部YonSuite交付事业部4、数据同步任务中检查新任务搜索启动方案编码【BIP2_voucher_scheme_u8c_fg】或方案名称【总账集成U8C-账薄2】（具体编码和名称按照项目生成的编码和自己编辑的名称为准）四、常见问题（有问题通过提交YS工单解决）1、凭证类型，通过汉字对应。比如U8C凭证类别为记账，需要在BIP维护成记账。YonSuite交付事业部2、制单人取值不能为空，不支持取值为空的设置删除[Administrator]:标题4,行距:最小值12磅,不对齐到网格设置格式[Administrator]:YonSuite交付事业部3、报错信息凭证根据辅助核算类型编码【0001】无法找到对应数据，问题报错提示信息如下这中报错类型的原始，基本上都是BIP的辅助核算项目的编码和U8C的不一致导致的，当前信息传进来U8C之后，U8C识别不了。即如下图标题4设置格式[Administrator]:YonSuite交付事业部这些档案的编码和U8C里面的不一致YonSuite交付事业部BIP的部门档案编码是0001，U8C里面部门档案编码是2，档案不一致，具体见第二章节。4、数据同步日志DetailMessage:Instantiateobjecterror,class….U8C没有打对应的补丁，联系U8C相关人员，打对应的补丁标题4,行距:最小值12磅,不对齐到网格设置格式[Administrator]:YonSuite交付事业部5、报错信息，下面的档案无法翻译，档案类型：操作员，档案编码15776547564，具体报错如下图：所有报错这种‘无法翻译’的问题，都是因为两边档案编码不一致，因为费控和U8C对接是按照编码进行对接的，两边编码不一致，所以U8C无法识别。操作员传值应该是U8C的登录的人，即如下图：标题4设置格式[Administrator]:YonSuite交付事业部YonSuite交付事业部6、报错信息找不到的档案列表：1、档案类型【主体账簿】，档案编码列表【999_0003】；2、档案类型【会计科目】，档案编码列表【123107，100102】；3、档案类型【凭证类别】，档案编码列表【房产】；具体报错如下图：问题原因：项目上报错之后，到U8C查看发现是一致的，项目上经常遇到这个情况，但是其实是因为没有细心检查。YonSuite交付事业部这个问题是因为费控那边的账簿编码是999_0003，U8C里面的是999-0003，这两个是不一致的，是‘下划线’和‘横线’的区别。后面的报错【会计科目】、【凭证类别】都是因为上面的账簿编码引起的。如果修改完账簿编码之后，会计科目和凭证类别还报错，再核对费控和U8C的这两个档案是否一致。YonSuite交付事业部7、凭证列表查询异常，未查询到账簿信息YonSuite交付事业部需要设置BIP账簿Code,集成对象参数Code保持一致。YonSuite交付事业部YonSuite交付事业部
