Metadata-Version: 2.1
Name: odoo-addon-l10n_br_base_l10n_br_compat
Version: 18.0.2.0.0
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:61e60a1c7b570beb09fcc9b2e35e54330ac4b5d35390867b7809a0be897793ec
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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 harmoniza o módulo base da localização brasileira da OCA,
``l10n_br_base``, com o módulo ``l10n_br``, módulo da Odoo Community que
também serve como base para a localização Odoo Enterprise. 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
  parcela 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 viabiliza o uso de
  aproximadamente um terço dos módulos da localização OCA com a
  localização fechada do Odoo Enterprise.
- **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. O módulo também evita a duplicação dos
  registros de cidades ``res.city``.

Público-Alvo e Recomendações:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- **Para usuários do Odoo Enterprise:** Este módulo é ideal para uma
  **transição progressiva para a OCA** 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_br_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 sua
  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.
