Alles over Moneybird
Moneybird: veelvoorkomende fouten
Veelvoorkomende fouten bij Moneybird, zoals een ontbrekend product, een dubbele factuur of een onbekende factuur bij een betaling, met oorzaak en oplossing.
Bijgewerkt op 9 november 2026
Deze pagina helpt bij fouten die je in de activiteit van Moneybird ziet. Je opent haar met Hulp bij deze fout. Zoek de melding of de HTTP-code 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
Invoice '...' already found in target system!
Oorzaak: Je stuurt een order met het type Invoice en Moneybird heeft al een verkoopfactuur met dezelfde referentie. APIcenter maakt de factuur dan niet nog een keer aan, om dubbele facturen te voorkomen.
Oplossing:
- Zoek de factuur in Moneybird op de referentie uit de melding.
- 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 welke waarde in het veld referentie terechtkomt. Zie Verkooporders naar Moneybird sturen.
Product: '...' not found!
Oorzaak: Een orderregel verwijst naar een product dat APIcenter niet in Moneybird vindt. APIcenter zoekt het product op de identifier van de regel.
Oplossing:
- Controleer in Moneybird of er een product is met de identifier uit de melding.
- Ontbreekt het product? Maak het aan in Moneybird of stuur het met Producten naar Moneybird sturen.
- Staat het product er wel, maar met een andere identifier? Pas de identifier aan in Moneybird of onder Data mapping van de flow.
- Probeer de order opnieuw.
Invoice '...' cannot be found!
Oorzaak: Bij het versturen van een betaling vindt APIcenter geen verkoopfactuur met dezelfde referentie als de betaling. De factuur moet al in Moneybird staan. APIcenter zoekt alleen tussen verkoopfacturen, niet tussen externe verkoopfacturen.
Oplossing:
- Controleer in Moneybird of de factuur bestaat en welke referentie hij heeft.
- Maak de factuur eerst aan, bijvoorbeeld met Verkooporders naar Moneybird sturen.
- Probeer de betaling opnieuw. Zie Betalingen naar Moneybird sturen.
The following fields need to be present
Oorzaak: Er ontbreekt een verplicht veld. Bij een betaling zijn de referentie, het bedrag en de betaaldatum verplicht. Bij een product is de identifier verplicht. De melding noemt het veld dat ontbreekt.
Oplossing:
- Vul het veld in de bronapplicatie in.
- Controleer onder Data mapping van de flow dat het veld aan het juiste veld is gekoppeld.
- Probeer het record opnieuw.
At least one of the following fields needs to be present
Oorzaak: Bij het versturen van een order zoekt APIcenter de klant op ID, e-mailadres of telefoonnummer. De order bevat geen van die drie.
Oplossing:
- Vul in de bronapplicatie minstens het e-mailadres of het telefoonnummer van de klant in.
- Controleer onder Data mapping van de flow dat dit veld aan de klant is gekoppeld.
- Probeer de order opnieuw.
Default debtor ... doesn't exist
Oorzaak: De standaarddebiteur staat aan, maar APIcenter vindt de klant met het ID of e-mailadres uit de instellingen niet in Moneybird.
Oplossing:
- Controleer in de flow-instellingen de waarden bij Value to use as Default debtor ID en Default debtor email address.
- Vul het ID of e-mailadres in van een klant die in Moneybird bestaat.
- Probeer de order opnieuw.
Fouten van Moneybird
Moneybird geeft bij een fout een HTTP-code terug. Die staat in de activiteit. Meer informatie staat in de documentatie van Moneybird.
401: geen of ongeldige toegang
Oorzaak: Moneybird accepteert de toegang van APIcenter niet. De toegang is ongeldig, ingetrokken of ontbreekt.
Oplossing: Controleer de gegevens van de Moneybird-verbinding, sla op en klik op Testverbinding. Zie Verbinding of inloggen mislukt en Moneybird koppelen aan APIcenter.
402: limiet van het account bereikt
Oorzaak: Je Moneybird-account heeft een limiet bereikt.
Oplossing: Controleer je abonnement in Moneybird en neem zo nodig contact op met Moneybird.
403: IP-adres geblokkeerd
Oorzaak: Moneybird heeft het IP-adres geblokkeerd voor gebruik van de API. Moneybird doet dat om misbruik te voorkomen.
Oplossing: Neem contact op met APIcenter-support. Moneybird beschrijft de blokkade bij Throttling.
404: niet gevonden
Oorzaak: Het product, de factuur of de klant bestaat niet in Moneybird. Bij het zoeken naar een product of een factuur vangt APIcenter deze fout op en behandelt het als "niet gevonden". Je ziet de fout dus alleen als het om een ander record gaat.
Oplossing:
- Lees in de activiteit welk record Moneybird niet vindt.
- Controleer of dat record in Moneybird bestaat, in de administratie van Administration ID (filled automatically).
422: gegevens geweigerd
Oorzaak: Moneybird slaat de gegevens niet op omdat ze niet kloppen, bijvoorbeeld door een ontbrekend verplicht veld of een onbekend btw-tarief of onbekende grootboekrekening.
Oplossing:
- Lees in de activiteit welk veld Moneybird noemt.
- Vul dat veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
- Gaat het om een btw-tarief of grootboekrekening? Controleer of de naam of het ID in Moneybird bestaat.
429: te veel verzoeken
Oorzaak: Moneybird staat 150 verzoeken per 5 minuten per IP-adres toe en je zit daarboven.
Oplossing: Wacht even. Moneybird geeft in het antwoord aan hoe lang je moet wachten. APIcenter probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen.
500: fout bij Moneybird
Oorzaak: Er ging iets mis bij Moneybird zelf.
Oplossing: Wacht en probeer het later opnieuw. Zie Mislukte records en opnieuw proberen.