Perk controleert uw Business Central-verbinding voordat elke onkostenexport wordt uitgevoerd. Als de verbinding ongeldig is, wordt de export onmiddellijk geblokkeerd met een duidelijke, bruikbare foutmelding in plaats van dat deze halverwege stilzwijgend mislukt. Dit artikel legt uit waarom de authenticatie kan mislukken en hoe u elk probleem kunt oplossen.

Wanneer en waar Perk authenticatiefouten weergeeft

Perk voert de authenticatiecontrole uit voordat de export begint, waardoor de fout direct aan het licht komt, voordat er documenten naar Business Central worden verzonden, in plaats van na een mislukte poging.

• Handmatige exports — de fout verschijnt als een pop-upmelding op het moment dat u de export start. De melding bevat het specifieke foutbericht, zodat u er direct op kunt reageren.
• Automatische export — de fout verschijnt direct bij de onkostenpost zelf, omdat er geen handmatig triggermoment is waaraan een melding kan worden gekoppeld. Controleer de onkostenpost om de authenticatiefout en de vervolgstappen te bekijken.

In beide gevallen wordt de export volledig geblokkeerd — geen gedeeltelijke of stille fouten — en het weergegeven bericht komt overeen met een van de onderstaande oorzaken. Deze controle valideert alleen de authenticatie. Het detecteert niet:

• Onjuiste bedrijfsnaam, webservicenaam, instantie of basis-URL.
• Fouten na succesvolle authenticatie, zoals mislukte Azure AD-naar-Business Central API-verbindingen.
• Fouten in de toewijzing van stamgegevens.

Deze problemen komen aan het licht als mislukte exportdocumenten tijdens de export zelf.

Ontbrekende inloggegevens

Waarom dit gebeurt: De client-ID of het clientgeheim voor de Business Central-verbinding is nooit opgeslagen in Perk.

Wat te doen: Ga naar Instellingen > Integraties > Business Central en voltooi de configuratie van de inloggegevens door de Client-ID en het Clientgeheim in te voeren.

Ontbrekende Azure AD-tenantconfiguratie

Waarom het gebeurt:

• Cloud Business Central: Het veld Tenant-ID is leeg in de ERP-configuratie.
• Business Central op locatie: De directory-ID ontbreekt in de inloggegevens.

Wat te doen:

• Cloud: ga naar Instellingen Integraties Business Central [API] en controleer de tenant-ID in de integratie-instellingen.
• Op locatie: ga naar Instellingen Integraties Business Central [API] en controleer de Directory ID in het gedeelte met referenties.

Referenties geweigerd door Azure AD

Waarom dit gebeurt: Azure AD heeft de referenties geweigerd. De client-ID of het clientgeheim is mogelijk onjuist of verlopen, of de app-registratie in Azure AD is mogelijk verwijderd. Het foutbericht bevat de Azure AD-foutcode en een beschrijving.

Wat te doen:

1. Controleer de Azure AD-foutcode die in het bericht wordt weergegeven.
2. Ga naar Instellingen Integraties Business Central en maak opnieuw verbinding met geldige inloggegevens.
3. Als de app-registratie is verwijderd, maak dan een nieuwe aan in Azure AD en werk de referenties in Perk bij.

Netwerk- of firewallblokkering van de aanmeldingsservice van Microsoft.

Waarom dit gebeurt: Perk kan login.microsoftonline.com niet bereiken — een firewall of DNS-configuratie blokkeert de verbinding. De foutmelding toont de POSIX-foutcode (bijvoorbeeld ECONNREFUSED of ETIMEDOUT) en het geblokkeerde eindpunt.

Wat te doen: Neem contact op met uw IT- of netwerkbeheerder en deel de foutcode en het eindpunt die in het bericht worden weergegeven. Zorg ervoor dat login.microsoftonline.com bereikbaar is.

Onverwachte fout tijdens de controle van de inloggegevens.

Waarom dit gebeurt: Er is een onverwachte fout opgetreden tijdens de controle, bijvoorbeeld een fout bij het parseren van de configuratie of een runtimefout. Het onbewerkte foutbericht wordt weergegeven.

Wat te doen: Noteer het volledige foutbericht en neem contact op met de supportafdeling. Configuratieproblemen met Business Central (zoals de bedrijfsnaam of de naam van de webservice) worden niet door deze controle gedetecteerd en kunnen zich afzonderlijk voordoen als mislukte exportdocumenten.