Invoices Lifecycle

​

Invoice states

​

DRAFT

• No invoice number or date
• Does not affect AP/AR balances
• Can update amounts, line items, tax
• Can be deleted

​

FINALIZED

• Has sequential invoice number
• Has official invoice date
• Due date calculated (if payment_terms provided)
• Affects AP/AR balances
• Immutable - corrections require credit notes

​

CANCELLED

​

State transitions

DRAFT → finalize() → FINALIZED

​

Creating an invoice

curl https://api.nocotax.app/invoices \
  -u ${ACCOUNT_ID}:${YOUR_API_KEY} \
  -H "Content-Type: application/json" \
  -d '{
    "flow": "sales",
    "currency": "EUR",
    "customer_id": "org_customer_123",
    "items": [
      {
        "description": "Monthly Subscription",
        "quantity": 1,
        "unit_extratax_amount": 9900
      }
    ]
  }'

​

Finalizing an invoice

curl https://api.nocotax.app/invoices/inv_123/finalize \
  -X POST \
  -u ${ACCOUNT_ID}:${YOUR_API_KEY}

1. Invoice number assigned
2. Invoice date set to today
3. Due date calculated (from payment_terms)
4. AP/AR balances updated
5. Invoice locked from changes

​

Payment status

​

Working with finalized invoices

​

Attaching payments

​

Correcting errors

curl https://api.nocotax.app/credit_notes \
  -u ${ACCOUNT_ID}:${YOUR_API_KEY} \
  -H "Content-Type: application/json" \
  -d '{
    "flow": "sales",
    "currency": "EUR",
    "customer_id": "org_customer_123",
    "invoice_id": 'inv_123',
    "items": [
      {
        "description": "Monthly Subscription",
        "quantity": 1,
        "unit_extratax_amount": 9900
      }
    ]
  }'

​

Best practices

• Review drafts carefully before finalizing
• Finalize invoices promptly - don’t leave in DRAFT
• Use payment_terms for automatic due date calculation
• Issue credit notes for corrections, never modify finalized invoices
• Track payment status for automated reminders