OdooWiki OCA HUB

Brazilian Localization IE Search

l10n_br_ie_search folder_open OCA/l10n-brazil open_in_new
Uncategorised License: AGPL-3

Módulo que busca a inscrição estadual referente ao CNPJ pesquisado ao clicar no botão de busca de cnpj do módulo l10n_br_cnpj_search, assim preenchendo o campo State Tax Number.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

When you look up a Brazilian company by CNPJ in Odoo, this module also fetches and fills in the company's State Tax Number (Inscrição Estadual). You choose in Settings whether the lookup uses SEFAZ or the SINTEGRAWS service.

This module extends the CNPJ lookup wizard so that, in addition to the company data already retrieved, Odoo also fills in the partner's State Tax Number (l10n_br_ie_code).

Where it appears: - In Settings, a new option lets you choose the provider for the state registration search: SEFAZ or SINTEGRAWS. - If you pick SINTEGRAWS, a token field appears where you enter the SINTEGRA access token. - The lookup happens automatically when you use the existing CNPJ search button on a partner.

Business rules and behaviour: - The provider is stored as a system setting; the SINTEGRA token is stored as a system parameter. - For SEFAZ, the search uses the company's digital certificate and the state code of the partner's address. - For SINTEGRAWS, the search calls an external web service with the CNPJ and token. - If the service returns an error or a non-success status, Odoo shows a validation error and stops the lookup. - The returned state registration number is written into the partner's State Tax Number field.

It touches the CNPJ search wizard, the settings screen, and the partner record. It depends on the Brazilian CNPJ search and electronic invoice modules.

Models and fields (3)
  • res.config.settings · extends an existing modelie_search (Select IE search provider), sintegra_token (SINTEGRA Token)
  • partner.search.wizard · extends an existing model
  • l10n_br_cnpj_search.webservice.abstract · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 15.0

Confirmed on 2026-11-03 in branch 15.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 18.0

Esta busca de informações a partir do cnpj é realizada com base no provedor SINTEGRA com o token da conta do usuário no site da API configurado na aba de configurações ou com o WebService do SEFAZ ao marcar a opção correspondente e configurando o certificado da empresa, vale ressaltar que o provedor SINTEGRA é pago, enquanto que o SEFAZ é gratuito.

  • Para usar o SINTEGRAws
  • Acesse Configurações
  • Clique na caixa de seleção "Activate state subscription search"
  • Insira o seu token da API no campo "SINTEGRA Token"
  • Preencha os campos obrigatórios, insira no campo de CNPJ o CNPJ que deseja buscar e clique na lupa ao lado do campo para buscar e o campo State Tax Number será preenchido com a inscrição estadual

No verified information in OCA: Installation.

info

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.