ERP API 对接指南
ERP怎么和电商平台对接？
RESTful、SOAP、GraphQL三种接口怎么选
— ERP与电商平台API对接全景图
ERP和电商打通要走API接口，不要靠人工导出导入。RESTful轻量、电商平台常用；SOAP规范严格、银行税务常指定；GraphQL由调用方决定取哪些字段。选哪种不看哪个更先进，看对接方要求什么。
本文导读
01ERP到底有没有API接口？
02三种接口形式怎么选
03ERP和电商平台对接的4种做法
ANALYSIS
01ERP到底有没有API接口？有，但要看开放到哪一层
主流ERP都提供API。但“有接口”和“能接你要的东西”是两回事。接口能力分三层：
数据读取
查库存、查订单状态、查价格。这一层几乎所有ERP都开放。
数据写入
把电商订单下推成ERP里的销售订单，把发货单号回写给电商平台。这一层部分ERP只开放一半——能读不能写。
业务动作
审核、过账、冲销这类操作。开放到这一层的ERP不多，因为风险高。
选型时直接问供应商四个问题：开放了哪些对象（商品、订单、库存、往来单位各自能不能接）？只读还是可写？有没有接口文档和测试环境？写操作有没有审批和回滚机制？
提示
问不清楚这四条，后面大概率卡在实施阶段。
COMPARISON
02三种接口形式：RESTful、SOAP、GraphQL 各自适合什么
— RESTful、SOAP、GraphQL三种接口对比
RESTful
用 URL 加 JSON 传数据，结构轻量，开发快，调试直观。电商开放平台、小程序、自建业务系统基本都走这种，是中小企业用得比较多的一种对接形式。
SOAP
用 XML 信封封装，规范严格，自带 WS-Security 等安全规范。银行、税务开票、政务系统、部分老牌系统常用——很多时候不是你想选，是对方指定必须用。
GraphQL
由调用方自己声明要哪些字段，一次请求把需要的数据拿全，不用跑好几个接口。适合字段特别多、多个终端取数差异大的场景。代价是缓存策略和权限控制要自己设计，复杂度比前两种高。
「对接方指定什么，就用什么。」接口对接的目标是连通，不是选先进。银行和税务通常指定 SOAP；电商开放平台基本是 RESTful；企业内部多端系统之间，可以考虑 GraphQL。
PRACTICE
03ERP和电商平台对接的4种做法
01走平台开放平台接口（优先选这种）
主流电商平台都有开放平台和官方接口文档，配套授权机制。稳定、有维护，出问题能查到原因。代价是要按平台的规范来，能拿哪些字段由平台决定。
02中间件定时同步
平台不给接口，或者给的接口字段不全时的常见做法——用一张中间表，定时把两边的差异数据同步一次。适合订单量不大、允许分钟级延迟的场景。
03数据库直连取数
技术上能实现，风险也在这里：对方表结构一改，你的对接就断；而且多数平台的用户协议不允许这么做。除非是内部自己的两套系统，否则不建议。
04文件导入导出
比较原始的办法，每天导Excel。订单量到几百单一天就撑不住，人工成本高且容易出错，只能作为临时过渡。
重点
对接时要同步的东西，按方向分清楚：订单从电商进ERP，发货和物流单号从ERP回写电商，库存从ERP同步到电商防超卖，价格由ERP单向同步给电商。库存这一项必须准，否则会超卖，比不对接还麻烦。
CHECKLIST
04对接前必须确认的5件事
01接口文档和测试环境
谁提供文档，有没有沙箱可以先跑通再上生产。没有测试环境的对接，等于在生产上试错。
02调用频率限制
每秒几次、每天多少次。大促期间订单集中，限流会直接导致漏单。
03幂等机制
同一笔订单被重复推送，会不会在ERP里生成两张销售订单。这一条不做，重复下单是必然的。
04失败重试和日志
失败的单据能不能查到、能不能一键重推、有没有告警。接口不可能永远成功，关键在失败后能不能发现和补救。
05密钥与数据安全
密钥怎么存、多久换一次、客户手机号和地址这类字段脱不脱敏。
CASE
05厦门速达的做法：能对接就不替换
厦门速达软件有限公司面向中小企业提供API接口开发，支持 RESTful API、SOAP API、GraphQL API 三种形式，用在几类场景上：
电商平台对接
订单下推进ERP、发货和库存回写平台，避免超卖和人工搬单。
MES 对接
车间工序和报工数据回传，生产进度进ERP。
企业自有系统对接
已经有系统在用的，从现有业务库取数，做单证管理、资产负债数据采集、周报月报这类报表模块，不强制整体替换——能对接解决的，就不推倒重来。
CAUTION
06什么情况下先别急着做对接
订单量还小
一天几十单，人工导出几分钟就搞定，这时候花几万做对接不划算。等订单量上来再做，需求也更清楚。
业务流程还没定
今天一个改法明天一个改法，接口跟着反复返工。先把自己这边的流程固化下来。
对接方没有接口文档
没有文档意味着全靠猜和试，成本不可控，也不好验收。
没有人对接口负责
上线后接口挂了、数据不同步，得有人能排查。中小企业常常是上线时有人跟，出问题时找不到人，这一步要提前安排。
「接口对接不是技术活，是先把两边谁说了算这件事定清楚。」
如果你觉得今天这篇有收获，欢迎点赞、在看、转发三连，我们下篇见