Simplicate: veelvoorkomende fouten

Veelvoorkomende fouten bij Simplicate, zoals een verlopen API-key, te weinig rechten, te veel verzoeken of onderhoud, met de oorzaak en de oplossing.

Deze pagina helpt bij fouten die je in de activiteit van Simplicate ziet. Je opent haar met Hulp bij deze fout. Zoek de melding of de statuscode 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 Simplicate

Simplicate meldt een fout met een HTTP-statuscode. Een statuscode in de reeks 400 betekent dat het verzoek niet lukt. Bij een fout van de zakelijke kant geeft Simplicate ook een lijst met meldingen mee. Die lees je in de activiteit.

De API-key is verlopen of ingetrokken

Oorzaak: Een API-key werkt niet meer na de verloopdatum die je bij het aanmaken hebt gekozen. Ook een API-key die je in Simplicate verwijdert, werkt niet meer. De verloopdatum van een bestaande API-key kun je niet wijzigen.

Oplossing:

1. Ga in Simplicate naar Instellingen > API en controleer of de API-key er nog staat en niet is verlopen.
2. Maak zo nodig met Nieuw een nieuwe API-key. Zie Simplicate koppelen aan APIcenter.
3. Open in APIcenter de Simplicate-verbinding en vul de nieuwe Authentication-Key en Authentication-Secret in.
4. Klik op Testverbinding.

Geen toegang tot facturen of relaties

Oorzaak: Een API-key heeft dezelfde rechten als de Simplicate-gebruiker waarvoor hij is gemaakt. Heeft die gebruiker geen toegang tot facturen of tot personen en organisaties, dan krijgt APIcenter die gegevens niet.

Oplossing:

1. Laat een beheerder van Simplicate de rechten van de gebruiker aanpassen, of maak een API-key voor een gebruiker met genoeg rechten.
2. Vul bij een nieuwe API-key de nieuwe waarden in bij de verbinding in APIcenter.
3. Klik op Testverbinding en probeer de flow opnieuw.

HTTP 429: te veel verzoeken

Oorzaak: Simplicate beperkt het aantal verzoeken per minuut. Simplicate noemt als ondergrens minimaal 60 verzoeken per minuut en past de limiet per onderdeel van de API aan wanneer dat nodig is. Haalt de flow veel facturen op, dan haalt APIcenter bij elke factuur ook de klant op. Dat kost extra verzoeken. Bij een overschrijding antwoordt Simplicate met statuscode 429.

Oplossing:

1. Wacht even. APIcenter probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen.
2. Komt het vaak voor? Verlaag Amount to process van de flow, zodat elke run minder facturen ophaalt.

HTTP 500 of 503: storing of onderhoud

Oorzaak: Simplicate heeft een tijdelijke storing of is offline voor gepland onderhoud. Bij onderhoud geeft Simplicate statuscode 503.

Oplossing: Wacht en probeer het later opnieuw. Blijft de fout bestaan zonder aangekondigd onderhoud, neem dan contact op met Simplicate. Zie Mislukte records en opnieuw proberen.

Een factuur wordt niet opgehaald

Oorzaak: APIcenter haalt alleen facturen op met een factuurdatum vanaf de datum bij From what date do you want to retrieve orders?.

Oplossing:

1. Controleer de factuurdatum in Simplicate.
2. Open de flow Verkooporders ophalen uit Simplicate en controleer op het tabblad Instellingen de datum bij From what date do you want to retrieve orders?.
3. Zet de datum zo nodig terug en wacht op de volgende run.

Meer over de API van Simplicate staat in de documentatie van de Simplicate REST API.