Toegangsgegevens versleuteld bewaren; de waarde wordt nooit teruggegeven
- In de sandbox
In gewone woorden
Een proces bewaart toegangsgegevens alleen voor zijn eigen omgeving. Met legal_entity koppelt u ze aan het verkoper-ID waarvoor ze gelden (btw-nummer, NIP, SIREN of bedrijfs-ID); toegangsgegevens zonder die koppeling dienen voor de andere facturen van de eindklant. Een beheerderssleutel van een eindklant bewaart alleen voor de eigen eindklant.
apiKeyAuthorizationBearer <token>Stuur uw sleutel als bearer-token: Authorization: Bearer <your-api-key>. De health-aanroep is de enige aanroep die geen sleutel vereist.
application/json- body
client*stringOptioneel met een sleutel van een eindklant
^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$route*string"PL-KSEF""RO-EFACTURA""PEPPOL""FR-PA""DE-XRECHNUNG"kind*stringissued_by*stringissued_on*stringdateexpires_on?stringdateenvironment?stringMoet de omgeving van dit proces zijn; dat is de standaard.
"sandbox""production"legal_entity?stringlength <= 64value*stringBewaard.
application/json- response
id?stringclient?stringroute?stringkind?stringissued_by?stringissued_on?stringexpires_on?stringenvironment?|sandbox of production; null voor toegangsgegevens die vóór 3 okt. 2026 zijn bewaard en die alleen een sandbox gebruikt.
legal_entity?stringrevoked_at?stringstored?booleancurl -X POST "https://example.com/credentials" \ -H "Authorization: Bearer <your-api-key>" \ -H "Content-Type: application/json" \ -d '{ "client": "string", "route": "PL-KSEF", "kind": "string", "issued_by": "string", "issued_on": "2019-08-24", "value": "string" }'{ "id": "string", "client": "string", "route": "string", "kind": "string", "issued_by": "string", "issued_on": "string", "expires_on": "string", "environment": "string", "legal_entity": "string", "revoked_at": "string", "stored": true}Toegangsgegevens intrekken; het record blijft voor het auditspoor POST
Vorige
Een factuur stoppen die nog niet is ingediend POST
Werkt alleen zolang de factuur received, validated of queued is. Sinds 0.18.3 geldt: als een verzending is geprobeerd en het antwoord verloren is gegaan (een time-out of een 5xx), staat de factuur op submitting en geeft een annulering 409 send-in-progress, omdat het verzendkanaal hem kan hebben; de worker zet hem op submitted of dead_letter. Zodra het verzendkanaal hem heeft, is een annulering een zakelijk document (een creditnota, of een KOR in Polen), geen API-aanroep. Sinds 0.18.5 geeft het annuleren van een factuur die al is geannuleerd 200 met die factuur, zodat een nieuwe poging na een verloren antwoord veilig is. Sinds 0.18.6 mag de sleutel van de beheerder een dead_letter-factuur annuleren als er nooit een aanroep naar het verzendkanaal voor is gedaan: er kan niets op het verzendkanaal staan, dus hetzelfde document kan daarna opnieuw worden verzonden. Als er wel een aanroep is gedaan, is het antwoord 409 dead-letter-reached-rail, want een verzending waarvan het antwoord verloren ging, kan er zijn: controleer eerst bij het verzendkanaal. De sleutel van een eindklant krijgt 409 dead-letter; de beheerder beslist.