ERPとサードパーティAPIの連携
ERPと外部サービス:CRM、物流、税務、アイデンティティ
ERPと周辺サービスをREST、SOAP、Webhook、iPaaSで接続し、再試行とアラートを備えます。
ブループリント
横にスクロールすると図全体を確認できます。
ERPから外部パートナーへ:一つのプラットフォーム、多数の相手
業務イベントはERPを一度だけ出て、連携プラットフォームが各パートナーの期待する形式で届けます。コールバックも同じ経路で戻ります。再試行しても失敗するメッセージはデッドレターキューに入り、ペイロードを添えたアラートが上がります。
- 主要フロー
- 非同期
- 例外経路
9ステップのフロー
フローを順に示す
- ERPから連携プラットフォームへ:業務イベント、REST · OData · webhook経由(主要フロー)。
- 連携プラットフォームからCRMへ:顧客と注文、REST/JSON経由(主要フロー)。
- 連携プラットフォームから物流と運送会社へ:出荷の予約、REST/JSON経由(主要フロー)。
- 物流と運送会社から連携プラットフォームへ:追跡イベント、webhook経由(非同期)。
- 連携プラットフォームから電子インボイス・税務プラットフォームへ:クリアリング用の請求書、SOAP/XML · REST経由(主要フロー)。
- 連携プラットフォームからKYC・本人確認プロバイダーへ:本人確認、REST/JSON経由(主要フロー)。
- KYC・本人確認プロバイダーから連携プラットフォームへ:確認結果、webhook経由(非同期)。
- 連携プラットフォームからデッドレターキューとアラートへ:再試行後も失敗。デッドレターキューへ(例外経路)。
- デッドレターキューとアラートからサポートチームへ:ペイロードとエラー付きのアラート(例外経路)。
概要
これは、お客様のERPとその周辺サービス、すなわちCRM、運送会社や物流事業者、電子インボイスと税務プラットフォーム、アイデンティティとKYCのプロバイダーとの間のフローです。各パートナーは独自のAPI、独自の形式、独自の障害を持ち、通常はそれぞれが別のプロジェクトとして持ち込まれます。
参照設計では、業務イベントをERPから一度だけ統合プラットフォームへ送り、そこから各パートナーが期待する形式で、REST、SOAP、Webhook、取引先が求める場合はAS2上のEDIで届けます。追跡イベントや審査結果などのコールバックは、同じプラットフォームを通じて戻ります。
パートナーの停止は異常事態ではなく通常の出来事です。一時的な失敗は再試行します。再試行後も失敗するメッセージはデッドレターキューに送り、ペイロードとエラーを添えてサポートチームに通知し、修正して再送できるようにします。
フローの仕組み
ERPがイベントを発行
顧客、注文、請求書が変わると、ERPはAPI、ODataサービス、Webhookを通じて業務イベントを1件、統合プラットフォームへ発行します。
CRMが最新の状態に
プラットフォームがCRMの取引先、連絡先、注文を更新し、営業・サービス担当がERPの情報を確認できます。
出荷を予約
出荷可能な注文は運送会社や物流事業者のAPIで予約し、ラベルと参照番号を受け取ります。
追跡情報の受信
運送会社が追跡と配達証明のイベントをWebhookで送り、プラットフォームがERPの注文を更新します。
請求書のクリアリング
請求書は当局が求める形式で電子インボイスまたは税務プラットフォームへ送り、クリアリング状況を請求書とともに保存します。
アイデンティティの確認
新規の顧客やサプライヤーをKYCまたはアイデンティティプロバイダーへ送り、アカウント有効化の前に結果をWebhookで受け取ります。
障害が起きたとき
パートナーが一時的に利用不可
呼び出しを間隔を広げながら再試行します。すべての書き込みに冪等キーを付けるため、再試行で出荷や請求書が二重に作られることはありません。
再試行後もメッセージが失敗
ペイロードとパートナーのエラーを添えてデッドレターキューへ送り、サポートチームに通知します。修正後、キューから再送します。
パートナーがAPIを変更
各パートナーのテスト環境に対してコントラクトテストを実行し、変更を検知します。事前通知のある変更は、パートナーの期限前に計画して試験します。
データが拒否された場合
税番号の欠落など業務上の理由でデータを拒否したパートナーは、エラーをERPのレコードへ返し、担当者が修正できるようにします。
標準とシステム
- 連携
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- IDとアクセス
- OAuth 2.0
よくある質問
どのサードパーティサービスと接続できますか。
APIまたはファイルインターフェースが文書化されているサービスであれば接続できます。代表例はCRMプラットフォーム、運送会社と物流事業者、マーケットプレイス、電子インボイスと税務プラットフォーム、給与、KYCとアイデンティティのプロバイダー、AS2でEDI文書を交換する取引先です。計画を確定する前に、各パートナーのAPI、制限、テスト環境を確認します。
これには統合プラットフォームが必要ですか。
1つのERPに複数のパートナーが接続するようになると、MuleSoft、Boomi、Azure Logic Appsなどのプラットフォーム、またはメッセージキュー上に構築した独自サービス群により、マッピング、再試行、監視を一か所にまとめられます。パートナーが1–2社であれば直接接続で足りることもあります。ライセンス費用を含むトレードオフをお客様の状況に即して提示します。
電子インボイスや税務クリアリングのプラットフォームに接続できますか。
はい。現在、多くの国が請求書を定められた形式で政府または認定プラットフォームを通じて発行・クリアリングすることを求めています。当社はお客様の国が求めるプラットフォームまたは認定事業者とERPを連携し、クリアリング状況と識別子を請求書ごとに保存し、拒否にも対応します。適用される規則はお客様の税務アドバイザーが確認します。
受信するWebhookはどう保護しますか。
受信するすべてのWebhookを処理前に検証します。パートナーが署名する場合は署名で、しない場合はトークン、送信元、タイムスタンプの確認で検証します。ペイロードは契約に照らして検証し、パートナーが複数回送信してもイベントは一度だけ処理します。
パートナーが停止したらどうなりますか。
他のフローは動き続けます。そのパートナー向けのメッセージは再試行したうえでキューに入り、サポートチームに通知され、失われるものはありません。パートナーが復旧すると、キューのメッセージを順番に再送します。ダッシュボードには影響を受けたパートナーと待機中のメッセージ数が表示されます。
構築するコネクターの所有権は誰にありますか。
当社がお客様のために構築する成果物の知的財産権は、最初のコミットからお客様に帰属し、最後に譲渡手続きを要しません。コネクターはソースコード、テスト、ドキュメントとともに納品するため、お客様のチームまたは別のサプライヤーが保守できます。既存のXSISのツールは当社に帰属し、お客様にライセンスします。パートナーAPIと統合プラットフォームのライセンスは、各ベンダーの条件に従います。
契約ではなく、対話から始めましょう
構築、接続、保護のどれが必要かを教えてください。アーキテクトが内容を一緒に整理し、どこから始めるべきかを提案します。
今後の流れ
日程の調整
セッションの日程を調整するため、当社チームからメールをお送りします。
事前コンサルティングセッション
無料の30分オンライン事前相談です。目標、システム、制約を伺います。
準備状況レビュー
無料の48時間準備状況レビューで、プリンシパルアーキテクトがプロジェクトを6項目のDefinition of Readyに照らして確認し、適切なトラックを提案します。
トラックの選択
スコープが確定したプロジェクトには、拘束力のある提案書を3–5営業日以内にお渡しします。構想段階のプロジェクトはBlueprint Studioから始まります。稼働中のシステムに障害がある場合、文書化されていない場合、連携が必要な場合は、1–2週間の診断から始まります。Blueprint Studioと診断はそれぞれ固定料金で、提案書に記載します。