Craft Commerce 5 · België & Nederland
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. Net de onderdelen die een boekhouder een namiddag kosten worden overgeslagen: btw verlegd naar de medecontractant, 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 ze erop kwam, en totalen die tot op de cent aansluiten op de bankkoppeling. Bird is net die onderdelen.
Zie het voor u het verstuurt
Er is precies één plek in de code waar een Commerce-bestelling Moneybird-JSON wordt, en de Voorbeeld-knop draait die. Wat u vóór het boeken te zien krijgt is byte voor byte wat er geboekt wordt — inclusief de btw-tarief-id's, en daar 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 naar de medecontractant, geëxporteerd en werkelijk nultarief komen in drie verschillende roosters 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.
- Uw tarief voor btw verlegd en uw exporttarief zijn aparte instellingen
- Een niet-gekoppeld tarief weigert de bestelling en noemt het percentage
Commerce bepaalt, Bird boekt
De belastingmotor van Commerce kent uw zones, uw tarieven en uw btw-nummercontroles al. Dat hier opnieuw afleiden zou uw 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 lijn 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 toont. Een cent afrondingsverschil per lijn gaat op een lijn van 0% — het is geen omzet en mag niet worden belast alsof het dat wel is.
- Of zet de aansluiting af, 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 ze over
- Niets wat Bird doet kan een klant beletten te betalen
Betaald betekent ook echt betaald
Bird stuurt facturen; Moneybird is waar een overschrijving eraan gekoppeld wordt. De webhook meldt uw 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 u installeert.
Neen. Bird is een onafhankelijke plug-in, gebouwd door Justin Holt, en spreekt de publieke API van Moneybird aan zoals elke andere client dat zou doen. De plug-in 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 uw facturen uit Moneybird komen, wilt u verkoopfacturen — Moneybird nummert ze, maakt de pdf en kan ze mailen. Als uw webshop zijn eigen facturen al uitgeeft en enkel de boekhouding moet kloppen, wilt u externe verkoopfacturen: de bestelreferentie ís het factuurnummer en Moneybird boekt enkel de omzet en de btw. Het is één instelling.
Neen, en dat is het ontwerp. De belastingmotor van Commerce kent uw zones en uw 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% aangerekend is. Verlegging is een uitspraak over wat er aangerekend is, niet over wat er aangerekend had kunnen worden, en het als verlegd boeken zou uw aangifte precies verlagen met wat de klant betaald heeft. De oorzaak is bijna altijd de btw-nummercontrole van Commerce die af staat — zet ze aan en volgende bestellingen komen bij het afrekenen op nul uit.
Neen. 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 documentlijn en een nieuwe poging op. Het kan geen klant opleveren die niet kon betalen.
Niets, tot u erom vraagt. Backfill haalt ze alsnog op, en een proefdraai toont 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 u 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.