Skip to main content

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