Alles over Exact Online Fiscaal
Exact Online Fiscaal: veelvoorkomende fouten
Veelvoorkomende fouten bij Exact Online Fiscaal, zoals een ontbrekend verplicht veld of een dubbele klant, met de oorzaak en de oplossing.
Bijgewerkt op 9 november 2026
Deze pagina helpt bij fouten die je in de activiteit van Exact Online Fiscaal ziet. Je opent haar met Hulp bij deze fout. Zoek de melding en volg de stappen.
Gaat het om inloggen in het algemeen, een gepauzeerde of gestopte flow, of opnieuw proberen? Zie dan Verbinding of inloggen mislukt, Flow gepauzeerd of gestopt en Mislukte records en opnieuw proberen.
Fouten van APIcenter
Validation of required fields failed: The following fields are required and need to be present in the data
Oorzaak: Een verplicht veld ontbreekt of is leeg. De melding noemt het veld. APIcenter eist deze velden:
- Bij een persoon: het BSN (bsn). Voor een klant die nog niet bestaat ook de geboortedatum (BirthDate), voorletters (Initials) en achternaam (Surname).
- Bij een bedrijf die nog niet bestaat: de rechtsvorm (TypeOfBusinessEntity).
Oplossing:
- Open de activiteit en lees welk veld wordt genoemd.
- Vul het veld in de bronapplicatie in.
- Controleer onder Data mapping van de flow Klanten naar Exact Online Fiscaal sturen dat het veld aan een bronveld is gekoppeld. De voorletters, de rechtsvorm en het BSN staan niet in de standaard mapping.
- Probeer de klant opnieuw.
Validation of required fields failed: At least one of the following fields needs to be present
Oorzaak: APIcenter kan de klant niet identificeren of niet aanmaken. De melding noemt geen veld, maar de data bevat geen van de vereiste velden:
- Bij een bedrijf: een KvK-nummer (coc) of RSIN (rsin). Voor een bedrijf dat nog niet bestaat ook een RSIN (rsin) of btw-nummer (VatNumber).
- Bij een klant waarvan het type niet bekend is: een KvK-nummer, RSIN of BSN (bsn).
Oplossing:
- Open de activiteit en kijk bij de data welke velden zijn meegestuurd.
- Vul het KvK-nummer, RSIN, BSN of btw-nummer in de bronapplicatie in, passend bij het type klant.
- Controleer onder Data mapping dat deze velden zijn gekoppeld. Het KvK-nummer en het btw-nummer staan in de standaard mapping, het RSIN en het BSN niet.
- Probeer de klant opnieuw.
Found multiple customers with the same coc, rsin or bsn
Oorzaak: APIcenter zoekt de klant op KvK-nummer (coc), RSIN (rsin) of BSN (bsn). Heeft Exact Online Fiscaal meer dan één klant met dezelfde waarde, dan stopt APIcenter. APIcenter kan dan niet bepalen welke klant moet worden bijgewerkt.
Oplossing:
- Noteer de waarde uit de melding.
- Zoek die waarde in Exact Online Fiscaal en kijk of de klant dubbel is aangemaakt.
- Verwijder of corrigeer de dubbele klant in Exact Online Fiscaal.
- Controleer onder Data mapping dat het veld met de waarde goed is gekoppeld.
- Probeer de klant opnieuw.
Fouten van Exact Online Fiscaal
Andere fouten komen van Exact Online Fiscaal zelf. APIcenter laat dan de melding zien die Exact Online Fiscaal teruggeeft. Lees die melding in de activiteit en pas de gegevens in de bronapplicatie aan. De velden en regels van de API staan beschreven op api-app3.fiscaalgemak.nl/Help.
De verbinding werkt niet of de sleutel wordt geweigerd
Oorzaak: De sleutel is onjuist, of de omgeving bij Environment Type klopt niet met de omgeving waarmee je inlogt bij Exact Online Jaarrekening & Fiscaal. Exact geeft aan dat de automatisch aangemaakte API-koppeling soms een authenticatiefout geeft.
Oplossing:
- Ga naar Applicaties en open de verbinding met Exact Online Fiscaal.
- Controleer of Environment Type dezelfde omgeving is als waarmee je inlogt bij Exact Online Jaarrekening & Fiscaal.
- Maak in Exact Online Jaarrekening & Fiscaal onder Beheer > Koppelingen > API-koppelingen een nieuwe, aparte API-koppeling met een nieuwe sleutel. Zie Exact Online Fiscaal koppelen aan APIcenter.
- Vul de nieuwe sleutel in en klik op Testverbinding.