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

一、集成背景说明

需要注意

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

需要注意

当对接需要批号的时候，批号字段需要通过单独接口关联出来

（不建议对接批号，后面详讲《查询出库类接口委外回传的效期和批次信息》）

调用奇门接口需要奇门资质
奇门自定义接口不支持传税率，标准接口才可以传，后续会补充上去

客户需求：

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

整体方案：

二、主数据集成

需求规划：

仓库确定库存组织（两边对应的仓库编码一致，单据传递中根据仓库确认库存组织）
店铺确定销售组织（需要维护一个店铺对应的客户以及销售组织的关系表，YS自定义单据）
需要进行对接的是供应商和物料对接。从YS对接到旺店通

对接规划图

对接方案

集成方案	同步频率	取数说明	备注说明
物料集成同步-v	5min	状态：启用	1、出现部分业务错误，YS的单位没有在旺店通建立导致同步不成功
供应商集成同步-v	5min

对接建议

（1）物料不要对接辅助单位，应为YS里面的辅助单位是要勾选了启用辅助单位后才有对应的需要输入固定换算和浮动换算，后续在传递的时候经常会有问题

（2）物料批次保质期对接的时候不需要对接到旺店通，旺店通没有参数是否启用，而是在实际业务单据中填写了就能启用批号保质期

总结：方案从一开始的需要对接批号、保质期、辅助单位，调整为不需要对接。辅助类的数据尽量不要对接会导致流程复杂出错率高

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

需求规划：

销售业务统一在旺店通OMS发起并且对接到YS中生成对应的销售订单/销售出库单
销售出库单需要和销售订单进行关联
线上的订单按照：店铺、仓库，日期进行按天汇总后传递

对接规划图

对接方案

集成方案	同步频率	取数说明	备注说明
销售业务
销售出库单对接销售订单(线上)-v	00:00 拉取 02:00 写入	店铺不等于*****	1、订单合并、下推销售出库单； 2、交易类型：发出商品 3、销售出库单交易类型由销售订单带出； 4、金额由税率计算得出
销售出库单对接销售订单(线下)-v	3min(6-23)	店铺等于***	1、先生成销售订单，下推销售出库单； 2、交易类型：发出商品 3、销售类型：订单类型 4、金额由税率计算得出
网店与客户/组织映射关系	3min		重要的依赖关系，用于关联客户与销售组织。必须要在YS及时维护正确
仓库查询-v	3min		重要的依赖关系，用于关联库存组织。必须要在YS及时维护正确
单位查询-v	3min		重要的依赖关系，通过名称关联YS编码。必须要在YS及时维护正确，并且旺店通名称必须保持一致。
销售退货
退换货生成销售退货(线上)-v	3min(6-23)	1、平台类型不等于线下的（0、127）； 2、处理状态大于等于65（委外待收货、待收货、部分到货、待结算、已完成； 3、退货类型：退货、换货	1、销售类型写在表头备注； 2、关联来源单据是查询销售订单进行关联；
退换货生成销售退货(线下)-v	3min(6-23)	1、平台类型等于线下的（0、127）；处理状态大于等于65（委外待收货、待收货、部分到货、待结算、已完成； 2、退货类型：退货、换货	1、销售类型写在表头备注； 2、关联来源单据是查询销售订单；
退货入库对接YS销售出库(红字)-v	7min(6-23)		1、交易类型：销售出库 2、关联来源单据是查询销售退 3、货单；审核状态变为退货中
查询YS销售退货单-v	2min(6-23)		1、满足销售红字销售出库下推《退货入库对接YS销售出库(红字)-v》
（红字）销售出库审核-v	3min(6-23)
查询YS销售出库-v	2min		2、满足销售红字销售出库下推《新销售出库审核-v》
销售退货审核
YS销售退货审核-v	3min(6-23)	退货数量等于累计退货数量	1、审核完成状态变成已完成 2、目前按照一行一页的方式进行取数审核
查询YS销售订单-v	3min		关联销售退货单
新销售出库审核-v	3min(6-23)		红字销售出库单据审核
客户退款
退换管理客户退款-v	3min	处理状态：待结算、已完成类型：退款、退款不退货、订单补款	无

对接建议

（1）尽量不要对接销售订单，在和实施的同事沟通后发现销售订单在技术上是可以实现对接的，但是在实际对接过程中比较累赘，销售出库单对应的字段完成足够支持财务核算要求

（2）调用YS销售订单下推（销售出库来源生单）的时候三个参数一定要写 bizFlow、bizFlow_version、bizFlow_name如果一开始的时候不清楚三个值可以通过手工新增销售订单并且能正常下推后通过浏览器F12或者查询详情接口进行查看

（3）销售退货的时候这个项目会有多次入库的情况，目前YS是没有办法直接在多次入库后自动调整状态为完成状态，会一直处于收货中。所以在方案中我们添加了一个方案判断销售退货和累计入库数量一直的时候调用审核进行完成动作

（4）在YS的列表查询接口中如果涉及到反写或者是计算的字段，在查询接口调用的时候该值为空就连KEY都不会返回，了解前一直不知道有这样的情况，时而能取到值时而不行

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