一、集成背景说明
用友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系统，现在需要将三套系统的相关数据进行对接打通，实现所有业务的数据可以打通，并且保证电商业务的库存和财务核算系统的数据准确。
整体方案：
天猫商城淘宝拼多多抖音京东商城线下经销商业务平台旺店通WMS旺店通京东沧海仓OMS出入库管理第三方库存售后服务精细库存作业出入库管理线下订单管理智能拣货配货轻易云数据治理分发数据链路追溯异构数据融合QCLOUD用友YONSUITE管理成本核算管理主数据管理存货核算管理系统基石新财税管理阿米巴经营结算财务会计中心
用友YS与电商旺店通ERP对接整体方案
二、主数据集成
需求规划：
1仓库确定库存组织（两边对应的仓库编码一致，单据传递中根据仓库确认库存组织）
2店铺确定销售组织（需要维护一个店铺对应的客户以及销售组织的关系表，YS自定义单据）
3需要进行对接的是供应商和物料对接。从YS对接到旺店通
对接规划图
主数据流转流程流程说明旺店通(OMS)YONSUITE以YS作为主数据源,物料档案自动生成货品档案同步到对应的旺店通,并且不能轻易修改关键的编码,名称字段.删除的时候需供应商自动生成供应商要两边同时删除或者作废.正常ERP的主数据参数会比较多客户编码映射店铺仓库编码映射仓库销售组织编码映射店铺货主组织编码映射仓库
对接方案
集成方案 | 同步频率 | 取数说明 | 备注说明 |
物料集成同步-v | 5min | 状态：启用 | 1、出现部分业务错误，YS的单位没有在旺店通建立导致同步不成功 |
供应商集成同步-v | 5min |
对接建议
（1）物料不要对接辅助单位，应为YS里面的辅助单位是要勾选了启用辅助单位后才有对应的需要输入固定换算和浮动换算，后续在传递的时候经常会有问题
（2）物料批次保质期对接的时候不需要对接到旺店通，旺店通没有参数是否启用，而是在实际业务单据中填写了就能启用批号保质期
总结：方案从一开始的需要对接批号、保质期、辅助单位，调整为不需要对接。辅助类的数据尽量不要对接会导致流程复杂出错率高
三、销售业务（线上、线下业务）
需求规划：
1销售业务统一在旺店通OMS发起并且对接到YS中生成对应的销售订单/销售出库单
2销售出库单需要和销售订单进行关联
3线上的订单按照：店铺、仓库，日期进行按天汇总后传递
对接规划图
线上销售业务流转流程旺店通(OMS)流程说明旺店通(WMS)YONSUITE线上销售是旺店通获销售订单销售出库取各个平台的销售数据按店铺,仓库,存货汇总传输的方式传输数据,线上平台的销售订单销售出库单销售退货数据也是按数据合井后自动生成明细的方式进行传输.需要先调用销售自动生成订单的保存-提交-审核接口后,触发调用销销售出库单售出库来源生单接,关联生成销售出口,库单退换货单退货入库单销售退货自动生成(已审核)销售出库退货入库单自动生成(红字)退换货单退款单自动生成
线下销售业务流转流程(手工单)旺店通(OMS)流程说明旺店通(WMS)YONSUITE销售订单销售出库线下业务包括手工单销售订单已审核业务需要在旺店并且区分好类型区分线上自动生成和线下订单调用不同自动生成的接口,线下的直接对接订单明细,并且关联出库明细销售出库单销售出库退换货单销售退货单自动生成自动关联退货入库单销售出库单退货入库单自动生成(红字)(入库)
对接方案
集成方案 | 同步频率 | 取数说明 | 备注说明 |
销售业务 | |||
销售出库单对接销售订单(线上)-v | 00:00 拉取 | 店铺不等于***** | 1、订单合并、下推销售出库单； |
销售出库单对接销售订单(线下)-v | 3min(6-23) | 店铺等于*** | 1、先生成销售订单，下推销售出库单； |
网店与客户/组织映射关系 | 3min | 重要的依赖关系，用于关联客户与销售组织。 | |
仓库查询-v | 3min | 重要的依赖关系，用于关联库存组织。 | |
单位查询-v | 3min | 重要的依赖关系，通过名称关联YS编码。 | |
销售退货 | |||
退换货生成销售退货(线上)-v | 3min(6-23) | 1、平台类型不等于线下的（0、127）； | 1、销售类型写在表头备注； |
退换货生成销售退货(线下)-v | 3min(6-23) | 1、平台类型等于线下的（0、127）； | 1、销售类型写在表头备注； |
退货入库对接YS销售出库(红字)-v | 7min(6-23) | 1、交易类型：销售出库 | |
查询YS销售退货单-v | 2min(6-23) | 1、满足销售红字销售出库下推《退货入库对接YS销售出库(红字)-v》 | |
（红字）销售出库审核-v | 3min(6-23) | ||
查询YS销售出库-v | 2min | 2、满足销售红字销售出库下推《新销售出库审核-v》 | |
销售退货审核 | |||
YS销售退货审核-v | 3min(6-23) | 退货数量等于累计退货数量 | 1、审核完成状态变成已完成 |
查询YS销售订单-v | 3min | 关联销售退货单 | |
新销售出库审核-v | 3min(6-23) | 红字销售出库单据审核 | |
客户退款 | |||
退换管理客户退款-v | 3min | 处理状态：待结算、已完成 | 无 |
对接建议
（1）尽量不要对接销售订单，在和实施的同事沟通后发现销售订单在技术上是可以实现对接的，但是在实际对接过程中比较累赘，销售出库单对应的字段完成足够支持财务核算要求
（2）调用YS销售订单下推（销售出库来源生单）的时候三个参数一定要写 bizFlow、bizFlow_version、bizFlow_name如果一开始的时候不清楚三个值可以通过手工新增销售订单并且能正常下推后通过浏览器F12或者查询详情接口进行查看
（3）销售退货的时候这个项目会有多次入库的情况，目前YS是没有办法直接在多次入库后自动调整状态为完成状态，会一直处于收货中。所以在方案中我们添加了一个方案判断销售退货和累计入库数量一直的时候调用审核进行完成动作
（4）在YS的列表查询接口中如果涉及到反写或者是计算的字段，在查询接口调用的时候该值为空就连KEY都不会返回，了解前一直不知道有这样的情况，时而能取到值时而不行
总结：旺店通销售出库单对接到YS电商企业一定要合并，特别是日单量庞大的企业，一定不要对接批号，会导致很多数据出库出现负库存，因为批号很难和采购的对应上，所以在对接的时候尽量不要传批号
前宣基础资料.30341.蓝图确法宽求1.2修订过程1.3最终实现销售业务..2.1蓝图确认需求2.2修订过程122.3最终实现163.采购业务262663................................................................................................监控备来3.2修订过程263.3最终实现3435调拨业务...4.1蓝图确认需求354.2修订过程374.3最终实现405,报损业务..415.1蓝图确认需求4152参江过程,425.3最终安现.....42426,生产开单业务.6.1蓝图确认需求426.2修订过程4446.3最终实现...................4447,盘点业务..4907.1蓝图确认需求497.2修订过程49Z.3最终实现50
