Moneybird koppeling





Magento Moneybird koppeling: facturen, creditnota's en klanten automatisch geboekt
Een complete boekhoudkoppeling tussen Magento 2 en Moneybird
Elke order in je Magento-webshop moet uiteindelijk in je boekhouding terechtkomen. Facturen overtypen kost elke maand uren, en één verkeerd btw-tarief of grootboek is genoeg om je btw-aangifte scheef te trekken. De Magento Moneybird koppeling neemt dat werk van je over.
De extensie boekt elke Magento-factuur en -creditnota automatisch in Moneybird, met de klant als Moneybird-contact, het juiste btw-tarief op elke regel en de juiste grootboekrekening voor producten, verzendkosten, betaalkosten en correcties. Je koppelt één keer met een Moneybird API-token en een cronjob houdt je boekhouding elk kwartier bij.
Alles gebeurt in de Magento-admin: een wachtrij met een duidelijke status per factuur, een tab Accounting op elke order, een dry run die de boeking laat zien voordat die verstuurd wordt en CLI-commando's voor developers. Verkrijgbaar als maandabonnement of als eenmalige licentie.

Magento in een paar minuten koppelen aan Moneybird
De koppeling staat binnen een paar minuten. Maak in Moneybird een API-token aan onder Instellingen → Koppelingen → Externe applicaties, plak het in Stores → Configuration → Magmodules → Moneybird en klik op Check Credentials.
De extensie leest welke Moneybird-administraties het token kan bereiken en helpt je door de rest:
- Administratie: met één administratie wordt die automatisch gekozen. Heb je er meer, dan kies je zelf, met het id naast de naam zodat je nooit in de verkeerde boekhouding boekt.
- Import Info: met één klik haal je je grootboekrekeningen en btw-tarieven op uit Moneybird, zodat elke keuzelijst je eigen gegevens toont.
- Per store view: token, administratie en koppelingen stel je per store view in, zodat een tweede webshop in een eigen administratie kan boeken.
Het token wordt versleuteld opgeslagen in Magento. Koppel je opnieuw met een account dat de gekozen administratie niet meer bereikt, dan wordt die keuze gewist in plaats van dat er geboekt wordt in een boekhouding die je niet kunt zien.

Facturen en creditnota's
Elke Magento-factuur en -creditnota wordt automatisch in Moneybird geboekt, als externe verkoopfactuur of als Moneybird-verkoopfactuur.
Klanten als contacten
Klanten worden Moneybird-contacten met bedrijfsnaam, btw-nummer en KvK-nummer, zonder dubbele contacten.
Juiste btw, ook voor ICP
Magento-belastingregels koppel je aan Moneybird-btw-tarieven, met aparte terugvaltarieven voor 0%, intracommunautaire leveringen en export.
Juiste grootboekrekeningen
Producten, verzendkosten, betaalkosten en correcties boeken elk op een eigen grootboekrekening, zodat je winst-en-verliesrekening klopt.

Twee manieren van boeken: externe verkoopfactuur of verkoopfactuur
Niet elke webshop factureert op dezelfde manier. Daarom ondersteunt de Magento Moneybird koppeling beide boekingsroutes van Moneybird. Je kiest per store view bij Book orders as.
Externe verkoopfactuur is de standaard. Magento nummert en verstuurt de factuur, Moneybird boekt de omzet. Je Magento-factuurnummer gaat mee als referentie en de boeking krijgt een bronlabel, standaard "Magento", zodat je boekhouder altijd ziet waar hij vandaan komt.
Verkoopfactuur laat Moneybird de factuur zelf maken, met een eigen nummerreeks, een eigen PDF-opmaak via een Moneybird-workflow en als je wilt een eigen e-mail naar de klant.
De route wordt per factuur vastgelegd
Elke factuur onthoudt de route waarmee hij geboekt is. Pas je de instelling later aan, dan geldt dat alleen voor nieuwe facturen, en een creditnota volgt altijd zijn origineel. Wat al geboekt is, blijft staan waar het staat.
Magento-belastingregels koppelen aan Moneybird-btw-tarieven
Magento berekent hoeveel btw er op een regel zit. Moneybird wil weten onder welk btw-tarief die geboekt wordt. Onder Accounting → Configuration → Tax Rate Mapping koppel je elke Magento-belastingregel aan een van je eigen Moneybird-btw-tarieven, direct in het overzicht.
Vier terugvaltarieven vangen alles op wat je regels niet dekken: With Tax, No Tax, EU No Tax voor intracommunautaire leveringen met verlegde btw, en No EU No Tax voor export buiten de EU.
ICP-leveringen op het juiste tarief
De extensie controleert eerst of een regel een intracommunautaire levering is, voordat die als gewone 0% geboekt kan worden. Een B2B-order voor een Belgische klant met btw-nummer komt op je tarief voor verlegde btw terecht, zodat je ICP-opgaaf compleet blijft.


