用友YonSuite与旺店通数据集成对接-技术篇1

一、集成背景说明

用友YonSuite公开API文档
https://open.diwork.com/#/doc-center/docDes/api
需要注意

1. 有关联关系的建议要用来源生单的保存接口，不然全局联查不到
2. 单据需要审核或者确认的时候需要调用保存和审核/确认两个接口（建议用友能优化自动审核参数，减少调用次数）
3. 调用列表接口的时候发现没有相关的字段没有返回记得要去查看UI模板或者是这个字段是否是反写或者计算得出（踩坑点：列表查询的时候涉及计算反写的字段如果字段是空，返回参数key都没有）
4. 每个接口都有单独的限流次数大部分的一秒2次

旺店通ERP公开API文档
https://open.wangdian.cn/qyb/open/apidoc
需要注意

1. 当对接需要批号的时候，批号字段需要通过单独接口关联出来
   （不建议对接批号，后面详讲 《查询出库类接口委外回传的效期和批次信息》）
2. 调用奇门接口需要奇门资质
3. 奇门自定义接口不支持传税率，标准接口才可以传，后续会补充上去

客户需求：
旺店通企业版结合旺店通WMS以及其他品牌的WMS（京东沧海）进行电商业务的管理，线下使用的是用友YonSuite系统进行财务和业务的核算系统，全部业务数据将汇集到用友YonSuite系统，现在需要将三套系统的相关数据进行对接打通，实现所有业务的数据可以打通，并且保证电商业务的库存和财务核算系统的数据准确。
整体方案：

二、主数据集成

需求规划：

1. 仓库确定库存组织（两边对应的仓库编码一致，单据传递中根据仓库确认库存组织）
2. 店铺确定销售组织（需要维护一个店铺对应的客户以及销售组织的关系表，YS自定义单据）
3. 需要进行对接的是供应商和物料对接。从YS对接到旺店通
   对接规划图
   
   对接方案
   
   对接建议
   （1）物料不要对接辅助单位，应为YS里面的辅助单位是要勾选了启用辅助单位后才有对应的需要输入固定换算和浮动换算，后续在传递的时候经常会有问题
   （2）物料批次保质期对接的时候不需要对接到旺店通，旺店通没有参数是否启用，而是在实际业务单据中填写了就能启用批号保质期
   总结：方案从一开始的需要对接批号、保质期、辅助单位，调整为不需要对接。辅助类的数据尽量不要对接会导致流程复杂出错率高

三、销售业务（线上、线下业务）

需求规划：

1. 销售业务统一在旺店通OMS发起并且对接到YS中生成对应的销售订单/销售出库单

2. 销售出库单需要和销售订单进行关联

3. 线上的订单按照：店铺、仓库，日期进行按天汇总后传递
   对接规划图
   
   
   对接方案
   
   
   
   对接建议
   （1）尽量不要对接销售订单，在和实施的同事沟通后发现销售订单在技术上是可以实现对接的，但是在实际对接过程中比较累赘，销售出库单对应的字段完成足够支持财务核算要求
   （2）调用YS销售订单下推（销售出库来源生单）的时候三个参数一定要写 bizFlow、bizFlow_version、bizFlow_name如果一开始的时候不清楚三个值可以通过手工新增销售订单并且能正常下推后通过浏览器F12或者查询详情接口进行查看
   （3）销售退货的时候这个项目会有多次入库的情况，目前YS是没有办法直接在多次入库后自动调整状态为完成状态，会一直处于收货中。所以在方案中我们添加了一个方案判断销售退货和累计入库数量一直的时候调用审核进行完成动作
   （4）在YS的列表查询接口中如果涉及到反写或者是计算的字段，在查询接口调用的时候该值为空就连KEY都不会返回，了解前一直不知道有这样的情况，时而能取到值时而不行

   总结：旺店通销售出库单对接到YS电商企业一定要合并，特别是日单量庞大的企业，一定不要对接批号，会导致很多数据出库出现负库存，因为批号很难和采购的对应上，所以在对接的时候尽量不要传批号