跳至主要内容
XSIS

企业与集成

ERP 到第三方 API 的连接

ERP 到第三方:CRM、物流、税务与身份

通过 REST、SOAP、Webhook 与 iPaaS 在您的 ERP 与周边服务之间建立连接,并配有重试与告警。

蓝图

ERP 到第三方:一个平台,众多合作伙伴业务事件从 ERP 发出一次,集成平台按各合作伙伴期望的格式投递。回调以相同方式返回。重试后仍失败的消息进入死信队列,并附上负载触发告警。ERPERP客户、订单、发票XSIS集成平台iPaaS 或定制服务、映射与重试第三方CRM账户、联系人与商机第三方物流与承运商货运与跟踪第三方电子发票与税务平台清关与申报第三方KYC 与身份服务商验证与筛查服务死信队列与告警不丢失任何消息人员支持团队1REST · OData · webhook2REST/JSON3REST/JSON4webhook5SOAP/XML · REST6REST/JSON7webhook89

ERP 到第三方:一个平台,众多合作伙伴

业务事件从 ERP 发出一次,集成平台按各合作伙伴期望的格式投递。回调以相同方式返回。重试后仍失败的消息进入死信队列,并附上负载触发告警。

  • 主流程
  • 异步
  • 异常路径
9 步流程

流程逐步说明

  1. 从ERP到集成平台:业务事件,经由REST · OData · webhook(主流程)。
  2. 从集成平台到CRM:客户与订单,经由REST/JSON(主流程)。
  3. 从集成平台到物流与承运商:已预订货运,经由REST/JSON(主流程)。
  4. 从物流与承运商到集成平台:跟踪事件,经由webhook(异步)。
  5. 从集成平台到电子发票与税务平台:待清关发票,经由SOAP/XML · REST(主流程)。
  6. 从集成平台到KYC 与身份服务商:身份核验,经由REST/JSON(主流程)。
  7. 从KYC 与身份服务商到集成平台:核验结果,经由webhook(异步)。
  8. 从集成平台到死信队列与告警:重试后失败,进入死信队列(异常路径)。
  9. 从死信队列与告警到支持团队:附负载与错误的告警(异常路径)。

概述

这是您的 ERP 与周边服务之间的流程:CRM、承运商与物流服务商、电子发票与税务平台,以及身份与 KYC 服务商。每家合作方都有自己的 API、格式和故障方式,而每一项通常都作为独立项目出现。

参考设计将业务事件从 ERP 一次性发出,交由集成平台按各合作方预期的格式投递,方式包括 REST、SOAP、Webhook,或在贸易伙伴要求时通过 AS2 传输 EDI。跟踪事件或校验结果等回调也通过同一平台返回。

合作方宕机是正常事件,而非紧急事故。临时失败会重试。重试后仍然失败的消息进入死信队列,并连同载荷与错误向支持团队发出告警,以便修复后重放。

流程如何运作

  1. ERP 发布事件

    当客户、订单或发票发生变化时,ERP 通过其 API、OData 服务或 Webhook 向集成平台发布一个业务事件。

  2. CRM 保持同步

    平台更新 CRM 中的客户、联系人与订单,使销售和服务团队看到 ERP 所掌握的信息。

  3. 预订货运

    准备发货的订单通过承运商或物流服务商的 API 预订,并返回面单与参考号。

  4. 跟踪信息回传

    承运商通过 Webhook 发送跟踪与签收事件,平台更新 ERP 中的订单。

  5. 发票完成清关

    发票按主管机关要求的格式发送至电子发票或税务平台,清关状态随发票一同存储。

  6. 核验身份

    新客户或供应商被发送至 KYC 或身份服务商,结果在账户启用前通过 Webhook 返回。

出现故障时

  • 合作方暂时不可用

    调用会以递增的延迟重试。每次写入都附带幂等键,因此重试绝不会产生第二笔货运或第二张发票。

  • 消息重试后仍然失败

    它会连同载荷与合作方的错误进入死信队列,并向支持团队发出告警。修复后从队列中重放。

  • 合作方更改了 API

    契约测试针对各合作方的测试环境运行,从而发现变更。已公告的变更会排期,并在合作方的截止期限之前完成测试。

  • 数据被拒绝

    合作方因业务原因拒绝数据(例如缺少税号)时,错误会回写到 ERP 记录,由负责人更正。

标准与系统

集成
  • REST
  • SOAP
  • Webhooks
  • OpenAPI
  • EDI (EDIFACT, ANSI X12)
  • AS2
  • MuleSoft
  • Boomi
  • Azure Logic Apps
身份与访问
  • OAuth 2.0

问题与解答

你们可以连接哪些第三方服务?

任何提供有文档的 API 或文件接口的服务。典型示例包括 CRM 平台、承运商与物流服务商、电商平台、电子发票与税务平台、薪酬、KYC 与身份服务商,以及通过 AS2 交换 EDI 单据的贸易伙伴。在承诺方案之前,我们会审查每家合作方的 API、限制与测试环境。

这需要集成平台吗?

当多个合作方接入同一个 ERP 后,诸如 MuleSoft、Boomi 或 Azure Logic Apps 之类的平台,或基于消息队列构建的一组定制服务,可以把映射、重试与监控集中在一处。只有一两家合作方时,直连可能就足够。我们会针对您的情况说明取舍,包括许可成本。

你们能把我们接入电子发票与税务清关平台吗?

可以。许多国家现在要求发票以规定格式通过政府或经认可的平台开具或清关。我们将 ERP 与您所在国家要求的平台或经认可的提供商集成,把清关状态与标识符随每张发票存储,并处理拒绝情形。具体适用规则由您的税务顾问确认。

你们如何保护传入的 Webhook?

每个传入的 Webhook 在处理前都会经过验证:合作方对其消息签名时校验签名;不签名时则校验令牌、来源与时间戳。载荷按契约进行校验,即使合作方重复发送,事件也只处理一次。

合作方发生宕机时会怎样?

其余流程继续运行。发给该合作方的消息会先重试再排队,支持团队收到告警,任何内容都不会丢失。合作方恢复后,排队的消息按顺序重放。仪表盘会显示受影响的合作方以及等待中的消息数量。

你们构建的连接器归谁所有?

我们为您构建的工作成果,其知识产权从首次提交起即归您所有,无需在结束时另做转让。连接器连同源代码、测试与文档一并交付,您的团队或其他供应商可以继续维护。XSIS 原有的任何工具仍归我们所有,并授权给您使用。合作方的 API 与集成平台许可仍受各自供应商条款约束。

从对话开始,而不是从合同开始。

告诉我们您需要构建、连接或保障什么。架构师会与您一起梳理,然后建议从何处入手。

后续流程

  1. 约定时间

    我们的团队会通过电子邮件与您约定会谈时间。

  2. 咨询前会谈

    一次免费 30 分钟在线预咨询:我们梳理您的目标、系统与限制条件。

  3. 就绪评估

    在免费 48 小时就绪评估中,首席架构师对照 6 项就绪定义检查您的项目,并推荐合适的路线。

  4. 选择路线

    范围就绪的项目会收到一份有约束力的方案3–5 个工作日内。概念阶段的项目从 Blueprint Studio 开始。已上线系统若出现故障、缺乏文档或需要集成,则先进行1–2 周诊断。Blueprint Studio 与诊断服务各收取固定费用,费用在方案中列明。