Invoicing
lim manages the full invoice lifecycle from draft to payment, with automatic journal entry generation and receivables tracking.
Invoice Lifecycle
draft → sent → partially-paid → paid
→ overdue (auto-detected)
→ void
Create an Invoice
lim invoices create \
--customer "ABC Corp" \
--due-date 2026-04-30 \
--line "Web development services:500000:standard-10" \
--line "Server hosting (March):30000:standard-10"
✅ Invoice created: inv_01K9...
Customer: ABC Corp
Subtotal: ¥530,000
Tax (10%): ¥53,000
Total: ¥583,000
Due: 2026-04-30
Status: draft
Each --line follows the format description:amount:tax-code. lim calculates tax per line and totals automatically.
Send an Invoice
Sending finalizes the invoice and creates the corresponding journal entry (Accounts Receivable):
lim invoices send inv_01K9...
✅ Invoice inv_01K9... sent
Created je_01KA...:
DR Accounts Receivable 583,000
CR Sales Revenue 530,000
CR Output VAT 53,000
PDF generated: invoice-ABC-2026-03.pdf
Create a Quote
Quotes follow the same structure but don’t create journal entries:
lim invoices create --type quote \
--customer "XYZ Inc" \
--valid-until 2026-04-15 \
--line "Consulting:1000000:standard-10"
# Convert a quote to an invoice
lim invoices convert inv_01KB... --due-date 2026-05-31
Record Payment
# Full payment
lim invoices pay inv_01K9... --amount 583000 --date 2026-04-15
✅ Payment recorded for inv_01K9...
Created je_01KC...:
DR Checking Account 583,000
CR Accounts Receivable 583,000
Status: paid
# Partial payment
lim invoices pay inv_01K9... --amount 300000 --date 2026-04-10
✅ Partial payment recorded
Remaining: ¥283,000
Status: partially-paid
List and Filter Invoices
# All invoices
lim invoices list
# Filter by status
lim invoices list --status overdue
# Filter by customer
lim invoices list --customer "ABC Corp"
ID Customer Amount Due Date Status
inv_01K9.. ABC Corp 583,000 2026-04-30 paid
inv_01KD.. XYZ Inc 1,100,000 2026-05-31 sent
inv_01KE.. DEF Ltd 220,000 2026-03-15 overdue
Invoice System Compliance (インボイス制度)
lim generates invoices that comply with Japan’s Qualified Invoice System:
lim invoices send inv_01KD... --invoice-number T1234567890123
The generated PDF includes all required fields:
- Qualified invoice issuer registration number (T + 13 digits)
- Tax rate breakdown (10% and 8% separated)
- Tax amount per rate
- Transaction date and description
Ensure your company’s invoice registration number is configured in lim companies update --invoice-number T.... This number appears on all sent invoices.
Receivables Aging
Track outstanding receivables by age:
lim reports aging --date 2026-04-30
Receivables Aging (as of 2026-04-30)
────────────────────────────────────────────────
Customer Current 1-30d 31-60d 61-90d Total
XYZ Inc 1,100,000 1,100,000
DEF Ltd 220,000 220,000
────────────────────────────────────────────────
Total 1,100,000 0 220,000 0 1,320,000
Void an Invoice
lim invoices void inv_01KE... --reason "Duplicate invoice"
✅ Invoice inv_01KE... voided
Reversal entry je_01KF... created
Next Steps