Faturamento B2B italiano, feito direito

O que está incluído

• Número de IVA italiano e estrangeiro (UE), com validação de formato
• Código de destinatário SDI e PEC, com obrigatoriedade cruzada correta
• Checkbox "Solicitar Fatura" também para empresas, caso prefiram o recibo
• Código fiscal (Codice Fiscale), obrigatório para pessoas físicas que solicitam a fatura
• Sincronização automática carrinho → pedido
• Compatível com o tema Luma padrão e com o Hyvä
• Pronto para o Hyvä React Checkout sem desenvolvimento adicional, incluindo a nossa própria correção de compatibilidade com PHP 8.4/8.5

O módulo em ação

Requisitos

Magento 2.4.x (testado na 2.4.9) · PHP 8.1 - 8.5 (testado no PHP 8.5) · Tema Luma padrão, ou tema Hyvä (opcional — se presente, é usada uma interface de cadastro de endereços otimizada, testada especialmente neste tema)

Instalação

1. Receba as credenciais — após a compra você recebe por e-mail, imediatamente, a chave de licença e as credenciais de acesso ao repositório Composer privado.
2. Configure o acesso ao repositório no arquivo auth.json na raiz do projeto Magento:

   { "http-basic": { "repo.codingrow.com": { "username": "seu-usuario", "password": "sua-senha" } } }

3. Adicione o repositório ao composer.json do projeto:

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

4. Instale o módulo:

   composer require codingrow/module-b2bfatturazione

5. Habilite e execute a atualização:

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

6. Ative a licença em Admin > Store > Configuration > Codingrow > B2bFatturazione, colando a chave recebida por e-mail no campo "License Key". Salve e execute bin/magento cache:flush.

Personalizando os campos em endereços, e-mails e PDF

Os dados coletados (número de IVA, código de destinatário SDI, PEC, código fiscal, Fatura Solicitada) são campos padrão do endereço, portanto se integram ao sistema de Address Templates do Magento: Admin > Stores > Settings > Configuration > Customers > Customer Configuration > Address Templates. Aqui o Magento define 4 formatos — Text, Text One Line, HTML, PDF — usados respectivamente no cadastro de endereços, pedidos, e-mails/exportações e nos documentos PDF (faturas, romaneios).

Se você já tem um template personalizado (diferente do padrão): não o sobrescreva, apenas adicione as linhas abaixo ao seu template existente, para não perder as personalizações já feitas. Desmarque "Use system value" apenas no formato que deseja alterar.

Exemplo, formato HTML (também usado nos modelos de e-mail, Admin > Marketing > Modelos de e-mail, mesma sintaxe):

{{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}}Fatura Solicitada: Sim{{/depend}}<br />

Exemplo, formato PDF (mesma lógica, o separador de linha é | em vez de <br />):

Estes são templates de exemplo, para adaptar ao layout que preferir (ou combinar com o seu, se já personalizado) — não devem ser colados às cegas se você tiver outras alterações em andamento.

Desinstalação

1. Desative, desinstale e remova do composer.json:

   bin/magento module:uninstall Codingrow_B2bFatturazione

   O comando desativa o módulo, executa composer remove codingrow/module-b2bfatturazione automaticamente e executa setup:upgrade. Se preferir fazer manualmente, passo a passo:

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

2. Nota sobre os dados: os campos salvos (número de IVA, SDI, PEC, código fiscal, Tipo de Conta) permanecem no banco de dados de endereços e pedidos mesmo após a desinstalação — eles não são excluídos automaticamente, para não perder dados históricos. Se quiser removê-los completamente, é necessária uma intervenção manual no banco de dados.

Garantia de satisfação

Você tem 30 dias a partir da compra para solicitar o reembolso total, sem precisar explicar o motivo: basta acessar sua área reservada (codingrow.com/login) e clicar em "Solicitar reembolso". O reembolso é processado imediatamente, de forma automática. Após a confirmação do reembolso, a licença é desativada.

Histórico de versões

Versão atual: v1.3.8 — lançada em 25 de setembro de 2026

O módulo foi desenvolvido e aprimorado por meio de uma beta fechada a partir de junho de 2026, antes do lançamento público.

Testes e confiabilidade

Antes do lançamento público, o módulo foi testado em todas as combinações relevantes de tipo de cliente, endereço e faturamento. Alguns dos casos tratados e resolvidos:

• Seleção do tipo de conta (pessoa física/empresa) travada em um menu, não mais texto livre
• Bloqueio no lado do servidor de "Solicitar Fatura" para uma pessoa física sem código fiscal, mesmo pelo admin
• Obrigatoriedade cruzada de SDI/PEC correta para empresas italianas, estrangeiras e pessoas físicas
• Número de IVA italiano e estrangeiro (UE) com regras de formato distintas
• Dados consistentes entre carrinho, pedido e cadastro de endereços em cada etapa do checkout
• Validações aplicadas também no lado do servidor, não apenas no checkout: válidas mesmo se um endereço for editado pelo admin