Facturation B2B italienne, bien faite

Ce qui est inclus

• Numéro de TVA italien et étranger (UE), avec validation du format
• Code destinataire SDI et PEC, avec obligation croisée correcte
• Case à cocher « Facture demandée » disponible aussi pour les entreprises, si elles préfèrent le ticket de caisse
• Code fiscal (Codice Fiscale), obligatoire pour les particuliers qui demandent une facture
• Synchronisation automatique panier → commande
• Compatible avec le thème Luma par défaut et avec Hyvä
• Prêt pour Hyvä React Checkout sans développement supplémentaire, avec notre propre correctif de compatibilité PHP 8.4/8.5

Le module en action

Prérequis

Magento 2.4.x (testé sur 2.4.9) · PHP 8.1 - 8.5 (testé sur PHP 8.5) · Thème Luma par défaut, ou thème Hyvä (facultatif — s'il est présent, une interface de carnet d'adresses optimisée est utilisée, testée en particulier sur ce thème)

Installation

1. Recevez vos identifiants — après l'achat, vous recevez immédiatement par e-mail la clé de licence et les identifiants d'accès au dépôt Composer privé.
2. Configurez l'accès au dépôt dans le fichier auth.json à la racine du projet Magento :

   { "http-basic": { "repo.codingrow.com": { "username": "votre-nom-utilisateur", "password": "votre-mot-de-passe" } } }

3. Ajoutez le dépôt au composer.json du projet :

   composer config repositories.codingrow composer https://repo.codingrow.com

4. Installez le module :

   composer require codingrow/module-b2bfatturazione

5. Activez-le et lancez la mise à jour :

   bin/magento module:enable Codingrow_B2bFatturazione bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush

6. Activez la licence dans Admin > Store > Configuration > Codingrow > B2bFatturazione, en collant la clé reçue par e-mail dans le champ « License Key ». Enregistrez puis exécutez bin/magento cache:flush.

Personnaliser les champs dans les adresses, e-mails et PDF

Les données collectées (numéro de TVA, code destinataire SDI, PEC, code fiscal, Facture demandée) sont des champs d'adresse standard, ils s'intègrent donc dans le système Address Templates de Magento : Admin > Stores > Settings > Configuration > Customers > Customer Configuration > Address Templates. Magento y définit 4 formats — Text, Text One Line, HTML, PDF — utilisés respectivement dans le carnet d'adresses, les commandes, les e-mails et exports, et dans les documents PDF (factures, bons de livraison).

Si vous avez déjà un modèle personnalisé (pas celui par défaut) : ne l'écrasez pas, ajoutez seulement les lignes ci-dessous à votre modèle existant, pour ne pas perdre les personnalisations déjà faites. Décochez « Use system value » uniquement sur le format que vous voulez modifier.

Exemple, format HTML (utilisé aussi dans les modèles d'e-mail, Admin > Marketing > Email Templates, même syntaxe) :

{{depend prefix}}{{var prefix}} {{/depend}}{{var firstname}} {{depend middlename}}{{var middlename}} {{/depend}}{{var lastname}}{{depend suffix}} {{var suffix}}{{/depend}}{{depend firstname}}<br />{{/depend}}
{{depend company}}{{var company}}<br />{{/depend}}
{{if street1}}{{var street1}}<br />{{/if}}
{{depend street2}}{{var street2}}<br />{{/depend}}
{{depend street3}}{{var street3}}<br />{{/depend}}
{{depend street4}}{{var street4}}<br />{{/depend}}
{{if city}}{{var city}}, {{/if}}{{if region}}{{var region}}, {{/if}}{{if postcode}}{{var postcode}}{{/if}}<br />
{{var country}}<br />
{{depend telephone}}T: <a href="tel:{{var telephone}}">{{var telephone}}</a>{{/depend}}
{{depend fax}}<br />F: {{var fax}}{{/depend}}<br />
{{depend vat_id}}TVA : {{var vat_id}}{{/depend}}<br />
{{depend sdi}}SDI : {{var sdi}}{{/depend}}<br />
{{depend pec}}PEC : {{var pec}}{{/depend}}<br />
{{depend codice_fiscale}}Code fiscal : {{var codice_fiscale}}{{/depend}}<br />
{{depend fattura_richiesta}}Facture demandée : Oui{{/depend}}<br />

Exemple, format PDF (même logique, le séparateur de ligne est | au lieu de <br />) :

Ce sont des modèles d'exemple, à adapter à la mise en page que vous préférez (ou à fusionner avec le vôtre, s'il est déjà personnalisé) — ne les collez pas à l'aveugle si vous avez d'autres modifications en cours.

Désinstallation

1. Désactivez, désinstallez et retirez du composer.json :

   bin/magento module:uninstall Codingrow_B2bFatturazione

   Cette commande désactive le module, exécute automatiquement composer remove codingrow/module-b2bfatturazione et lance setup:upgrade. Si vous préférez le faire manuellement, étape par étape :

   bin/magento module:disable Codingrow_B2bFatturazione composer remove codingrow/module-b2bfatturazione bin/magento setup:upgrade

2. Remarque sur les données : les champs enregistrés (numéro de TVA, SDI, PEC, code fiscal, type de compte) restent dans la base de données du carnet d'adresses et des commandes même après la désinstallation — ils ne sont pas supprimés automatiquement, pour ne pas perdre les données historiques. Si vous voulez les supprimer entièrement, une intervention manuelle sur la base de données est nécessaire.

Garantie satisfait ou remboursé

Vous avez 30 jours à compter de l'achat pour demander un remboursement complet, sans avoir à justifier le motif : il suffit d'accéder à votre espace personnel (codingrow.com/login) et de cliquer sur « Demander un remboursement ». Le remboursement est traité immédiatement, automatiquement. À la confirmation du remboursement, la licence est désactivée.

Historique des mises à jour

Version actuelle : v1.3.6 — publiée le 15 août 2026

Le module a été développé et affiné à travers une bêta fermée à partir de juin 2026, avant la publication publique.

Tests et fiabilité

Avant la publication publique, le module a été mis à l'épreuve sur toutes les combinaisons pertinentes de type de client, d'adresse et de facturation. Quelques-uns des cas traités et résolus :

• Sélection du type de compte (particulier/entreprise) contrainte à un menu, plus de texte libre
• Blocage côté serveur de « Facture demandée » pour un particulier sans code fiscal, même depuis l'admin
• Obligation croisée de SDI/PEC correcte pour les entreprises italiennes, étrangères et les particuliers
• Numéro de TVA italien et étranger (UE) avec des règles de format distinctes
• Données cohérentes entre panier, commande et carnet d'adresses client à chaque étape du checkout
• Validations appliquées aussi côté serveur, pas seulement au checkout : valides même si une adresse est modifiée depuis l'admin