> ## 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

> Create invoices, track payment status, and manage receivables.

# 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

```bash theme={null}
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
```

<Tip>
  Each `--line` follows the format `description:amount:tax-code`. lim calculates tax per line and
  totals automatically.
</Tip>

## Send an Invoice

Sending finalizes the invoice and creates the corresponding journal entry (Accounts Receivable):

```bash theme={null}
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:

```bash theme={null}
lim invoices create --type quote \
  --customer "XYZ Inc" \
  --valid-until 2026-04-15 \
  --line "Consulting:1000000:standard-10"
```

```bash theme={null}
# Convert a quote to an invoice
lim invoices convert inv_01KB... --due-date 2026-05-31
```

## Record Payment

```bash theme={null}
# 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
```

```bash theme={null}
# 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

```bash theme={null}
# 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:

```bash theme={null}
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

<Warning>
  Ensure your company's invoice registration number is configured in `lim companies update   --tax-registration-number T...`. This number appears on all sent invoices.
</Warning>

## Receivables Aging

Track outstanding receivables by age:

```bash theme={null}
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

```bash theme={null}
lim invoices void inv_01KE... --reason "Duplicate invoice"
```

```
✅ Invoice inv_01KE... voided
   Reversal entry je_01KF... created
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Bank Reconciliation" icon="building-columns" href="/guides/bank-reconciliation">
    Match payments to bank transactions.
  </Card>

  <Card title="Financial Reports" icon="chart-line" href="/guides/financial-reports">
    Receivables aging and revenue reports.
  </Card>
</CardGroup>