开发 · API 数据同步
API 数据同步：真相源、幂等与字段字典
一句话结论：API 数据同步：先定写权限、字段字典与幂等，再谈 AI 摘要；缺真相源时模型结论不可签字。
订单/库存对接 ERP/OMS：先定唯一写权限与字段字典，设计幂等与重试，再谈 AI 异常摘要。双写无真相源或超卖靠客服救火，都不该上自动化话术。对照 库存真相源。
问题：为什么卡在这里
多系统字段不一致；缺幂等与重试；双写无真相源；用聊天机器人掩盖同步失败；超卖后靠客服救火。
方法：可执行步骤
1定真相源
WMS/ERP/店铺三选一主导
→
2字段字典
映射表书面化
→
3同步策略
幂等/重试/告警
→
4监控
失败可发现
→
5再接 AI
摘要与话术
上线检查：人为制造一次同步失败，确认告警到达负责人，而不是三天后客服才发现。
工具卡片
跨境履约
状态字典与升级规则；写清适用边界与下一步，避免一句话占位。
场景页 →RestockMate 场景长文
缺货挽回与询价并行；写清适用边界与下一步，避免一句话占位。
读长文 →WP 插件定制
集成类定制边界；写清适用边界与下一步，避免一句话占位。
场景页 →对比与边界
| 维度 | 建议做法 | 常见误区 |
|---|---|---|
| 真相源 | 单一主导系统 | 多处可改库存 |
| 失败 | 告警+重试 | 静默丢单 |
| AI | 数据稳定后摘要 | 先上话术掩盖 |
| 定制 | 映射清晰再写 | 边对边写接口 |
场景优势：库存/订单可信，自动化建立在真实数据上。
适用：多渠道订单、有 ERP/OMS、需要减少超卖与客服救火的团队。
不适合：以 Excel 手工表为唯一真相却要求全自动承诺时效。
FAQ
先做同步还是先做主题？
有超卖/状态混乱时优先同步与字典；皮肤解决不了真相源。
Shopify 与 ERP 都改库存怎么办？
必须指定写权限方向；双向乱写是事故高发。
AI 能自动对账吗？
可辅助差异报告，裁定与冲正必须人工规则。
Shopify 自建功能开发先走 API 对接还是先建 App？
数据类需求（库存、订单、商品）先做 API 同步：幂等任务、字段字典、失败重试。流程类需求（定制结算、专属审批）再考虑自建 App。先建 App 后补数据层的项目，最容易两头对不上账。
相关链接
Shopify App · 物流清关 · AI 开发
