peppol.sh

はじめに

peppol.shは、企業がPeppolネットワークを自社で管理することなく、コンプライアンス準拠の電子請求書を送信できるように設計されたPeppol電子請求書APIです。UBLスキーマ、SMPルックアップ、アクセスポイントの設定に苦労する代わりに、開発者はJSONデータを使ったシンプルなAPI呼び出しを行うだけで、peppol.shが変換と配信を処理します。

---

peppol.shとは？

peppol.shは、Peppolネットワーク向けのPeppol電子請求書APIであり、APIファーストの電子請求書サービスです。これは実際の問題を解決します。Peppol電子請求書には、検証、登録、認定アクセスポイントとの通信が必要です。peppol.shはそのプロセス全体を1回のREST API呼び出しにまとめます。

このサービスはJSONペイロードを受け取り、Peppol BIS 3.0 UBLに変換し、EN 16931に照らして文書を検証し、Peppolネットワークを通じて配信します。また、登録時からサンドボックス環境が含まれているため、ユーザーはすぐにPeppol請求書を送信し、本番稼働前に統合をテストできます。これにより、peppol.shは単なる変換ツール以上のものになっています。最新のソフトウェアチームのための完全なPeppol電子請求書APIです。

なぜこれが重要なのでしょうか？欧州の電子請求書義務化は拡大しています。ViDAは2030年までにEU全体で構造化電子請求書を義務付ける予定であり、すでに現在いくつかの加盟国で施行されています。ソフトウェアチームにとって、これはPeppolの専門家にならずに電子請求書コンプライアンスを追加する信頼できる方法が必要であることを意味します。peppol.shはそのギャップを狙っています。

peppol.shの主な機能

このPeppol電子請求書APIの主な強みは、すべてのプロセスが自動化されていることです。

ワンコール文書送信

JSONペイロードを/v1/documentsエンドポイントに送信すると、文書は配信のためにキューに入れられます。多段階のフローも、手動のPeppol設定も必要ありません。これがPeppol電子請求書APIエクスペリエンスの中核です。

JSONからUBLへの変換

peppol.shはJSONを有効なPeppol BIS 3.0 UBLに自動的に変換します。これにより、UBL構文を学習したり、複雑な変換テンプレートを維持したりする必要がなくなります。

組み込みの電子請求書コンプライアンス

このサービスはEN 16931の検証を処理し、認定Peppolアクセスポイントとして運用されます。これにより、EUの電子請求書コンプライアンス要件を満たしやすくなります。

初日からのサンドボックス

すべてのアカウントはサンドボックスモードで開始します。開発者はps_test_キーを使用してPeppol請求書を送信でき、サンドボックス配信はメールで送信されます。UIも承認もクレジットカードも不要です。

配信追跡とウェブフック

すべての文書にはステータスエンドポイントがあり、ウェブフックが配信イベントを通知します。チームは各請求書が実際に受信者に届くかどうかを確認できます。

参加者ルックアップ

ルックアップエンドポイントを使用すると、送信前に企業がPeppolに登録されているかどうかを確認できます。これにより、配信失敗を防ぐことができます。

自動送信のためのStripeアプリ

Stripeユーザーの場合、公式アプリがinvoice.finalizedイベントをリッスンし、Peppolネットワークを通じて請求書を自動的に送信します。このルートではコードの変更は必要ありません。

AIエージェント対応

peppol.shにはSKILL.mdファイルとMCPサーバーが含まれており、AIエージェントがアカウントを作成し、請求書を送信し、配信を自律的に追跡できます。これはAPIファーストの設計に合致しています。

peppol.shのユースケース

SaaSおよびEコマースのチェックアウト

顧客が支払いを完了すると、システムはpeppol.shを通じてPeppol請求書をその企業に送信できます。これはSaaS製品、Eコマースストア、サービス企業に役立ちます。

会計およびERP統合

会計プラットフォームは自社製品にPeppol送信を組み込むことができます。各テナントには1つの会社IDが付与されますが、テナントごとの料金や月額最低料金はありません。

