latepayers

latepayers：請求書 CSV から売掛金のエイジングレポートを作成

誰にいくらの未払いがあり、各請求書の支払いがどれだけ遅れているか、誰に最初に督促すべきかを確認できます。スプレッドシートで延滞中の請求書を管理しているフリーランス、小規模事業者、簿記担当者向けです。

支払いの遅れは、気付かないうちにキャッシュフローを圧迫します。latepayers は請求書のエクスポートデータを CSV として読み込み、標準的な期間区分で顧客ごとに集計し、延滞金額と経過期間の順に並べた売掛金のエイジングレポートを作成します。また、各顧客が通常どれくらい遅れて支払うかも表示します。これは MCP サーバーであり、単体の Go バイナリとしても利用できます。アカウント、API キー、ネットワークアクセスは不要です。

エージェントに尋ねられること

• 「誰にいくらの未払いがあり、どれくらい遅れていますか？」
• 「どの延滞請求書から優先して督促すべきですか？」
• 「売掛金のエイジングレポートを作成してください。」
• 「いつも支払いが遅れる顧客は誰ですか？」

インストール

MCP サーバーと、Claude に利用するタイミングを知らせるスキルを追加する Claude Code プラグインとしてインストールできます。npx でサーバーを実行するため、Node が必要です。

claude plugin marketplace add GillMacedo/latepayers
claude plugin install latepayers@latepayers-marketplace

その他の MCP クライアントの場合：

{
  "mcpServers": {
    "latepayers": {
      "command": "npx",
      "args": ["-y", "latepayers", "serve"]
    }
  }
}

または、Go 1.27 以降でバイナリをビルドします。

go install github.com/GillMacedo/latepayers@latest

使い方

何もインストールせずに、npx latepayers check invoices.csv を実行します。--as-of を指定しない場合は、今日の日付が使用されます。この例では、examples/ にある架空のファイルを使用しています。

$ go run . check examples/invoices.csv --as-of 2026-10-31
2026-10-31 時点：5745.50 未決済、3745.50 延滞（65.2%）
期限前：2000.00 | 1-30：500.00 | 31-60：975.00 | 61-90：0.00 | 90+：2270.50
優先して督促：
  Example Supplies Ltd  1700.00 延滞／未決済 1700.00、最古 92 日
    INV-2001  1200.00  期限 2026-07-31  92 日延滞
    INV-2002  500.00  期限 2026-10-01  30 日延滞
  Demo Bakery  620.00 延滞／未決済 620.00、最古 122 日
    INV-2009  620.00  期限 2026-07-01  122 日延滞
  Fictional Cafe  450.50 延滞／未決済 450.50、最古 139 日、通常 25.0 日遅れで支払い
    INV-2003  450.50  期限 2026-06-14  139 日延滞
  Sample Widgets  975.00 延滞／未決済 2975.00、最古 42 日、通常 3.0 日早く支払い
    INV-2007  975.00  期限 2026-09-19  42 日延滞
    INV-2006  2000.00  期限 2026-11-09  延滞なし
クレジット  INV-2010  -75.00
スキップ行 13：顧客、金額、日付がありません

--terms 45 を追加すると、支払期限のない請求書に適用する支払い条件を設定できます。機械可読形式で出力するには --json を追加します。

計算方法

値	ルール
未決済金額	残高列があればその値、なければ請求額から支払済み金額を差し引いた値
支払期限	期限日列があればその日付、なければ請求日から支払い条件の日数（既定値は 30 日）を加算した日付
期間区分	期限前、1～30 日、31～60 日、61～90 日、90 日超の延滞
督促の優先順位	延滞金額に延滞日数を掛けた値を合計し、その順に並べます
通常の延滞日数	支払い日列がある場合、支払い日から支払期限を差し引いた日数の平均

残高がマイナスの場合はクレジットとして表示し、合計には含めません。請求書番号の重複や通貨の混在があると、警告が表示されます。

MCP ツール

