Metadata-Version: 2.1
Name: odoo-addon-l10n_br_base_l10n_br_compat
Version: 18.0.1.0.0.2
Requires-Python: >=3.10
Requires-Dist: odoo-addon-l10n_br_base==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Compatibility with the l10n_br module
Home-page: https://github.com/OCA/l10n-brazil
License: AGPL-3
Author: Akretion, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=====================
l10n_br Compatibility
=====================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:1c0a079fbce61897b8cc97f21ce89c396186cb186022c0d5c49cd14e1385b201
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--brazil-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-brazil/tree/18.0/l10n_br_base_l10n_br_compat
    :alt: OCA/l10n-brazil
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-brazil-18-0/l10n-brazil-18-0-l10n_br_base_l10n_br_compat
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-brazil&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Compatibilidade entre a Localização Brasil OCA e o Módulo l10n_br "oficial"
---------------------------------------------------------------------------

Este módulo atua como uma ponte de integração, harmonizando o módulo
base da localização brasileira da OCA (``l10n_br_base``) com seu
equivalente da Odoo Community (``l10n_br``). Sua finalidade é abrir o
rico e maduro ecossistema open source da OCA para o ambiente mais
limitado do Odoo Enterprise, compatibilizando ambos os mundos.

Benefícios e Funcionalidades:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- **Integração de Ecossistemas:** Conecta a abrangência e flexibilidade
  do desenvolvimento colaborativo da OCA com a base do Odoo Enterprise.
  Isso permite que os módulos Enterprise sejam enriquecidos com uma
  porção significativa das funcionalidades da localização OCA. Este
  módulo funciona porque foi previamente feito um trabalho de
  harmonização dos campos dos objetos ``res.partner`` e ``res.company``
  na OCA com os novos nomes introduzidos pela Odoo a partir das versões
  16.0/17.0/18.0.
- **Compatibilidade Estendida:** Ao resolver os conflitos entre
  ``l10n_br_base`` (e aproximadamente um terço dos módulos OCA que
  dependem dele) e o módulo ``l10n_br``, este módulo desbloqueia uma
  compatibilidade que beneficia a quem pretende fazer uma transição do
  Odoo Enterprise para a OCA.
- **Prevenção de Conflitos:** Sua função é desativar as views
  conflitantes de ``res.partner`` e ``res.company`` do módulo
  ``l10n_br``. Isso elimina a duplicação de campos na interface,
  priorizando as visões mais completas e robustas fornecidas pelo
  ``l10n_br_base`` da OCA.

Publico-Alvo e Recomendações:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- **Para usuários do Odoo Enterprise:** Este módulo é ideal para uma
  **transição progressiva** ou para projetos que necessitam de
  funcionalidades de ambos os conjuntos de módulos.
- **Para usuários exclusivos da OCA:** Se você já utiliza apenas a
  localização open source OCA (**parabéns!**), a instalação deste módulo
  **não é recomendada**. Os módulos ``l10n_br`` e
  ``l10n_br_base_l10n_compat`` não agregam valor ao seu projeto e podem
  introduzir complexidade desnecessária.

Nota Técnica Importante:
~~~~~~~~~~~~~~~~~~~~~~~~

A compatibilidade remove o campo ``l10n_latam_identification_type_id``.
Caso este campo seja essencial para a sua operação (ex.: em um contexto
multi-empresa com outros países da América Latina), será necessário
recriá-lo através de um módulo de customização específico.

Aviso Importante sobre Compatibilidade de Licenças:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

É fundamental entender as implicações das licenças envolvidas ao
integrar módulos de ecossistemas diferentes:

- **Licença AGPL (Módulos OCA):** A licença AGPL-3, sob a qual a grande
  maioria dos módulos da OCA é publicada (e que era a licença original
  do Odoo), é uma licença de *copyleft* forte. Ela garante a liberdade
  de usar, modificar e redistribuir o software, mas **exige que qualquer
  trabalho derivado (módulo customizado que dependa de um módulo AGPL)
  seja também licenciado sob a AGPL** quando distribuído ou oferecido
  como serviço (SaaS). O objetivo é garantir que as melhorias feitas no
  software permaneçam livres e abertas para toda a comunidade.

- **Licença Proprietária (Odoo Enterprise):** A licença do Odoo
  Enterprise é restritiva e proprietária. Ela **não permite a
  redistribuição ou publicação do código-fonte** dos módulos Enterprise
  ou de trabalhos derivados deles.

**O Conflito Fundamental:** As liberdades fundamentais garantidas pela
AGPL são **incompatíveis** com as restrições impostas pela licença
proprietária do Enterprise. Portanto, **é juridicamente impossível criar
um módulo único que dependa simultaneamente de um módulo OCA (AGPL) e de
um módulo Odoo Enterprise (proprietário) e depois redistribuí-lo**
(mesmo por SaaS), pois isso violaria os termos de uma ou de outra
licença.

**Como este módulo resolve isso?** Este módulo de compatibilidade é
licenciado sob a AGPL e depende *apenas* do módulo ``l10n_br`` (também
AGPL) da Odoo Community e do ``l10n_br_base`` (AGPL) da OCA. Ele não
toca em nenhum código Enterprise. Sua função é criar um *ambiente* onde
os módulos Enterprise (executados sob sua própria licença) e os módulos
OCA (executados sob a AGPL) possam coexistir tecnicamente em uma mesma
instância Odoo, desde que o usuário possua licenças válidas para ambos.
A responsabilidade de cumprir os termos de ambas as licenças recai sobre
a empresa que os utiliza em conjunto.

**Table of contents**

.. contents::
   :local:

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-brazil/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-brazil/issues/new?body=module:%20l10n_br_base_l10n_br_compat%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Akretion

Contributors
------------

- `AKRETION <https://akretion.com/pt-BR/>`__:

  - Raphaël Valyi <raphael.valyi@akretion.com.br>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-rvalyi| image:: https://github.com/rvalyi.png?size=40px
    :target: https://github.com/rvalyi
    :alt: rvalyi

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-rvalyi| 

This module is part of the `OCA/l10n-brazil <https://github.com/OCA/l10n-brazil/tree/18.0/l10n_br_base_l10n_br_compat>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
