規制当局への報告インターフェース連携:項目マッピング、署名、受領通知、再報告
要点: 規制報告の難しさはリクエストを送ることではなく、次の3点にあります。当局ごとに電文形式が違い、しかも変わること。受領通知が非同期で届くことが多いこと。報告漏れも誤報告も問題になること。私たちは処理を3層に分けます。元データはまず社内の標準オブジェクトに変換し、そのうえで当局ごと・仕様の版ごとの電文を生成します。共通の送信層が署名、暗号化、再試行、受領通知を扱います。すべての報告と受領通知は監査記録として残し、再報告と突合の手順も定めます。
1.0 「形式」と「送信」を分ける
よくある旧来の作りは、地域ごとに1つのサービスを書き、項目マッピング、署名、送信をすべてコードに埋め込むものです。仕様が変わるたびにリリースが必要になり、地域ごとのサービスは少しずつずれ、同じ署名の不具合を何度も直すことになります。
より堅い構造は、変わる頻度で層を分けることです。
| 層 | 役割 | 何に連動して変わるか |
|---|---|---|
| 収集 | 企業のシステムからデータを取り出し、社内の標準オブジェクトに変換する | 企業のシステム |
| マッピング | 標準オブジェクトを、ある当局・ある仕様版の電文にする | 仕様の版 |
| 送信 | 認証、署名、暗号化、転送、受領通知、再試行 | ほとんど変わらない |
マッピングは「当局+仕様の版」で管理します。新しい版を稼働させても古い版は残し、施行日で切り替えます。戻すときは日付を戻すだけです。
2.0 マッピングは設定で、ただしテストできるように
マッピングのルールは設定として書きます。項目の対応、コード表の変換、単位の換算、必須項目の検証です。導入担当者はコードではなく画面で保守します。設定も間違えることがあるので、次のようにします。
- マッピングごとにサンプルデータと期待する電文を用意し、設定を変えるたびに自動で比較する。
- コード表(業種コード、行政区画など)は別に版管理し、参照するときは版を指定する。
- 設定の変更には承認と記録を付け、誰がいつ何を変えたかを追えるようにする。
設定では表現しきれないケースは必ず出てきます。そうした例外には安定したプラグインインターフェースを用意し、設定言語がプログラミング言語のように膨らむのを避けます。そうなると導入担当者は保守できず、開発者も触りたがらなくなります。
3.0 送信層
- 証明書と鍵は読み取り専用でマウントし、データベースに保存せず、設定画面にも表示しません。鍵の更新は文書化した手順で行います。
- 当局が求める伝送方式(HTTP、常時接続のTCP、メッセージキュー)を1つのランタイムで扱い、方式ごとに再試行やログの仕組みを作り分けません。
- 報告ごとに一意の業務通番を付け、再送時も同じ番号を使って当局側で重複排除できるようにします。当局が重複排除しない場合は、ローカルの「確認済み」状態を再送前に確認します。
- 同期の受領通知は通常「受け取った」ことしか意味しません。処理結果は非同期の受領通知で届くか、問い合わせて取得する必要があり、どちらの経路も必要です。
4.0 再試行、再報告、突合
| 状況 | 対応 |
|---|---|
| 通信失敗、タイムアウト | 上限付きの指数バックオフで再試行。上限を超えたら人手のキューへ |
| 当局の検証で却下 | 自動再試行しない。理由をデータの責任者に渡し、修正後に再報告する |
| 停止中に報告が漏れた | 時間帯を指定して再報告し、理由を記録する |
| 定期的に | 当局側の確認記録と突合し、未確認や不一致の項目を一覧にする |
検証エラーを自動で再試行しても、同じエラーが並ぶだけで意味がありません。当局側のレート制限に引っかかるおそれもあります。
5.0 監査
報告ごとに、元データのスナップショット、生成した電文、署名のダイジェスト、送信時刻、受領通知の内容を保存します。争いになったとき、ある時点で何を報告し、相手が何を返したかを示せなければなりません。保存期間は当局の要件と企業自身のコンプライアンス規程に従います。
コードに埋め込まれた旧来の報告サービスを置き換える場合や、新しい当局と接続する場合は、Web・クラウド・デバイス管理をご覧いただくか、プロジェクトのご相談からご連絡ください。
参考資料
- Enterprise Integration Patterns、Guaranteed Delivery:https://www.enterpriseintegrationpatterns.com/patterns/messaging/GuaranteedMessaging.html
よくあるご質問
地域ごとの仕様は頻繁に変わります。設定だけで本当に追いつけますか?
変更の大半は項目の追加、コード表の更新、検証ルールの調整で、これらは設定で対応できます。電文の構造や伝送方式まで変わる場合は、マッピングのテンプレートや送信層の修正が必要です。そのためマッピングは仕様の版ごとに管理し、新旧の版をしばらく並行させ、施行日で切り替えます。
当局のテスト環境が本番と同じ動きをしません。どうしますか?
よくあることです。結合テストで得た実際の受領通知をマスキングしてサンプルとして保存し、成功、検証エラー、各エラーコードを網羅します。本番稼働後はしばらく突合の頻度を上げ、テスト環境で見えなかった問題を早めに見つけます。
まず1地域だけで始められますか?
1地域から始めるのは妥当です。ただし構造は複数の当局を前提に設計し、標準オブジェクト、マッピング層、送信層を分けておきます。2地域目はマッピングを追加するだけで済み、サービスを丸ごと複製せずに済みます。
導入担当者はコードを書けません。マッピングを保守できますか?
日常的な項目の対応付けやコード表の保守は画面上で行え、変更のたびにサンプルデータと自動で比較されるので、誤りはすぐ差分として見えます。設定で表現できない例外は、開発者がプラグインインターフェースで実装します。