Clozo voor ontwikkelaars

Een HTTP-API met een gepubliceerd schema

Facturen maken, bezorgen en afletteren vanuit je eigen systeem. Het schema is gepubliceerd en doorzoekbaar; sleutels, webhooks en verbruik regel je zelf in je werkruimte.

API-referentie openen

De referentie wordt uit de draaiende dienst gegenereerd en kan dus geen eerdere versie beschrijven.

Snel aan de slag

curl https://api.useclozo.com/b2b/v1/documents \
  -X POST \
  -H "Authorization: Bearer clz_live_<keyid>_<secret>" \
  -H "Idempotency-Key: order-4471-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "issuer_id": "3f6c1b8e-2d4a-4e7b-9a15-6c0d2e8f7a41",
    "customer": {
      "name": "Kestrel Logistics GmbH",
      "country": "DE",
      "vat_number": "DE123456789"
    },
    "currency": "EUR",
    "line_items": [
      {
        "description": "Consulting, October",
        "quantity": "1",
        "unit_amount": 395000,
        "tax_rate": 0,
        "tax_category": "AE"
      }
    ]
  }'

HTTP/1.1 201 Created
{
  "object": "document",
  "id": "doc_5Hq2m8Zr4Kd9",
  "issuer_id": "3f6c1b8e-2d4a-4e7b-9a15-6c0d2e8f7a41",
  "issuer_country": "NL",
  "currency": "EUR",
  "subtotal": 395000,
  "tax_total": 0,
  "total": 395000,
  "reverse_charge": true,
  "status_bucket": "created",
  "status_detail": "draft",
  "invoice_number": ""
}
// ...

Maak een API-sleutel aan in je werkruimte en stuur die mee als Bearer-token. Verzoeken die documenten aanmaken of uitreiken of geldbewegingen vastleggen, verwachten een Idempotency-Key, zodat een nieuwe poging nooit een dubbel document oplevert. issuer_id is de UUID van een van je rechtspersonen.

Één regel om vooraf te lezen

De organisatie volgt uit het credential, nooit uit een requestparameter. Een sleutel voor één organisatie kan geen andere aanspreken — er is geen organisatie-id om mee te geven en geen manier om de scope via het request te verbreden. Ratelimieten worden teruggemeld via X-RateLimit-headers, zowel bij succes als bij een 429.

Wat de API dekt

Alles wat hier staat, is vandaag beschikbaar, tenzij het als Vroege toegang is gemarkeerd.

Gepubliceerd schema en een browser ervoor

Een OpenAPI-schema en een Swagger-UI, beide door de dienst zelf geleverd. Genereer je client uit het schema in plaats van endpoints over te typen.

API-sleutels met scopes en rotatie

Sleutels aanmaken, roteren en intrekken in je werkruimte. Bij rotatie krijg je de nieuwe sleutel voordat de oude stopt, dus een deploy hoeft niet op hetzelfde moment te gebeuren.

Ondertekende webhooks met bezorglog en replay

Endpoints registreren, een voorbeeldgebeurtenis sturen, het bezorglog lezen en één gebeurtenis of de hele dead-letter queue opnieuw aanbieden. Een gemiste bezorging herstel je zelf, zonder het ons te vragen.

Verbruik zelf uitlezen

Wat de organisatie heeft verbruikt, inclusief e-mail, is een endpoint en geen supportvraag.

Gefilterde exports

CSV- en XLSX-uittreksels van dezelfde data die je via de API kunt opvragen, voor de plekken waar een spreadsheet nog altijd het antwoord is.

E-factuurbezorging via PeppolVroege toegang. Vroege toegang: versturen en ontvangen via Peppol, KSeF en SdI wordt nu samen met klanten met vroege toegang ingeschakeld.

Bezorging van een document bij de Peppol-deelnemer van de ontvanger, met de bezorgstatus leesbaar via dezelfde API. Op de landenpagina zie je waar e-facturatie beschikbaar is.

Wat de werkruimte doet E-facturatie per land