Facturación B2B italiana, bien hecha

Qué incluye

• Número de IVA italiano y extranjero (UE), con validación de formato
• Código destinatario SDI y PEC, con obligatoriedad cruzada correcta
• Casilla "Solicitar factura" también para empresas, si prefieren el recibo
• Código fiscal, obligatorio para los particulares que solicitan factura
• Sincronización automática carrito → pedido
• Compatible con el tema Luma por defecto y con Hyvä
• Listo para Hyvä React Checkout sin desarrollo adicional, incluyendo nuestra propia corrección de compatibilidad con PHP 8.4/8.5

El módulo en acción

Requisitos

Magento 2.4.x (probado en 2.4.9) · PHP 8.1 - 8.5 (probado en PHP 8.5) · Tema Luma por defecto, o tema Hyvä (opcional — si está presente se usa una interfaz de libreta de direcciones optimizada, probada especialmente en este tema)

Instalación

1. Recibe las credenciales — después de la compra recibes por correo electrónico, al instante, la clave de licencia y las credenciales de acceso al repositorio Composer privado.
2. Configura el acceso al repositorio en el archivo auth.json en la raíz del proyecto Magento:

   { "http-basic": { "repo.codingrow.com": { "username": "tu-usuario", "password": "tu-contraseña" } } }

3. Añade el repositorio al composer.json del proyecto:

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

4. Instala el módulo:

   composer require codingrow/module-b2bfatturazione

5. Actívalo y ejecuta la actualización:

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

6. Activa la licencia en Admin > Store > Configuration > Codingrow > B2bFatturazione, pegando la clave recibida por correo electrónico en el campo "License Key". Guarda y ejecuta bin/magento cache:flush.

Personalizar los campos en direcciones, correos electrónicos y PDF

Los datos recogidos (número de IVA, código destinatario SDI, PEC, código fiscal, Factura Solicitada) son campos estándar de la dirección, por lo que se integran en el sistema de Address Templates de Magento: Admin > Stores > Settings > Configuration > Customers > Customer Configuration > Address Templates. Aquí Magento define 4 formatos — Text, Text One Line, HTML, PDF — usados respectivamente en la libreta de direcciones, pedidos, correos electrónicos y exportaciones, y en los documentos PDF (facturas, albaranes).

Si ya tienes una plantilla personalizada (no la que viene por defecto): no la sobrescribas, añade solo las líneas de abajo a tu plantilla existente, para no perder las personalizaciones ya hechas. Desmarca "Use system value" solo en el formato que quieras modificar.

Ejemplo, formato HTML (usado también en las plantillas de correo, Admin > Marketing > Email Templates, misma sintaxis):

{{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}}IVA: {{var vat_id}}{{/depend}}<br />
{{depend sdi}}SDI: {{var sdi}}{{/depend}}<br />
{{depend pec}}PEC: {{var pec}}{{/depend}}<br />
{{depend codice_fiscale}}Código Fiscal: {{var codice_fiscale}}{{/depend}}<br />
{{depend fattura_richiesta}}Factura Solicitada: Sí{{/depend}}<br />

Ejemplo, formato PDF (misma lógica, el separador de línea es | en lugar de <br />):

Estas son plantillas de ejemplo, pensadas para adaptarse al diseño que prefieras (o fusionarse con la tuya, si ya está personalizada) — no las pegues a ciegas si tienes otros cambios en curso.

Desinstalación

1. Desactiva, desinstala y elimina del composer.json:

   bin/magento module:uninstall Codingrow_B2bFatturazione

   El comando desactiva el módulo, ejecuta composer remove codingrow/module-b2bfatturazione automáticamente y lanza setup:upgrade. Si prefieres hacerlo manualmente, paso a paso:

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

2. Nota sobre los datos: los campos guardados (número de IVA, SDI, PEC, código fiscal, tipo de cuenta) permanecen en la base de datos de la libreta de direcciones y los pedidos incluso después de la desinstalación — no se eliminan automáticamente, para no perder datos históricos. Si quieres eliminarlos por completo, es necesaria una intervención manual en la base de datos.

Garantía de devolución de dinero

Tienes 30 días desde la compra para solicitar el reembolso completo, sin necesidad de justificar el motivo: basta con acceder a tu área privada (codingrow.com/login) y hacer clic en "Solicitar reembolso". El reembolso se procesa de inmediato, automáticamente. Al confirmarse el reembolso, la licencia se desactiva.

Historial de cambios

Versión actual: v1.3.8 — publicada el 25 de septiembre de 2026

El módulo se desarrolló y perfeccionó a través de una beta cerrada a partir de junio de 2026, antes del lanzamiento público.

Pruebas y fiabilidad

Antes del lanzamiento público, el módulo se puso a prueba en todas las combinaciones relevantes de tipo de cliente, dirección y facturación. Algunos de los casos abordados y resueltos:

• Selección del tipo de cuenta (particular/empresa) restringida a un menú, ya no texto libre
• Bloqueo en el lado del servidor de "Solicitar factura" para un particular sin código fiscal, incluso desde el admin
• Obligatoriedad cruzada de SDI/PEC correcta para empresas italianas, extranjeras y particulares
• Número de IVA italiano y extranjero (UE) con reglas de formato distintas
• Datos coherentes entre carrito, pedido y libreta de direcciones del cliente en cada paso del checkout
• Validaciones aplicadas también en el lado del servidor, no solo en el checkout: válidas incluso si una dirección se modifica desde el admin