Elke regel op de juiste grootboekrekening
Een boeking heeft pas waarde als het geld op de juiste plek landt. De extensie deelt elke factuur op in vier soorten regels, en elke soort boekt op een grootboekrekening die je kiest uit je geïmporteerde Moneybird-rekeningen.
- Product: je omzetrekening voor elke productregel.
- Verzending: een aparte omzetrekening, zodat verzendinkomsten los zichtbaar zijn.
- Betaal-/extra kosten: toeslagen van Mollie, Buckaroo, Sisow, Amasty en Fooman worden automatisch herkend.
- Correctie: aanpassingen op creditnota's en alles wat geen product, verzending of bekende toeslag is.
Een tarief of grootboek dat niet gekoppeld is, wordt weggelaten in plaats van geraden. Moneybird past dan de standaard van je administratie toe, die je kunt corrigeren, in plaats van een id dat bij de boekhouding van iemand anders hoort.

Een wachtrij die laat zien wat er gebeurd is
Onder Accounting → Data → Invoices zie je elke factuur die de extensie heeft opgepakt, met de status Moneybird Sync, het Moneybird Sync Result en het Moneybird ID van de boeking. Bij een mislukte factuur staat de melding van Moneybird zelf in de rij, dus je hoeft zelden een logbestand te openen. Dezelfde statuskolommen zie je ook in de gewone Magento-overzichten Sales → Invoices en Credit Memos.
Tijdelijke problemen zoals een time-out of een rate limit worden automatisch opnieuw geprobeerd, tot drie pogingen. Een boeking die Moneybird weigert, wordt als Failed geparkeerd tot je de oorzaak oplost, zodat er geen API-calls verspild worden. Met de rij- en bulkacties synchroniseer, sla je over, voeg je toe of verwijder je facturen zelf, en oudere facturen zet je in één keer in de wachtrij.
Start vanaf je boekjaar
Stel een startdatum in en alles van vóór die datum blijft buiten de synchronisatie. Ideaal als je aan het begin van een nieuw boekjaar overstapt naar Moneybird.
Elke boeking controleren voordat hij verstuurd wordt
Elke order krijgt een tab Accounting die de factuur- en creditnotaregels laat zien precies zoals ze geboekt worden: artikel, aantal, totaal, btw-percentage, het Moneybird-btw-tarief en de grootboekrekening waar elke regel op uitkomt.
Wil je voor één regel een ander tarief of grootboek? Klik erop, kies een ander, en de factuur gaat met de correctie terug in de wachtrij. Regels die je handmatig aanpast, blijven bij een latere herberekening ongemoeid.
Dry run: zie de boeking zonder hem te versturen
Show API Data toont het exacte verzoek aan Moneybird, met contact, referentie en per regel het btw-tarief en grootboek-id, zonder dat er iets wordt aangemaakt. De snelste manier om een nieuwe koppeling te controleren voordat die je boekhouding bereikt.


Creditnota's als eigen document geboekt
Terugbetalingen hebben een eigen wachtrij onder Accounting → Data → Credit Memos. Elke creditnota wordt als apart document met negatieve bedragen geboekt, op dezelfde route als de factuur waar hij bij hoort.
De oorspronkelijke boeking blijft precies zoals hij was, dus je boekhouding toont een verkoop en een terugboeking, zoals het ook gebeurd is. Dat werkt ook bij gedeeltelijke terugbetalingen: één regel van de zes wordt als één regel gecrediteerd.
Unieke referenties dankzij een prefix
Magento nummert facturen en creditnota's in aparte reeksen. Een instelbaar prefix, standaard C, houdt creditnota 000000002 en factuur 000000002 in Moneybird uit elkaar.
Klanten worden automatisch Moneybird-contacten
Voordat een factuur geboekt wordt, maakt de extensie de klant aan of werkt hem bij als contact in Moneybird, met naam, adres, telefoonnummer en het e-mailadres voor facturen.
Voor zakelijke klanten gaan ook de bedrijfsnaam, het btw-nummer en het KvK-nummer mee. Particuliere klanten worden als persoon geboekt, zodat hun factuur niet dubbel geadresseerd is.
Nooit een dubbel contact
Contacten worden gematcht op het Magento-klant-ID in plaats van op e-mailadres. Twee klanten die een mailbox delen, blijven twee contacten, en een terugkerende klant krijgt nooit een tweede contact in Moneybird.


