Referentie
Elk adres, met zijn bereik.
Deze tabel komt uit dezelfde catalogus waartegen de interface controleert. Wat hier staat is dus geen beschrijving van het gedrag, maar hetzelfde feit, tweemaal gelezen.
| Pad | Bereik | Recht | Wat er terugkomt |
|---|---|---|---|
| GET /api/extern/v1/me | De sleutel zelf: bedrijf, omgeving, bereiken, laatste gebruik. De eerste aanroep die men schrijft. |
||
| GET /api/extern/v1/customers | customers:read | VIEW_CUSTOMERS | Eén pagina met klanten en leveranciers, nieuwste eerst. |
| GET /api/extern/v1/customers/{id} | customers:read | VIEW_CUSTOMERS | Eén klant met alle stamgegevens. |
| POST /api/extern/v1/customers | customers:write | EDIT_CUSTOMERS | Maakt een klant aan. KRONENWERK trekt het klantnummer uit de eigen reeks van het bedrijf. |
| GET /api/extern/v1/invoices | invoices:read | VIEW_INVOICES | Uitgegeven facturen, te filteren op betaalstatus en factuurdatum. |
| GET /api/extern/v1/invoices/{number} | invoices:read | VIEW_INVOICES | Eén uitgegeven factuur, zoals het archief die heeft vastgelegd. |
| POST /api/extern/v1/invoices/drafts | invoices:write customers:read companies:read | EDIT_INVOICES VIEW_COMPANY_SETTINGS VIEW_CUSTOMERS | Start een factuurconcept voor een klant. Daarmee is die niet uitgegeven. |
| GET /api/extern/v1/transactions | transactions:read | VIEW_TRANSACTIONS | Dossiers — orders, projecten, productieruns — met fase en vervaldatum, nieuwste eerst. Beperk tot een periode met period, from en to; het venster gaat op de startdatum. |
| POST /api/extern/v1/transactions | transactions:write transactions:read | EDIT_TRANSACTIONS VIEW_TRANSACTIONS | Maakt een dossier aan. Nummer, fase en tijdlijn ontstaan als op het scherm van het product. |
| PATCH /api/extern/v1/transactions/{id} | transactions:write transactions:read | EDIT_TRANSACTIONS VIEW_TRANSACTIONS | Wijzigt een bestaand dossier. Een weggelaten veld blijft zoals het is; "none" als klant verwijdert de klant. |
| GET /api/extern/v1/reports/outstanding | reports:read | VIEW_REPORTS | Openstaande vorderingen en schulden van vandaag, gescheiden per richting. |
| GET /api/extern/v1/webhooks | webhooks:write | MANAGE_WEBHOOKS | De webhook-eindpunten van dit bedrijf. |
| GET /api/extern/v1/webhooks/events | webhooks:write | MANAGE_WEBHOOKS | De gebeurtenissen waarop een eindpunt zich kan abonneren. |
| POST /api/extern/v1/webhooks | webhooks:write | MANAGE_WEBHOOKS | Een eindpunt registreren; het ondertekeningsgeheim staat één keer in het antwoord. |
| DELETE /api/extern/v1/webhooks/{id} | webhooks:write | MANAGE_WEBHOOKS | Een eindpunt uitschakelen; het afleverlogboek blijft bewaard. |
Bladeren en filteren.
Elke lijst is een pagina. Een onzinnige waarde wordt begrensd in plaats van geweigerd: een getal in een adres is zelden kwade opzet.
Eén aanroep, volledig.
Bedragen komen als aantal kleinste eenheden met een valutacode. Nooit als opgemaakte tekst, die de scheidingstekens van één taal in een machinedocument zou dragen.
GET https://kronenwerk.org/api/extern/v1/invoices?status=OPEN&size=1\n\n{"data":[{"number":"R-2026-0001","issuedOn":"2026-04-02","buyer":"Kellermann GmbH","currency":"EUR","gross":{"minor":105910,"currency":"EUR"},"outstanding":{"minor":105910,"currency":"EUR"},"paymentState":"OPEN","overdue":false}],"page":0,"size":1,"total":1,"more":false}Een schrijfaanroep.
Drie adressen maken iets aan, en elk daarvan vereist de idempotentieheader. Er is geen adres dat een factuur uitgeeft, een betaling boekt of een document annuleert.
POST https://kronenwerk.org/api/extern/v1/customers\nAuthorization: Bearer greif_live_…\nIdempotency-Key: 6f1c2a8e-4b3d-4a21-9d77-0c5e1f9b2a44\n\n{"name":"Kellermann Elektrotechnik GmbH","email":"buchhaltung@kellermann.de","street":"Am Sandtorkai 41","postalCode":"20457","city":"Hamburg","country":"DE"}