跨境店铺→星空客户主数据同步：单一策略实战教程

这个策略解决什么问题

跨境电商的运营主体是「店铺」而不是传统意义上的客户。一家零售企业可能同时运营 Amazon、Shopee、Lazada 上的几十个店铺，而金蝶云星空的供应链体系里，订单、发货、对账都要挂到客户档案上。问题就来了：店铺建在旺店通·跨境版里，星空里没有对应客户，单据流转一开始就断。

这个策略就是用轻易云数据集成平台（Qeasy）把旺店通·跨境版的店铺档案按创建时间增量拉取出来，落地为金蝶云星空 BD_Customer 客户档案。它解决的不是「能不能传过去」，而是「怎样既不漏、又不重、还不脏」地把主数据统一起来。

数据流向与字段映射

数据流向：旺店通·跨境版（店铺）→ 轻易云中间层（idCheck 去重 + 映射）→ 金蝶云星空（BD_Customer 客户）

关键字段对照表：

目标端 otherRequest 固定参数：FormId=BD_Customer，Operation=BatchSave，IsAutoSubmitAndAudit=true（保存即审核），IsVerifyBaseDataField=true。

源端还有 shopId、platformId、platformName、kjType、remark 等未映射字段，后续要按平台分组织或挂客户分类时，可走 COLLECTION 扩展。

在轻易云上如何配置

我们在客户现场做这个策略时，轻易云上的配置是分三块的。

源端（旺店通·跨境版）：类型 WebAPI，effect=QUERY，方法 POST，接口 /api/openservices/shop/v1/getShopList。number 填 {{shopName}}，id 填 {{shopNo}}，idCheck 一定要开成 true——这是去重关键。请求体里 start_time={{LAST_SYNC_TIME|datetime}}、end_time={{CURRENT_TIME|datetime}}、status=1（按创建时间过滤）、page_size=100。

目标端（金蝶云星空）：类型 EXECUTE，effect=EXECUTE，方法 POST，接口 batchSave。id 和 number 都填 0，idCheck 也开 true。请求体按上面那张表配 5 个字段，再加 4 个 otherRequest 固定参数。

调度与串联：源端 crontab */20 * * * *，目标端 */25 * * * *，错开 5 分钟让目标端有窗口把攒下来的批次写完。如果客户那边主数据量更大，可以同步抬到 */10 与 */15。

实施步骤

这个策略我们一般按三步走。

第一步：增量起点初始化。轻易云平台第一次跑时，LAST_SYNC_TIME 为空，需要手动指定一个起点时间（例如「当前时间往前 7 天」），先把历史店铺捞一遍补齐。空跑会全量回灌，源端扛不住。

第二步：全量触发与核对。起点配好后立刻跑一次全量，到星空 BD_Customer 里按 FNumber 抽样核对编码、名称是否对得上、组织是否正确。这一步主要盯两个数：拉取总数 vs 落地总数、源端空值字段是否被错误写入。

第三步：常态化调度。核对无误后启用 */20 和 */25 的双轨调度。轻易云客户的常见应对模式是增量与全量双轨——日常增量跑，每周日 02:00 触发一次全量兜底，防止 LAST_SYNC_TIME 漂移或漏单。

踩坑复盘

坑一：idCheck 没开或开反。 源端 idCheck 必须 true，不然已同步的店铺会重复写入，星空里 FNumber 冲突直接报错。目标端 idCheck 同样要 true，让平台按 id（shopNo）去重。

坑二：status 写错。 源端 status=0 是按更新时间，status=1 才是按创建时间。客户要的是「建店即建客户」，如果错配成 0，老店铺的修改会反复触发，脏数据就来了。

坑三：组织常量写死后的多组织困境。 当前 FUseOrgId/FCreateOrgId 固定 100。某制造企业客户后续要按平台拆组织（Amazon 店进 A 组织、Shopee 店进 B 组织），要回头把 platformId 走 COLLECTION 映射。我们吃过这个亏，稳妥的做法是上线前就和业务确认组织维度。

坑四：IsAutoSubmitAndAudit=true 但下游有审批流。 客户档案如果后续要走信用额度审批，保存即审核反而把流程跳过了。建议这种场景把审核关掉，交给下游单据触发。

坑五：分页写死 100 遇上限流。 跨境大卖家一次性建店可能上千，page_size=100 没改的话会被源端分页截断。轻易云平台支持分页自动续传，但 end_time 窗口内如果新增店铺超过阈值，仍可能漏。

适用场景与不适用场景

适用：跨境电商多店铺、店铺即客户主体、需要把旺店通·跨境版主数据统一到金蝶云星空支撑后续订单/对账/库存主数据流转的场景。 不适用：店铺与客户是 1:N 关系（一店多客户）、需要复杂审批流、源端不支持时间范围增量、需要跨方案联查物料/组织映射的复杂场景。