Italiaanse B2B-facturering, goed gedaan

Wat is inbegrepen

• Italiaans en buitenlands (EU) btw-nummer, met formaatvalidatie
• SDI-ontvangercode en PEC, met correcte kruislingse verplichtstelling
• Checkbox "Factuur aanvragen" ook voor bedrijven, als zij liever een kassabon hebben
• Italiaans fiscaal nummer (Codice Fiscale), verplicht voor particulieren die een factuur aanvragen
• Automatische synchronisatie winkelwagen → order
• Compatibel met het standaard Luma-thema en met Hyvä
• Direct klaar voor Hyvä React Checkout, inclusief onze eigen PHP 8.4/8.5-compatibiliteitsfix

De module in actie

Vereisten

Magento 2.4.x (getest op 2.4.9) · PHP 8.1 - 8.5 (getest op PHP 8.5) · Standaard Luma-thema, of Hyvä-thema (optioneel — indien aanwezig wordt een geoptimaliseerde adresboek-interface gebruikt, specifiek getest op dit thema)

Installatie

1. Ontvang je gegevens — na aankoop ontvang je direct per e-mail de licentiesleutel en de toegangsgegevens voor de privé-Composer-repository.
2. Configureer de toegang tot de repository in het bestand auth.json in de root van je Magento-project:

   { "http-basic": { "repo.codingrow.com": { "username": "je-gebruikersnaam", "password": "je-wachtwoord" } } }

3. Voeg de repository toe aan het composer.json van je project:

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

4. Installeer de module:

   composer require codingrow/module-b2bfatturazione

5. Schakel in en voer de upgrade uit:

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

6. Activeer de licentie onder Admin > Store > Configuration > Codingrow > B2bFatturazione, door de sleutel die je per e-mail hebt ontvangen te plakken in het veld "License Key". Sla op en voer bin/magento cache:flush uit.

Velden aanpassen in adressen, e-mails en pdf

De verzamelde gegevens (btw-nummer, SDI-ontvangercode, PEC, Codice Fiscale, Factuur aangevraagd) zijn standaard adresvelden en passen dus in het systeem van Address Templates van Magento: Admin > Stores > Settings > Configuration > Customers > Customer Configuration > Address Templates. Hier definieert Magento 4 formaten — Text, Text One Line, HTML, PDF — gebruikt in respectievelijk het adresboek, orders, e-mails/exports en in pdf-documenten (facturen, vrachtbrieven).

Heb je al een aangepast template (niet het standaardtemplate): overschrijf het niet, voeg alleen de onderstaande regels toe aan je bestaande template, zodat je je eerdere aanpassingen niet verliest. Vink "Use system value" alleen uit voor het formaat dat je wilt wijzigen.

Voorbeeld, HTML-formaat (ook gebruikt in e-mailtemplates, Admin > Marketing > Email Templates, dezelfde 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}}BTW: {{var vat_id}}{{/depend}}<br />
{{depend sdi}}SDI: {{var sdi}}{{/depend}}<br />
{{depend pec}}PEC: {{var pec}}{{/depend}}<br />
{{depend codice_fiscale}}Fiscaal nummer: {{var codice_fiscale}}{{/depend}}<br />
{{depend fattura_richiesta}}Factuur aangevraagd: Ja{{/depend}}<br />

Voorbeeld, pdf-formaat (dezelfde logica, het regelscheidingsteken is | in plaats van <br />):

Dit zijn voorbeeldtemplates, bedoeld om aan te passen aan de gewenste lay-out (of te combineren met je eigen template, als je er al een hebt aangepast) — plak ze niet blindelings als je nog andere wijzigingen in behandeling hebt.

Deïnstallatie

1. Schakel uit, deïnstalleer en verwijder uit composer.json:

   bin/magento module:uninstall Codingrow_B2bFatturazione

   Dit commando schakelt de module uit, voert automatisch composer remove codingrow/module-b2bfatturazione uit en start setup:upgrade. Als je het liever handmatig, stap voor stap doet:

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

2. Opmerking over gegevens: de opgeslagen velden (btw-nummer, SDI, PEC, Codice Fiscale, accounttype) blijven ook na de deïnstallatie in de database van adresboek en orders staan — ze worden niet automatisch verwijderd, om historische gegevens niet te verliezen. Wil je ze volledig verwijderen, dan is een handmatige database-actie nodig.

Niet-goed-geld-terug-garantie

Je hebt 30 dagen vanaf aankoop om een volledige terugbetaling aan te vragen, zonder reden op te geven: log gewoon in op je account (codingrow.com/login) en klik op "Terugbetaling aanvragen". De terugbetaling wordt direct automatisch verwerkt. Zodra de terugbetaling is bevestigd, wordt de licentie gedeactiveerd.

Changelog

Huidige versie: v1.3.6 — uitgebracht op 15 augustus 2026

De module is ontwikkeld en verfijnd via een gesloten bèta vanaf juni 2026, voorafgaand aan de publieke release.

Testen en betrouwbaarheid

Voorafgaand aan de publieke release is de module getest op alle relevante combinaties van klanttype, adres en facturering. Enkele van de behandelde en opgeloste gevallen:

• Selectie van accounttype (particulier/bedrijf) vastgelegd in een keuzelijst, niet langer vrije tekst
• Serverzijdige blokkering van "Factuur aanvragen" voor een particulier zonder Codice Fiscale, ook vanuit admin
• Correcte kruislingse verplichtstelling van SDI/PEC voor Italiaanse bedrijven, buitenlandse bedrijven en particulieren
• Italiaans en buitenlands (EU) btw-nummer met afzonderlijke formaatregels
• Consistente gegevens tussen winkelwagen, order en klantenadresboek bij elke stap van de checkout
• Validaties ook serverzijdig toegepast, niet alleen in de checkout: blijven gelden als een adres via admin wordt bewerkt