Alles over FreshBooks
FreshBooks: veelvoorkomende fouten
Veelvoorkomende fouten bij FreshBooks, zoals een dubbele factuur, een ontbrekend veld of een ongeldige pagina, met de oorzaak en de oplossing.
Bijgewerkt op 9 november 2026
Deze pagina helpt bij fouten die je in de activiteit van FreshBooks ziet. Je opent haar met Hulp bij deze fout. Zoek de melding of de foutnaam (bijvoorbeeld RequiredField) 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
The order with order number ... was found in the target system
Oorzaak: FreshBooks heeft al een factuur met hetzelfde factuurnummer als de order. APIcenter maakt de factuur dan niet nog een keer aan, om dubbele facturen te voorkomen.
Oplossing:
- Zoek de factuur in FreshBooks op het factuurnummer.
- Staat de factuur er al? Dan is er niets meer te doen: de order is al verwerkt.
- Staat de factuur er niet, maar krijg je toch deze melding? Controleer onder Data mapping van de flow welk factuurnummer APIcenter meestuurt. Zie Verkooporders naar FreshBooks sturen.
Fouten van FreshBooks
FreshBooks geeft bij een fout een foutcode en een omschrijving. Die staan in de activiteit.
1001 RequiredField
Oorzaak: Een verplicht veld ontbreekt in de gegevens die APIcenter naar FreshBooks stuurt.
Oplossing:
- Lees in de activiteit welk veld ontbreekt.
- Vul dat veld in de bronapplicatie, of controleer de koppeling onder Data mapping van de flow.
- Probeer de order of klant opnieuw.
1004 InvalidValue
Oorzaak: Een waarde heeft een verkeerd type of ligt buiten het toegestane bereik.
Oplossing:
- Lees in de activiteit welke waarde FreshBooks weigert.
- Pas de waarde aan in de bronapplicatie, of controleer de koppeling onder Data mapping.
1003 AccessDenied
Oorzaak: Je hebt in FreshBooks geen toegang tot de gevraagde actie.
Oplossing:
- Controleer in FreshBooks of de gebruiker waarmee je hebt gekoppeld toegang heeft tot klanten en facturen.
- Koppel FreshBooks zo nodig opnieuw. Zie FreshBooks koppelen aan APIcenter.
1042 InactiveAccountError
Oorzaak: Het account in het verzoek is niet actief in FreshBooks.
Oplossing: Controleer in FreshBooks of je account actief is en probeer het opnieuw.
1012 UnknownResource of 1011 DeletedResource
Oorzaak: FreshBooks vindt de klant of factuur uit het verzoek niet, of die is verwijderd.
Oplossing: Controleer in FreshBooks of de klant of factuur nog bestaat en probeer het opnieuw.
1013 InvalidPerPage of 1014 InvalidPage
Oorzaak: FreshBooks eist voor het aantal per pagina en voor de pagina een positief geheel getal. APIcenter stuurt bij het ophalen van klanten Amount to process als aantal per pagina en Offset als pagina mee.
Oplossing:
- Open de flow Klanten ophalen uit FreshBooks en ga naar het tabblad Instellingen.
- Zet Amount to process en Offset op een positief geheel getal.
- Probeer de flow opnieuw.
409 Conflict
Oorzaak: FreshBooks verwerkt tegelijk een ander verzoek op hetzelfde object. Dit kan gebeuren als er tegelijk meerdere facturen worden aangemaakt zonder eigen factuurnummer.
Oplossing: Probeer het opnieuw. FreshBooks maakt de factuur bij een nieuwe poging aan. Zie Mislukte records en opnieuw proberen.
401 Unauthorized
Oorzaak: APIcenter heeft geen geldige toegangssleutel voor FreshBooks. Een verversingssleutel van FreshBooks kan maar één keer worden gebruikt. Gaat het verversen mis, dan is opnieuw koppelen nodig.
Oplossing: Koppel FreshBooks opnieuw. Zie Verbinding of inloggen mislukt.
Meer over de fouten van FreshBooks staat in de documentatie van de FreshBooks API.