1 文档使用说明
本文适用纷享销客CRM与金蝶云星空（企业版）的集成，可以实现 金蝶云星空（企业版）对象 数据同步到 纷享销客CRM对象 或将 纷享销客CRM对象 数据同步到 金蝶云星空（企业版）对象。本文档适用对象：实施顾问、技术顾问、销售经理、CSM等；
2 金蝶云星空（企业版）连接器实施配置
2.1 实施前置条件
实施前，请确认：客户已下单开通了 集成平台产品，并联系值班开发配置 系统集成平台 菜单；
2.2 实施配置
2.2.1 金蝶云星空（企业版）配置
进入云星空，配置连接账号权限，确保该账号具备对接单据的增删查改权限。
2.2.2 集成平台配置
2.2.2.1 连接授权
进入管理后台>系统集成平台>授权配置 菜单，点击右上角的 新建连接授权，连接器选择 K3 Cloud连接器，新建 按提示填写账号授权，如下图：
确认无误后，点击 连接授权 即完成了云星空的连接。
2.2.2.2 配置中间表
目前 系统集成平台 数据映射关系存储到自定义对象。在配置集成流前，先创建自定义对象，创建时，配置主属性为自增编号，其他的按默认即可，保存新建。
进入系统集成平台>工具>数据存储，点击修改符号，弹窗选择刚刚创建的自定义对象绑定。确认后，系统集成平台将自动在选择的自定义对象添加5个字段（字段名称：映射数据分组、映射数据ID1、主属性1、映射数据ID2、主属性2）；
修改 数据存储 绑定的自定义对象，（已存在的）数据映射不会自动迁移，需要手动先导出再导入新绑定的自定义对象迁移数据；
注意：数据映射关系是同步的关键信息，为避免避免数据被误改，强烈建议配置该对象仅管理员角色可见。
集成流编排配置中间表节点
数据同步完成之后，需要保存数据映射关系，可以在集成流最后配置创建映射动作节点：
映射节点可以配置多组，可以通过 映射数量 的值控制写入多少组映射。每组映射，根据 映射数据分类、映射数据ID1、映射数据ID2 三个数据确定唯一的一个映射关系。
与云星空（企业版）集成时，受对方接口特性约束（查询数据需要传数据的编码，但是更新数据需要传数据的ID），建议每组数据映射保存ID和编码的映射关系，以便按需使用。
如订单同步后数据映射配置：
订单数据ID映射关系配置示例
订单数据编码映射关系配置示例
特别说明，如果是明细的数据映射关系，需要使用pluck公式循环写映射关系（应为明细为数组结构，里面有多条明细，需要遍历执行映射写入）。
订单明细数据ID映射关系配置示例
2.2.2.3 配置集成流
数据创建和更新是否拆分说明
目前，系统集成平台将外部系统动作做了拆分，用户可以按需自行配置是新增还是更新，且新增和更新的配置是独立的，即用户可以分开配置新增、更新不同的字段。而对于高频对接的云星空和CRM系统，连接器也支持合并的动作配置（CRM新建/更新动作合一，云星空保存/提交/审核动作合一），但需要写节点的配置步骤里面配置ID查询公式（如果是主从结构，需要分别配置）。同步时，会根据查询结果来判断是走新增接口还是走更新接口。
集成流配置方案示意
ERP→CRM ID查询公式示例：云星空发货单同步到CRM发货单的ID配置：
发货单主数据的ID查询（注：截图为示例配置，可根据实际调整分类名称和字段）
发货单明细数据的ID查询（注：截图为示例配置，可根据实际调整分类名称和字段）
CRM→CRM ID查询公式示例：云星空发货单同步到CRM发货单的ID配置：
联系人主数据的ID查询（注：截图为示例配置，可根据实际调整分类名称和字段）
集成流配置示例：
组织集成流同步配置
组织机构同步trigger配置
组织机构同步action配置
组织机构同步映射配置
物料分组集成流配置示例
物料分组同步trigger配置
物料分组同步action配置
物料分组同步映射配置
物料集成流配置示例：
物料同步trigger配置
物料同步action配置
如果需要同步基准单位，则继续配置单位映射：
物料同步映射配置
多单位同步示例
多单位同步trigger配置
多单位同步action配置
多单位同步映射配置
客户集成流配置示例
客户同步trigger配置
客户同步action配置
客户同步映射配置
联系人集成流配置示例
订单集成流配置示例
订单同步trigger配置
订单同步action配置
订单同步映射配置
2.2.2.4 数据同步及历史数据核对
调试过程中，配置完集成流发布后，可以在列表点击 立即同步 触发数据同步，验证配置是否正确。
集成流验证无误后，拉取历史数据时，可以在工具>历史数据同步 创建同步任务：
任务开始执行后，可以进入 读取日志 查看任务执行情况，包括历史任务读取基本信息、接口读取速度、异常接口等信息。用户可以下载 异常接口 的信息，按数据核对指引 来排查缺漏数据；
读取日志 仅记录任务读取接口的情况，数据读取后会在 运行监控>Trigger日志 记录，并在 Trigger数据快照 记录每条数据快照。相同数据将不再触发集成流同步。
3 FAQ
1、配置过程中，常用的公式有哪些？
·日期转换公式：
星空日期转换为CRM时间戳字段：date2long(xxx,"yyyy-MM-dd'T'HH:mm:ss","ms")
CRM时间戳转换为星空日期字段：long2date (1743565200000,yyyy-MM-dd HH:mm:ss"ms")转换的输出结果为"2026-04-02 10:00:00"
·人员字段转换：tuple(x），多个字符串转换为数组 ["x"]，CRM人员字段为字符串数组格式，映射时需注意数组与单值的转换。
·单选字段：CRM接收的是value，ERP接收的也是选项编码。
选项少可以使用公式：let result = path("['trigger']['objectFieldVal']['gender']");result =="1" ? "SEX01_SYS":"SEX02_SYS"
选项多则通过在数据映射表建立映射关系，或者CRM的选项value和ERP选项值一样直接做字段配置即可。
完整公式使用指引详见：https://help.fxiaoke.com/d0c3/55fb
2、依赖关系怎么配置？
下面以物料分组为例，同步的时候，上级物料分类没有同步过来的时候，需要等待上级物料分组先同步过来，再同步改物料分组。
方法：增加映射等待节点，该节点会在30分钟内不断查询依赖集成流关联数据的同步情况，如果查到后就会往下流转
从对象的等待映射：这块注意，由于涉及多个明细，需要用到公式：pluck
3、获取指定组织客户如何配置？
4、配置了查找中间表公式但是值没有转换或转换后报错
1.先检查该节点输入时，这个字段有没有传值，没有传值的话：
1）检查第一个参数，查找的分类名称是否填写正确
2）检查第二个参数表达式是否选择正确
3）检查第三个参数，查找的数据id是否正确
如果有值的话：
1）确认查找到的id在目标系统存在，比如查找到的crm的数据，那这条数据是否在crm还存在
常见场景有，同步了数据后，删除了目标系统数据，但是中间表没有清除，导致查出来的还是原来的值
5、外部数据同步到CRM 时提示XX关联关系不存在
这是crm该字段使用了查找关联，检查字段查找的中间表结果是否正确。
6、ERP 从对象被 CRM 空数组覆盖
若未配置不删除明细且erp有明细又没有映射关系，修改时会用CRM传入的数组为准。如果不需要同步，就不要对接该从对象。