CLI-commando's en een zelftest voor developers
Dagelijks doet de Magento-cron het werk, op een schema dat je zelf kiest. Wil je binnen een paar seconden antwoord, dan zijn er twee consolecommando's.
bin/magento accounting:sync:moneybird draait de wachtrij direct en toont één regel per document, met de melding van Moneybird bij alles wat misging. bin/magento accounting:selftest:moneybird controleert de PHP-versie, de modulestatus, de geïnstalleerde versie en de Magento-versie.
Met debugmodus aan wordt elk API-verzoek en -antwoord in een eigen Moneybird-log geschreven. Fouten worden altijd gelogd.
De Moneybird koppeling kopen in plaats van zelf bouwen
Een betrouwbare boekhoudkoppeling is meer dan een API aanroepen. Hij moet overweg kunnen met twee boekingsroutes, btw inclusief verlegging en export, grootboekkoppelingen, nieuwe pogingen, creditnota's en dubbele contacten, en hij moet blijven werken als Moneybird of Magento verandert. Dat zelf bouwen en onderhouden kost al snel meer ontwikkeltijd dan een licentie ooit kost.
Daarom kies je het model dat bij je webshop past:
Maandabonnement
Start zonder grote investering vooraf, altijd de nieuwste versie, met updates en support inbegrepen.
Eenmalige licentie
Eén keer betalen en de extensie zo lang gebruiken als je wilt, inclusief een jaar updates en support.
Boekt Magento-facturen en -creditnota's automatisch in Moneybird.
Kies tussen externe verkoopfacturen en Moneybird-verkoopfacturen.
Koppelt Magento-belastingregels aan Moneybird-btw-tarieven, inclusief ICP en export.
Aparte grootboekrekeningen voor producten, verzendkosten, betaalkosten en correcties.
Maakt klanten aan als Moneybird-contacten, gematcht op klant-ID.
Wachtrij, tab Accounting, dry run en CLI-commando's in de Magento-admin.
Magento Moneybird koppeling: technische details voor developers en webshophouders
De voordelen voor developers
De extensie is gebouwd op de Magmodules accounting base, die de wachtrij, de overzichten, de ordertab en de logging levert, terwijl deze module alles regelt wat specifiek is voor Moneybird: de API-client, de twee boekingsroutes en het vertalen van belastingregels en regeltypes naar Moneybird-btw-tarieven en -grootboekrekeningen. Factuurregels worden vastgezet op het moment dat een document in de wachtrij komt, zodat een boeking reproduceerbaar is. Tijdelijke fouten worden met een oplopende wachttijd opnieuw geprobeerd, geweigerde payloads niet. De extensie vraagt Magento 2.4.4 of nieuwer en PHP 8.1 of nieuwer, installeer je met composer require magmodules/magento2-moneybird en wordt geleverd met unit-, contract- en end-to-endtests.
Goed om te weten voor webshophouders
Voor webshophouders betekent de Magento Moneybird koppeling: nooit meer facturen overtypen. Je koppelt één keer, stelt je btw-tarieven en grootboekrekeningen in, en elke factuur, creditnota en klant komt vanzelf in Moneybird. Je boekhouder ziet precies waar elke boeking vandaan komt, en jij ziet in de wachtrij in één oogopslag of alles is aangekomen.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de Moneybird koppeling-extensie voor . We hebben ons best gedaan om je te helpen met de installatie, configuratie en probleemoplossing. Als je het antwoord dat je zocht niet kunt vinden, kun je ons altijd een bericht sturen via dit formulier.
Installatieartikelen
Configuratie

Adobe Commerce Goedgekeurd door Marketplace
Deze extensie staat op de officiele Adobe Commerce Marketplace en heeft het reviewproces doorlopen op codekwaliteit, performance en beveiliging.
Goedkeuring via de Adobe Marketplace betekent dat de extensie voldoet aan de Magento coding standards en correct integreert met het platform. Updates doorlopen hetzelfde reviewproces.

Hyvä Compatibele Plugin
Deze extensie biedt volledige ondersteuning voor Hyva Themes. Alle frontend-componenten, widgets en templates werken native met Hyva's Alpine.js en Tailwind CSS stack.
De extensie werkt direct op Hyva en wordt bij elke nieuwe Hyva-release getest om compatibiliteit te blijven garanderen.

GraphQL Klaargemaakt
Deze extensie stelt data en configuratie beschikbaar via Magento's GraphQL API. Je kunt data direct opvragen en muteren vanuit headless frontends of eigen applicaties.
Het GraphQL-schema volgt de conventies van Magento en dekt alle kernfunctionaliteit van de extensie. Hierdoor is het geschikt voor PWA Studio, Vue Storefront of elke andere headless setup.

Magento Cloud Ondersteuning
Deze extensie is volledig compatibel met Adobe Commerce Cloud (Magento Cloud). Het werkt met het read-only filesystem, de build- en deploy-pipeline en cloud-specifieke caching-lagen.
Er is geen extra configuratie of workaround nodig voor cloud-omgevingen. De extensie gaat op dezelfde manier om met static content deployment en configuratiebeheer als bij on-premise installaties.

Privé Composer Repo
Na aankoop krijg je toegang tot een prive Composer-repository met persoonlijke credentials. Installeer en update de extensie met een enkel composer-commando, net als elke andere dependency.
Je Composer-credentials zijn beschikbaar in je accountdashboard. Updates worden gepubliceerd zodra een nieuwe versie beschikbaar is, zodat je altijd toegang hebt tot de laatste versie.