PHPackages                             robsoned/brazilzipcode - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. robsoned/brazilzipcode

ActiveMagento2-module[API Development](/categories/api)

robsoned/brazilzipcode
======================

Magento 2 module to use brazil zipcode search services. Forked from magedev/brazilzipcode

0226PHP

Since Jul 30Pushed 9mo agoCompare

[ Source](https://github.com/robsoned/BrazilZipCode)[ Packagist](https://packagist.org/packages/robsoned/brazilzipcode)[ RSS](/packages/robsoned-brazilzipcode/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

BrazilZipCode
=============

[](#brazilzipcode)

Sobre o Módulo
--------------

[](#sobre-o-módulo)

Módulo criado para utilização de serviços de consulta de CEP, já contendo de forma básica consulta pelo ViaCep e Correios.

Módulo originalmente criado por [m2-magedev/BrazilZipCode](https://github.com/m2-magedev/BrazilZipCode/).

### Como instalar

[](#como-instalar)

#### Instalar via Composer (recomendado)

[](#instalar-via-composer-recomendado)

```
composer require robsoned/brazilzipcode
php bin/magento module:enable MageDev_BrazilZipCode
php bin/magento setup:upgrade

```

### Configurações

[](#configurações)

Para configurar o módulo acesse: Lojas > Configurações > MageDev > Brazil ZipCode

### Como usar a consulta

[](#como-usar-a-consulta)

Em seu javascript (seja para qualquer área da loja que deseja consultar um CEP), faça uma chamada GET para o endpoint abaixo utilizando o cep com ou sem formatação:

```
URL_DA_LOJA/rest/V1/magedev-brazil-zipcode/search/CEP_A_SER_CONSULTADO
https://minhaloja.com.br/rest/V1/magedev-brazil-zipcode/search/08226-021
https://minhaloja.com.br/rest/V1/magedev-brazil-zipcode/search/08226021

```

### Payload de retorno

[](#payload-de-retorno)

```
{
    "zip_code": "08226021",
    "street": "Rua 18 de Abril",
    "neighborhood": "Cidade Antônio Estevão de Carvalho",
    "additional_info": "",
    "city": "São Paulo",
    "state": "SP",
    "code": "3550308",
    "data_source": "ViaCep",
    "is_valid": true
}

```

#### Observações:

[](#observações)

- Caso a funcionalidade de persistência no banco de dados esteja ativa, os dados serão armazenados no banco de dados e, em uma consulta posterior ao mesmo CEP, o dado será retornado do banco.
- Caso a funcionalidade de cache esteja ativa, o CEP sejá armazenado no cache, e em uma posterior consulta ao mesmo CEP, o dado será retornado do cache.

### Limpando o cache apenas do módulo

[](#limpando-o-cache-apenas-do-módulo)

```
php bin/magento cache:clean config_zipcode_search_api

```

### Uso da consulta de CEP por serviços externos (Outras plataformas, sistemas ou postman)

[](#uso-da-consulta-de-cep-por-serviços-externos-outras-plataformas-sistemas-ou-postman)

Criar uma chave de integração no Magento e fazer uso do header de Authorization.

Adicionando novos serviços através do seu módulo
------------------------------------------------

[](#adicionando-novos-serviços-através-do-seu-módulo)

- Crie seu módulo
- Crie sua classe de serviço estendendo da classe MageDev\\BrazilZipCode\\Gateway\\AbstractZipCodeService
- Sobrescreva os métodos getAddressData e validate
- Declare o xml brazil\_zipcode\_services.xml no etc de seu módulo com o seguinte conteúdo

```

       NOME_DO_SEU_SERVICO
       VENDOR_DO_MODULO\NOME_DO_MODULO\Services\NOME_DA_CLASSE_SO_SEU_SERVICO

```

- Instale seu módulo e limpe o cache.
- Obs: Caso deseje priorizar seu serviço, acesse as configurações do módulo BrazilZipCode no admin e adicione seu serviço como o primeiro da lista, assim seu serviço será o primeiro a ser acessado quando o CEP não for localizado no cache ou banco de dados.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance40

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 57.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/dfbd0293ed7c01e59d2a9e4f6cd2b79837b040bda5ce9b716ce4490698c63795?d=identicon)[RobsonTrimes](/maintainers/RobsonTrimes)

---

Top Contributors

[![m2-magedev](https://avatars.githubusercontent.com/u/68076636?v=4)](https://github.com/m2-magedev "m2-magedev (15 commits)")[![r-martins](https://avatars.githubusercontent.com/u/191149?v=4)](https://github.com/r-martins "r-martins (6 commits)")[![robsoned](https://avatars.githubusercontent.com/u/18008565?v=4)](https://github.com/robsoned "robsoned (4 commits)")[![feeh27](https://avatars.githubusercontent.com/u/13547485?v=4)](https://github.com/feeh27 "feeh27 (1 commits)")

### Embed Badge

![Health badge](/badges/robsoned-brazilzipcode/health.svg)

```
[![Health](https://phpackages.com/badges/robsoned-brazilzipcode/health.svg)](https://phpackages.com/packages/robsoned-brazilzipcode)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)