产品同步自动生成多规格商品

背景

当产品同步,涉及到商品、规格、规格值等同步时,如果需要每个对象对接,同步过程中的数据转换和处理逻辑比较复杂,这导致了集成流配置非常复杂,对同步过程问题的排查也很困难。基于此,SFA团队增加支持仅通过新增产品,自动生成商品、规格、规格值。集成平台同步进行了适配。简化多规格产品的对接流程。

方案描述

  • 仅同步到CRM的【产品】对象
  • 将规格、规格值信息,以固定格式同步到【产品】对象的规格属性字段product_spec
  • 接口提供方将根据【产品名称】和【规格属性】,解析,匹配或生成商品、规格、规格值

发布节奏和灰度

CRM侧:灰度功能,有需求请联系相应产品经理。
集成平台:适配代码灰度中,预计3月中旬全网。另外有历史企业名单控制,新对接企业才可直接使用该方案,如果测试接口报错可提工单联系研发值班从名单中去除。

对接指南

产品名称

CRM接口会将相同名称的产品归为同一个商品的不同规格的产品。
对接上保持原来的产品名称,CRM商品名称使用第三方系统产品名称,产品名称使用第三方系统产品名称拼接规格值;
使用该特性的产品,不允许修改产品名称!
使用该特性的产品,不允许修改产品名称!
使用该特性的产品,不允许修改产品名称!

规格属性字段

外部接口,或者项目中使用函数,构建出固定格式的规格属性字段。
格式:规格1:规格值1;规格2:规格值2。如:size:lg;color:blue。(:和;都是英文符号,规格和规格值中不允许出现这两个符号)
数据要求:相同产品名称的值,将认为是同一个商品的不同规格,所以接口提供的相同名称产品,需要具有相同数量和名称的规格。
比如对下表数据,1、2、3、6任意组合都是合法数据,1、2、3任一个和4、5任一个组合,都是非法数据。
序号 产品名称规格属性
1电视机size:65;color:blue
2电视机size:55;color:blue
3电视机size:55;color:red
4电视机size2:25;color:red
5电视机size:25;color:red;h:44
6电视机2size:25;color:red;h:44
7电视机3 
8电视机4111
由于CRM接口限制,使用该特性将不允许对接无规格属性的产品,解决方案是使用默认值赋值默认的规格和规格值。如上表数据7,如果未配置默认值为不合法数据。
规格属性必须按格式包含规格和规格值,如上表数据8,为不合法数据

示例

配置如下:主要是规格属性字段,需要配置默认值(自己随意按上面描述的格式配置)。
部分同步数据如下
CRM结果如下

迁移指南

对于历史企业,对接方案比较多,无法平滑迁移,需要每个项目具体分析。这里后续记录下每种迁移方案。

FAQ

  1. 报错:必填字段商品名称未填写不可进行当前操作。未申请CRM接口的灰度,或者该企业在集成平台历史企业名单内。
  2. 使用该功能是否允许修改产品名称。暂不支持
  3. 使用该功能是否支持调整规格名称或规格值名称并同步。暂不支持,需要人工介入处理
  4. 使用该功能是否允许增加商品的规格。暂不支持,需人工介入处理(两边刷数据)
  5. 是否支持修改产品的规格属性(由属性1换到属性2)。不支持,会报错:规格属性不支持修改
  6. 报错:规格属性不支持修改。见上问
  7. 报错:商品(erp->crm)策略明细没有创建,请先创建商品(erp->crm)的策略明细,创建完不用启用。该企业在集成平台历史企业名单内。可提工单申请移除。
  8. 报错:缺少规格属性。规格属性值为空或者规格属性不符合规则,规则见上方说明。
  9. 修改产品名称后同步,字段映射这里改了,但是看调用详情,写接口没传name这个字段。使用该特性不支持修改产品名称,所以从平台屏蔽了产品名称字段修改。
2024-03-04
0 0