LedgerLou Receivables
The Receivables module covers the entire receivables process: create customers, capture outgoing invoices and credit notes, and track open receivables through to payment receipt.
API ReferenceCustomer master dataManage receivables centrally with IBAN, USt ID number, default revenue account, and address
Outgoing invoicesCapture invoices and credit notes with line items, tax amounts, and due dates in a structured way
Credit notesCapture credit notes as a dedicated invoice type — automatic clearing against open receivables
Open items listView receivables grouped by customer with remaining amounts, due dates, and credit-note clearing
Duplicate detectionDuplicate names (case-insensitive), tax numbers, USt ID numbers, and invoice numbers are detected and rejected automatically
API & MCPFull REST access, MCP tools available for the core flow
Workflow
1
Create a customerCreate a customer with name, IBAN, USt ID number, and optional default revenue account via the dashboard or
POST /v1/customers. Duplicate names, tax numbers, and USt ID numbers are detected automatically — the error response contains the ID of the existing customer.2
Capture an outgoing invoiceCreate an outgoing invoice via
POST /v1/outgoing-invoices with line items. For credit notes, use type credit_note.3
Link the invoice to the journalVia
PATCH /v1/outgoing-invoices/ the invoice is linked to a journal intent. The status changes from draft to open. Credit notes are marked as paid immediately.4
Monitor open receivables
GET /v1/outgoing-invoices/open-items shows all unpaid invoices grouped by customer. Credit notes are cleared automatically.5
Payment receipt and settlementIncoming payments are reconciled via the Bank module. This reduces the open receivable and sets the status automatically to
partially_paid or paid.Status lifecycle
| Status | Meaning |
|---|---|
draft | Invoice captured but not yet posted (no intent) |
open | Linked to the journal, fully open |
partially_paid | Partial payment received |
paid | Fully paid (or credit note with intent) |
overdue | Open invoice past its due date |
Credit notes
Credit notes are captured as outgoing invoices with type = 'credit_note'. Amounts stay positive — the settlement direction is determined by the type and the posting direction:
- Posting: Revenue (debit) to receivables (credit)
- Status: Credit notes with an
intent_idare consideredpaidimmediately - Open items: Credit notes are cleared against open invoices of the same customer
Access methods
Dashboard (UI)Manage customers, capture outgoing invoices, and inspect open receivables.
REST APIManage customers, outgoing invoices, and open receivables programmatically.
MCPMCP agents can create customers, capture outgoing invoices, and query open receivables.
Scopes
debitoren:readdebitoren:write