systemcode / customer-address-autocomplete-brazil

systemcode/customer-address-autocomplete-brazil

Brazilian postcode mask and address autocomplete for Magento customer address forms.

magento2-module Compatibility: 2.4.8-2.4.9 Code Quality: Info Tests: N/A Security: Pass OSL-3.0

System Code Address Autocomplete (Brazil)

About Module

Adds Brazilian CEP masking and address autocomplete on checkout and customer address forms. Looks up street, neighborhood, city, and state via zip code API, with options to reorder fields, disable address fields until lookup completes, lock autofilled data (including street prefix), and allow manual entry on lookup failure.

Configuration

Stores > Configuration > System Code > Address Autocomplete (Brazil)

Screenshots

Admin Configuration

[image: Admin Configuration]

Frontend

[image: Checkout]

Requirements

  • systemcode/base
  • systemcode/customer
  • magento/module-customer
  • magento/module-checkout
  • magento/module-directory

How to install

✓ Install by Composer (recommended)

composer require systemcode/base systemcode/customer systemcode/customer-address-autocomplete-brazil
php bin/magento module:enable SystemCode_CustomerAddressAutocompleteBrazil
php bin/magento setup:upgrade

✓ Install Manually

  • Copy module to folder app/code/SystemCode/CustomerAddressAutocompleteBrazil and run commands:
php bin/magento module:enable SystemCode_CustomerAddressAutocompleteBrazil
php bin/magento setup:di:compile
php bin/magento setup:upgrade

Suggested installation bundles

These modules are not required by Address Autocomplete (Brazil), but work well together for a complete Brazilian address experience.

Address essentials

Custom street labels, street prefix, and CEP autocomplete.

composer require systemcode/base systemcode/customer \
  systemcode/customer-street-lines \
  systemcode/customer-street-prefix \
  systemcode/customer-address-autocomplete-brazil

Address autocomplete + registration

Collect the customer address during account creation.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-address-registration

Address + Brazilian identity

Combine address autocomplete with CPF/CNPJ customer identity.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-identity-brazil

Full Brazilian storefront stack

Address, identity, registration, street labels, and street prefix.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-address-registration \
  systemcode/customer-street-lines \
  systemcode/customer-street-prefix \
  systemcode/customer-identity-brazil

Full stack with Enhanced identity

Dedicated CPF, CNPJ, Social Name, and Trade Name fields.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-address-registration \
  systemcode/customer-street-lines \
  systemcode/customer-street-prefix \
  systemcode/customer-identity-brazil \
  systemcode/customer-identity-brazil-enhanced

License

OSL-3.0

Authors


Sobre o Módulo

Adiciona máscara de CEP brasileiro e autocomplete de endereço no checkout e nos formulários de endereço do cliente. Consulta logradouro, bairro, cidade e estado pela API de CEP, com opções para reordenar campos, desabilitar endereço até a consulta, bloquear campos preenchidos automaticamente (incluindo prefixo de logradouro) e permitir preenchimento manual em caso de falha.

Configuração

Lojas > Configuração > System Code > Address Autocomplete (Brazil)

Screenshots

Configuração no Admin

[image: Configuração no Admin]

Frontend

[image: Checkout]

Requisitos

  • systemcode/base
  • systemcode/customer
  • magento/module-customer
  • magento/module-checkout
  • magento/module-directory

Como Instalar

✓ Instalação via Composer (recomendado)

composer require systemcode/base systemcode/customer systemcode/customer-address-autocomplete-brazil
php bin/magento module:enable SystemCode_CustomerAddressAutocompleteBrazil
php bin/magento setup:upgrade

✓ Instalação Manual

  • Copie o módulo para app/code/SystemCode/CustomerAddressAutocompleteBrazil e execute:
php bin/magento module:enable SystemCode_CustomerAddressAutocompleteBrazil
php bin/magento setup:di:compile
php bin/magento setup:upgrade

Combinações de instalação sugeridas

Estes módulos não são obrigatórios para o Address Autocomplete (Brazil), mas combinam bem para uma experiência completa de endereço brasileiro.

Essenciais de endereço

Rótulos de rua, prefixo de logradouro e autocomplete de CEP.

composer require systemcode/base systemcode/customer \
  systemcode/customer-street-lines \
  systemcode/customer-street-prefix \
  systemcode/customer-address-autocomplete-brazil

Autocomplete + cadastro

Coleta o endereço do cliente já no cadastro.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-address-registration

Endereço + identidade brasileira

Autocomplete de endereço com identidade CPF/CNPJ.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-identity-brazil

Stack completo brasileiro

Endereço, identidade, cadastro, rótulos de rua e prefixo de logradouro.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-address-registration \
  systemcode/customer-street-lines \
  systemcode/customer-street-prefix \
  systemcode/customer-identity-brazil

Stack completo com identidade Enhanced

Campos dedicados de CPF, CNPJ, Razão Social e Nome Fantasia.

composer require systemcode/base systemcode/customer \
  systemcode/customer-address-autocomplete-brazil \
  systemcode/customer-address-registration \
  systemcode/customer-street-lines \
  systemcode/customer-street-prefix \
  systemcode/customer-identity-brazil \
  systemcode/customer-identity-brazil-enhanced

Licença

OSL-3.0

Autores

No changelog yet

The vendor hasn't published a changelog. Tagged releases appear in the Versions tab.

Versions
Version Stability QA Status Compatibility Released
1.0.0 stable Fail Magento 2.4.8-2.4.9 Details 2026-06-11 11:57:36

Requires 5

Package Constraint
magento/module-checkout *
magento/module-customer *
magento/module-directory *
systemcode/base ^2.0
systemcode/customer ^1.0

Compatibility

Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.

Compatibility matrix (Magento × PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Fail di error Pass
2.4.8 Pass Pass
2.4.9 Pass Pass

Code Quality

Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge — a phpcs finding can't make a module incompatible.

Static analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

Static analysis results
Tool Status Findings Summary
PHPCS Pass 0
PHPMD Pass 0
Cpd Pass 0
Composer validate Info 4 valid; 4 advisory notes (composer validate --strict)

PHPStan

Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell → details modal.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Pass Pass
2.4.8 Pass Pass
2.4.9 Pass Pass

Tests

Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.

Unit tests

Unit tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Integration tests

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Security

Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan Pass 0
License
OSL-3.0

More from systemcode

View vendor
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.