nice to have
Back to the shelf Sign in Submit a kit
← All kits

Invoice & Receipt Kit

Talk it through to get invoices and receipts, tracked until paid

How to use
Example output from Invoice & Receipt Kit

Invoice & Receipt Kit is a vibe coding kit for Claude Code and Codex. Talk it through to get invoices and receipts, tracked until paid. It includes 8 fixes for pitfalls the maker hit in real work. Free.

When this helps

Every time you issue an invoice, you worry about missing details and tax miscalculation

What it does

Turns what you say into an invoice or delivery note with Japan's invoice-system details and consumption tax calculated correctly. Mention a product code and it copies the name, price and tax rate from your product list; it also handles monthly summary invoices and invoices built from a quote. Before issuing, it checks for things to fix (✗), such as a missing transaction date, a wrong registration number, or a due date before the issue date, and things to confirm (△), such as a mismatch with a quote total. Issuing produces a numbered PDF; corrections are kept as a new version. Payments are recorded after you confirm a proposed match against a bank statement; receipts built from a payment work out the revenue stamp duty for paper receipts of 50,000 yen or more. Invoices, payments, due dates and corrections are all tracked in an Excel ledger.

The fixes baked into this kit

  1. A one-digit error in the registration number went throughThe registration number was only checked for the "T + 13 digits" shape, so a single wrong digit still passed. Now the corporate number's check digit is verified too.
  2. Invoices printed the issue date in place of a missing transaction dateLine items with no transaction date silently got the issue date printed instead. A missing transaction date is now flagged to fix (✗); monthly summary invoices pass if a billing period is given.
  3. Order totals and invoice totals were off by a few yenThe order screen rounds tax down per line, while the invoice rounds down once per tax rate, so identical orders came out a few yen apart. Invoices built from a quote are now flagged to confirm (△) if they differ from the quote total.
  4. The due date was missing from invoicesThe due date existed in the data but was never printed on the invoice. It is now shown in bold, and flagged to confirm (△) if missing.
  5. Spec-sheet headings like "JAN code" or "case" were read as product namesImporting from 31 real product lists misread headings such as "JAN code" and "case" as the product name. The tool now tells apart table, one-item-per-sheet and side-by-side layouts and only uses the actual name field.
  6. Tax rates were guessed when missingNone of the product lists had a tax-rate column. Rather than guess 8% or 10%, the field is left blank for a person to decide.
  7. Overpayments showed a negative remaining balanceWhen a payment exceeded the invoice total, the screen showed a remaining balance like "-¥9,440". It now reads as "amount received in excess".
  8. A symbol in an invoice number could write to the wrong folderPutting a "/" at the start of an invoice number let it write into a different folder. Invoice numbers are now restricted to 1-6 letters.

What's inside

  • The flow (draft → check → issue → payment → receipt → ledger)
  • A check that the invoice has all required Japanese invoice details
  • Consumption tax rounded once per tax rate, not per line
  • Due dates calculated from each client's billing cutoff
  • A tool that matches payments against a bank statement
  • Receipts with the revenue stamp duty amount worked out
  • An Excel ledger of invoices, payments and due dates
  • A sample company you can try it on
File list (40)
  • .gitignore
  • AGENTS.md
  • CLAUDE.md
  • KIT.md
  • NOTES.md
  • data/README.md
  • output/README.md
  • rules/CHECK.md
  • rules/FLOW.md
  • rules/LAW.md
  • rules/PROMPTS.md
  • rules/SPEC.md
  • rules/TONE.md
  • samples/midoridai-office/bank-statement.csv
  • samples/midoridai-office/company.json
  • samples/midoridai-office/fix2.json
  • samples/midoridai-office/invoice1.json
  • samples/midoridai-office/invoice2.json
  • samples/midoridai-office/invoice3.json
  • samples/midoridai-office/receipt-request.json
  • samples/midoridai-office/revision1.json
  • tools/draft.mjs
  • tools/issue.mjs
  • tools/items.mjs
  • tools/ledger.mjs
  • tools/lib/bank.mjs
  • tools/lib/book.mjs
  • tools/lib/input.mjs
  • tools/lib/invoice.mjs
  • tools/lib/law.mjs
  • tools/lib/layout.mjs
  • tools/lib/ledger.mjs
  • tools/lib/paths.mjs
  • tools/lib/pdf.mjs
  • tools/lib/receipt.mjs
  • tools/lib/regno.mjs
  • tools/lib/render.mjs
  • tools/lib/request.mjs
  • tools/lib/result.mjs
  • tools/lib/run.mjs

The first three decisions

  1. The client (who you are invoicing)
  2. The period covered (which month's work)
  3. Items and quantities (copied from your product list by code)

What you need

  • No extra costClaude Code or CodexBoth CLAUDE.md and AGENTS.md are included
  • No extra costNode.js 18 or newerTo run the tools. Nothing else to install
  • No extra costGoogle Chrome or Microsoft EdgeTo produce PDFs. Without one, open the file in a browser and use "Print to PDF"
  • No extra costExcel or NumbersTo view company info, invoice entries and the ledger

How to use

Just paste this into your AI.

I want to use the nice to have kit "Invoice & Receipt Kit". Follow https://nicetohave.app/en/g/VDL2DTR6-•••••••••• and set it up.

Works the same in Claude Code or Codex.
Read what this tells your AI to do, before you paste it

If you would rather take the files yourself

Paste the line above and your AI fetches it. If your AI cannot fetch it, or you would rather download it yourself, start here.

Download the kit as a zip

  1. Unpack the zip you downloaded
  2. Open the resulting folder in Claude Code or Codex (in VS Code, "Open Folder")
  3. Type "start building with this kit". The instructions are inside (Claude Code reads CLAUDE.md, Codex reads AGENTS.md)

FAQ

Can I use it if I'm not registered for the invoice system?
Yes. It leaves out the registration number and shows the tax-inclusive total per tax rate with "of which, consumption tax equivalent." It won't produce anything that could be mistaken for a qualified invoice.
I already use the estimate kit. Do I need to re-enter my company details?
No. Your company details and product list from the estimate kit can be used as they are. Missing rows such as bank details are added during setup, and the previous file is kept as a backup.
Will it email invoices to my clients?
No. The kit stops at making the PDF; a person sends it. It does include sample wording for the cover email and for a payment reminder once the due date has passed.
Do receipts sent as PDFs need a revenue stamp?
It tells you a PDF doesn't need one, based on the National Tax Agency's view that items handed over electronically aren't subject to stamp duty. If you print it and hand over a paper copy instead, a stamp is needed.
What happens when a client deducts the bank transfer fee from the payment?
If the shortfall is ¥1,000 or less and looks like a fee, it asks whether to treat it as one. It also notes that deducting the fee isn't allowed for transactions covered by the Subcontract Act (now the SME Subcontracting Act), but whether you're covered and what to do is the company's call.

Reviews

Used it? Leave a rating
A few words are optional. A thank-you, or show off what you made. It goes to the maker.
Sign in with GitHub to write

Supporters

Once support opens, the people who backed this kit will be listed here.

Publisher
shuto-shinoda
Published
2026/10/07
Price
Free
Category
Delegate work
Personal data
Handled
Security review
Needed (depends what you handle)
What's inside
The flow (draft → check → issue → payment → receipt → ledger)A check that the invoice has all required Japanese invoice detailsConsumption tax rounded once per tax rate, not per lineDue dates calculated from each client's billing cutoffA tool that matches payments against a bank statementReceipts with the revenue stamp duty amount worked outAn Excel ledger of invoices, payments and due datesA sample company you can try it on

More kits