Een Moneybird-koppeling laat CRM, planning of een klantportaal samenwerken met de boekhouding zonder gegevens handmatig over te typen. De Moneybird API gebruikt geautoriseerde toegang en kan rechten beperken met scopes. Webhooks melden wijzigingen, bijvoorbeeld rond contacten of verkoopfacturen, zodat je eigen systeem niet voortdurend hoeft te vragen of er iets is veranderd. Volgens de officiële documentatie bevatten webhookberichten een handtekening voor verificatie en een idempotency key om dubbele verwerking bij retries te voorkomen. De techniek is daarmee goed te organiseren, maar het procesontwerp blijft doorslaggevend: bepaal welk systeem eigenaar is van klantgegevens, wanneer een conceptfactuur mag ontstaan en welke status een medewerker handmatig moet beoordelen. Kopieer niet de hele administratie naar je CRM als alleen factuurnummer en betaalstatus nodig zijn. Zo blijft de boekhouding gespecialiseerd en krijgt de operatie precies genoeg terugkoppeling om zonder extra lijstjes door te werken.
Welke Moneybird-flow levert meestal waarde?
Een veelvoorkomende keten begint bij een goedgekeurde opdracht. Het operationele systeem heeft klant, afspraken en geleverde onderdelen. Na interne controle maakt de koppeling een contact of verkoopfactuur in Moneybird. Moneybird blijft verantwoordelijk voor de financiële status. Een wijziging wordt via een webhook teruggegeven, waarna het CRM of portaal de gebruiker informeert.
| Stap | Actie | Controle |
|---|---|---|
| 1. Opdracht gereed | Operationeel systeem verzamelt factuurregels | Zijn klant, btw, bedragen en referentie compleet? |
| 2. Goedkeuring | Bevoegde medewerker accordeert | Mag deze opdracht nu financieel worden verwerkt? |
| 3. Aanmaken | Koppeling verstuurt gegevens naar Moneybird | Bestaat deze overdracht al? |
| 4. Terugkoppeling | Moneybird meldt een relevante wijziging | Is de webhook echt en nog niet verwerkt? |
| 5. Vervolgactie | CRM toont status of start een taak | Welke rol moet bij een uitzondering handelen? |
OAuth of een persoonlijk API-token?
Moneybird ondersteunt OAuth voor applicaties die namens gebruikers toegang krijgen. De documentatie noemt ook persoonlijke API-tokens als eenvoudigere optie, met een expliciete afweging in beveiliging. Een persoonlijk token geeft toegang alsof het een wachtwoord is en moet ook zo worden behandeld.
Voor een structurele productie-integratie is een autorisatiestroom met passende scopes meestal beter beheersbaar. Kies alleen de rechten die nodig zijn. Als een koppeling uitsluitend verkoopfacturen en contacten verwerkt, hoort toegang tot andere delen van de administratie niet vanzelfsprekend mee te komen.
Volgende stap
Benieuwd wat dit voor jou kost?
Vertel wat je nodig hebt. We rekenen het door en sturen een offerte op maat.
Waarom zijn webhooks nuttig?
Zonder webhooks moet een systeem periodiek alle relevante records opvragen. Dat geeft vertraging en onnodige belasting. Een webhook meldt dat er iets is veranderd. De ontvanger verwerkt de melding, controleert zo nodig de actuele bron en werkt de eigen status bij.
Moneybird probeert een webhook volgens de documentatie opnieuw af te leveren als de ontvangende URL geen succesvolle status teruggeeft. Daarom moet dezelfde gebeurtenis veilig meer dan één keer kunnen binnenkomen. De idempotency key helpt om te herkennen dat een specifieke push al is verwerkt.
Hoe controleer je of een webhook echt is?
Moneybird documenteert een handtekening in de Moneybird-Signature-header. De ontvanger kan daarmee controleren of de payload bij Moneybird vandaan komt en onderweg niet is gewijzigd. Vergelijk handtekeningen op een timing-veilige manier en controleer ook de timestamp volgens de actuele documentatie.
- Gebruik uitsluitend een beveiligd HTTPS-endpoint.
- Bewaar het webhooksecret buiten broncode en deel het niet via chat of tickets.
- Verifieer de handtekening vóórdat bedrijfsdata wordt gewijzigd.
- Sla idempotency keys tijdelijk op om retries veilig af te handelen.
- Log een technische referentie, maar geen onnodige factuur- of persoonsgegevens.
Welke status toon je in je eigen systeem?
Vertaal financiële details naar de taak van de gebruiker. Een accountmanager hoeft niet elk boekhoudveld te zien, maar wil wel weten of een factuur als concept bestaat, is verzonden of aandacht vraagt. Maak duidelijk welke status rechtstreeks uit Moneybird komt en welke status intern is.
Liever even bellen?
Laat je terugbellen
Eén telefoontje is vaak sneller dan drie mailtjes. Je hoort binnen een werkdag van ons.
Hoe test je de koppeling vóór livegang?
- Gebruik testdata zonder echte persoonsgegevens of bankgegevens.
- Test een nieuw contact, een bestaand contact en een mogelijke dubbele match.
- Test ontbrekende of ongeldige factuurinformatie.
- Stuur dezelfde webhookgebeurtenis tweemaal en controleer dat niets dubbel wordt verwerkt.
- Onderbreek de ontvangende service en controleer herstel en waarschuwingen.
- Trek de autorisatie in en controleer dat de fout zichtbaar en veilig wordt afgehandeld.
Een Moneybird-koppeling staat zelden op zichzelf. SiteJob ontwerpt hem als onderdeel van het proces tussen verkoop, uitvoering en finance. Lees meer over de Moneybird-koppeling.
