Incasso API
van factuur tot dossier in één request.

Endpoints

Blader door alle endpoints, velden en voorbeelden in de interactieve API-reference. De onderliggende machine-leesbare specificatie staat op /api/v1/openapi.json (OpenAPI 3.1), direct bruikbaar in Postman, Insomnia of uw codegenerator.

Voorbeelden in uw taal

PHP

<?php
$opdracht = [
    'type' => 'incasso',
    'reference' => 'ORDER-2026-0042',
    'debtors' => [[
        'type' => 'business',
        'company_name' => 'Voorbeeld Webshop B.V.',
        'customer_number' => 'KLANT-1234',
        'address' => [
            'street' => 'Hoofdstraat', 'house_number' => '12',
            'postal_code' => '1234 AB', 'city' => 'Amsterdam',
        ],
    ]],
    'invoices' => [[
        'invoice_number' => 'F2026-0815',
        'invoice_date' => '2026-04-01',
        'payment_term_days' => 14,
        'amount_cents' => 125000, // € 1.250,00
    ]],
    'attachments' => [[
        'filename' => 'F2026-0815.pdf',
        'content_base64' => base64_encode(file_get_contents('factuur.pdf')),
    ]],
];

$ch = curl_init('https://nl.legal/api/v1/orders');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('NLLEGAL_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => json_encode($opdracht),
    CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);

if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 201) {
    echo "Dossier aangemaakt: " . $result['case']['case_number'];
    foreach ($result['warnings'] as $warning) {
        echo "\nLet op: " . $warning['message'];
    }
} else {
    echo "Fout: " . $result['detail'];
}

Python

import base64
import os
import uuid

import requests

opdracht = {
    "type": "pre-incasso",
    "reference": "ORDER-2026-0042",
    "debtors": [{
        "type": "individual",
        "first_name": "Jan",
        "last_name": "Jansen",
        "customer_number": "KLANT-5678",
        "address": {
            "street": "Kerkstraat", "house_number": "1",
            "postal_code": "9712 AB", "city": "Groningen",
        },
    }],
    "invoices": [{
        "invoice_number": "F2026-0901",
        "invoice_date": "2026-05-01",
        "due_date": "2026-05-15",
        "amount_cents": 50000,  # € 500,00
    }],
}

with open("factuur.pdf", "rb") as f:
    opdracht["attachments"] = [{
        "filename": "F2026-0901.pdf",
        "content_base64": base64.b64encode(f.read()).decode(),
    }]

response = requests.post(
    "https://nl.legal/api/v1/orders",
    json=opdracht,
    headers={
        "Authorization": f"Bearer {os.environ['NLLEGAL_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    timeout=60,
)

if response.status_code == 201:
    data = response.json()
    print("Dossier aangemaakt:", data["case"]["case_number"])
else:
    print("Fout:", response.json()["detail"])