De opvolgingslijst: afgewezen facturen en facturen in de dead-letterlijst, met de cataloguscode en wie handelt
- In de sandbox
In gewone woorden
Sinds 0.15.0 leest een sleutel van een eindklant met de scope read de rijen van de eigen eindklant, zodat een bedrijf zijn eigen
afgewezen facturen kan zien. Een sleutel van een eindklant krijgt hoogstens de nieuwste 200 rijen in de gevraagde status, met truncated: true
als er meer zijn; sinds 0.18.2 wordt de status eerst toegepast, zodat een oude open rij nooit achter nieuwere
afgehandelde verdwijnt. De sleutel mag 30 keer per minuut de lijst opvragen (daarboven 429). De sleutel van de beheerder ziet de rijen van alle
eindklanten, of van één eindklant met client.
apiKeyAuthorizationBearer <token>Stuur uw sleutel als bearer-token: Authorization: Bearer <your-api-key>. De health-aanroep is de enige aanroep die geen sleutel vereist.
status?stringopen (nog niet afgehandeld), handled, of all. De standaard is all, zoals vóór 0.8.0.
"all""open""handled""all"client?stringHet filter van de beheerder op één eindklant. Een sleutel van een eindklant mag alleen de eigen eindklant noemen; elke andere geeft 404. Een andere vorm geeft 400.
^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$data: een rij per factuur en code.
application/json- response
data*array<>truncated?booleanAanwezig en true als de lijst van een sleutel van een eindklant is ingekort tot de nieuwste 200 rijen, vóór het statusfilter.
curl -X GET "https://example.com/care" \ -H "Authorization: Bearer <your-api-key>"{ "data": [ { "invoice_id": "string", "catalogue_code": "string", "who_acts": "us", "age_seconds": 0, "handled": true, "handled_at": "2019-08-24T14:15:22Z", "route": "PEPPOL", "client": "string", "invoice_ref": "string", "deadline_at": "2019-08-24T14:15:22Z", "field": "string", "fix_hint": "string" } ], "truncated": true}De bewaarde bestanden van een factuur op de opvolgingslijst met hun SHA-256 GET
Sinds 0.15.0 leest een sleutel van een eindklant met de scope read het bewijs van de facturen van de eigen eindklant, 10 keer per minuut. De factuur van een andere eindklant geeft 404, precies zoals een factuur die niet op de opvolgingslijst staat. Bestanden van samen meer dan 8 MiB geven 413 (evidence-too-large) voor elke sleutel; lees ze dan een voor een met GET /invoices/{id}/documents/{kind}.
De opvolgingsrijen van een factuur als afgehandeld markeren POST
Alleen met de sleutel van de beheerder. Een opvolgingsrij afhandelen is het werk van de opvolging van afwijzingen, dus een sleutel van een eindklant krijgt 403.