ERP連携 — API統合

3ステップのオンボーディング

1. 1 · キーとサンドボックス権限を分けたテスト用キーと本番用キーを受け取ります（発行のみ、取得のみ、両方）。
2. 2 · プログラミングではなくフィールドマッピング御社のエクスポート形式（CSV、IDoc風、JSON）を、明細行を含めてサーバー側で請求モデルへマッピングします。ドライランで、何かが発行される前に結果を確認できます。
3. 3 · テスト書類 → 承認 → 本番サンドボックスの書類が実際の検証を通過します。問題がなければ本番キーを有効化します。連携ステータス（キー、マッピング、最初の書類）はいつでも照会できます。

継続運用での信頼性

• 冪等性：同じ書類番号を2回送信 → 書類は1件、重複なし。タイムアウト後の再送も安全です。
• 正直なエラー：不正な書類は、具体的なルール違反を伴うエラーとして返却されます — 決して黙って「たぶん大丈夫」で通すことはありません。
• テナント分離とセグメント：ERPキーはERPテナントでのみ機能します。Webアカウントはapiにアクセスできず、その逆も同様です。
• 完全なアーカイブ：APIで発行した書類も8年間、改ざん不可の状態でGoBDアーカイブに保管されます — 御社のERPが自前で対応する必要はありません。

マシンインターフェースのセキュリティ

APIキーはハッシュ化して保存され（平文は生成時に一度だけ表示）、権限（発行のみ、取得のみ）と環境（サンドボックス／本番）を持ち、いつでもローテーションできます。すべての呼び出しはテナントに紐付けられ、記録されます。Web画面とマシン向けAPIは、厳密に分離されたアクセス経路です。

呼び出し例

POST /v1/erp/invoices · Authorization: Bearer <API-Key>
{"number":"RE-2026-1042","buyer":{"name":"Kunde GmbH","country":"DE","vat_id":"DE…"},"lines":[{"name":"Seefracht","net_price":2500,"service_type":"intl_transport"}]}
応答：{"status":"VALID","number":"RE-2026-1042", …} — または、正確な検証エラー。

よくある質問

連携の技術的な仕組み

御社のシステムは、APIキー認証を備えた軽量なREST APIを呼び出します：請求データをJSON（ヘッダー、取引先、明細、税・支払情報）として渡すと、CoolHanXはそこからEN 16931準拠のXRechnungを生成し、BR-DEに照らして検証し、欠落のない連番を採番し、GoBD準拠でアーカイブし、ステータスを返します。発行は冪等です：同じ参照番号で再度呼び出しても、二重請求は発生しません。

ERPのデータレコードから検証済みの電子請求書へ

1. 1 · マッピングの設定御社のフィールド名を一度だけEN 16931のBTにマッピングします — オンボーディング時に、本番発行の前にテスト実行（サンドボックス）を行います。
2. 2 · データの送信御社のERPが請求データレコードを付けてAPIを呼び出します。
3. 3 · 検証と発行CoolHanXが検証し、採番し、アーカイブします — またはエラー時には、番号を消費せずに具体的なBR-DEコードを返します。
4. 4 · ステータスの返却結果（VALID/エラー）、請求書番号、アーカイブ参照が御社のシステムに返されます。

オンボーディング、サンドボックス、料金

ERP顧客向けには、本番稼働の前にマッピングと発行を安全にテストできるサンドボックスをご用意しています。お見積りは書類量と連携作業量に応じます — 一律料金ではなく、ご相談のうえ最適なお見積りを作成しますので、お気軽にお問い合わせください。

関連トピック

連携できるERPシステムとフォーマット

請求データをエクスポートできるものはすべて連携できます — フォーマットの作業は当社のサーバー側マッピングが引き受けます。実績のある方法：

どのプログラミング言語からでも連携可能

インターフェースはAPIキーを備えた軽量なREST APIです — Python、PHP、Java、C#、Node.jsから、あるいはcurlで直接連携できます。請求データをJSONで送信すると、CoolHanXが生成、検証、採番、アーカイブを行い、ステータスを返します。SDKの強制も、独自ライブラリも不要です。

curl -X POST https://…/v1/erp/invoices -H 'Authorization: Bearer <API-Key>' -H 'Content-Type: application/json' -d '{…}'