CRM 与金蝶云星辰双向数据同步

要解决什么问题

当销售在六度人和 EC 维护客户与订单，运营又在金蝶云星辰处理商品分类和物料时，两套系统常出现客户主数据不一致、已结单订单漏录入、分类重复创建等问题。手工搬运字段容易漏掉 crmId、productId 这类关联键，也容易把个人客户和企业客户写混。

技能如何工作

该技能把同步拆成两个方向：

• EC → 金蝶：每小时拉取 EC 客户与 status=3 的已结单订单，写入金蝶客户资料和 销售订单。客户以 crmId 作为金蝶 number 去重，已存在则更新，不存在则新增；订单会把 code 加上 EC- 前缀，并映射金额、物料、日期与备注。
• 金蝶 → EC：每日凌晨 1 点拉取金蝶商品分类，转成 EC 产品。默认生成 productUnit=个、money=0.00、onOff=0 等字段，并用本地映射表和名称匹配避免重复创建。

两个方向都记录同步时间戳，后续按变更增量拉取；首次执行若需要全量，可使用 --full 参数。

适用边界与注意点

• EC getSales 查询的 creatTime 间隔不能超过 31 天，批量同步时要分段处理。
• 金蝶 app-token 24 小时有效，脚本会缓存并自动刷新。
• productId 会被直接映射为金蝶 materialid_id，金蝶侧必须已存在对应物料，否则订单物料关联可能失败。
• 字段映射集中在 map_ec_customer_to_jdy() 与 map_ec_order_to_jdy() 中，接入新客户、订单字段时需要按实际业务调整。