odoo-addon-l10n-br-fiscal 16.0.1.18.0.3__py3-none-any.whl → 16.0.1.18.2__py3-none-any.whl

odoo/addons/l10n_br_fiscal/models/comment.py

@@ -89,16 +89,16 @@ class Comment(models.Model):
     def name_get(self):
         def truncate_name(name):
             if len(name) > 60:
-                name = "{}...".format(name[:60])
+                name = f"{name[:60]}..."
             return name
 
-        return [(r.id, "{}".format(truncate_name(r.name))) for r in self]
+        return [(r.id, f"{truncate_name(r.name)}") for r in self]
 
     # format_amount function for fiscal observation
     # This way we can format numbers in currency template on fiscal observation
     # msg We'll call this function when setting the variables env below
     def format_amount(self, env, amount, currency):
-        fmt = "%.{}f".format(currency.decimal_places)
+        fmt = f"%.{currency.decimal_places}f"
         lang = env.ref("base.lang_pt_BR")
 
         formatted_amount = (
@@ -113,7 +113,7 @@ class Comment(models.Model):
         else:
             post = "\N{NO-BREAK SPACE}" + "{}".format(currency.symbol or "")
 
-        return "{pre}{0}{post}".format(formatted_amount, pre=pre, post=post)
+        return f"{pre}{formatted_amount}{post}"
 
     def compute_message(self, vals, manual_comment=None):
         if not self.ids and not manual_comment:

odoo/addons/l10n_br_fiscal/models/data_abstract.py

@@ -94,10 +94,10 @@ class DataAbstract(models.AbstractModel):
     def name_get(self):
         def truncate_name(name):
             if len(name) > 60:
-                name = "{}...".format(name[:60])
+                name = f"{name[:60]}..."
             return name
 
         if self._context.get("show_code_only"):
-            return [(r.id, "{}".format(r.code)) for r in self]
+            return [(r.id, f"{r.code}") for r in self]
 
-        return [(r.id, "{} - {}".format(r.code, truncate_name(r.name))) for r in self]
+        return [(r.id, f"{r.code} - {truncate_name(r.name)}") for r in self]

odoo/addons/l10n_br_fiscal/models/data_ncm_nbs_abstract.py

@@ -147,20 +147,18 @@ class DataNcmNbsAbstract(models.AbstractModel):
             lambda r: r.product_tmpl_qty > 0 and not r.tax_estimate_ids
         )
 
-        query = """
-            WITH {0}_max_date AS (
+        query = f"""
+            WITH {object_name.lower()}_max_date AS (
                SELECT
-                   {0}_id,
+                   {object_name.lower()}_id,
                    max(create_date)
                FROM
                    l10n_br_fiscal_tax_estimate
-               GROUP BY {0}_id)
-               SELECT {0}_id
-               FROM {0}_max_date
+               GROUP BY {object_name.lower()}_id)
+               SELECT {object_name.lower()}_id
+               FROM {object_name.lower()}_max_date
             WHERE max < %(create_date)s
-            """.format(
-            object_name.lower()
-        )
+            """
 
         query_params = {"create_date": data_max.strftime("%Y-%m-%d")}
 

odoo/addons/l10n_br_fiscal/models/document_eletronic.py

@@ -191,9 +191,7 @@ class DocumentEletronic(models.AbstractModel):
         if attachment_id:
             return {
                 "type": "ir.actions.act_url",
-                "url": "/web/content/{id}/{nome}".format(
-                    id=attachment_id.id, nome=attachment_id.name
-                ),
+                "url": f"/web/content/{attachment_id.id}/{attachment_id.name}",
                 "target": "new",
             }
 
@@ -229,6 +227,7 @@ class DocumentEletronic(models.AbstractModel):
             if not record.issuer:
                 raise ValidationError(
                     _(
-                        "The field 'Issuer' is required for brazilian electronic documents!"
+                        "The field 'Issuer' is required for brazilian electronic "
+                        "documents!"
                     )
                 )

odoo/addons/l10n_br_fiscal/models/document_event.py

@@ -242,7 +242,7 @@ class Event(models.Model):
             if not os.path.exists(save_dir):
                 os.makedirs(save_dir)
             f = open(file_path, "w")
-        except IOError as e:
+        except OSError as e:
             raise UserError(
                 _("Erro!"),
                 _(

odoo/addons/l10n_br_fiscal/models/document_fiscal_line_mixin_methods.py

@@ -207,7 +207,8 @@ class FiscalDocumentLineMixinMethods(models.AbstractModel):
         for line in self:
             # Determine if 'CSLL' and 'IRPJ' taxes may apply:
             # 1. When providing services (tax_icms_or_issqn == "issqn")
-            # 2. When supplying products to public entities (partner_is_public_entity is True)
+            # 2. When supplying products to public entities (partner_is_public_entity
+            #  is True)
             if line.tax_icms_or_issqn == "issqn" or line.partner_is_public_entity:
                 line.allow_csll_irpj = True  # Tax charges may apply
             else:
@@ -224,7 +225,7 @@ class FiscalDocumentLineMixinMethods(models.AbstractModel):
         vals.pop("id", None)
 
         if default:  # in case you want to use new rather than write later
-            return {"default_%s" % (k,): vals[k] for k in vals.keys()}
+            return {f"default_{k}": vals[k] for k in vals.keys()}
         return vals
 
     def _get_all_tax_id_fields(self):
@@ -275,7 +276,7 @@ class FiscalDocumentLineMixinMethods(models.AbstractModel):
         for line in self:
             taxes_groups = line.fiscal_tax_ids.mapped("tax_domain")
             fiscal_taxes = line.fiscal_tax_ids.filtered(
-                lambda ft: ft.tax_domain not in taxes_groups
+                lambda ft, taxes_groups=taxes_groups: ft.tax_domain not in taxes_groups
             )
             line.fiscal_tax_ids = fiscal_taxes + taxes
 

odoo/addons/l10n_br_fiscal/models/document_fiscal_mixin_fields.py

@@ -29,9 +29,9 @@ class FiscalDocumentMixinFields(models.AbstractModel):
         domain = (
             "[('state', '=', 'approved'),"
             "'|',"
-            "('company_id', '=', %s),"
+            f"('company_id', '=', {self.env.company.id}),"
             "('company_id', '=', False),"
-        ) % (self.env.company.id,)
+        )
         return domain
 
     fiscal_operation_id = fields.Many2one(

odoo/addons/l10n_br_fiscal/models/document_fiscal_mixin_methods.py

@@ -21,7 +21,7 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
         vals.pop("id", None)
 
         if default:  # in case you want to use new rather than write later
-            return {"default_%s" % (k,): vals[k] for k in vals.keys()}
+            return {f"default_{k}": vals[k] for k in vals.keys()}
         return vals
 
     def _get_amount_lines(self):
@@ -121,11 +121,12 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
                         line.freight_value = amount_freight_value * (
                             line.freight_value / amount_freight_old
                         )
-                    record._get_product_amount_lines()[
-                        -1
-                    ].freight_value = amount_freight_value - sum(
-                        line.freight_value
-                        for line in record._get_product_amount_lines()[:-1]
+                    record._get_product_amount_lines()[-1].freight_value = (
+                        amount_freight_value
+                        - sum(
+                            line.freight_value
+                            for line in record._get_product_amount_lines()[:-1]
+                        )
                     )
                 else:
                     amount_total = sum(
@@ -136,11 +137,12 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
                             line.freight_value = amount_freight_value * (
                                 line.price_gross / amount_total
                             )
-                    record._get_product_amount_lines()[
-                        -1
-                    ].freight_value = amount_freight_value - sum(
-                        line.freight_value
-                        for line in record._get_product_amount_lines()[:-1]
+                    record._get_product_amount_lines()[-1].freight_value = (
+                        amount_freight_value
+                        - sum(
+                            line.freight_value
+                            for line in record._get_product_amount_lines()[:-1]
+                        )
                     )
                 for line in record._get_product_amount_lines():
                     line._onchange_fiscal_taxes()
@@ -169,11 +171,12 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
                         line.insurance_value = amount_insurance_value * (
                             line.insurance_value / amount_insurance_old
                         )
-                    record._get_product_amount_lines()[
-                        -1
-                    ].insurance_value = amount_insurance_value - sum(
-                        line.insurance_value
-                        for line in record._get_product_amount_lines()[:-1]
+                    record._get_product_amount_lines()[-1].insurance_value = (
+                        amount_insurance_value
+                        - sum(
+                            line.insurance_value
+                            for line in record._get_product_amount_lines()[:-1]
+                        )
                     )
                 else:
                     amount_total = sum(
@@ -184,11 +187,12 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
                             line.insurance_value = amount_insurance_value * (
                                 line.price_gross / amount_total
                             )
-                    record._get_product_amount_lines()[
-                        -1
-                    ].insurance_value = amount_insurance_value - sum(
-                        line.insurance_value
-                        for line in record._get_product_amount_lines()[:-1]
+                    record._get_product_amount_lines()[-1].insurance_value = (
+                        amount_insurance_value
+                        - sum(
+                            line.insurance_value
+                            for line in record._get_product_amount_lines()[:-1]
+                        )
                     )
                 for line in record._get_product_amount_lines():
                     line._onchange_fiscal_taxes()
@@ -217,11 +221,12 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
                         line.other_value = amount_other_value * (
                             line.other_value / amount_other_old
                         )
-                    record._get_product_amount_lines()[
-                        -1
-                    ].other_value = amount_other_value - sum(
-                        line.other_value
-                        for line in record._get_product_amount_lines()[:-1]
+                    record._get_product_amount_lines()[-1].other_value = (
+                        amount_other_value
+                        - sum(
+                            line.other_value
+                            for line in record._get_product_amount_lines()[:-1]
+                        )
                     )
                 else:
                     amount_total = sum(
@@ -232,11 +237,12 @@ class FiscalDocumentMixinMethods(models.AbstractModel):
                             line.other_value = amount_other_value * (
                                 line.price_gross / amount_total
                             )
-                    record._get_product_amount_lines()[
-                        -1
-                    ].other_value = amount_other_value - sum(
-                        line.other_value
-                        for line in record._get_product_amount_lines()[:-1]
+                    record._get_product_amount_lines()[-1].other_value = (
+                        amount_other_value
+                        - sum(
+                            line.other_value
+                            for line in record._get_product_amount_lines()[:-1]
+                        )
                     )
                 for line in record._get_product_amount_lines():
                     line._onchange_fiscal_taxes()

odoo/addons/l10n_br_fiscal/models/document_move_mixin.py

@@ -247,7 +247,9 @@ class DocumentMoveMixin(models.AbstractModel):
                         {
                             "source_document_id": self.id,
                             "subsequent_operation_id": subsequent_id.id,
-                            "fiscal_operation_id": subsequent_id.subsequent_operation_id.id,
+                            "fiscal_operation_id": (
+                                subsequent_id.subsequent_operation_id.id
+                            ),
                         },
                     )
                 )

odoo/addons/l10n_br_fiscal/models/document_serie.py

@@ -79,7 +79,7 @@ class DocumentSerie(models.Model):
         return super().create(vals_list)
 
     def name_get(self):
-        return [(r.id, "{}".format(r.name)) for r in self]
+        return [(r.id, f"{r.name}") for r in self]
 
     def _is_invalid_number(self, document_number):
         self.ensure_one()

odoo/addons/l10n_br_fiscal/models/icms_regulation.py

@@ -2067,6 +2067,7 @@ class ICMSRegulation(models.Model):
         nbm=None,
         cest=None,
         operation_line=None,
+        ind_final=None,
     ):
         self.ensure_one()
         tax_group_icmsst = self.env.ref("l10n_br_fiscal.tax_group_icmsst")
@@ -2076,7 +2077,9 @@ class ICMSRegulation(models.Model):
             company, partner, tax_group_icmsst, ncm, nbm, cest
         )
 
-        tax_definitions = self._tax_definition_search(domain, ncm, nbm, cest, product)
+        tax_definitions = self._tax_definition_search(
+            domain, ncm, nbm, cest, product, ind_final
+        )
         return tax_definitions
 
     def map_tax_def_icms_difal(
@@ -2119,6 +2122,7 @@ class ICMSRegulation(models.Model):
         nbm=None,
         cest=None,
         operation_line=None,
+        ind_final=None,
     ):
         self.ensure_one()
         tax_definitions = self.env["l10n_br_fiscal.tax.definition"]
@@ -2137,7 +2141,7 @@ class ICMSRegulation(models.Model):
             )
 
             tax_definitions = self._tax_definition_search(
-                domain, ncm, nbm, cest, product
+                domain, ncm, nbm, cest, product, ind_final
             )
 
         return tax_definitions
@@ -2151,6 +2155,7 @@ class ICMSRegulation(models.Model):
         nbm=None,
         cest=None,
         operation_line=None,
+        ind_final=None,
     ):
         self.ensure_one()
         tax_definitions = self.env["l10n_br_fiscal.tax.definition"]
@@ -2161,7 +2166,9 @@ class ICMSRegulation(models.Model):
             company, partner, tax_group_icmsfcpst, ncm, nbm, cest
         )
 
-        tax_definitions = self._tax_definition_search(domain, ncm, nbm, cest, product)
+        tax_definitions = self._tax_definition_search(
+            domain, ncm, nbm, cest, product, ind_final
+        )
 
         return tax_definitions
 
@@ -2192,15 +2199,15 @@ class ICMSRegulation(models.Model):
         )
 
         icms_def_taxes |= self._map_tax_def_icmsst(
-            company, partner, product, ncm, nbm, cest, operation_line
+            company, partner, product, ncm, nbm, cest, operation_line, ind_final
         )
 
         icms_def_taxes |= self._map_tax_def_icmsfcp(
-            company, partner, product, ncm, nbm, cest, operation_line
+            company, partner, product, ncm, nbm, cest, operation_line, ind_final
         )
 
         icms_def_taxes |= self._map_tax_def_icmsfcpst(
-            company, partner, product, ncm, nbm, cest, operation_line
+            company, partner, product, ncm, nbm, cest, operation_line, ind_final
         )
 
         icms_taxes |= icms_def_taxes.mapped("tax_id")

odoo/addons/l10n_br_fiscal/models/product_template.py

@@ -26,8 +26,8 @@ class ProductTemplate(models.Model):
     # demo products of type 'product' (this type is added to product.template
     # in the stock module).
     # For some reason when running the tests, some inverse method fields then fail when
-    # reading 'product' value for the product type. It seems it is because l10n_br_fiscal
-    # doesn't depend on stock. But we don't want such a dependency.
+    # reading 'product' value for the product type. It seems it is because
+    # l10n_br_fiscal doesn't depend on stock. But we don't want such a dependency.
     # So a workaround to avoid the bug we add the 'product' value to the selection.
     type = fields.Selection(
         selection_add=[("product", "Storable Product")],

odoo/addons/l10n_br_fiscal/models/subsequent_document.py

@@ -3,7 +3,6 @@
 # License AGPL-3 or later (http://www.gnu.org/licenses/agpl)
 #
 
-from __future__ import division, print_function, unicode_literals
 
 from odoo import api, fields, models
 

odoo/addons/l10n_br_fiscal/models/subsequent_operation.py

@@ -2,8 +2,6 @@
 # License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
 
 
-from __future__ import division, print_function, unicode_literals
-
 from odoo import fields, models
 
 from ..constants.fiscal import SITUACAO_EDOC

odoo/addons/l10n_br_fiscal/models/tax_definition.py

@@ -20,11 +20,7 @@ class TaxDefinition(models.Model):
     _description = "Tax Definition"
 
     def _get_complete_name(self):
-        return "{tax_group}-{tax}-{cst_code}".format(
-            tax_group=self.tax_group_id.name,
-            tax=self.tax_id.name,
-            cst_code=self.cst_code,
-        )
+        return f"{self.tax_group_id.name}-{self.tax_id.name}-{self.cst_code}"
 
     @api.depends("tax_group_id", "tax_id", "cst_code")
     def _compute_display_name(self):

odoo/addons/l10n_br_fiscal/readme/CONFIGURE.md

@@ -0,0 +1,7 @@
+Para uma boa configuração fiscal, você tem que revisar bem:
+
+- em Configurações: as operaçoes fiscais que você vai usar, as linhas de
+  operação fiscal e as definições das taxas nessas linhas.
+- a configuração fiscal da sua empresa (aba fiscal)
+- a configuração fiscal dos clientes e fornecedores (aba fiscal) e dos
+  produtos (aba fiscal).

odoo/addons/l10n_br_fiscal/readme/CONTRIBUTORS.md

@@ -0,0 +1,12 @@
+- [Akretion](https://www.akretion.com/pt-BR):
+  - Renato Lima \<<renato.lima@akretion.com.br>\>
+  - Raphaël Valyi \<<raphael.valyi@akretion.com.br>\>
+  - Magno Costa \<<magno.costa@akretion.com.br>\>
+- [KMEE](https://www.kmee.com.br):
+  - Luis Felipe Mileo \<<mileo@kmee.com.br>\>
+  - Luis Otavio Malta Conceição \<<luis.malta@kmee.com.br>\>
+- [Escodoo](https://www.escodoo.com.br):
+  - Marcel Savegnago \<<marcel.savegnago@escodoo.com.br>\>
+- [Engenere](https://engenere.one):
+  - Antônio S. Pereira Neto \<<neto@engenere.one>\>
+  - Felipe Motter Pereira \<<felipe@engenere.one>\>

odoo/addons/l10n_br_fiscal/readme/DESCRIPTION.md

@@ -0,0 +1,196 @@
+![image](../static/img/fiscal_dashboard.png)
+
+## Classificações fiscais
+
+Primeramente, este módulo traz uma variedade de cadastros fiscais para
+produtos, parceiros ou empresas. Na hora de emitir documentos fiscais
+como NF-e, NFS-e etc... até empresas do regime simplificado ou MEI
+precisam de vários desses cadastros. E empresas do regime normal
+precisam deles para calcular os impostos ou emitir documentos fiscais.
+
+Produtos:  
+- tipo fiscal
+- NCM (com ligações com os impostos)
+- genêro fiscal
+- CEST
+- NBM
+- NBS
+- tipo de serviço
+- unidades fiscais
+
+Parceiros:  
+- CNAE
+- perfil fiscal
+
+## Conceito de documento fiscal
+
+O Odoo nativo não tem o conceito de documento fiscal. O conceito mais
+parecido seria o `account.move` e até a versão 10.0 a localização
+estendia o invoice para suportar as NF-e e NFS-e apenas. Naquela época
+não era razoável você cogitar fazer o SPED no Odoo, o próprio core do
+Odoo não tinha maturidade para isso então era válido a abordagem
+empírica de ir suportando mais casos de NFe dentro do invoice Odoo
+apenas.
+
+Porém, na v12, amadurecemos o framework XML/SOAP de forma que se torna
+razoável suportar vários documentos fiscais (NF-e, NFS-e, MDF-e, CT-e,
+EFD-Reinf, e-Social, GNRE, BP-e...) com a qualidade OCA dentro do Odoo.
+Também, apesar de complexo, o core do Odoo finalmente tem suporte
+suficiente para as operações de uma empresa que faria o SPED.
+
+Nisso se torna interessante ter o conceito de documento fiscal
+`l10n_br_fiscal.document` independente do invoice Odoo para suportar
+todos os documentos fiscais mesmo, de forma modular. Um outro motivo
+para ter o conceito de documento fiscal fora do módulo account é que
+quando você analisa o código deste módulo `l10n_br_fiscal`, quase nada
+dele poderia ser feito pelo módulo account do Odoo. Então ter esse
+módulo l10n_br_fiscal que não depende do módulo account também é uma
+forma de modularizar a localização para facilitar a manutenção dela,
+especialmente quando se trata de migrar e que o módulo pode ter mudado
+bastante como foi o caso entre a v8.0 e a v9.0 ou a v12.0 e v13.0 por
+exemplo. Facilita também a governança do projeto possibilitando que
+pessoas sejam responsáveis por diferentes partes. O módulo
+l10n_br_fiscal foi principalmente extraído do módulo
+l10n_br_l10n_br_account_product das v7.0 as v.10.0.
+
+Esse módulo `l10n_br_fiscal` é agnóstico de qualquer tecnologia XML ou
+SOAP. Ele contém apenas o que há de comum entre os documentos fiscais
+mas esses últimos são implementados em outros módulos. Para um
+determinado documento fiscal como a Nf-e, você tem então por exemplo:
+
+- `nfelib`: um pacote de data bindings puro Python (que não depende do
+  Odoo). Em geral usamos um gerador de código para gerar esses bindings
+  a partir dos esquemas XSD da fazenda.
+- `l10n_br_nfe_spec`: um modulo de mixins Odoo geridos também a partir
+  dos XSD. Esses mixins são apenas as estruturas de dados das
+  especificações antes de ser injectados em objetos Odoo existantes
+  (como res.partner ou l10n_br_fiscal.document) ou até tornados
+  concretos caso não exite objetos na Odoo ou na OCA para eles já.
+- `l10n_br_nfe`: um módulo Odoo que trata de injectar esses mappings
+  fiscais nos objetos Odoo e que implementa a lógica como os wizards
+  para a transmissão.
+
+A transmissão é realizada usando uma lib de transmissão como
+`erpbrasil.doc` (baseada em Python Zeep). Importante: no caso da
+`NFS-e`, a ausência de padrão nacional hoje e a simplicidade do modelo
+(comparado com a NFe) faz que foi decidido de não usar um módulo de
+mixins fiscais Odoo geridos, o mapping é com a lib de binding é feito
+manualmente, família de NFS-e por família.
+
+Alem disso a maioria do codigo do `l10n_br_fiscal.document` e das linhas
+dele `l10n_br_fiscal.document.line` é na verdade feito dentro de mixins
+`10n_br_fiscal.document.mixin` e `10n_br_fiscal.document.line.mixin`
+respectivamente. Esses mixins podem assim ser injectados em outros
+objetos Odoo que precedem os documentos fiscais e podem armazenar então
+o mesmo tipo de informação: `sale.order`, `purchase.order`,
+`stock.picking`... Isso é bem visível nos módulos que estendem esse
+módulo:
+
+``` text
+|-- l10n_br_fiscal
+    |-- l10n_br_sale
+    |-- l10n_br_purchase
+    |-- l10n_br_account
+    |-- ...
+```
+
+Porem o caso do invoice Odoo no modulo `l10n_br_account` é diferente
+ainda. Pois já se tem a tabela independente do documento fiscal cuja
+grande maioria das dezenas e até centenas de campos fiscais (no caso de
+muitos tipos de documentos fiscais) não são redundante com os do invoice
+Odoo. Se a gente injetasse esses mixins dentro do invoice, aí sim essas
+centenas de campos seriam duplicados entre o invoice e o documento
+fiscal. Por isso, o sistema que foi adotado no modulo `l10n_br_account`
+é que um invoice Odoo passa a ter um
+`_inherits = "l10n_br_fiscal.document"` de forma que se pilota o
+documento fiscal através do invoice, oferecendo o mesmo tipo de
+integração como antes. O mesmo tipo de mecanismo acontece com a linha do
+documento fiscal.
+
+Sendo assim, já pelos \_inherits, o invoice Odoo e as linhas dele já vão
+puxar todos campos fiscais como se eles fossem das suas respectivas
+tabelas sem duplicar eles no banco. Se alem disso a gente injetasse os
+mixins `10n_br_fiscal.document.mixin` e
+`10n_br_fiscal.document.line.mixin` no invoice e invoice.line, esses
+campos fiscais apareceriam também nas tabelas `account_move` e
+`account_move_line` de forma redundantes com os campos puxados pelos
+\_inherits. Para não ter esse problema, os métodos fiscais comuns (sem
+os campos) foram ainda extraidos nos mixins:
+`10n_br_fiscal.document.mixin.methods` e
+`10n_br_fiscal.document.line.mixin.methods` que são injectados nos
+objetos `account_move` e `account_move_line` respectivamente dentro do
+modulo `l10n_br_account`.
+
+## Impostos brasileiros
+
+O módulo l10n_br_fiscal lida com os principais impostos brasileiros
+como:
+
+- ICMS do Simples Nacional
+- ICMS do Regime normal
+- IPI
+- PIS
+- COFINS
+- ISSQN
+- IRPJ
+- II
+- CSLL
+- INSS
+
+O módulo l10n_br_fiscal também lida com:
+
+- ST
+- retenções
+
+![image](../static/img/fiscal_line.png)
+
+![image](../static/img/fiscal_total.png)
+
+É notório que o cálculo dos impostos no Brasil é muito especial e muito
+trabalhoso. Geralmente é o motivo pelo qual os ERPs internacionais não
+tem grande fatia de mercado brasileiro.
+
+Até a versão 10.0, tentamos usar e estender o objeto Odoo `account.tax`.
+A Akretion até criou o projeto `OCA/account-fiscal-rule` para determinar
+as alíquotas de cada imposto de accordo com os parâmetros da operação
+fiscal. Porém, a gente acabava usando quase nada do
+`account.fiscal.position` nativo na parte fiscal e pelo contrário, isso
+nos obrigava a ter um registro `account.tax` para cada aliquota e nos
+obrigava a manter centenas de taxas e dezenas de milhares de regras para
+selecionar a "posição fiscal" Odoo que aplicaria as taxas corretas. E
+você ainda tinha que gerir essas dezenas de milhares de regras para uma
+determinada empresa do regime normal. Conclusão: era inviável nos
+projetos menores de tentar se encaixa na lógica do Odoo para calcular os
+impostos brasileiros.
+
+Nisso criamos neste módulo os modelos de taxas que representam
+exatamente o funcionamentos dos impostos brasileiros. Além dos cálculos,
+esses modelos também nos servem a carregar as tabelas dos impostos. E
+mais adiante, no módulo `l10n_br_account`, ligamos os objetos nativos
+`account.tax` as alíquotas dos impostos brasileiros.
+
+Claro esses modelos dos impostos atendem as empresas do regime normal,
+mas é bom lembrar que até empresas do regime simplificado precisam
+desses modelos para realizar as operações com ST (Substituição
+Tributária)...
+
+## Operações fiscais
+
+> ![image](../static/img/fiscal_operation.png)
+
+No Odoo nativo, o conceito mais parecido com a operação fiscal e o
+`account.fiscal.position`. E ate a versão 10.0, era o que a gente usava.
+Porém, a posição fiscal do Odoo não resolve muito os nossos problemas
+pois:
+
+- no Brasil se tem uma operação fiscal por linha de documento fiscal
+- a posição fiscal do Odoo desconhece a lógica da parametrização fiscal
+  brasileira
+- já que puxamos o cadastro dos impostos no módulo l10n_br_fiscal fora
+  do módulo account (sem depender dele), não temos ainda o objeto
+  `account.fiscal.position` neste módulo.
+
+Com tudo, optamos por criar um objeto `l10n_br_fiscal.operation` que faz
+exactamente o que precisamos para o Brasil. Mais adiante, no módulo
+`l10n_br_account` é realizado a integração entre a posição fiscal do
+Odoo e essa operação fiscal.

odoo/addons/l10n_br_fiscal/readme/HISTORY.md

@@ -0,0 +1 @@
+

odoo/addons/l10n_br_fiscal/readme/INSTALL.md

@@ -0,0 +1,5 @@
+Para instalar o módulo l10n_br_fiscal, você precisa de instalar primeiro
+os pacotes Python
+
+- erpbrasil.base
+- erpbrasil.assinatura

odoo/addons/l10n_br_fiscal/readme/ROADMAP.md

@@ -0,0 +1 @@
+

odoo/addons/l10n_br_fiscal/readme/USAGE.md

@@ -0,0 +1,4 @@
+Você pode criar documentos fiscais direitamente pelo menu fiscal, mas a
+princípio você vai pilotar a criação de documentos fiscais a partir dos
+invoices Odoo, usando módulos adicionais como l10n_br_account,
+l10n_br_sale, l10n_br_purchase...