Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.uselim.com/llms.txt

Use this file to discover all available pages before exploring further.

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 --tax-registration-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

Bank Reconciliation

Match payments to bank transactions.

Financial Reports

Receivables aging and revenue reports.