アプリ開発者向けNordlet

1つのJSON API、型付きSDK、Webhook、MCPサーバー、サンドボックス企業を活用し、自社ソフトウェアに請求書発行、帳簿付け、EUの税務申告機能を追加できます。

多くのアプリケーションでは、注文の決済、サブスクリプションの更新、返金など、金銭の移動を伴うイベントが発生します。これらのイベントはすべて、企業の帳簿に正しく反映されなければなりません。

Nordletは、APIファーストで構築された会計ソフトウェアです。Webアプリケーションで行えるすべての操作は、1つのJSON APIからも利用できます。アプリケーション側からイベントを送信するだけで、Nordletが帳簿を管理し、税務申告の準備を行います。

Nordletができること

すべてのアクションを POST /v1/{module}/{resource}/{action} として公開し、JSONボディを受け付けます（例: /v1/sales/invoices/create）。
各リクエストは、特定の企業に紐付くAPIキーによって認証されます。各キーには sales:read や sales:write などの権限スコープが付与され、実行可能な操作が制限されます。
金額は浮動小数点数ではなく、常に小数文字列として受け取るため、丸め誤差による端数のズレが生じません。
すべての変更系リクエストにおいて Idempotency-Key ヘッダーを受け付けます。同じキーを用いたリクエストを再試行した場合、処理が重複して実行されることはなく、最初のリクエストに対する応答が返されます。べき等性 (idempotency) とは、繰り返しリクエストを行っても、1回のリクエストと同じ結果をもたらす性質を指します。
すべてのエラーを共通のフォーマットで返します。
APIキーごとに1分あたり300リクエストまで許可されます。
すべての変更操作を監査ログ (audit log) に記録します。

これらのルールの詳細については、API規約ガイドを参照してください。

請求書の発行時には、欠番のない連番が割り当てられ、会計期間 (accounting period) がオープンであることが確認された上で、同一のデータベーストランザクション内で仕訳 (journal entry) が計上されます。
すべての仕訳において、借方と貸方が一致していなければなりません。トランザクションの保存時に、データベース自体がこの整合性を検証します。
発行および登録済みのドキュメントは削除できません。銀行口座の消し込み誤りなどを修正する場合は、過去のデータを編集するのではなく、逆仕訳 (reversing entry) を行います。これがイミュータブル・レジャー (immutable ledger) の仕組みです。

TypeScript、Python、Go、Java、C#、Ruby、PHP、Swift、Rust向けに、同一のOpenAPI定義から生成された型付きSDKを提供しています。SDKが公開されるまでは、ソースリポジトリから直接インストールできます。SDKガイドを参照してください。
すべてのエンドポイントが含まれるPostmanコレクションを利用できます。
MCPサーバーを利用すると、Claude CodeなどのAIアシスタントからAPIを検索し、APIキーを使って呼び出すことができます。各呼び出しは通常のリクエストと同様であり、同じスコープと制限が適用されます。
Webhookにより、sale_invoice.issued（請求書発行済み）や sale_invoice.paid（請求書支払済み）などのイベント発生をアプリケーションに通知できます。通知にはすべてHMAC署名が付与されるため、Nordletからの送信であることを検証できます。配信に失敗した場合は、約24時間にわたって再試行が行われます。

入門ガイドでは、最初のAPIキーの発行、初めての請求書作成、そして一連のサイクルの流れについて解説しています。

はい。各APIキーは1つの企業に紐付いているため、企業ごとにキーを作成します。すべてのWebhook配信には所属する企業の companyId が含まれているため、1つの受信サーバーで複数の企業を処理できます。

いいえ。Nordletが帳簿から申告書類を作成します。国や地域に応じて、Nordletから直接送信される場合や、アップロード用のファイルを生成する場合、あるいは画面に入力すべき数値が表示される場合があります。対応状況の詳細は申告サポート一覧表を参照してください。