RaCar Checkout Manager for Brazilian Stores

RaCar Checkout Manager for Brazilian Stores is a powerful WooCommerce plugin designed specifically for Brazilian stores. It enhances the WooCommerce checkout experience by adding essential fields like CPF, CNPJ, RG, and more and allowing control of all WooCommerce fields. Additionally, it includes an address autofill feature that uses CEP (Brazilian postal codes) to automatically populate address fields, saving time and improving accuracy.

O Gerenciador de Checkout RaCar para Lojas Brasileiras é um poderoso plugin para WooCommerce desenvolvido especificamente para lojas no Brasil. Ele aprimora a experiência de finalização de compra no WooCommerce, adicionando campos essenciais como CPF, CNPJ, RG e outros, além de permitir o controle de todos os campos do WooCommerce. Adicionalmente, inclui um recurso de preenchimento automático de endereços que utiliza o CEP para preencher automaticamente os campos de endereço e bloquenado-os (à escolha do admin), economizando tempo e aumentando a precisão.

Key Features:

• CPF, CNPJ, and RG Fields: Add and validate these essential fields for Brazilian customers.
• Address Autofill: Automatically fill in address fields based on the CEP entered by the customer.
• Customizable Checkout Fields: Enable, disable, or customize checkout fields to suit your store’s needs.
• Input Masks: Add input masks for CPF, CNPJ, and cellphone fields for better user experience.
• WooCommerce HPOS Compatibility: Fully compatible with WooCommerce’s High-Performance Order Storage (HPOS).
• Admin Interface: Modern and intuitive admin interface for managing settings.
• Translation Ready: Fully localized and ready for translation.

This plugin is free and always will be. If it saves you time, consider buying me a coffee to support its development.

• Campos CPF, RG, CNPJ, IE, número da residência, bairro e telefone: Adiciona e valida esses campos essenciais para clientes brasileiros.
• Preenchimento automático de endereço: Preenche automaticamente os campos de endereço com base no CEP inserido pelo cliente.
• Bloqueio de campos de endereço: Ao preencher os campos de endereço, pode bloqueá-los ao comando do admin.
• Campos do checkout personalizáveis: Habilite, desabilite ou personalize os campos de finalização de compra para atender às necessidades da sua loja.
• Máscaras de entrada: Adiciona máscaras de entrada (pontos e traços) para os campos CPF, CNPJ, CEP e celular para uma melhor experiência do usuário.
• Compatibilidade com WooCommerce HPOS: Totalmente compatível com o High-Performance Order Storage (HPOS) do WooCommerce.
• Interface administrativa: Interface administrativa moderna e intuitiva para gerenciar as configurações.
• No seu idioma: Já vem traduzido para o pt-BR, mas você pode mudar qualquer texto que aparece para o usuário.

Este plugin é gratuito e sempre será. Se ele economizar seu tempo, considere me oferecer um café para apoiar o desenvolvimento deste e outros plugins.

External Services

This plugin connects to external APIs to obtain address information based on Brazilian postal codes (CEP), which is needed to autofill address fields during checkout and registration. These services are used only when the user enters a CEP during checkout and the autofill feature is enabled.

BrasilAPI (Primary Service)

The plugin sends the user’s postal code (CEP) to BrasilAPI when the user enters a valid CEP in the address field ‘postcode’. This service is provided by “BrasilAPI”: https://brasilapi.com.br/docs (terms of use and privacy policy available on their website).

What is it? BrasilAPI is a free public API that provides Brazilian address data based on postal codes (CEP).

What data is sent? – Only the CEP (postal code) is sent via a GET request to https://brasilapi.com.br/api/cep/v2/{cep} (e.g., https://brasilapi.com.br/api/cep/v2/01234567). – No personal user data (name, email, order details, or IP address) is transmitted. – Requests are made only when the user enters a valid CEP and triggers the autofill feature (via JavaScript on the frontend).

When is it used? – When a customer enters a CEP in the billing or shipping address field during checkout. – Only if the address autofill feature is enabled in the plugin settings (Tab 2: Autofill Addresses).

What data is returned? – Street name (logradouro) – Neighborhood (bairro) – City (cidade) – State (uf)

Terms and Documentation: – BrasilAPI Terms of Service: https://brasilapi.com.br/#termos-de-uso – BrasilAPI Documentation: https://brasilapi.com.br/docs

ViaCEP (Fallback Service)

If BrasilAPI does not return a usable address (network error, HTTP error, invalid JSON, or CEP not found), the plugin tries ViaCEP once as a secondary source.

The plugin sends only the same Brazilian postal code (CEP) in a GET request to https://viacep.com.br/ws/{cep}/json/ (see ViaCEP). ViaCEP is a widely used public CEP lookup service in Brazil. Formal terms of use are not published as clearly as some larger APIs; the plugin documents this connection here for transparency and WordPress.org compliance.

What data is sent? – Only the CEP digits in the URL path (same scope as BrasilAPI). – No personal user data (name, email, order details, or IP address) is transmitted by the plugin.

When is it used? – Only after BrasilAPI fails or returns no valid address for that CEP. – Only when autofill is enabled and the customer triggers a CEP lookup as described above.

Data Handling

• No data storage: The plugin does not store or track any data beyond the single request to the API.
• Optional feature: The address autofill integration is optional and can be disabled in the plugin settings (Tab 2: Autofill Addresses).
• Fallback mechanism: The plugin tries BrasilAPI first, then ViaCEP. If neither service returns a valid address, the checkout continues with manual entry without fatal errors.
• User control: Users can disable the autofill feature at any time through the plugin settings.

Data Transmission

Data sent: Only the Brazilian postal code (CEP) entered by the user. When: Every time a user enters or modifies a CEP field (postcode) during WooCommerce checkout or My Account registration. Conditions: Only when the user manually enters a CEP value. No data is sent if the field is left empty. Purpose: To automatically populate address fields (street, neighborhood, city, state) based on the provided CEP. Storage: The CEP and returned address data are stored locally in the user’s browser session and WooCommerce order/customer data. Responses come from BrasilAPI when available, otherwise from ViaCEP; third-party APIs do not retain that payload beyond normal HTTP handling.

License

This plugin is licensed under the GPLv2 or later. See the GNU General Public License for more details.