YonSuite营销管理与U8集成配置说明2021年05月(c)2021用友网络科技股份有限公司新一代云ERP解决方案2目录YonSuite营销管理与U8集成配置说明.11.流程图..错误！未定义书签。2.U8补丁安装..42.1U8ISD升级到201及以上版本.42.2U8安装补丁..43.U8初始化配置..53.1EAI配置.53.2接口设置..53.2.1.接口参数..53.2.2.店铺档案配置..83.3基础档案同步..83.3.1.客户档案..83.3.2.仓库档案..83.3.3.商品..93.3.4.基础档案同步任务..103.3.5.人员同步任务..113.3.6.商品同步任务..113.4存量同步..163.5同步日志查看..164.YS-B2B订货.174.1单据流程..174.1.1参数配置..174.2B2B单据同步..184.2.1单据同步流程..184.2.2销售订单同步U8.194.2.3出库单同步YS..22新一代云ERP解决方案34.2.4收款单同步U8.234.2.5退货单同步U8（530上线）.245.YS-B2C订单中心.255.1集成配置..255.1.1.系统参数..265.1.2.组织配置..275.1.3.ERP集成设置.285.1.4.店铺ERP配置..295.2B2C订单中心和U8业务数据同步..295.2.1.销售日报同步U8的零售日报..295.2.2.收款日报同步U8的收款单..32日期作者版本号备注2021-05-20曹吉友、李艳昌V1.0初始版本新一代云ERP解决方案41.U8补丁安装客户通过商务系统购买YS的B2C订单中心，获取登录用户、密码、session、对外企业ID后，再进行下列配置。支持对接U816.0版本。1.1.U8ISD升级到201及以上版本1.2.U8安装补丁U816.0环境安装SA、营销云适配器（UR）补丁以及平台所有补丁【后续新功能相关模块可能会同步更新补丁，为避免产生问题，请及时更新上列补丁】补丁后缀补丁对应模块SA销售管理UR营销云适配器新一代云ERP解决方案52.U8初始化配置2.1.EAI配置菜单：U8EAI接口设置功能：配置EAI接口设置，包括EAI数据源，外部系统注册，用于和YonSuite的业务单元进行对照。2.2.接口设置2.2.1.接口参数 菜单：U8基础设置-业务参数-供应链-混合云设置-营销云接口设置 功能：启用产品：选B2C订单中心或BIP销售订单新一代云ERP解决方案6填写AppKey、AppSecret获取路径：YonSuite-连接集成服务—API管理—调用API操作：添加新一代云ERP解决方案7API授权—新增API（选择用友开放API）※需要选择用友YonBIP下的数字化建模、采购供应下的批次号、现存量下的所有项。接口默认值：销售管理设置制单人，用于B2C订单中心的销售日报生成U8零售日报的制单人。销售管理设置业务员，用于B2C订单中心的销售日报生成U8零售日报的业务员。公共选项设置：商品分类是否同步营销云（勾选则进行同步）仓库是否同步营销云（勾选则仓库属性包含电商仓的仓库进行同步）新一代云ERP解决方案8部门是否同步营销云（勾选则进行同步）部门档案进同步仅适用零售部门（勾选则仅同步适用零售的部门）供应商是否同步营销云（可不勾选）2.2.2.店铺档案配置 功能：营销云设置启用产品B2C订单中心或BIP销售订单时，会自动建立平台=YS的店铺档案，用于基础档案的同步。2.3.基础档案同步2.3.1.客户档案 菜单：U8基础设置—基础档案-客户分类、客户级别、客户档案 同步：客户属性为内销的客户。2.3.2.仓库档案 菜单：U8基础设置—基础档案-仓库档案 同步：仓库属性为电商仓的仓库。新一代云ERP解决方案92.3.3.商品 存货档案菜单：U8基础设置—基础档案-存货分类、计量单位、存货档案功能：新增或修改存货档案注：一定要有“适用零售”或内销属性才可同步。 商品档案菜单：U8基础设置-业务参数-供应链-混合云设置-商品同步功能：根据存货档案生成商品档案，功能：根据存货档案生成商品档案，点击生成店铺商品，用于同步至YB的物料档案。新一代云ERP解决方案10※表体的YS商品编码和YS商品SKU可以手工修改，按YS商品编码和YS商品SKU同步YS。YS商品编码=YS中的物料编码YS商品SKU=YS中的SKU编码2.3.4.基础档案同步任务 功能：将基础档案信息同步至YonSuite的数字化建模，可以设置相应定时任务。 菜单：预警与通知-预警定时任务-公共服务-基础档案自动增量同步营销云 同步范围：商品分类、记录单位组、计量单位、自由项、部门、客户分类、客户级别、客户档案、结算方式、发运方式、供应商分类、供应商档案、仓库档案。新一代云ERP解决方案112.3.5.人员同步任务 功能：将基础档案信息同步至YonSuite的数字化建模下的各档案，可以设置相应定时任务，包括人员类和人员。 菜单：预警与通知-预警定时任务-公共服务-人员信息自动增量同步营销云2.3.6.商品同步任务 功能：将存货同步至YonSuite的数字化建模的物料档案，可以设置相应定时任务（B2C订单中心使用数字化建模—基础数据—物料—物料档案） 同步步骤：1、在U8同步商品档案中，根据存货+自由项生成商品档案，再生成YS店铺的商品档案。2、通过“预警与通知-预警定时任务-公共服务-基础档案自动增量同步营销云”定时任务，同步商品分类、计量单位、自由项（包括自由项和自由项的值）到基础服务的商品中心。基础档案对照关系:1）菜单：YS—数字化建模——基础设置—物料下的物料规格、计量单位菜单。2）存货分类：同步YS—数字化建模—基础设置—物料分类（同级同步），物料分类只有三级，如果U8存货分类不超过3级直接同步；超过3级，一级、二级和末级分类进行同步；商品分类需要勾选参数“营销云接口设置—公共选项—商品分类是否下发至营销云”进行同步。新一代云ERP解决方案12对应关系：物料分类U8-存货分类备注上级上级分类名称分类名称分类编码分类编码商品分类和商品档案默认同步YonSuite的企业账号级（创建组织）。3）计量单位：同步到计量单位中。注：需要同步的商品，包含固定和无换算率计量单位组中的所有单位进行同步。不支持同步浮动换算率计量单位组和计量单位。商品中心—计量单位U8-计量单位备注编码编码名称名称商家编码编码物料档案的主单位：对应U8同步商品的分销单位，默认为U8主计量单位，可手工修改要货单位：对应U8同步商品的要货单位，默认为U8存货档案的销售单位，可手工修改（换图）新一代云ERP解决方案13注：U8不同的计量单位组可能存在多个名称相同的计量单位，U8下发到商品中心时会下发多个，拼接计量单位组的名称，如商品_个。4）自由项，同步到商品规格中。商品中心—商品规格U8-存货自由项备注规格名称自由项名称规格编码自由项编码（如cFree1）用商家编码记录对应关系规格名称自由项名称表体规格值名称自由项值同步后：新一代云ERP解决方案14注：自由项同步成功以后会自动在U8基础设置-业务参数-供应链-混合云-营销云自定义项对照表中，增加对应的对照关系，不要手工点删除。3、商品分类中选择商品模板，存在有自由项的存货需要同步时，必须在商品分类中选择商品模板（带商品规格），否则同步存货后显示不出SKU信息。4、通过“预警与通知-预警定时任务-公共服务-商品档案自动增量同步”定时任务同步商品信息。存货同步后会按商品分类中的模板进行显示。（如果手工已在商品档案中建立商品，同步时不覆盖商品模板和商品信息）新一代云ERP解决方案15注：1、基础档案只支持从U8同步基础服务，不支持基础服务同步U8（包括基础服务手工新增的商品）。2、销售渠道默认默认显示线上批发、线上零售。3、同步后的基础档案，u8进行修改，修改后需要再次同步基础服务进行更新。4、同步后的基础档案，不要在U8中手工删除，否则会导致业务单据同步失败。5、商品对应关系：YB物料编码=U8YS商品编码YB物料名称=U8YS商品名称YBSKU编码=U8YS商品SKU6、套件结构不进行同步，需要在YS—数字化建模—基础设置—套件—套件商品结构中，手工创建套件商品结构。新一代云ERP解决方案162.4.存量同步 菜单：预警与通知-预警定时任务-公共服务-存量自动同步营销云 功能：将U8存量同步至YonSuite的库存服务，可以设置相应定时任务注：1、不同步仓库属性包含门店仓的存量。2、第一次同步存量为全量同步，后续同步为增量同步，发生存货变化才同步。3、同步存量包括现存量、预计入库量和预计出库量。2.5.同步日志查看 菜单：U8基础设置-业务参数-供应链-混合云设置-营销云同步日志新一代云ERP解决方案173.YS-B2B订货3.1.单据流程3.1.1参数配置 服务启用：U8基础设置-业务参数-供应链-混合云设置-营销云接口设置 操作：1、勾选“BIP销售订单”新一代云ERP解决方案182、填写AppKey、AppSecret（同基础档案设置）3、填写销售订单下载规则 订单下载提前天数：订单下载定时任务下载的订单时间范围，以任务运行时间前N天为准，为空时仅下载当天订单，例如设置订单下载提前天数为3，2021-05-14日订单下载定时任务执行时下载订单【审核】时间为2021-05-11； 收款单下载提前天数：收款单下载定时任务下载的收款单单据时间范围，以任务运行时间前N天为准，为空时仅下载当天收款单； 默认销售类型编码：本版本支持“普通销售”订单同步。3.2B2B单据同步3.2.1单据同步流程新一代云ERP解决方案193.2.2销售订单同步U8 功能：YS销售订单【审核】后，通过U8定时任务“销售订单下载”下载到U8，生成“审核态”销售订单。 操作步骤：1、手工下载：U8路径为混合云设置-销售服务订单下载选择交易确认时间，选择交易单号后，点击【确定】新一代云ERP解决方案20支持按照订单【审核】时间范围以及订单单号查询、下载说明：手工下载中根据“交易编号”下载时，YS对应销售订单未审核也会被下载。2、自动下载：U8路径为“预警和定时任务”-定时任务源-销售管理，选择“订单下载”新增订单下载任务。新一代云ERP解决方案21创建U8“订单下载”定时任务，设置任务执行周期、下次执行时间；YS订单【审核】后，手工执行U8定时任务或者待定时任务自动执行；定时任务执行完成后可以在“销售管理”中查看已下载销售订单；注意：本版本销售订单下载U8后，任意端修改订单不会更新，如果要修改订单，需要删除U8销售订单后在YS中弃审销售订单再修改，修改完成并审核后，重新下载销售订单；3、日志查询新一代云ERP解决方案223.2.3出库单同步YS 功能：U8销售订单发货、出库，在出库单审核后，同步生成YS销售出库单。 操作步骤新一代云ERP解决方案23创建U8“销售出库单上传”定时任务，设置任务执行周期、下次执行时间；U8对来源YS的销售订单出库单审核后，执行U8“销售出库单上传”定时任务或等待定时任务自动执行；任务执行完成后会生成YS销售出库单，门户端可查看当前订单发货状态以及发货信息；当U8出库单由多个销售订单合并发货、出库时，会根据来源订单拆分上传，生成YS多个销售出库单;当U8出库单【弃审】时，会实时删除已上传YS对应的销售出库单，YS由U8上传的销售出库单不允许删除;当YS销售出库单在门户端【签收】后，销售出库单不允许删除，即U8出库单不允许【弃审】;交易类型对应关系：U8出库单出库类别即收发类别编码应保持与YS销售出库单交易类型编码一致3.2.4收款单同步U8 功能：YS收款单审核后，通过U8“收款单下载”任务，下载到U8生成待审核的收款单 操作步骤：新一代云ERP解决方案24创建U8“收款单下载”定时任务，设置任务执行周期、下次执行时间；YS收款单【审核】后，手工执行U8定时任务或者待定时任务自动执行；收款单下载按照YS收款单表体下载，下载范围“款项类型”为“应收款”、“预收款”类型；注意：本版本收款单下载后，单据在任意方修改不会进行同步，如修改收款单，需要手工删除U8收款单后再进行YS单据修改3.2.5退货单同步U8（530上线） 功能：YS退货单【确认】后，通过U8“退货单下载”任务，下载到U8生成销售退货单 操作步骤：创建U8“退货单下载”定时任务，设置任务执行周期、下次执行时间；YS退货单【确认】后，手工执行U8定时任务或者待定时任务自动执行；注意：本版本退货单下载U8后，退货发货需要各自在U8、YS进行处理新一代云ERP解决方案254.YS-B2C订单中心4.1.对接流程B2C订单中心作为YonSuite（后续简称YS）中的重要模块，面向U8客户提供公有云应用服务，帮助企业U8系统实现与第三方电商平台、支付平台、仓储和物流平台数据信息对接，并在线进行订单审核、打单、发货等业务处理。新一代云ERP解决方案264.2.集成配置4.2.1.系统参数 菜单：YS–B2C服务-B2C订单中心-系统参数 功能：设置ERP混合云集成为是，进行U8对接；选择否时，YS本身就是一套ERP系统，可独立使用。 功能：系统参数配置—ERP系统选择U8，设置ERP账号、密码（可任意输入）和数据源新一代云ERP解决方案27※ERP系统账号对应系统编码，数据源对应U8账套4.2.2.组织配置 菜单：YS-基础服务-组织 功能：基础服务—组织中业务单元编码对应U8EAI接口系统编码，B2C订单中心的一个组织对应U8一个账套，支持多账套对接。 支持多组织，按定时任务所在账套找YS的业务单元。注：基础档案同步时，相同编码的档案不要同时进行同步，同步后会进行覆盖，支持不同组织的不同档案进行同步。新一代云ERP解决方案284.2.3.ERP集成设置 菜单：YS–B2C服务-B2C订单中心-ERP集成设置 功能：配置销售日报及收款日报集成 配置内容：销售日报的同步表单编码ec_salesdailyrpt动作ERP同步urlhttp://10.10.12.40/DataConversionCenterServer/api/common/convertjsontou8data（其中10.10.12.40换成对应U8服务器地址）过程convertjsontou8data收款日报的同步表单编码ec_coldailyrpt动作ERP同步urlhttp://10.10.12.40/DataConversionCenterServer/api/common/convertjsontou8data（其中10.10.12.40换成对应U8服务器的地址）过程convertjsontou8data新一代云ERP解决方案294.2.4.店铺ERP配置 菜单：YS—B2C订单中心-店铺管理-店铺档案 功能：设置店铺配置，不填会导致销售日结失败。客户ERP编码：U8中菜单【客户档案】中存在的未停用客户编码部门ERP编码：U8中菜单【部门】中存在的部门编码4.3.B2C订单中心和U8业务数据同步4.3.1.销售日报同步U8的零售日报 功能：将B2C订单中心的销售日报同步给U8，在U8中生成零售日报、销售发货单、销售出库单。 操作步骤：1、YS—B2C订单中心—业务参数——日结相关：参数说明：参数参数说明日报生成方式汇总：按组织ID+店铺+客户+日期汇总订单或退换货单生成销售日报，表体按仓库+商品汇总；按客户+单据日期汇总生成收款新一代云ERP解决方案30日报明细：一个订单或退换货单生成一张销售日报；一张收款单生成一张收款日报销售日报生成时点发退货即时生成：订单发货、退换货单入库（售后仅退款，退换货单审核）生成销售日报手工生成：手工进行销售日结固定时点生成：选择生成日报的时点，按选择时点生成销售日报收款日报生成时点手工生成：手工进行收款日结固定时点生成：选择生成日报的时点，按选择时点生成收款日报2、订单发货后，通过手动或自动生成销售日报。（换图）3、退款类型为“退款”的售后退换货单，审核后，通过手动或自动生成销售日报。4、退款类型为“退货”或“换货”的退换货单，入库后，通过手动或自动生成销售日报。5、报表中心-交换信息查询，查看日报是否推送成功；也可查看销售日报列表中的交换状态字段。（换图）新一代云ERP解决方案316、推送成功的日报，在U8中查看相应单据。6、推送失败的，报表中心-交换信息查询中可查询错误信息，可以进行重发。新一代云ERP解决方案327、售后仅退款的销售日报，生成退补类型的零售日报。8、U商城储值订单生成的销售日报，销售类型从店铺档案的卡券业务类型中取值。9、推送成功的销售日报不允许删除。注：1、生成U8零售日报，不受U8可用量控制，同时生成零售日报、销售发货单（销售退货单）、销售出库单。2、生成U8零售日报，不受“销售生成出库单”选项控制，未勾选“销售生成出库单”，仍生成销售出库单3、生成U8零售日报，不受允限销控制。4、U8零售日报表头的备注中会记录“***销售日报生成“。5、电商通销售日报的数量对应计量单位为零售单位，生成U8零售日报时，数量对应关系如下：无换货率存货数量=销售日报的数量固定换算率存货件数=销售日报的数量数量=件数*换算率（零售单位对应的换算率）6、销售日报表体的是否卡券订单为“是”时，生成零售日报的销售类型从店铺档案的卡券业务类型中取值。4.3.2.收款日报同步U8的收款单 功能：将B2C订单中心的收款日报同步给U8，在U8中生收款单。 操作步骤：1、订单发货后，打开财务管理—电商对账单，导入或下载电商对账单。2、财务管理—收款核对，勾选单据，进行勾对，勾对成功生成收款单。3、打开收款日报，通过手工收款日结或自动日结，生成收款日报。新一代云ERP解决方案334、报表中心-交换信息查询，查看收款日报是否推送成功。5、处理成功的收款日报，可在U8应收管理—收款单查询，查看生成的收款单信息。收款单默认为已审核状态。6、推送失败的，报表中心-交换信息查询错误原因，可以进行重发。推送成功的收款日报不允许删除。
