API搭載の会計ソフト

Nordletのすべての機能が1つのJSON APIを通じて利用可能です。SDK、ウェブホック、べき等なリトライ処理、AIアシスタント向けのMCPサーバーも完備しています。

API（Application Programming Interface）とは、プログラム同士が通信するための仕組みです。会計APIを活用すれば、人間が画面を操作してクリックしなくても、自社ソフトウェアから直接請求書の作成や入金の記録、レポートの読み取りを行うことができます。

Nordletは、APIを主要なアクセス経路として設計された会計ソフトです。Webアプリで実行できるすべての操作が、同じJSON API経由で利用可能です。このページは、開発者や自社プロダクトの連携先を検討している方に向けて記載しています。

Nordletの主な機能

統一されたリクエスト形式。 すべての呼び出しは POST /v1/{module}/{resource}/{action の形式で行われ、JSONのボディを伴います。例として sales/invoices/create や bank/transactions/match などがあります。
スコープ付きAPIキー。 各キーは1つの企業に紐づき、sales:read や bank:write などのスコープを持ちます。必要なスコープを持たないキーでリクエストを行った場合、403エラーが返されます。
テキスト形式の金額。 金額は最大4桁の小数点を持つ10進数の文字列として扱われ、浮動小数点数は使用しないため、端数の丸め誤差によるペニーの損失が発生しません。
単一のエラー形式。 すべてのエラーは、コード、メッセージ、リクエストIDを含む共通のエンベロープで返されます。
共通のリストクエリ。 すべての list 呼び出しには、共通のページネーション、ソート、フィルタリングの各フィールドが適用され、集計値を含めることが可能です。
厳格な会計ルール。 仕訳エントリは貸借が一致している必要があり、伝票番号に欠番は認められません。また、締め処理が行われた会計期間に対する新規の計上は、409エラーにより拒否されます。すべての変更は監査ログに記録されます。

べき等性（idempotency）による安全なリトライ

ネットワーク障害により、サーバーでのリクエスト処理は完了したものの、その応答を受け取る前に接続が切断される場合があります。このような場合に単純にリトライを行うと、同じ請求書が二重に作成されてしまうおそれがあります。べき等性（idempotency）とは、同じリクエストを何度繰り返しても、初回と同じ結果が得られる性質を指します。

データを変更するすべてのリクエストには、Idempotency-Key ヘッダーを付与して送信してください。
同じキーとボディでリトライを行った場合、保存されていた前回の応答が x-idempotent-replay: true と共に出力されます。
同じキーに対して異なるボディでリクエストを行った場合は拒否されます。
キーは24時間保持されます。

ウェブホック（Webhooks）

ウェブホックとは、sale_invoice.paid のようなイベントが発生した際に、Nordletからお客様のサーバーへ送信される通知メッセージのことです。

イベントはデータの変更と同じデータベーストランザクション内で書き込まれるため、ロールバックされた変更についてはイベントが送信されません。
各配信には、お客様のシークレットを用いてHMAC-SHA256の署名が付与されるため、Nordletからの正当なリクエストであることを検証できます。
配信に失敗した場合、約24時間にわたりリトライが行われます。また、手動で再送を行うことも可能です。
サブスクリプションの管理は、アカウント → ウェブホック の画面またはAPI経由で行うことができます。

開発者向けツール

APIリファレンス。 OpenAPIの定義から生成されたインタラクティブなAPIリファレンスと、Postmanコレクションを提供しています。
SDK。 同一の定義から生成された、TypeScript、Python、Go、Java、C#、Ruby、PHP、Swift、Rust向けの型安全なクライアントを利用できます。SDKガイドをご確認ください。
MCPサーバー。 APIキーを使用することで、ClaudeなどのAIアシスタントがAPIの検索や呼び出しを行えるようになります。MCPサーバーガイドをご覧ください。
テスト企業（サンドボックス）。 本番環境と同様に動作するテスト用の企業環境です。テストデータとしてフラグ付けされ、申告書類や電子インボイス（e-invoice）の送信先も行政機関のテスト用エンドポイントに限定されます。
レートリミット。 APIキーあたり毎分300リクエストの制限が設けられており、残りのリクエスト数を示すヘッダーが返されます。

FAQ

APIでどのような操作が可能ですか？

請求書発行、購買管理、総勘定元帳（general ledger）、銀行照合、在庫管理、固定資産管理、給与計算、各種レポート作成、国税当局への申告など、プロダクト内のすべての機能を利用できます。入門ガイド（getting started）では、請求書の作成から付加価値税（VAT）の数値算出に至るまでの全プロセスを解説しています。

自社プロダクトに会計機能を組み込むことはできますか？

はい、可能です。Nordlet内の各企業は個別の帳簿を保持しており、お客様のソフトウェアからAPIキーを通じてそれらの帳簿を操作できます。APIには、一度計上された仕訳エントリの直接の編集や削除を行う機能はありません。誤りの修正は新たな仕訳エントリの追加として処理され、これにより改ざん不能な帳簿（immutable ledger）が維持されます。