ツール	機能
receivables_aging_report	大きなファイルに対する上限を指定して、優先度別の合計額、期間区分、顧客を返します
receivables_inspect_csv	行の内容を表示せずに、検出された列と行数を表示します

どちらも読み取り専用で、誰かに連絡することはありません。receivables_aging_report は顧客名と金額を MCP クライアントに返すため、使用する AI モデルにそれらの情報が渡ります。CLI ではすべての処理がご利用のマシン上で完結します。

FAQ

売掛金のエイジングレポートとは何ですか？ 未払いの請求書を支払期日からの経過日数ごとに分類し、どれだけの金額がリスクにさらされているか、誰に連絡すべきかを確認できるようにするものです。

QuickBooks、Xero、FreshBooks のエクスポートに対応していますか？ CSV を読み込み、Balance Due などの一般的な列名を認識します。--columns customer=Who,amount=Sum のように、ほかの列名を指定することもできます。これらの製品には接続せず、それぞれの実際のエクスポートデータでのテストもまだ行っていません。

支払いのリマインダーを送信できますか？ いいえ。連絡すべき相手をお知らせします。メッセージはご自身またはエージェントが下書きを作成し、承認できます。

制限事項

• これは売掛金回収の管理に役立つものであり、会計や法律に関する助言ではありません。
• 正確性はエクスポートデータに依存するため、顧客に連絡する前に残高を確認してください。
• 請求書へのクレジットの適用や、通貨の換算は行いません。
• 顧客名が異なれば、それぞれ別の顧客として扱います。
• 読み込み可能なのは最大 50 MB の CSV ファイルのみです。
• これまでにテストしたのは架空のデータで、実際のエクスポートデータではありません。お手元のデータで問題が起きた場合は、データではなく列見出しを添えて issue を作成してください。

貢献

個人の方も、AI エージェントと協働している方も、貢献を歓迎します。CONTRIBUTING.md をご覧ください。最初に取り組むのに適した issue：

• ほかの会計ツールや言語の列名を追加する
• レポートを CSV に書き出す --out を追加する
• サマリーに売上債権回転日数（DSO）を追加する
• 支払遅延日数順に並べ替えた請求書別の表示を追加する
• プラグインアイコンを追加する

プルリクエストの流れ

1. PR を作成します。 リポジトリをフォークし、ブランチで作業して、変更は 1 つに絞ってください。ユーザー向けの変更内容がわかるタイトルを付けてください。タイトルは変更履歴にも記載されます。feat: は Added、fix: は Fixed の項目に入ります。
2. 自動チェック。 コードの変更にはテストが必要で、make test が成功しなければなりません。30 行を超える変更には、リンクされた未解決の issue（Closes #<number>）が必要です。また、PR の変更行数は最大 800 行です。不足がある場合は、修正内容をコメントでお知らせします。
3. レビュー。 Claude が各 PR を自動的にレビューします。コードの PR にはセキュリティレビューも行われ、サンドボックスでテストされます。その後、レビュー担当者が PR をマージするか、変更を依頼します。CI、エージェント設定、npm または Python の依存関係、ベンダーコード、ビルドファイルを変更する PR は、この方法ではマージできません。その旨をコメントでお知らせします。セキュリティレビューで承認されなかった変更も同様です。
4. リリース。 ユーザーがインストールする内容に影響する変更がマージされると、約 2 時間以内に新しいバージョンがリリースされ、GitHub Release と、プロジェクトにある場合は npm パッケージが公開されます。ドキュメントと CI の変更は次のリリースまで保留されます。

AI に関する開示

このプロジェクトは主に Claude Code で生成され、メンテナーがレビューしました。

自己紹介

私は Giulliano Macedo です。GoTech Solutions で開発者向けツールを作っています。近況の確認やお問い合わせはこちらからどうぞ。

• GitHub：GillMacedo
• LinkedIn：giulliano
• X：@giumacedo

latepayers が入金のお役に立った場合は、スターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

---

MIT ライセンスです。

Giulliano Macedo、GoTech Solutions が開発 · LinkedIn · X