Permite consultar o endereço através do CEP e preencher o campos do endereço com as informações consultadas, esse módulo também permite utilizar os seguintes serviços para consulta de CEP:
- API CEP
- Via CEP
- Correios
Para otimizar as buscas este módulo salva o resultado das consultas de cep na tabela l10n_br_zip, por padrão a cada 365 dias o registro de cep na tabela é atualizado em uma nova consulta de cep nos cadastros do Odoo.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Lets users fill in Brazilian addresses automatically from a ZIP code (CEP). A search button appears next to the ZIP field on partners and companies, and results are cached in Odoo for reuse.
This module adds Brazilian ZIP code (CEP) lookup to Odoo addresses. On a contact or company form, when the country is Brazil, a small search button appears next to the ZIP field. Clicking it looks up the address and fills in street, district, city and state automatically.
- Lookups are stored in a dedicated CEP list (
l10n_br.zip) that you can browse from the CEPs menu, with a "Selecionar" button to apply a stored CEP to an address. - If several CEPs match, a "Pesquisar CEP" wizard opens so you can pick the right one, refine the search, or start a new search.
- If nothing is found locally, the module queries an online service (VIA CEP or API CEP) and saves the result for next time.
- In Settings you choose the ZIP search provider and how many days a stored CEP stays valid before it is refreshed (default 365 days).
It extends address handling on contacts and companies (res.partner, res.company) and adds settings on res.config.settings. Access to the CEP data and the search wizard is limited to partner managers.
Depends on
Required by other modules
Models and fields (4)
- l10n_br.zip · new modelcity_id (City), district, state_id (State), zip_code (CEP), country_id (Country), street_name (Logradouro), street_type, street_number, zip_complement (Range)
- l10n_br.zip.search · new modelzip (CEP), state (state), city_id (Cidade), zip_ids (CEPs), district, state_id (State), address_id (Id do objeto), country_id (Country), object_name (Nome do Objeto), street_name (Logradouro)
- res.config.settings · extends an existing modelcep_update_days (Days to Update CEP), cep_ws_provider (ZIP Search Provider)
- format.address.mixin · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 7 confirmed, 2 with no information of 9 versions.
Sources · Odoo 12.0
Confirmed on 2026-11-03 in branch 12.0 of OCA/l10n-brazil.
terminal Installation and usage
OCA documentation · Odoo 19.0Installation
Source · Odoo 19.0Este módulo depende do l10n_br_base e da biblioteca BrazilCEP ( ).
Configuration
Source · Odoo 19.0Nas configurações gerais no grupo de Localização Brasileira pode ser habilitada ou desabilitada a busca de CEP
Ao habilitar a busca de CEP existe as configurações:
- Provedor de Busca de CEP;
- Periodo para um registro na l10n_br_zip ser atualizado em uma nova consulta.
Usage
Source · Odoo 19.0Nos endereços de parceiro, empresa e prospectos será exibido ao lado do campo CEP um botão para pesquisa de CEP.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.