Metadata-Version: 2.1
Name: odoo12-addon-l10n-br-nfe-spec
Version: 12.0.2.0.0.99.dev1
Summary: nfe spec
Home-page: https://github.com/OCA/l10n-brazil
Author: Akretion, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: LGPL-3
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.5
Requires-Dist: odoo (<12.1dev,>=12.0a)

========
nfe spec
========

.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
    :target: https://odoo-community.org/page/development-status
    :alt: Production/Stable
.. |badge2| image:: https://img.shields.io/badge/licence-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--brazil-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-brazil/tree/12.0/l10n_br_nfe_spec
    :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-12-0/l10n-brazil-12-0-l10n_br_nfe_spec
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
    :target: https://runbot.odoo-community.org/runbot/124/12.0
    :alt: Try me on Runbot

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

Este módulo contem a estrutura de dados da Nota Fiscal Electrônica (NF-e).
Um módulo que usa ele é o módulo `l10n_br_nfe` que permite transmitir as NF-e's.


Geração
~~~~~~~

O código dos mixins Odoo desse módulo é 100% gerado a partir dos últimos esquemas XSD da Fazenda usando generateDS e essa extensão dele:

https://github.com/akretion/generateds-odoo

Depois de baixar os esquemas na pasta /tmp/generated/schemas/nfe/v4_00 basta fazer o comando:

.. code-block:: bash

   python gends_run_gen_odoo.py -f -l nfe -x 4_00 -e '^ICMS\d+|^ICMSSN\d+' -d . -v /tmp/generated/schemas/nfe/v4_00/leiauteNFe_v4.00.xsd


Prefixo dos campos e versão
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Com até uns 800 campos fiscais apenas na NF-e, com uma meia dúzia de documentos fiscais complexos,
com 3000 módulos OCA, existiria um risco real de conflito com os nomes de campos vindo dos esquemas.
Além disso, temos várias versões da NFe, a 3.1, a 4.0 etc...

Nisso foi decidido que cada campo tem um prefixo composto do nome do schema
e de alguns dígitos da versão do esquema. No caso `nfe40_`. A escolha de 2 dígitos permite
que uma atualização menor do esquema use os mesmos campos (e dados no banco então) e que um simples
update Odoo (--update=...) consiga resolver a migração. Enquanto que para uma mudança maior
como de 3.1 para 4.0, seria assumido de usar novos campos e novas tabelas (para os objetos não Odoo)
e que a lib nfelib iria trabalhar com os campos da versão maior do documento fiscal considerado.


Casos das tags de ICMS e ICMSSN
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Para facilitar a validação das tags de ICMS e ICMSSN, o esquema contem tags especificas para cada tipo desses impostos.
Porem, Depois no Odoo o modelo é diferente com uma class apenas. Se a gente injectasse todos esses mixins de ICMS e ICMSSN na mesma class Odoo
a gente teria colisão de campos, com campos com o mesmo nome e seleções diferentes... Para evitar esses problemas, filtramos as classes
desses tags (opção -x no generateds-odoo). De qualquer forma, ja que o Odoo e o módulo l10n_br_fiscal tem modelos proprios para os impostos
temos que assumir que o mapping das tags de impostos nao pode ser tão automatizada.

**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 smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-brazil/issues/new?body=module:%20l10n_br_nfe_spec%0Aversion:%2012.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
~~~~~~~~~~~~

* 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/12.0/l10n_br_nfe_spec>`_ project on GitHub.

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


