Create AR invoice

Creates a new AR invoice or credit note with line items. The customer must exist. Invoice numbers are unique per customer.

create_outgoing_invoice

Authorization

Authorization string header required API key in the format ll_.... Pass as a Bearer token in the OAuth flow.

Scopes

debitoren:write

Parameters

customer_id string (uuid) required Customer ID

invoice_number string required Invoice number (max 100)

invoice_date string required Invoice date (YYYY-MM-DD)

due_date string optional Due date (YYYY-MM-DD)

total_net number required Net amount

total_tax number required Tax amount

total_gross number required Gross amount

currency string optional Currency (ISO 4217, default: EUR)

type string required "invoice" or "credit_note"

intent_id string (uuid) optional Link journal intent (sets status to open)

lines array required Invoice line items with position, description, quantity, unit_price, tax_rate, tax_amount, line_total

notes string optional Free-text notes (max 2000)

Response

200

Success

MCP create_outgoing_invoice

JSON

{
  "tool": "create_outgoing_invoice",
  "params": {
    "customer_id": "<string>",
    "invoice_number": "<string>",
    "invoice_date": "<string>",
    "due_date": "<string>",
    "total_net": 1,
    "total_tax": 1,
    "total_gross": 1,
    "type": "<string>",
    "lines": [
      {
        "position": 1,
        "description": "<string>",
        "quantity": 1,
        "unit_price": 1,
        "tax_rate": 1,
        "tax_amount": 1,
        "line_total": 1
      }
    ]
  }
}

200 Response

JSON

{
  "id": "<string>"
}