Este es el módulo 'raíz' de la localización brasileña. Aporta adaptaciones en los modelos del módulo base de Odoo como Parceiros, Empresas y Direcciones:
- Campo CNPJ y CPF con formateo y validación de estos campos;
- Campo de Inscripción Estadual con validación;
- Formateo de los campos de dirección;
- Código del Banco Central y Siscomex para países;
- Código del IBGE para estados y municipios;
- Lista de los Bancos brasileños;
- Cuentas bancarias y claves PIX de los parceiros;
- Lista de los municipios brasileños.
Se trata de un módulo muy simple y maduro. Existen algunos otros módulos simples que dependen solo de ese módulo o casi como l10n_br_crm o l10n_br_portal.
Pero si quieres emitir o solo gestionar algún tipo de documento fiscal como NF-e o NFS-e, el próximo módulo que debes mirar es el l10n_br_fiscal que es sin embargo un módulo mucho más complejo.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Añade campos fiscales y de dirección brasileños (CNPJ/CPF, números de impuesto estatal y municipal, códigos IBGE, claves Pix) a partners, companies, banks y cities, con reglas de validación y formato.
Este módulo adapta los datos base de Odoo para Brasil. En los partners y las compañías se obtienen campos para CNPJ/CPF (el número de IVA), State Tax Number (Inscrição Estadual), Municipal Tax Number, código Suframa, razón social, distrito y una ciudad vinculada a la lista de ciudades brasileñas. Estos campos aparecen en los formularios de partner y compañía solo cuando el país es Brasil.
Las reglas de validación se ejecutan automáticamente: se comprueba que CNPJ y CPF tengan el formato y los dígitos de control correctos, y el State Tax Number se valida según el estado. Se bloquea el CNPJ/CPF duplicado a menos que active la opción 'Multiple partners with the same CNPJ' en Ajustes; aun así, el mismo State Tax Number no se puede repetir para el mismo estado. También puede desactivar la validación de CPF/CNPJ o IE en Ajustes.
Las direcciones se formatean al estilo brasileño: nombre de la calle, número, distrito, y la ciudad se elige de una lista filtrada por estado. El CNPJ/CPF se almacena sin puntuación pero se muestra formateado, y la búsqueda por un número formateado también funciona.
Los bancos incorporan código de banco brasileño, número ISPB y marca COMPE. Las cuentas bancarias incorporan número de sucursal, dígito de la cuenta y tipo de cuenta, con comprobaciones de la longitud de la sucursal y de los campos obligatorios para cuentas corrientes/de ahorro. Los partners pueden almacenar claves Pix (CPF/CNPJ, teléfono, correo electrónico o clave aleatoria) con validación de formato y unicidad por partner.
Los países, estados y ciudades incorporan códigos IBGE, BC, Siscomex, SIAFI y ANP. El módulo también carga la lista de ciudades, estados y bancos brasileños.
Depende de
Lo necesitan otros módulos
Modelos y campos (11)
- res.bank · amplía un modelo existentecode_bc (Brazilian Bank Code), short_name, ispb_number (ISPB Number), compe_member (COMPE Member)
- res.city · amplía un modelo existenteanp_code (ANP Code), ibge_code (IBGE Code), siafi_code (SIAFI Code)
- res.company · modelo nuevozip, city, street, city_id, street2, district, state_id, country_id, legal_name, street_name, street_number, street_number2, l10n_br_ie_code, l10n_br_im_code, l10n_br_isuf_code, state_tax_number_ids (State Tax Numbers)
- res.country · amplía un modelo existentebc_code (BC Code), ibge_code (IBGE Code), siscomex_code, nationality_code
- res.partner · modelo nuevopix_key_ids (Pix Keys), is_br_partner, l10n_br_rg_code (RG)
- res.partner.pix · modelo nuevokey, key_type (Type), sequence, partner_id (Partner), partner_bank_id (Bank Account)
- res.partner.bank · amplía un modelo existenteacc_number (Account Number), bra_number (Bank Branch), bra_bank_bic (BIC/Swift Final Code.), acc_number_dig (Account Digit), bra_number_dig (Bank Branch Digit), partner_pix_ids (Pix Keys), bank_account_type, company_country_id (Company Country), transactional_acc_type (Account Type)
- res.country.state · amplía un modelo existenteibge_code (IBGE Code)
- state.tax.numbers · modelo nuevostate_id (State), company_id (Company), partner_id (Partner), l10n_br_ie_code (State Tax Number)
- res.config.settings · amplía un modelo existentemodule_l10n_br_zip (Use Brazilian postal service API), allow_cnpj_multi_ie (Multiple partners with the same CNPJ), disable_ie_validation (Disable IE validation), disable_cpf_cnpj_validation (Disable CPF and CNPJ validation)
- l10n_br_base.party.mixin · modelo nuevovat, city_id (City of Address), district, country_id, legal_name, show_l10n_br, l10n_br_ie_code (State Tax Number), l10n_br_im_code (Municipal Tax Number), cnpj_cpf_stripped (CNPJ/CPF Stripped), l10n_br_isuf_code (Suframa), show_br_vat_format, vat_formatted_cnpj (VAT Formatted (Brazil)), state_tax_number_ids (Others State Tax Number)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 8 confirmadas, 1 sin información de 9 versiones.
Fuentes · Odoo 15.0
Confirmado el 2026-11-03 en la rama 15.0 de OCA/l10n-brazil.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Instalación
Fuente · Odoo 19.0Este módulo depende de dos paquetes Python:
- erpbrasil.base
- num2words
- phonenumbers
- email_validator
Configuración
Fuente · Odoo 19.0Tras la instalación del módulo debe rellenarse la dirección de la empresa para que la formación y validaciones necesarias para Brasil funcionen en los objetos partner y en las direcciones.
Una vez configurada la dirección de la empresa, en el registro del partner encontrarás los campos CNPJ, CPF, IE, RG y los campos de dirección formateados para Brasil. Si solo tienes instalado el módulo base, puedes instalar el módulo Contact para acceder al registro de partners.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.