[16.0][MIG] l10n_br_cnab_structure

l10n_br_account_payment_order/README.rst

@@ -0,0 +1,216 @@
+=======================
+Brazilian Payment Order
+=======================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:86fd83fe97e79987ff8f6c6be81f0987ee99cce57aec36dc8ce83fa73ad149c8
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/licence-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/16.0/l10n_br_account_payment_order
+    :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-16-0/l10n-brazil-16-0-l10n_br_account_payment_order
+    :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=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+O modulo implementa a parte comum da infra-estrutura necessária para o uso do CNAB 240 ou 400 localizando o modulo https://github.com/OCA/bank-payment/tree/12.0/account_payment_order onde o Modo de Pagamento é usado para as configurações especificas de cada CNAB e a Ordem de Pagamento para o envio de Instruções CNAB, também é incluído grupos de acesso para permissões de segurança e o registro do LOG de retorno. Porém a implementação foi pensada para permitir que seja possível usar diferentes bibliotecas para gerar e tratar o retorno do CNAB, por isso é preciso instalar um segundo modulo que vai ter essa função, portanto a ideia é que aqui estará tudo que for comum para a implementação mas não irá funcionar sem esse segundo modulo.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Installation
+============
+
+This module depends on:
+
+* l10n_br_base
+* account_payment_order
+* account_due_list
+* account_cancel
+
+Configuration
+=============
+
+Verifique se o Banco e o tipo CNAB usado 240 ou 400 possuem os Códigos de Instrução do Movimento e os Códigos de Retorno do Movimento em:
+  * Faturamento > Configurações > Administração > CNAB Código de Movimento de Instrução
+  * Faturamento > Configurações > Administração > CNAB Código de Retorno do Movimento
+
+Caso seja preciso cadastrar por favor considere fazer um PR nesse modulo acrescentando em l10n_br_account_payment_order/data/cnab_codes/banco_X_cnab_Y_Z.xml assim em proximas implementações já não será preciso cadastra-los.
+
+Informe os dados do CNAB usado no cadastro do:
+
+  * Faturamento > Configurações > Administração > Modos de Pagamento
+
+Verifique as permissões de acesso dos usuários que vão utilizar o CNAB, existe o Usuário e o Gerente CNAB.
+
+IMPORTANTE: Como o CNAB envolve dinheiro e o caixa da empresa a segurança e a rastreablidade são fundamentais e como as configurações especificas de cada CNAB estão no Modo de Pagamento/account.payment.mode foi incluído nele o objeto mail.thread que registra alterações feitas em campos importantes, porém campos many2many não estão sendo registrados pelo track_visibility( ver detalhes aqui l10n_br_account_payment_order/models/account_payment_mode.py#L59), e um campo especifico e importante que armazena os Codigos de Retorno do CNAB que devem gerar Baixa/Liquidação é desse tipo, portanto as alterações referentes a esse campo não estão sendo registradas. No repositorio https://github.com/OCA/social/tree/12.0 da OCA existe um modulo para corrigir isso o https://github.com/OCA/social/tree/12.0/mail_improved_tracking_value , por isso considere e é RECOMENDADO incluir esse modulo na implementação para corrigir esse problema. A inclusão da dependencia desse modulo aqui está pendente de aprovação.
+
+Usage
+=====
+
+Ao criar uma Fatura/account.invoice que tem um Modo de Pagamento do tipo CNAB e se o campo auto_create_payment_order estiver marcado as linhas referentes as Parcelas serão criadas automaticamente em uma nova Ordem de Pagamento ou adicionadas em uma já existente que esteja no estado Rascunho, também é possível incluir manualmente, a geração do arquivo e o tratamento do arquivo de retorno dependem da instalação de um segundo modulo onde é definida a biblioteca a ser utilizada.
+
+Known issues / Roadmap
+======================
+
+* Verificar a questão do campos many2many que não estão sendo registrados pelo track_visibility e se será incluída a dependendecia https://github.com/OCA/social/tree/12.0/mail_improved_tracking_value ( confirmar o problema na v14 ).
+
+* Processo de Alteração de Carteira, falta informações sobre o processo.
+
+* Mapear e incluir os codigos dos bancos de cada CNAB 240 / 400, aqui devido a quantidade de possibilidades se trata de um "roadmap" constante onde contamos com PRs de outros contribuidores que irão implementar um caso que ainda não esteja cadastrado, apesar do codigo permitir que o cadastro seja feito na tela nesses casos.
+
+* Processo de "Antecipação do Título junto ao Banco" ou "Venda do Título junto a Factoring" ver as alterações feitas na v14 https://www.odoo.com/pt_BR/forum/ajuda-1/v14-change-in-payment-behavior-how-do-the-suspense-and-outstanding-payment-accounts-change-the-journal-entries-posted-177592 .
+
+* CNAB de Pagamento, verificar a integração com o PR https://github.com/OCA/l10n-brazil/pull/972 e a possibilidade de multiplos modos de pagamento na mesma Ordem de Pagamento https://github.com/odoo-brazil/l10n-brazil/pull/112
+
+* Verificar a possibilidade na v14 de remoção do ondele='restrict' no campo "move_line_id" e o campo "related" "ml_maturity_date" do account.payment.line no modulo dependente https://github.com/OCA/bank-payment/blob/14.0/account_payment_order/models/account_payment_line.py#L39 para permitir o processo de Cancelamento de uma Fatura quando existe uma Ordem de Pagamento já confirmada/gerada/enviada( detalhes l10n_br_account_payment_order/models/account_payment_line.py#L130 )
+
+* Funcionalidade de Agrupar Por/Group By não funciona em campos do tipo Many2Many, aparentemente isso foi resolvido na v15(verfificar na migração), isso é usado nos objetos referentes aos Codigos CNAB de Instrução e Retorno.
+
+* Confirmar se existem Bancos que usam os mesmos conjuntos de Codigos CNAB de Instrução e Retorno para caso não existir remover o many2many do Banco e deixar apenas o many2one.
+
+* Na migração remover o objeto bank.payment.line, que está vazio, porém é necessário para evitar erro na atualização do modulo ver detalhes em l10n_br_account_payment_order/models/account_payment_line.py:291 e referencia do problema https://github.com/odoo/odoo/issues/44767 .
+
+* Verificar a possibilidade de usar o objeto account.payment no caso CNAB e o modulo https://github.com/OCA/bank-payment/tree/14.0/account_payment_order_return para tratar o LOG de Retorno do CNAB, RFC https://github.com/OCA/l10n-brazil/issues/2272 .
+
+Changelog
+=========
+
+14.0.1.0.0 (2022-04-29)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [MIG] Migração para a versão 14.0.
+
+13.0.1.0.0 (2022-01-28)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [MIG] Migração para a versão 13.0.
+
+12.0.3.0.0 (2021-05-13)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [MIG] Migração para a versão 12.0.
+* Incluído a possibilidade de parametrizar o CNAB 240 e 400, devido a falta de padrão cada Banco e CNAB podem ter e usar codigos diferentes.
+* Incluído os metodos para fazer alterações em CNAB já enviados.
+* Incluído dados de demo e testes.
+* Separado o objeto que fazia o Retorno do arquivo e registrava as informações para ter um objeto especifico que registra o Log e assim os modulos que implementam a biblioteca escolhida podem ter um metodo/objeto especifico para essa função.
+
+12.0.1.0.0 (2019-06-06)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [MIG] Inicio da Migração para a versão 12.0.
+
+10.0.2.0.0 (2018-05-17)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [REF] Modulo unido com o l10n_br_account_payment_mode e renomeado para l10n_br_account_payment_order.
+
+10.0.1.0.0 (2018-08-29)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [MIG] Migração para a versão 10.
+
+8.0.1.0.1 (2017-07-14)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [NEW] Refatoração e melhorias para suportar a geração de boletos através do br-cobranca (ruby)
+
+8.0.1.0.0 (2017-07-14)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [NEW] Melhorias para suportar a geração de pagamento da folha de pagamento;
+
+8.0.0.0.0 (2016-01-18)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [NEW] Primeira versão
+
+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_account_payment_order%0Aversion:%2016.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
+~~~~~~~
+
+* KMEE
+* Akretion
+
+Contributors
+~~~~~~~~~~~~
+
+* `KMEE <https://www.kmee.com.br>`_:
+
+  * Luis Felipe Mileo
+  * Fernando Marcato
+  * Hendrix Costa
+
+* `Akretion <https://www.akretion.com/pt-BR>`_:
+
+  * Magno Costa
+
+* `Engenere <https://engenere.one>`_:
+
+  * Antônio S. Pereira Neto
+
+* `Escodoo <https://www.escodoo.com.br>`_:
+
+  * Marcel Savegnago
+
+Other credits
+~~~~~~~~~~~~~
+
+The development of this module has been financially supported by:
+
+* KMEE INFORMATICA LTDA - www.kmee.com.br
+* AKRETION LTDA - www.akretion.com
+
+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-mbcosta| image:: https://github.com/mbcosta.png?size=40px
+    :target: https://github.com/mbcosta
+    :alt: mbcosta
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-mbcosta| 
+
+This module is part of the `OCA/l10n-brazil <https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_account_payment_order>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

l10n_br_account_payment_order/__init__.py

@@ -0,0 +1,2 @@
+from . import models
+from . import wizards

l10n_br_account_payment_order/__manifest__.py

@@ -0,0 +1,74 @@
+# Copyright (C) 2016-Today - KMEE (<http://kmee.com.br>).
+#  Luis Felipe Miléo - [email protected]
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Brazilian Payment Order",
+    "version": "16.0.1.0.0",
+    "license": "AGPL-3",
+    "author": "KMEE, Akretion, Odoo Community Association (OCA)",
+    "maintainers": ["mbcosta"],
+    "website": "https://github.com/OCA/l10n-brazil",
+    "development_status": "Beta",
+    "category": "Banking addons",
+    "depends": [
+        "l10n_br_base",
+        "account_payment_order",
+        "l10n_br_account_due_list",
+        "account_due_list_payment_mode",
+    ],
+    "data": [
+        # Security
+        "security/cnab_cobranca_security.xml",
+        "security/ir.model.access.csv",
+        # Data
+        "data/cnab_data.xml",
+        "data/l10n_br_payment_export_type.xml",
+        "data/boleto_data.xml",
+        # CNAB Mov. Instruction and Return Codes
+        "data/cnab_codes/banco_bradesco_cnab_240_400.xml",
+        "data/cnab_codes/banco_cef_cnab_240.xml",
+        "data/cnab_codes/banco_do_brasil_cnab_400.xml",
+        "data/cnab_codes/banco_itau_cnab_240_400.xml",
+        "data/cnab_codes/banco_sicred_cnab_240.xml",
+        "data/cnab_codes/banco_unicred_cnab_240_400.xml",
+        "data/cnab_codes/banco_ailos_cnab_240.xml",
+        "data/cnab_codes/banco_santander_cnab_240_400.xml",
+        # Boleto Wallet Code
+        "data/cnab_codes/banco_santander_boleto_wallet_code.xml",
+        "data/cnab_codes/banco_bradesco_boleto_wallet_code.xml",
+        # Wizards
+        "wizards/account_payment_line_create_view.xml",
+        "wizards/account_move_line_change.xml",
+        # Views
+        "views/account_journal.xml",
+        "views/account_payment_order.xml",
+        "views/account_payment_line.xml",
+        "views/account_payment_mode.xml",
+        "views/l10n_br_cnab_return_log_view.xml",
+        "views/account_move_line.xml",
+        "views/l10n_br_cnab_return_move_code_view.xml",
+        "views/account_payment_views.xml",
+        "views/l10n_br_cnab_mov_instruction_code_view.xml",
+        "views/account_move_view.xml",
+        "views/l10n_br_cnab_boleto_wallet_code_view.xml",
+    ],
+    "demo": [
+        "demo/account_payment_method.xml",
+        "demo/mov_instruction_code.xml",
+        "demo/res_partner_bank.xml",
+        "demo/account_account.xml",
+        "demo/account_journal.xml",
+        "demo/ir_sequence.xml",
+        "demo/account_payment_mode.xml",
+        "demo/account_invoice.xml",
+        "demo/res_users.xml",
+        "demo/account_payment_order.xml",
+    ],
+    "installable": True,
+    "external_dependencies": {
+        "python": [
+            "erpbrasil.base>=2.3.0",
+        ]
+    },
+}