Craft Commerce 5 · Belgique & Pays-Bas
La moitié de l'intégration que personne ne construit
Toutes les passerelles Moneybird du marché créent un contact et une facture, puis s'arrêtent là. Ce sont précisément les parties qui coûtent une après-midi à un comptable qui sont laissées de côté : l'autoliquidation, qui est un 0 % différent d'une exportation, les taux One Stop Shop par pays de destination, les remboursements qui rendent la TVA au taux auquel elle a été appliquée, et des totaux qui tombent au centime près sur le flux bancaire. Bird, c'est exactement ces parties-là.
Voyez-le avant de l'envoyer
Il existe exactement un endroit dans le code où une commande Commerce devient du JSON Moneybird, et le bouton Aperçu l'exécute. Ce qui vous est montré avant la comptabilisation est octet pour octet ce qui sera comptabilisé — identifiants de taux de TVA compris, et c'est précisément là que se logent les erreurs.
{% 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 %}
Ce qu'il fait réellement
Six choses qu'une passerelle façon Zapier ne fait pas.
0 %, ce sont trois taux différents
L'autoliquidation, l'exportation et le taux zéro véritable atterrissent dans trois grilles différentes de la déclaration de TVA. Bird comptabilise lequel des trois il s'agissait, au lieu de comptabiliser un montant et d'abandonner la raison en route.
- Votre taux d'autoliquidation et votre taux d'exportation sont deux réglages distincts
- Un taux non associé refuse la commande et nomme le pourcentage
Commerce décide, Bird comptabilise
Le moteur fiscal de Commerce connaît déjà vos zones, vos taux et vos contrôles de numéro de TVA. Le redériver ici donnerait à votre boutique deux réponses qui finiraient par diverger — et celle qui figure sur la carte du client est celle de Commerce.
- Un numéro de TVA sur une commande qui a tout de même payé 21 % n'est pas de l'autoliquidation
- Bird comptabilise ce qui s'est passé, pas ce qui aurait pu se passer
Des taux appariés sur le montant
Commerce arrondit la TVA ligne par ligne : une ligne de 10,10 € à 21 % enregistre donc 2,12 €, ce qui redonne 20,99 % une fois recalculé. Une recherche par pourcentage refuserait chaque jour des commandes parfaitement ordinaires. Bird cherche le taux associé dont le calcul tombe à moins d'un centime près.
Des totaux qui tombent juste sur le flux bancaire
Le total de la facture est égal à ce que le client a payé, parce que c'est le montant que la banque affichera. Un centime d'écart d'arrondi par ligne va sur une ligne à 0 % — ce n'est pas du chiffre d'affaires et cela ne doit pas être taxé comme tel.
- Ou désactivez le rapprochement, et Bird refusera ces commandes à la place
Il ne peut pas comptabiliser deux fois le même chiffre d'affaires
La table des documents est unique sur la commande, le type et la source, et cet index est la garantie. Une tâche relancée, un bouton cliqué deux fois et un webhook qui double la file d'attente butent tous dessus.
- Un envoi interrompu en vol retrouve sa facture par la référence et la reprend
- Rien de ce que fait Bird ne peut empêcher un client de payer
Payé veut dire réellement payé
Bird envoie les factures ; c'est dans Moneybird qu'un virement bancaire est rapproché de l'une d'elles. Le webhook prévient votre site quand cela se produit, vérifié en HMAC-SHA256 sur le corps brut et rejeté au-delà de cinq minutes.
- Pas de secret, pas de signature, pas d'horodatage périmé, pas de requête
- Peut faire changer le statut de la commande Commerce dès que la facture est payée
Questions fréquentes
Les questions qui valent la peine d'être tranchées avant d'installer.
Non. Bird est un plugin indépendant développé par Justin Holt, et il dialogue avec l'API publique de Moneybird comme le ferait n'importe quel autre client. Il n'est ni affilié à Moneybird, ni approuvé, ni sponsorisé par Moneybird ; « Moneybird » est une marque de son titulaire respectif.
Lite l'est, et ce n'est pas une version d'essai. Les factures, les contacts, les paiements, la TVA intérieure, l'autoliquidation, l'exportation et le rapprochement des arrondis sont tous gratuits dans Lite. Pro coûte 99 $ une fois, avec 49 $ de renouvellement annuel, et ajoute le One Stop Shop, les notes de crédit pour les remboursements, l'envoi depuis Moneybird, le webhook à signature vérifiée, les comptes comptables par type de produit et le journal de connexion.
Si vos factures viennent de Moneybird, vous voulez des factures de vente : Moneybird les numérote, produit le PDF et peut les envoyer. Si votre boutique émet déjà ses propres factures et que seule la comptabilité doit être juste, vous voulez des factures de vente externes : la référence de commande est le numéro de facture, et Moneybird ne comptabilise que le chiffre d'affaires et la TVA. C'est un seul réglage.
Non, et c'est voulu. Le moteur fiscal de Commerce connaît déjà vos zones et vos taux, et la réponse que le client a réellement payée est celle de Commerce. Ce que Bird ajoute, c'est la raison — parce que Moneybird doit savoir de quel 0 % il s'agit.
Parce que la commande a facturé 21 %. L'autoliquidation est une affirmation sur ce qui a été facturé, pas sur ce qui aurait pu l'être — et la comptabiliser en autoliquidation minorerait votre déclaration exactement du montant payé par le client. La cause est presque toujours le contrôle du numéro de TVA de Commerce laissé désactivé : activez-le et les commandes suivantes passeront à 0 % dès la commande.
Non. Tout ce qui s'exécute pendant la commande échoue en mode ouvert, et l'envoi passe par la file d'attente par défaut. Une panne chez Moneybird, un jeton expiré ou une limite de débit produisent une ligne de document en échec et une nouvelle tentative. Cela ne peut pas produire un client qui n'a pas pu payer.
Rien, tant que vous ne le demandez pas. Le backfill les rattrape, et une simulation indique chaque commande qui serait comptabilisée, et sous quel traitement TVA, sans rien envoyer.
Craft CMS 5.3+, Craft Commerce 5.0+ et PHP 8.2+.
Commencez gratuitement, passez à Pro quand vous franchissez une frontière
Lite comptabilise les factures avec une TVA intérieure, une autoliquidation et une exportation correctes, gratuitement. Pro coûte 99 $ avec 49 $ de renouvellement annuel, et ajoute le One Stop Shop, les notes de crédit, l'envoi, le webhook et le journal de connexion.