Invoice Statuses

An invoice moves through several statuses from upload to payment.

Status lifecycle

Upload / Email sync
        │
        ▼
    nouveau          ← Freshly added, not yet reviewed
        │
        ▼ (OCR runs automatically)
   processing        ← Worker is extracting data
        │
   ┌────┴────┐
   ▼         ▼
processed   error    ← OCR succeeded / failed
   │
   ▼ (admin reviews)
  checked             ← Admin has reviewed the extracted data
   │
   ▼ (admin approves)
  approved            ← Ready for payment
   │
   ▼ (admin marks paid)
  paid                ← Payment recorded

Status descriptions

Status	Description
nouveau	The invoice has just been uploaded or imported. No OCR has run yet or OCR has not started.
processing	The background worker is currently extracting data from the invoice image.
processed	OCR extraction completed successfully. Data (amount, date, invoice number) has been filled in automatically.
error	OCR extraction failed. The invoice must be reviewed and filled in manually.
checked	An admin has reviewed the invoice details and confirmed they are correct.
approved	The invoice has been approved for payment.
paid	The invoice has been marked as paid.

Flags vs status

In addition to the status field, invoices have boolean flags that can be set independently:

Flag	Description
checked	Admin has reviewed the data
approved	Admin has approved for payment
markedAsPaid	Admin has marked the invoice as paid
archived	Hidden from the default list view