BuildsByLuke Checkout Brasil for WooCommerce

开发者	lukeaxiomflow
更新时间	2026年7月31日 22:36
PHP版本:	7.4 及以上
WordPress版本:	7.0
版权:	GPLv2 or later
版权网址:	版权信息

下载

1.0.1

详情介绍:

Brazilian checkout fields for WooCommerce — on BOTH the classic and the block checkout, with CPF/CNPJ validation ready for the alphanumeric CNPJ format Brazil issues from July 31, 2026. From July 31, 2026, Brazil's Receita Federal issues CNPJs with letters in the first 12 positions. Any digits-only validator silently rejects those new companies at checkout. This plugin validates BOTH the classic numeric format and the new alphanumeric format, check digits included. What the free version does (complete — no locked features)

CPF and CNPJ fields with real check-digit validation — including the alphanumeric CNPJ (check digits computed over ASCII−48 character values, per the official SERPRO specification) — with clear error messages at checkout.
Individual/company selector (Pessoa Física / Pessoa Jurídica) on the classic checkout — or run in individuals-only, companies-only, or no-document mode. Optional RG and State Registration (Inscrição Estadual) fields, and a company legal-name (Razão Social) field added when your WooCommerce install lacks one.
Street number and neighborhood address fields (billing and shipping) plus an optional cell phone field — and Brazilian address formatting ("street, number / neighborhood") everywhere WooCommerce prints an address.
Native block checkout (Gutenberg) support — a combined "CPF or CNPJ" contact field plus street number/neighborhood fields via WooCommerce's official Additional Checkout Fields API (WooCommerce 8.9+), validated server-side.
Input masks on the classic checkout (CPF, alphanumeric-aware CNPJ, CEP, phone) — lightweight vanilla JavaScript, no dependencies.
Compatible with Brazilian Market on WooCommerce data: fields are stored under the exact same meta keys (_billing_cpf, _billing_cnpj, _billing_persontype, _billing_number, _billing_neighborhood, …). Migrating from that plugin, existing customer and order data keeps working — and so do integrations that read those keys (NF-e issuers, payment gateways), including for orders placed on the block checkout (values are mirrored into the legacy keys).
CPF/CNPJ shown on the admin order screen and in order emails; Site Health checks; WP-CLI (wp cbfw validate 12.ABC.345/01DE-35).
English source strings with a complete Brazilian Portuguese (pt_BR) translation bundled — stores running in Portuguese see every field, message and setting in Portuguese.

Honest scope This plugin adds and validates checkout fields. It is not fiscal or tax software, it does not issue NF-e invoices, and it cannot by itself make a store compliant with any regulation — invoicing and tax obligations remain with your ERP/issuer, which will keep finding the data under the usual meta keys. Pro (in-dashboard upgrade, 14-day trial, no card required): address autofill from the CEP (your own server queries ViaCEP, with caching), an alphanumeric-CNPJ transition report (scans your orders and flags documents with invalid check digits that will break ERP/NF-e integrations), fiscal CSV export (CPF/CNPJ/IE by period) for your accountant, and custom labels for this plugin's fields. Pro is a separate, paid build; its code is not part of this plugin. It is sold and licensed through Freemius (see "External services").

安装:

Install and activate (WooCommerce is required — declared via the Requires Plugins header).
A Checkout Brasil menu appears in the dashboard. Choose the person-type mode (individuals and companies, individuals only, companies only, or no document fields) and which fields to use.
Done — the fields appear on both the classic and the block checkout.

屏幕截图:

升级注意事项:

1.0.1 Plugin renamed; all strings now in English with a bundled pt_BR translation. No functional changes.

常见问题:

What changes with the alphanumeric CNPJ?

From July 31, 2026, Brazil's Receita Federal issues CNPJs with letters in the first 12 positions (the two check digits remain numeric, computed over ASCII−48 character values). Digits-only validators reject those documents. This plugin validates both formats, check digits included.

I am migrating from Brazilian Market on WooCommerce. Do I lose data?

No. Field names and meta keys are identical — deactivate the old plugin, activate this one, and existing customer/order data stays where it always was. Integrations reading _billing_cpf/_billing_cnpj keep working.

Does it work with the block (Gutenberg) checkout?

Yes — natively, through WooCommerce's official Additional Checkout Fields API (WooCommerce 8.9+). On the block checkout the document is a single "CPF or CNPJ" field (the API does not yet support showing/hiding a field based on another field's value), while the classic checkout gets the full individual/company selector.

Is the checkout shown in Portuguese?

Yes. A complete Brazilian Portuguese (pt_BR) translation is bundled. Stores whose site language is Portuguese (Brazil) see every checkout field, validation message and setting in Portuguese. The source strings are English, so the plugin can be translated into any language.

Does the plugin issue NF-e invoices or guarantee fiscal compliance?

No. It adds and validates checkout fields. Invoice issuance and tax obligations are your ERP/issuer's job — those tools will keep finding the data under the usual meta keys. No plugin can, by itself, make a store compliant with any regulation.

Can I use only the street number/neighborhood fields, without CPF/CNPJ?

Yes — the "no document fields" mode keeps only the address fields you enable.

Does the free version phone home?

No. The plugin's own features make no external requests. The Freemius SDK (which powers the optional paid upgrade) only talks to Freemius in the four click-through situations listed under "External services" — never in the background.

更新日志: