Probleemoplossing

De meeste problemen tonen zich als een foutcode in het API-antwoord of een staat op het dashboard; deze pagina legt de meest voorkomende koppelingen aan met een oplossing.

De API-fouten

Fout	Betekenis	Oplossing
401 credential.invalid	de sleutel is onbekend, ingetrokken, of u stuurt haar verkeerd	kopieer de sleutel uit de onthulling (deze staat niet meer in de lijst), en controleer dat de header Authorization: Bearer exg_live_… is
402 billing.inactive	het abonnement van de organisatie is verlopen of geannuleerd	vernieuw het in het portaal (Organisatie → Abonnementen); de app-pagina's tonen dezelfde staat via de gate
403 access.denied	de rechten van de sleutel dekken dit datatype, niveau of administratie niet	maak een sleutel aan met het recht, of (voor een gekoppeld gereedschap) trek in en koppel opnieuw met meer toegang
403 credential.ip_not_allowed	de sleutel heeft een IP-toestemmingslijst en het adres van de aanvrager staat er niet op	voeg het adres of bereik toe aan de toestemmingslijst van de sleutel, of verwijder de lijst
404 exact.not_found	het record-id bestaat niet in die administratie	controleer de divisie en het id (ids zijn per administratie)
429 exact.rate_limited	Exact's eigen limiet is bereikt	wacht Retry-After seconden en probeer opnieuw; overweeg de cache voor herhaalde lijsten
429 exact.paused	het eindpunt werd gepauzeerd na herhaalde Exact-fouten	niets om te doen; het hervat zichzelf

Een 400 (resource.bad_parameter, resource.bad_limit) is een typefout in de query: een parameter twee keer gegeven, een onbekende parameter, of een limit buiten 1–1000. GET /resources geeft de toegestane filters, ops en sortsleutels weer.

Het dashboard toont een probleem

Staat	Betekenis	Oplossing
de gate: niet geabonneerd	geen actief Data Bridge-abonnement	abonneren in het portaal (de gate linkt daarheen)
de gate: Exact Online verbinden	de Exact-verbinding van de app ontbreekt	verbind deze in het portaal (de gate linkt daarheen); kies de administraties om in te schakelen
Exact-verbinding vereist herautorisatie	Exact vraagt om een nieuwe aanmelding (het refresh token is verlopen)	meld opnieuw aan op de verbindingpagina van het portaal; de cache wordt automatisch geleegd
een administratie ontbreekt uit GET /divisions	deze is niet ingeschakeld voor deze app	schakel in op de verbindingpagina; sleutels met Alle ingeschakelde administraties pakken hem automatisch op

MCP-problemen

Symptoom	Betekenis	Oplossing
de toestemmingspagina zegt dat het verzoek verlopen is	het autorisatieverzoek was al gebruikt of verlopen	start de verbinding opnieuw vanaf het AI-gereedschap
de toestemmingspagina vraagt om tweefactor in te schakelen	de aangemelde gebruiker is geen eigenaar/beheerder met 2FA	schakel 2FA in in het portaal (de pagina linkt daarheen en keert terug), of meld u aan als beheerder
het gereedschap stopt plotseling met een 401/403	het gekoppelde gereedschap werd ingetrokken, of de goedkeurende beheerder werd gedegradeerd of verloor 2FA	koppel het gereedschap opnieuw, of herstel de rol van de beheerder, de controle is per aanroep, met opzet
het gereedschap ziet minder tools dan verwacht	de rechten bevatten niet die datatypen (de tools worden gegenereerd uit de rechten)	koppel opnieuw met bredere toegang, of controleer de rechten van de sleutel

Gegevens zien er verkeerd uit

• Verouderd na een wijziging in Exact: met de cache aan kan een lijstantwoord tot de TTL oud zijn. Nu leegmaken op de Cachepage, of verlaag de TTL; de get-by-id-aanroep gaat altijd naar Exact.
• De data van een divisie ontbreekt: de divisie is niet ingeschakeld voor de app (zie hierboven), geen bug in de API.
• Exact's veldnamen vs de genormaliseerde namen: de API retourneert de genormaliseerde velden (accountId, invoiceDate, …); GET /resources en het OpenAPI-document vermelden ze per datatype.

Nog steeds vastgelopen?

Voeg toe aan uw e-mail: de organisatie, de sleutelnaam (niet de sleutel zelf), de exacte foutcode en -boodschap, en het eindpunt en de query (zonder de sleutel). Zie Ondersteuning.