Craft Commerce 5 · Nederland & België
De helft van de koppeling die niemand bouwt
Elke Moneybird-koppeling op de markt maakt een contact en een factuur aan, en houdt daar op. Juist de onderdelen die een boekhouder een middag kosten worden overgeslagen: btw verlegd, dat een ánder 0%-tarief is dan export, One Stop Shop-tarieven per land van bestemming, terugbetalingen die de btw teruggeven tegen het tarief waarmee die erop kwam, en totalen die tot op de cent aansluiten op de bankkoppeling. Bird is precies die onderdelen.
Zie het voordat je het verstuurt
Er is precies één plek in de code waar een Commerce-bestelling Moneybird-JSON wordt, en de Voorbeeld-knop draait die. Wat je vóór het boeken te zien krijgt is byte voor byte wat er geboekt wordt — inclusief de btw-tarief-id's, en dáár zitten de fouten.
{% set document = craft.bird.documentForOrder(order) %}
{% if document and document.getIsBooked() %}
<p>Invoice {{ document.getLabel() }} — {{ document.getStateLabel() }}</p>
{% endif %}
{% set vat = craft.bird.vatTreatment(order) %}
{% if vat.reverseCharge %}
<p>VAT reverse-charged — {{ vat.vatNumber }}</p>
{% endif %}Wat het werkelijk doet
Zes dingen die een Zapier-achtige koppeling niet doet.
0% zijn drie verschillende tarieven
Verlegd, geëxporteerd en werkelijk nultarief komen in drie verschillende rubrieken van de btw-aangifte terecht. Bird boekt wélk van de drie het was, in plaats van een bedrag te boeken en de reden achter te laten.
- Je tarief voor btw verlegd en je exporttarief zijn aparte instellingen
- Een niet-gekoppeld tarief weigert de bestelling en noemt het percentage
Commerce bepaalt, Bird boekt
De belastingmotor van Commerce kent je zones, je tarieven en je btw-nummercontroles al. Dat hier opnieuw afleiden zou je webshop twee antwoorden geven die uit elkaar gaan lopen, en het antwoord op de kaart van de klant is dat van Commerce.
- Een btw-nummer op een bestelling die tóch 21% betaalde is geen verlegging
- Bird boekt wat er gebeurd is, niet wat er had kunnen gebeuren
Tarieven gematcht op het bedrag
Commerce rondt de btw per regel af, dus € 10,10 tegen 21% legt € 2,12 vast — wat teruggerekend 20,99% oplevert. Een opzoeking op percentage zou doodgewone bestellingen dagelijks weigeren. Bird zoekt het gekoppelde tarief waarvan de rekensom binnen een cent uitkomt.
Totalen die aansluiten op de bankkoppeling
Het factuurtotaal is gelijk aan wat de klant betaald heeft, want dat is het bedrag dat de bank laat zien. Een cent afrondingsverschil per regel gaat op een regel van 0% — het is geen omzet en moet niet worden belast alsof het dat wel is.
- Of zet de aansluiting uit, dan weigert Bird die bestellingen in plaats daarvan
Het kan dezelfde omzet niet twee keer boeken
De documenttabel is uniek op bestelling, soort en bron, en die index ís de garantie. Een opnieuw uitgevoerde taak, een dubbelgeklikte knop en een webhook die de wachtrij inhaalt lopen er allemaal op vast.
- Een push die halverwege sneuvelt vindt zijn factuur op referentie terug en neemt die over
- Niets wat Bird doet kan een klant beletten te betalen
Betaald betekent ook echt betaald
Bird stuurt facturen; Moneybird is waar een bankoverschrijving eraan gekoppeld wordt. De webhook vertelt je site wanneer dat gebeurt, geverifieerd met HMAC-SHA256 over de ruwe body en geweigerd na vijf minuten.
- Geen secret, geen handtekening, geen verlopen timestamp, geen verzoek
- Kan de status van de Commerce-bestelling verzetten zodra de factuur betaald is
Veelgestelde vragen
De vragen die het waard zijn beantwoord te worden vóór je installeert.
Nee. Bird is een onafhankelijke plugin, gebouwd door Justin Holt, en spreekt de publieke API van Moneybird aan zoals elke andere client dat zou doen. De plugin is niet gelieerd aan Moneybird en wordt door Moneybird niet onderschreven of gesponsord; “Moneybird” is een handelsmerk van de rechthebbende.
Lite wel, en het is geen proefversie. Facturen, contacten, betalingen, binnenlandse btw, verlegging, export en de afrondingsaansluiting zitten allemaal gratis in Lite. Pro kost eenmalig $ 99 met $ 49 per jaar verlenging, en voegt One Stop Shop toe, creditnota's voor terugbetalingen, versturen vanuit Moneybird, de webhook met handtekeningcontrole, grootboekrekeningen per producttype en het verbindingslogboek.
Als je facturen uit Moneybird komen, wil je verkoopfacturen — Moneybird nummert ze, maakt de pdf en kan ze mailen. Als je webshop zijn eigen facturen al uitgeeft en alleen de boekhouding moet kloppen, wil je externe verkoopfacturen: de bestelreferentie ís het factuurnummer en Moneybird boekt alleen de omzet en de btw. Het is één instelling.
Nee, en dat is het ontwerp. De belastingmotor van Commerce kent je zones en je tarieven al, en het antwoord dat de klant werkelijk betaald heeft is dat van Commerce. Wat Bird toevoegt is de reden, want Moneybird moet weten wélke 0% het is.
Omdat er 21% in rekening is gebracht. Verlegging is een uitspraak over wat er berékend is, niet over wat er berekend had kunnen worden, en het als verlegd boeken zou je aangifte precies verlagen met wat de klant betaald heeft. De oorzaak is bijna altijd de btw-nummercontrole van Commerce die uit staat — zet die aan en volgende bestellingen komen bij het afrekenen op nul uit.
Nee. Alles wat tijdens het afrekenen draait faalt open, en de push loopt standaard via de wachtrij. Een storing bij Moneybird, een verlopen token of een ratelimiet levert een mislukte documentregel en een nieuwe poging op. Het kan geen klant opleveren die niet kon betalen.
Niets, tot je erom vraagt. Backfill haalt ze alsnog op, en een proefdraai laat zien welke bestellingen geboekt zouden worden en onder welke btw-behandeling, zonder iets te versturen.
Craft CMS 5.3+, Craft Commerce 5.0+ en PHP 8.2+.
Begin gratis, stap over zodra je de grens over gaat
Lite boekt facturen met correcte binnenlandse btw, verlegging en export, voor niets. Pro kost $ 99 met $ 49 per jaar verlenging, en voegt One Stop Shop, creditnota's, versturen, de webhook en het verbindingslogboek toe.