Italienische B2B-Rechnungsstellung, richtig gemacht

Was enthalten ist

• Italienische und ausländische (EU) USt-IdNr., mit Formatvalidierung
• SDI-Empfängercode und PEC, mit korrekter wechselseitiger Pflichtfeldlogik
• Checkbox „Rechnung anfordern" auch für Unternehmen, falls ein Kassenbon bevorzugt wird
• Codice Fiscale, verpflichtend für Privatpersonen, die eine Rechnung anfordern
• Automatische Synchronisierung Warenkorb → Bestellung
• Kompatibel mit dem Standardtheme Luma und mit Hyvä
• Sofort einsatzbereit für Hyvä React Checkout, inklusive unseres eigenen PHP 8.4/8.5-Kompatibilitäts-Fixes

Das Modul in Aktion

Voraussetzungen

Magento 2.4.x (getestet mit 2.4.9) · PHP 8.1 – 8.5 (getestet mit PHP 8.5) · Standardtheme Luma oder Hyvä-Theme (optional — falls vorhanden, wird eine optimierte Adressbuch-Oberfläche verwendet, die speziell auf diesem Theme getestet wurde)

Installation

1. Zugangsdaten erhalten — nach dem Kauf erhältst du sofort per E-Mail den Lizenzschlüssel und die Zugangsdaten zum privaten Composer-Repository.
2. Repository-Zugang konfigurieren in der Datei auth.json im Stammverzeichnis des Magento-Projekts:

   { "http-basic": { "repo.codingrow.com": { "username": "dein-benutzername", "password": "dein-passwort" } } }

3. Repository hinzufügen zur composer.json des Projekts:

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

4. Modul installieren:

   composer require codingrow/module-b2bfatturazione

5. Aktivieren und Update ausführen:

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

6. Lizenz aktivieren unter Admin > Store > Configuration > Codingrow > B2bFatturazione, indem du den per E-Mail erhaltenen Schlüssel in das Feld „License Key" einfügst. Speichern und bin/magento cache:flush ausführen.

Felder in Adressen, E-Mails und PDF anpassen

Die erfassten Daten (USt-IdNr., SDI-Empfängercode, PEC, Codice Fiscale, Rechnung angefordert) sind Standard-Adressfelder und fügen sich daher in Magentos eigenes System der Address Templates ein: Admin > Stores > Settings > Configuration > Customers > Customer Configuration > Address Templates. Magento definiert hier 4 Formate — Text, Text One Line, HTML, PDF — die jeweils im Adressbuch, in Bestellungen, in E-Mails/Exporten und in PDF-Dokumenten (Rechnungen, Lieferscheinen) verwendet werden.

Falls du bereits ein angepasstes Template hast (nicht das Standard-Template): Überschreibe es nicht, sondern füge nur die unten stehenden Zeilen zu deinem bestehenden Template hinzu, um bereits vorgenommene Anpassungen nicht zu verlieren. Deaktiviere „Use system value" nur bei dem Format, das du ändern möchtest.

Beispiel, HTML-Format (auch in den E-Mail-Vorlagen verwendet, Admin > Marketing > Email Templates, gleiche Syntax):

{{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}}USt-IdNr.: {{var vat_id}}{{/depend}}<br />
{{depend sdi}}SDI: {{var sdi}}{{/depend}}<br />
{{depend pec}}PEC: {{var pec}}{{/depend}}<br />
{{depend codice_fiscale}}Steuernummer: {{var codice_fiscale}}{{/depend}}<br />
{{depend fattura_richiesta}}Rechnung angefordert: Ja{{/depend}}<br />

Beispiel, PDF-Format (gleiche Logik, der Zeilentrenner ist | statt <br />):

Dies sind Beispiel-Templates, die an das von dir bevorzugte Layout angepasst werden sollten (oder mit deinem eigenen zusammengeführt, falls bereits angepasst) — sie sollten nicht blind eingefügt werden, wenn du bereits andere Änderungen vorgenommen hast.

Deinstallation

1. Deaktivieren, deinstallieren und aus composer.json entfernen:

   bin/magento module:uninstall Codingrow_B2bFatturazione

   Der Befehl deaktiviert das Modul, führt automatisch composer remove codingrow/module-b2bfatturazione aus und startet setup:upgrade. Falls du es lieber manuell, Schritt für Schritt, machen möchtest:

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

2. Hinweis zu den Daten: die gespeicherten Felder (USt-IdNr., SDI, PEC, Codice Fiscale, Kontotyp) bleiben auch nach der Deinstallation in der Adressbuch- und Bestelldatenbank erhalten — sie werden nicht automatisch gelöscht, um historische Daten nicht zu verlieren. Wenn du sie vollständig entfernen möchtest, ist ein manueller Eingriff in die Datenbank erforderlich.

Geld-zurück-Garantie

Du hast ab dem Kauf 30 Tage Zeit, um die vollständige Rückerstattung zu verlangen, ohne einen Grund angeben zu müssen: Melde dich einfach in deinem persönlichen Bereich an (codingrow.com/login) und klicke auf „Rückerstattung anfordern". Die Rückerstattung wird sofort automatisch bearbeitet. Nach Bestätigung der Rückerstattung wird die Lizenz deaktiviert.

Änderungsprotokoll

Aktuelle Version: v1.3.8 — veröffentlicht am 25. September 2026

Das Modul wurde vor der öffentlichen Veröffentlichung ab Juni 2026 in einer geschlossenen Betaphase entwickelt und verfeinert.

Tests und Zuverlässigkeit

Vor der öffentlichen Veröffentlichung wurde das Modul mit allen relevanten Kombinationen aus Kundentyp, Adresse und Rechnungsstellung geprüft. Einige der behandelten und gelösten Fälle:

• Auswahl des Kontotyps (Privatperson/Unternehmen) auf ein Menü beschränkt, kein Freitext mehr
• Serverseitige Sperre von „Rechnung anfordern" für eine Privatperson ohne Codice Fiscale, auch über das Admin-Panel
• Korrekte wechselseitige Pflichtfeldlogik von SDI/PEC für italienische Unternehmen, ausländische Unternehmen und Privatpersonen
• Italienische und ausländische (EU) USt-IdNr. mit unterschiedlichen Formatregeln
• Konsistente Daten zwischen Warenkorb, Bestellung und Kundenadressbuch bei jedem Checkout-Schritt
• Validierungen auch serverseitig angewendet, nicht nur im Checkout: gelten auch, wenn eine Adresse über das Admin-Panel geändert wird