Moneybird-problemen oplossen in Magento 2
Op zoek naar Magento Moneybird koppeling: facturen, creditnota's en klanten automatisch geboekt? Bekijk de volledige Magento Moneybird koppeling: facturen, creditnota's en klanten automatisch geboekt pagina voor functies, configuratieopties en prijzen.
Begin bij Accounting > Data > Invoices. Een regel die faalde draagt de reden in zijn eigen kolom, dus je hebt zelden een logbestand nodig.
"Voor store X is geen Moneybird-administratie gekozen"
Er is niets gekozen onder Verbinding > Administratie, of een reconnect heeft die keuze gewist omdat het account de gekozen administratie niet meer bereikt.
Kies er een. Is de dropdown leeg, klik dan eerst op Verbinden met Moneybird — die lijst wordt bij het verbinden gevuld, en dat is bewust: een configuratiepagina tonen mag niet afhangen van of Moneybird bereikbaar is.
De factuur faalde met iets over contact_id
De klant heeft Moneybird nooit als relatie bereikt. Dat is het echte probleem; de factuur is alleen waar je het merkt.
Meestal faalde de klantsynchronisatie eerder, en die zegt zelf waarom. Kijk in de logstream onder Geavanceerd > Debug. Een klant zonder e-mailadres of zonder land is de meest voorkomende oorzaak.
"reference has already been taken"
Moneybird heeft al een factuur onder dit nummer. Er is niets mis met wat je stuurde — het is een duplicaat.
De module vraagt Moneybird eerst of de factuur al bestaat, dus normaal kan dit niet gebeuren. Het gebeurt wel wanneer:
- de factuur met de hand in Moneybird is gemaakt, of door een eerdere koppeling, onder hetzelfde nummer
- de regel als externe verkoopfactuur geboekt is, waar Moneybird geen opzoekmogelijkheid publiceert
De regel stopt met opnieuw proberen, en dat is bewust: nog een keer sturen geeft hetzelfde conflict. Verwijder het duplicaat in Moneybird en zet de regel terug in de wachtrij, of markeer hem als overgeslagen.
Alles faalt met een 403
De verbinding kan de administratie waar hij op staat niet zien. Dat is iets anders dan een verkeerd token: de inloggegevens zijn goed, de toegang niet.
Dit gebeurt na opnieuw verbinden met een Moneybird-account dat minder toegang heeft dan het vorige. Verbind met het juiste account, of kies een administratie die dit account wél bereikt.
Alles faalt met een 401
Het token is geweigerd. De module vernieuwt een token waarvan hij denkt dat het verlopen is, en herauthenticeert één keer als Moneybird een token weigert dat hij nog goed dacht — dus een hardnekkige 401 betekent dat het vernieuwen zelf faalt.
Klik opnieuw op Verbinden met Moneybird. Een refresh token dat aan Moneybirds kant is ingetrokken kan niet vernieuwd worden, en niets in de shop kan dat verschil zien voordat het geprobeerd is.
Regels boeken op de verkeerde grootboekrekening, of zonder btw
Twee verschillende oorzaken, en de kolom vertelt welke.
De regel heeft helemaal geen btw-tarief of grootboekrekening. Er is niets gekoppeld, dus de module liet het veld weg en Moneybird pakte de standaard van je administratie. Klik op Import Info, koppel daarna de Magento-belastingregels onder Accounting > Configuration > Tax Rate Mapping en kies de grootboekrekeningen onder Instellingen.
De regel heeft de verkeerde. De koppeling wijst naar iets anders. Let op: een EU-order met nul btw valt onder EU zonder btw, niet onder Zonder btw — btw verlegd wordt beslist vóór "nul btw" hem kan opvangen, want als gewoon nultarief boeken laat je ICP-opgave achter.
Een factuur is in de verkeerde administratie geboekt
Wijzig de administratie en zet alleen de regels terug in de wachtrij die nog niet verstuurd zijn. Een factuur die al in de verkeerde administratie staat moet daar verwijderd worden: de module kan een boeking niet tussen administraties verplaatsen, en Moneybird ook niet.
De creditnota is niet gekoppeld aan de factuur
Zo werkt de externe-verkoopfactuurroute. Moneybird heeft daar geen creditnota-actie, dus de creditnota is een tweede boeking met negatieve bedragen die op zichzelf staat. Alleen de verkoopfactuurroute koppelt de twee.
De wachtrij loopt nooit leeg
Controleer eerst of cron überhaupt draait — Geavanceerd > Debug toont wat de module logde. Kijk daarna naar Algemeen > Synchronisatie: een leeg schema betekent dat de taak nooit afgaat.
Je kunt de wachtrij altijd met de hand doorzetten met het CLI-commando "accounting:sync:moneybird".
Niets werkt en je wil weten waarom
Het CLI-commando "accounting:selftest:moneybird" rapporteert over de verbinding, de PHP- en Magento-versies, en of de module Moneybird überhaupt kan bereiken.
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team
Voor een compleet overzicht van functies en configuratieopties, bekijk Magento Moneybird koppeling: facturen, creditnota's en klanten automatisch geboekt.