ricono 作ったものと、詰まった箇所の記録

freee APIで毎月の請求書発行を自動化した話(詰まった6箇所の記録)

freeeAPI業務自動化個人事業

毎月末、同じ内容の請求書を数社ぶん作っていました。金額も件名も先月と同じ。違うのは日付だけです。

1社3分としても、確認まで含めれば30分弱。年間で6時間。作業そのものより、「今月まだやってない」が頭の片隅に居座り続けるのが嫌でした。

freee にはAPIがあるので、スクリプトにしました。いまは1コマンドで全社ぶんが発行されます。

ただ、公式ドキュメントを読んだだけでは動きませんでした。実際に動かすまでに6箇所で詰まりました。 そこだけ書き残します。手順そのものは公式を読めば分かるので、ここでは繰り返しません。

前提

「毎月まったく同じものを作る」という条件だからこそ自動化が効きます。毎回内容が変わる請求書には向きません。


1. Python 3.14 で証明書の検証に失敗する

最初に止まったのはAPIの話ですらなく、SSLでした。

CERTIFICATE_VERIFY_FAILED

スクリプトを書き終えて実行した瞬間にこれです。コードは1行も実行されていません。

原因は Python が OS の証明書ストアを見ていないことでした。Windows の場合、certifi が持っている証明書と、OSが信頼している証明書がずれていると起きます。

解決は truststore を入れて、OS側の信頼ストアを使わせるだけでした。

import truststore
truststore.inject_into_ssl()

これを他のimportより先に置きます。1行で済む話ですが、「APIの認証を間違えたか」と疑って30分溶かしました。証明書エラーは認証エラーに見えるので、最初に切り分けるべきでした。

2. 支払期日のフィールド名が payment_due_on ではない

ここが一番たちが悪かったところです。

請求書は作成に成功します。レスポンスも200。画面で開くと、支払期日だけが空。

payment_due_on という名前で送っていました。それらしい名前なので疑いませんでした。正しくは:

"payment_date": "2026-11-30",   # ← これ

知らないキーを送ってもエラーにならず、黙って無視されます。 作成自体は成功するので、気づくには出来上がった請求書を目視するしかありません。

API連携で一番怖いのはエラーで落ちることではなく、成功を名乗って中身が欠けることだと改めて思いました。自動化したあとも、最初の数ヶ月は現物を目で見たほうがいいです。

3. withholding_tax_entry_method は必須

源泉徴収を使っていなくても省略できません。省略すると 400 で落ちます。

"withholding_tax_entry_method": "out",

エラーメッセージからはこのキーだと分からず、必須項目を一つずつ足して特定しました。

4. unit_price は文字列で渡す

数値で渡すと通りません。

"unit_price": "50000",   # 文字列。50000 ではない

金額を文字列で持つのは違和感がありますが、そういう仕様です。

5. 請求書一覧APIの日付フィルタが効かない

「同じ請求書を二重に作らない」ようにするため、発行前に既存の請求書を取りに行きます。ここで一番時間を使いました。

つまり「今月の請求書があるか」を見たいのに、一番古いところから100件ずつ辿ることになります。offset を増やしながら最後まで取りに行くしかありませんでした。

offset = 0
rows = []
while True:
    page = get_invoices(offset=offset, limit=100)
    rows += page
    if len(page) < 100:
        break
    offset += 100

件数が増えるほど遅くなる作りなので、将来的には取得済みの請求書番号を手元に持っておくべきだと思っています。いまはまだ件数が少ないので素直に全件取っています。

6. 二重作成を防ぐキーの選び方

同じ月に2回実行しても請求書が増えないようにします。判定は 取引先ID × 請求日 で行いました。

key = (invoice["partner_id"], invoice["billing_date"])

請求書番号や件名で判定すると、件名が変わったときに二重に作られます。内容ではなく「誰に・いつの分か」で見るのが正解でした。

これがあるので、途中で失敗しても何度でも流し直せます。自動化で一番大事なのは速さではなく、気軽に再実行できることだと思っています。


いまの運用

月末に1コマンド流すと、全社ぶんの請求書が下書きで作られます。できたものを画面で一覧して、問題なければ送付する。

手作業は30分から3分になりました。ただ、正直なところ、節約できた時間より「忘れない」ことのほうが価値がありました。 請求を出し忘れると入金が1ヶ月ずれます。それが構造的に起きなくなったのが大きい。

向く人・向かない人

向く:毎月同じ取引先に、同じ金額・同じ件名で請求している。取引先が3社以上ある。

向かない:毎回内容が変わる。取引先が1〜2社(手でやったほうが早い)。

スクリプトを書く時間は、詰まった箇所を含めて半日ほどでした。上に書いた6箇所を踏まなければ2時間で終わると思います。この記事がその2時間になれば十分です。


使っているもの

← 記事一覧