ERPとの受注連携:手動審査、冪等な送信、同期ログ

要点: ERP連携でいちばん多い誤解は、「ERPが受注を受け付けた」を「受注が完了した」と同じに扱うことです。多くのERPは受注後も人が審査し、その後に出庫を計上します。プラットフォームは待つしかありません。私たちは、送信のたびに安定した業務キーを付けて安全に再試行できるようにし、状態は1回の応答を信じるのではなく定期的に問い合わせて確認し、すべての同期処理を同期ログに書き、日次の突合で両側の不一致を見つけます。

プラットフォームとERPの受注同期を示す図。プラットフォーム側は支払済み、顧客登録の送信、冪等キー付きの受注送信、状態のポーリング。ERP側は顧客マスタ、手動審査、出荷と請求。手動審査は破線で描かれ、人の作業待ちであり再試行しても早まらないと注記されています。すべての呼び出しは1つの同期ログに書き込まれ、日次の突合で差異を一覧にします。
図1. 受注同期の経路。ERP内の手作業があるからこそ、状態はコールバックを待つのではなく問い合わせて確認します。

1.0 まず業務の流れを書き出す

連携コードを1行書く前に、ERPの導入担当と業務側と一緒に、受注から請求までの各ステップを書き出します。それぞれがどちら側で起きるか、自動か手作業かも記します。典型的な流れは、顧客登録、受注送信、ERPでの審査、出庫計上、配送と追跡番号、入金確認、請求書の取得です。

手作業のステップに印を付けることが重要です。プラットフォームで「処理中」と表示されている受注は、ERP内の誰かのタスク一覧で止まっているのかもしれず、いくら再試行しても動きません。画面とアラートで「ERP待ち」と「送信失敗」を区別しないと、運用担当は両方の問題を開発者に持ち込むことになります。

2.0 送信は安全に再試行できるようにする

厄介なのはタイムアウトです。リクエストが届いたのかどうかわかりません。再試行でERPが伝票をもう1枚作れば、二重受注になります。

  • 伝票ごとに安定した業務キー(通常はプラットフォームの受注番号)を付け、ERPはそれで重複を排除します。ERPが重複排除に対応していなければ、送信前にその伝票が既にあるか問い合わせます。
  • 依存するマスタデータを先に送ります。新規顧客は受注より先に登録します。依存先が準備できていなければ、伝票はローカルのキューで待たせ、無理に送りません。
  • コードが一致しないのは例外ではなく日常です。ERPに商品や顧客がまだ登録されていないときに何を送るか、どちら側が穴を埋めるかを、事前に文書で決めておきます。
  • ERPのエラーはHTTP 200の本文に隠れていることがよくあります。エラーの意味は1つのクライアントでまとめて判定し、呼び出し箇所ごとに解釈がばらつかないようにします。

3.0 状態は問い合わせで得る

送信の応答からわかるのは「受け取った」ことだけです。その後の状態は定期ジョブで問い合わせます。

設計項目私たちの選択
走査方法OFFSETではなく主キーによるキーセットページング。件数が増えても安定し、ページ間で取りこぼさない
走査順カーソルを循環させ、前回止まった位置から再開する。同じ失敗伝票ばかり処理しない
バックオフ失敗が続く伝票は問い合わせ間隔を延ばし、上限を設ける。上限を超えたら人に回す
同時実行1つの伝票を同時に扱うワーカーは1つだけ。行ロックかリースで保証する

4.0 同期ログが障害調査の入口

呼び出しのたびに1行を書きます。伝票番号、操作、リクエストの要約、結果コード、ERPのメッセージ、所要時間、試行回数です。パスワード、トークン、個人情報の全体はログに入れません。

この表があれば、「この受注はなぜまだ出荷されないのか」という調査は、アプリケーションログを掘ったりERP側にスクリーンショットを頼んだりする前に、クエリ1本から始められます。私たちは障害対応手順書も整備しています。新しい問題を解決するたびに、症状、根本原因、対処、診断用のクエリを記録し、新しい項目を先頭に置きます。ERP連携の問題は形を変えて繰り返し現れるので、この手順書はどんなダッシュボードより役に立ちます。

5.0 突合

すべてのステップが正しくても、両側は少しずつずれていきます。誰かがERP上で直接受注を修正・取消したり、問い合わせ結果が書き込まれなかったりするためです。日次の突合で受注状態、金額、請求書を比べ、差異を一覧にして担当者に渡します。突合はどちら側も自動で「修正」しません。出力は作業リストです。

6.0 開発とテスト

  • ERPアダプターはインターフェースとし、ローカルとCIではシミュレーション実装を使います。請求を含む受注のライフサイクル全体がオフラインで動きます。
  • ERPのテスト環境は本番と異なるか、そもそも存在しないことがよくあります。結合テストでは各エンドポイントの実際のリクエストとレスポンスをマスキングして保存し、回帰テストのケースにします。
  • 本番稼働直後の数週間は突合の頻度を上げ、テスト環境では見えなかったケースを早めに洗い出します。

受注システムをERPにつなぐ場合や、既存の連携がたびたび止まる場合は、Web・クラウド・デバイス管理をご覧いただくか、プロジェクトのご相談からご連絡ください。

参考資料

よくあるご質問

ERPがデータベースのビューしか公開しておらず、APIがありません。連携できますか?

読み取り専用のビューで商品や在庫を取得するのは問題ありません。ERPのデータベースに伝票を直接書き込むのは危険です。ERP自身の検証を迂回するうえ、問題が起きたときに責任の所在が曖昧になります。書き込みはERPのAPIかインポート機能を通し、読み書きの境界は事前にERPの導入担当と合意しておきます。

在庫はどのくらいの頻度で同期すべきですか?

売り越しのコストと、ERPが耐えられる呼び出し頻度で決まります。注文確定時に在庫をリアルタイムでもう一度確認するほうが、定期同期の頻度を極端に上げるより確実で、ERPへの負荷も小さく済みます。

ERP側の審査が遅く、顧客にはずっと「処理中」と表示されます。どうすればいいですか?

どこで止まっているかを正直に表示します。たとえば「ERP審査待ち」とし、業務側と合意した処理期限も示します。ERP内の審査をプラットフォームが代わりに行うことはできませんが、待ち状態を見える化し、期限を超えたら担当者に自動で通知することはできます。

将来ERPを入れ替えるとき、プラットフォームは作り直しになりますか?

連携コードが1つのアダプターにまとまっていれば、ERPの入れ替えは主にアダプターの書き直し、コード対応表の作り直し、通しテストで済みます。業務コードのあちこちからERPのAPIを直接呼んでいると、変更範囲はずっと大きくなります。最初からアダプター層を作る理由はここにあります。