=== CNPJ Alfanumérico — Máscara e Validação para WooCommerce ===
Contributors: rogertakemiya
Tags: woocommerce, cnpj, cnpj alfanumérico, checkout, brasil, validação
Requires at least: 5.6
Tested up to: 6.7
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Aplica máscara e valida o novo CNPJ alfanumérico (IN RFB nº 2.229/2024) no checkout do WooCommerce. Compatível com o CNPJ numérico legado.

== Description ==

A partir de 06/07/2026 a Receita Federal passa a emitir o CNPJ no formato **alfanumérico**: as 12 primeiras posições podem conter letras (A–Z) e números (0–9), e os 2 últimos dígitos verificadores continuam numéricos. Os CNPJs numéricos atuais permanecem válidos.

Este plugin prepara o checkout da sua loja WooCommerce para o novo formato:

* Máscara automática `XX.XXX.XXX/XXXX-XX` aceitando letras e números.
* Validação dos dígitos verificadores pelo módulo 11 com a conversão ASCII − 48 (regra oficial SERPRO/RFB).
* Validação no servidor (fonte da verdade) durante o processamento do pedido.
* Feedback visual em tempo real no campo (válido/inválido).
* Compatível com o CNPJ numérico legado — uma única regra valida os dois formatos.
* Compatível com HPOS (High-Performance Order Storage).
* Sem dependências externas e sem chamadas a serviços de terceiros.

= Filtros disponíveis =

* `cnpj_alfanumerico_field_key` — altera a chave do campo (padrão `billing_cnpj`), útil para integrar com o "Brazilian Market on WooCommerce".
* `cnpj_alfanumerico_required` — torna o campo obrigatório (padrão `false`).

= Uso programático =

`if ( CNPJ_Alfanumerico_Validator::is_valid( '12.ABC.345/01DE-35' ) ) { /* ... */ }`

== Installation ==

1. Faça upload da pasta `cnpj-alfanumerico-validador` para `/wp-content/plugins/` (ou instale o .zip por Plugins > Adicionar novo > Enviar plugin).
2. Ative o plugin no menu Plugins.
3. Pronto: o campo de CNPJ passa a ter máscara e validação no checkout. Use os filtros acima para ajustar o comportamento.

== Frequently Asked Questions ==

= O CNPJ numérico atual continua funcionando? =
Sim. A mesma regra de validação aceita tanto o formato numérico legado quanto o novo alfanumérico.

= Funciona no checkout em blocos (WooCommerce Blocks)? =
Esta versão foca no checkout clássico (shortcode). Suporte ao checkout em blocos está no roteiro.

= O plugin envia o CNPJ para algum servidor externo? =
Não. Todo o cálculo é local, no seu site.

== Changelog ==

= 1.0.0 =
* Versão inicial: máscara, validação client-side e server-side, suporte a HPOS.
