領収書をPDFで発行してメール送信（kinvoice ＋ VWork教材）

領収書をPDFで発行し、ダウンロードURLをお客様へメールで送るシステムです。フォームに 顧客名・メールアドレス・金額（税込）・発行日・但し書き を入れるだけで発行できます。発行した領収書は送信履歴に残り、再送やPDFの確認ができます。

■ PDFをメールに添付しません

添付にすると、宛先を1文字間違えた瞬間に領収書が他人の手元に残ります。取り消せません。本システムは推測困難なURL（32桁）を送り、開いたら宛先メールアドレスの入力を求めます。2つ揃わないと開きません。認証前の画面には顧客名も金額も領収書番号も出しません。メールアドレスを10回間違えるとロックします。

■ 領収書としての体裁

宛名・金額（税込）・但し書き・発行日・発行元・税率ごとの内訳（10% / 8% / 対象外）。適格請求書発行事業者の登録番号は、設定したときだけ印字します（未設定なら「記載しておりません」と出るので、架空の番号を書く必要がありません）。電子交付につき収入印紙は不要である旨も印字します。税額の内訳は端数が出ても合計が必ず税込総額に一致します（9,999円 → 9,090 ＋ 909）。

■ 動作環境

PHP 7.4以上が動くサーバーがあれば動きます。データベースは不要（JSONにflockで書きます）。Composer も npm も使いません。FTPで上げるだけで設置できます。

■ AIエージェントに設置してもらえます

CLAUDE.md / AGENTS.md / INSTALL.md を同梱しています。Claude Code や Codex にフォルダを渡すと、各手順の確認つきで設置まで進められます。設定が足りないうちは、管理画面が不足している項目を名指しで表示します。

■ 教材が付いています

このシステムをAIと1日で作る間に実際に踏んだ「6つの罠」の記録が入っています。メールが「送信済」なのに届かない（SPF）／設定を置いても効かない（defineは先勝ち）／動いているのに売り物にならなかった／サーバーの設定を古い版で上書きしかけた／画像が汚い原因が直感と逆だった／数字を読み違えて結論を間違えた。すべて実際に起きたことです。

あわせて、請求書・見積書へ改造する練習問題と、AIと仕事を進めるための作法をまとめた VWork 一式を同梱しています。

■ ライセンス

MIT License。商用利用・再販・改変・再配布が自由に行えます。動くコード自体は GitHub でも公開しています（https://github.com/katsushi2441/kinvoice）。本商品で提供しているのは、それに加えた教材・AI向け設置手順書・VWork 一式です。

■ サポート

ダウンロード販売のため、設置作業と伴走支援は含まれません。設置代行・改造代行・継続的な相談は、有償のサポートとして別途承ります。

■ こんな方に

・領収書の発行依頼が来るたびに、Excelで作ってPDFにして送っている

・宛名や但し書きの書き間違いで、作り直しが発生している

・メール添付で送っていて、誤送信が怖い

・インボイス制度の体裁を満たしているか自信がない

・レジや会計ソフトを入れるほどの規模ではない

■ なぜPDFを添付しないのか

これは本製品でいちばん考えた点です。

添付方式は、宛先を1文字間違えた瞬間に他人の手元へ領収書が残ります。送信を取り消しても、相手のメールボックスからは消えません。金額と宛名が書かれた書類なので、これは事故です。

本製品は、推測困難な32桁のURLを送り、開いたときに宛先メールアドレスの入力を求めます。URLとメールアドレスの2つが揃わないと開きません。 認証前の画面には顧客名も金額も領収書番号も出しません。10回間違えるとロックします。

手間は1手増えますが、誤送信が事故にならなくなります。

■ 導入の流れ

1. レンタルサーバーにFTPでアップロードする（データベースの用意は不要）
2. 設定ファイルに社名・住所・登録番号（あれば）を書く
3. 自分宛にテスト発行して、届いたメールとURLの挙動を確認する

設定が足りないうちは、管理画面が不足している項目を名指しで表示します。

■ できないこと

正直に書いておきます。

・請求書の発行は入っていません（kbilling が担当です）

・売上の集計・会計ソフト連携は入っていません

・レジ機能・キャッシュドロア連動はありません

・収入印紙の貼付が必要な紙の領収書には対応していません（電子交付なので不要である旨を印字します）

・電子帳簿保存法のタイムスタンプには対応していません

領収書を発行して、安全に届けて、履歴を残すところに絞った道具です。

■ 税額の内訳について

税込総額から内訳を出すとき、単純に割ると合計が総額に一致しないことがあります。本製品は端数が出ても合計が必ず税込総額に一致するようにしています（9,999円 → 9,090 ＋ 909）。Excelの自前テンプレートから移ると1円合わないことがありますが、正しいのは本製品の側です。

■ この商品固有のご質問

Q. 適格請求書発行事業者の登録番号は必須ですか？

A. 必須ではありません。設定したときだけ印字し、未設定なら「記載しておりません」と表示します。架空の番号を書いてしまう事故が起きない作りです。

Q. 発行済みの領収書を再送できますか？

A. できます。送信履歴に残るので、そこから再送とPDFの確認ができます。

Q. お客様がメールアドレスを忘れたらどうなりますか？

A. 発行時に入力したアドレスが正解です。管理画面で確認して、口頭で伝えるか再送してください。10回間違えるとロックがかかります。

Q. 何件まで発行できますか？

A. 上限はありません。オンプレミスなので、件数による課金もありません。