自動化された請求ワークフロー

財務チームと開発者は、完全にAPI駆動の請求フローを構築できます。登録からKYC、本番送信まで、すべてのステップを自動化できます。

AIエージェントと内部ツール

API全体がブートストラップ可能であるため、AIエージェントや内部スクリプトはダッシュボードを開くことなく、ワークスペースの作成、請求書の送信、ステータスの確認ができます。

peppol.shの使用方法

このPeppol電子請求書APIの使用は、いくつかの簡単なステップで構成されています。

1. /v1/signupへの1回のcurlリクエストでアカウントを作成し、即座にサンドボックスAPIキーを取得します。
2. ps_test_キーを使用してサンドボックスモードでPeppol請求書を送信し、レスポンスに文書IDが含まれることを確認します。
3. /v1/kyc/documentsおよび/v1/kyc/submitを介して文書をアップロードおよび提出してKYCを完了します。
4. 本番用APIキーを作成し、認定Peppolアクセスポイントを通じて請求書の送信を開始します。

ブラウザは必要ありません。フロー全体をターミナルまたは自動化エージェントから実行できます。

peppol.shのターゲットオーディエンス

• インフラを管理せずにPeppol電子請求書APIを求める開発者
• SaaSおよびEコマース企業
• 会計およびERPプラットフォーム
• 請求プロバイダーおよびフィンテック企業
• AIエージェント開発者および自動化チーム
• EUの電子請求書義務化に備える企業

peppol.shは無料ですか？

peppol.shは、無料のサンドボックス環境と、本番送信向けの透明な文書ごとの従量課金を提供しています。

この料金体系により、Peppol電子請求書APIは小規模チームから大規模プラットフォームまで幅広く利用しやすくなっています。登録時にクレジットカードは不要で、クレジットは失効しません。

peppol.shの長所と短所

peppol.shに関するよくある質問

Peppol電子請求書APIの使用を開始するにはどのくらい時間がかかりますか？

APIによる登録は即時です。サンドボックスモードでは1分以内にテスト請求書を送信できます。本番稼働にはKYC承認とワークスペースの検証が必要ですが、登録にはダッシュボードや承認ステップはありません。

peppol.shはEUのどの国でも動作しますか？

peppol.shは、欧州で広く使用されているPeppolネットワークとPeppol BIS 3.0を中心に構築されています。ネットワークを通じて請求書を送受信するには、買い手と売り手がPeppolに登録されている必要があります。ルックアップエンドポイントを使用すると、名前または税務IDで登録を確認できます。

サンドボックスキーと本番キーの違いは何ですか？

サンドボックスキーはps_test_で始まり、テスト請求書をメールで配信します。本番キーはps_live_で始まり、実際のPeppolネットワークを通じて請求書を配信します。ワークスペースの検証は一度だけ行われ、承認後に本番キーが作成されます。

peppol.shでPDF請求書を送信できますか？

はい。Peppol電子請求書APIは、コンプライアンス準拠の文書を送信する2つの方法としてJSONとPDFのアップロードをサポートしています。製品ドキュメントによると、JSONはUBLに変換され、PDFは文書として提出されます。

テスト用の無料プランはありますか？

はい。すべてのアカウントはサンドボックスモードで開始し、テスト目的であれば永久に無料のままです。ユーザーは本番ワークスペースを作成する前に、サンドボックスでテスト文書を送信できます。

peppol.shはテナントごとに課金しますか？

いいえ。テナントごとの料金はなく、月額最低料金もありません。料金は送信された請求書の数に基づいており、1件あたり€0.10からです。

peppol.shタグ

Peppol電子請求書API、Peppol請求書の送信、JSONからUBL、Peppol BIS 3.0、電子請求書コンプライアンス、Peppolアクセスポイント、電子請求書API、サンドボックステスト、Stripe電子請求書、EU電子請求書義務化、自動化された電子請求書、APIファーストの電子請求書