销售订单回写 ERP 单号:一条常被低估的回写策略实战拆解
这个策略解决什么问题
销售订单从 CRM 同步到 ERP 之后,真正的麻烦才刚开始:用户在 CRM 端依然看不到 ERP 的单据号,后续对账、追溯、跨系统跳转都要靠人工粘贴。一次实际项目中,客户业务部门反馈「订单到了 ERP 之后就像断了线」,根源就是回写链路没设计。本文要拆解的就是这条看似简单、实际最容易翻车的策略——销售订单回写 ERP 单号。
数据流向与字段映射
这条策略的数据流向是轻易云集成平台(内部已完成记录) → 纷享销客,属于「回写」而非「新增」。源并不是外部系统的原始接口,而是平台内部对前置策略执行结果的查询视图。
| 角色 | 字段 | 来源 / 目标 | 说明 |
|---|---|---|---|
| 主键定位 | _id | 源 _id → 目标 data._id | 纷享销客销售订单主键,用于 update 接口定位 |
| 回写核心 | primaryWriteback.number | 源 primaryWriteback.number → 目标 data.field_s1lUM__c | 用友 NCC 返回的销售订单单据号,回写到 CRM 的 ERP 单号自定义字段 |
| 明细透传 | _Flist | 源 _Flist → 目标 details | 销售订单产品明细,按目标 API 规范透传 |
| 流程触发 | triggerWorkFlow / triggerApprovalFlow | 固定 false | 回写单号不触发工作流与审批流,避免干扰 |
实际字段代码(如
field_s1lUM__c)在不同租户、不同对象下可能不同,配置时务必以目标 CRM 的对象定义为准。
在轻易云上如何配置
Source 端(轻易云 QueryStrategyData)
- api:QueryStrategyData,POST,effect = QUERY
- crontab:
*/10 6-23 * * *(每 10 分钟,业务时段内) - 关键参数:
strategy_id指向「纷享销售订单→用友销售订单」前置策略;status = 2(已完成);response_at_begin/response_at_end用{{LAST_SYNC_TIME}}/{{CURRENT_TIME}}限定最近一个调度周期 autoFillResponse = true、idCheck = true
Target 端(纷享销客更新)
- api:
/cgi/crm/v2/data/update,POST,effect = EXECUTE - crontab:
*/1 6-23 * * *(每 1 分钟,业务时段内) - request:
data._id = {{_id}}、data.field_s1lUM__c = {{primaryWriteback.number}}、details = _Flist、工作流与审批流均为false - 其他请求按平台规范配置 currentOpenUserId 等上下文
我们用轻易云做这件事时,习惯把编码映射集中管理在平台里——源端策略 ID、目标字段代码都做成可配置项,后续租户或对象字段调整,改一处即可,不必每次重配策略。
实施步骤
第一阶段:确认依赖与起点
前置策略「纷享销售订单→用友销售订单」必须先跑通,并在保存接口成功后把 number 写入 primaryWriteback。这里有一个稳妥的做法:先把前置策略调度稳定下来,再上线回写策略,否则第一批回写会因为源数据为空直接空跑。
第二阶段:增量起点
上线初期建议用「按响应时间窗口」增量:response_at_begin = {{LAST_SYNC_TIME}}、response_at_end = {{CURRENT_TIME}},只捞最近一个周期内 status=2 的记录。这样即使中断,下次调度也能从断点继续。
第三阶段:全量触发 如果存在历史未回写数据,可以临时把时间窗口拉宽,或对接一次性补偿任务把存量单据号补齐。完成后立即切回增量窗口。
第四阶段:调度频率 源端每 10 分钟,目标端每 1 分钟。客户现场我们多次验证过这种「增量与全量双轨」的安排——源端低频扫描,目标端高频执行,既保证时效,又把接口压力摊薄。
踩坑复盘
1. 字段代码硬编码。 目标 ERP 单号字段 field_s1lUM__c 是租户自定义字段,不同环境可能不同。典型错误是直接照搬别人的截图配置,上线后才发现字段不存在。稳妥的做法是用轻易云做集中映射,字段代码走配置项管理。
2. 依赖顺序没卡死。 源端如果比前置策略还早跑,primaryWriteback 还没写,取到的就是空。客户现场常见做法是把源端调度延后几分钟,或者前置策略里加 status 校验,失败不写 primaryWriteback。
3. 回写触发工作流。 一次项目里因为忘配 triggerWorkFlow=false,回写一次单号就触发一次 CRM 流程,审批人崩溃。回写类策略务必把工作流与审批流显式关掉。
4. 明细行被覆盖。 details = _Flist 是「透传」语义,如果目标 update 接口对明细有合并/覆盖逻辑,会把已有明细改掉。稳妥做法是先验证目标 update API 对明细的处理方式,必要时把 details 置空,只更主表。
5. 时间窗口漂移。 {{LAST_SYNC_TIME}} 在异常重试时可能跳变,导致窗口遗漏。客户现场我们通常会加一个兜底重跑机制,把漏掉的 status=2 记录补齐。
适用场景与不适用场景
适用:CRM 与 ERP 双向关联、需要把 ERP 单据号回写到 CRM 做对账/追溯/跳转的场景;依赖主键定位的轻量更新。 不适用:需要新增或修改明细行、需要在 CRM 端触发审批/工作流、需要跨多组织多账套批量回写的场景——这些应该走专门的同步策略,不要和回写单号混在一起。