OdooWiki OCA HUB

l10n_br Compatibility

l10n_br_base_l10n_br_compat folder_open OCA/l10n-brazil open_in_new
Localization Licencia: AGPL-3

Compatibilidad entre la Localización Brasil OCA y el Módulo l10n_br "oficial"

Este módulo armoniza el módulo base de la localización brasileña de la OCA, l10n_br_base, con el módulo l10n_br, módulo de la Odoo Community que también sirve como base para la localización Odoo Enterprise. Su finalidad es abrir el rico y maduro ecosistema open source de la OCA al entorno más limitado de Odoo Enterprise, compatibilizando ambos mundos.

Beneficios y Funcionalidades:

  • Integración de Ecosistemas: Conecta la amplitud y flexibilidad del desarrollo colaborativo de la OCA con la base de Odoo Enterprise. Esto permite que los módulos Enterprise se enriquezcan con una parte significativa de las funcionalidades de la localización OCA. Este módulo funciona porque previamente se realizó un trabajo de armonización de los campos de los objetos res.partner y res.company en la OCA con los nuevos nombres introducidos por Odoo a partir de las versiones 16.0/17.0/18.0.
  • Compatibilidad Extendida: Al resolver los conflictos entre l10n_br_base (y aproximadamente un tercio de los módulos OCA que dependen de él) y el módulo l10n_br, este módulo viabiliza el uso de aproximadamente un tercio de los módulos de la localización OCA con la localización cerrada de Odoo Enterprise.
  • Prevención de Conflictos: Su función es desactivar las views conflictivas de res.partner y res.company del módulo l10n_br. Esto elimina la duplicación de campos en la interfaz, priorizando las vistas más completas y robustas proporcionadas por el l10n_br_base de la OCA. El módulo también evita la duplicación de los registros de ciudades res.city.

Público Objetivo y Recomendaciones:

  • Para usuarios de Odoo Enterprise: Este módulo es ideal para una transición progresiva hacia la OCA o para proyectos que necesitan funcionalidades de ambos conjuntos de módulos.
  • Para usuarios exclusivos de la OCA: Si ya utilizas únicamente la localización open source OCA (¡enhorabuena!), no se recomienda la instalación de este módulo. Los módulos l10n_br y l10n_br_base_l10n_br_compat no aportan valor a tu proyecto y pueden introducir complejidad innecesaria.

Nota Técnica Importante: La compatibilidad elimina el campo l10n_latam_identification_type_id. En caso de que este campo sea esencial para tu operación (ej.: en un contexto multi-empresa con otros países de América Latina), será necesario recrearlo a través de un módulo de personalización específico.

Aviso Importante sobre Compatibilidad de Licencias:

Es fundamental entender las implicaciones de las licencias involucradas al integrar módulos de ecosistemas diferentes:

  • Licencia AGPL (Módulos OCA): La licencia AGPL-3, bajo la cual se publica la gran mayoría de los módulos de la OCA (y que era la licencia original de Odoo), es una licencia de copyleft fuerte. Garantiza tu libertad de usar, modificar y redistribuir el software, pero exige que cualquier trabajo derivado (módulo personalizado que dependa de un módulo AGPL) sea también licenciado bajo la AGPL cuando se distribuya o se ofrezca como servicio (SaaS). El objetivo es garantizar que las mejoras realizadas en el software permanezcan libres y abiertas para toda la comunidad.
  • Licencia Propietaria (Odoo Enterprise): La licencia de Odoo Enterprise es restrictiva y propietaria. No permite la redistribución o publicación del código fuente de los módulos Enterprise o de trabajos derivados de ellos.

El Conflicto Fundamental: Las libertades fundamentales garantizadas por la AGPL son incompatibles con las restricciones impuestas por la licencia propietaria del Enterprise. Por lo tanto, es jurídicamente imposible crear un módulo único que dependa simultáneamente de un módulo OCA (AGPL) y de un módulo Odoo Enterprise (propietario) y luego redistribuirlo (incluso por SaaS), pues esto violaría los términos de una u otra licencia.

¿Cómo resuelve esto este módulo? Este módulo de compatibilidad está licenciado bajo la AGPL y depende únicamente del módulo l10n_br (también AGPL) de la Odoo Community y del l10n_br_base (AGPL) de la OCA. No toca ningún código Enterprise. Su función es crear un entorno donde los módulos Enterprise (ejecutados bajo su propia licencia) y los módulos OCA (ejecutados bajo la AGPL) puedan coexistir técnicamente en una misma instancia Odoo, siempre que el usuario posea licencias válidas para ambos. La responsabilidad de cumplir los términos de ambas licencias recae sobre la empresa que los utiliza en conjunto.

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 18.0

Armoniza automáticamente los módulos de localización brasileña para que la lista de ciudades de OCA y los formularios de direcciones sustituyan a los incluidos con el módulo estándar l10n_br, evitando ciudades duplicadas y pantallas en conflicto.

Este es un módulo de compatibilidad técnica que se instala automáticamente cuando están presentes tanto la localización base brasileña de la OCA como la localización brasileña estándar. Los usuarios no obtienen un menú nuevo; en su lugar, cambian las pantallas existentes.

  • Durante la instalación, el módulo busca ciudades brasileñas que provienen de la localización estándar y las empareja con las ciudades equivalentes de la localización de la OCA, comparando el estado y el nombre de la ciudad (ignorando acentos y mayúsculas).
  • Cuando se encuentra una coincidencia, los registros que apuntaban a la ciudad estándar (contactos y rangos de códigos postales) se redirigen a la ciudad de la OCA, y se elimina la ciudad estándar duplicada.
  • Se desactivan varias vistas estándar de formularios de contacto/empresa relacionadas con direcciones e impuestos para que las versiones de la OCA sean las que se muestren.
  • El diseño de dirección utilizado para Brasil se cambia a la vista de dirección de la OCA.

Toca res.city, res.partner, l10n_br.zip.range, res.country y ir.model.data. No se añaden nuevas reglas de negocio, correos electrónicos ni trabajos programados.

Depende de

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.

Fuentes · Odoo 18.0

Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-brazil.

terminal Instalación y uso

Sin información verificada

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.

info

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.