Gids · 2026-05-16

API- en automatiseringsfoutmeldingen

Veelvoorkomende integratiefoutcodes uitgelegd voor niet-technische gebruikers.

Voor wie dit artikel is

Gebruik dit artikel wanneer een klant een fout ziet uit een integratie, automatisering of batchproces en moet weten welke actie nodig is.

Melding of code	Wat het betekent	Wat te doen
AUTHENTICATION_REQUIRED	Het verzoek bevatte geen bruikbare login of geldig bearer-token.	Log opnieuw in of voeg het ontbrekende API-token toe.
INVALID_API_KEY	De API-sleutel is verkeerd, verlopen, ingetrokken of niet geldig voor dit account of endpoint.	Maak of kopieer de juiste sleutel.
RATE_LIMITED	Er zijn te veel verzoeken in korte tijd verzonden.	Wacht op het retry-venster en ga daarna langzamer verder.
PAYLOAD_TOO_LARGE	Het geüploade bestand overschrijdt de maximale grootte.	Comprimeer de PDF of splits het werk op in kleinere facturen.
INVALID_UPLOAD	Het geüploade bestand kon niet als geldige factuurinvoer worden gelezen.	Controleer of het bestand niet leeg, beschadigd, met een wachtwoord beveiligd of in het verkeerde formaat is.
VALIDATION_FAILED	De factuurgegevens bevatten blokkerende problemen.	Controleer de teruggegeven velden en corrigeer de factuurgegevens voordat je opnieuw probeert.
OUTPUT_PROFILE_REQUIRED	Het gevraagde uitvoerformaat heeft een duidelijker complianceprofiel nodig.	Kies het bedoelde profiel, zoals XRechnung, EN 16931, ZUGFeRD of Factur-X.
OUTPUT_PROFILE_CONFLICT	Het gekozen formaat en profiel spreken elkaar tegen.	Kies één passend uitvoerdoel en probeer opnieuw.

Probeer tijdelijke fouten opnieuw, zoals time-outs, niet-beschikbare services en sommige uploadfouten.

Probeer validatie-, authenticatie-, rate-limit-, bestandsgrootte- of profielfouten niet blind opnieuw. Die moeten eerst worden gecorrigeerd.

Integreer factuurconversie via API: verkrijg toegang, upload met idempotency key, poll de taak en download het resultaat.

Converteer pdf-facturen per e-mail: activeer het Enterprise-kanaal, verifieer afzenders, kies een formaat en controleer het antwoord.

Praktische ERP-integratiechecklist voor e-facturatieprojecten: datamapping, formaatkeuze, validatie, exception handling en go-live-controles.