Metadata-Version: 2.1
Name: odoo-addon-l10n_br_nfse_dfe
Version: 18.0.1.0.1.1
Requires-Python: >=3.10
Requires-Dist: brazilfiscalreport
Requires-Dist: cryptography
Requires-Dist: nfelib>=3.2.0
Requires-Dist: odoo-addon-l10n_br_fiscal_certificate==18.0.*
Requires-Dist: odoo-addon-l10n_br_fiscal_dfe==18.0.*
Requires-Dist: odoo-addon-l10n_br_nfse==18.0.*
Requires-Dist: odoo==18.0.*
Requires-Dist: requests
Summary: Monitor incoming national NFS-e documents via the ADN distribution API.
Home-page: https://github.com/OCA/l10n-brazil
License: AGPL-3
Author: Escodoo, 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
Classifier: Development Status :: 3 - Alpha
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

================
Monitor de NFS-e
================

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

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
    :target: https://odoo-community.org/page/development-status
    :alt: Alpha
.. |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_nfse_dfe
    :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_nfse_dfe
    :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|

Monitor de NFS-e nacional (Distribuição DF-e)
=============================================

Este módulo baixa as **NFS-e nacionais** emitidas contra o CNPJ da
empresa pela API de distribuição do ADN (Ambiente de Dados Nacional) e
as coloca na mesma caixa de entrada do monitor de DF-e.

A NF-e continua no webservice SOAP ``NFeDistribuicaoDFe``. A NFS-e
nacional usa um cliente REST com certificado digital (mTLS) e não passa
por esse fluxo.

Principais funcionalidades
--------------------------

- Consulta por NSU em ``GET /contribuintes/DFe/{NSU}``, com paginação do
  lote.
- Gravação em ``l10n_br_fiscal_dfe.document`` e
  ``l10n_br_fiscal_dfe.dfe``, com o tipo fiscal ``nfse``.
- Notas completas e eventos. O cancelamento atualiza a situação do
  documento já recebido.
- Importação do XML nacional como documento fiscal de serviço (modelo
  ``SE``), com uma linha de serviço.
- Cron e canal ``queue_job`` reutilizados pelo motor genérico de DF-e.

.. IMPORTANT::
   This is an alpha version, the data model and design can change at any time without warning.
   Only for development or testing purpose, do not use in production.
   `More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
   :local:

Installation
============

Este módulo depende de:

- ``l10n_br_fiscal_dfe``
- ``l10n_br_nfse``
- ``l10n_br_fiscal_certificate``
- ``queue_job`` (exigido pelo motor de DF-e)

Bibliotecas Python: ``nfelib`` (>= 3.2.0) consulta o lote e os eventos
no ADN. ``requests`` e ``cryptography`` continuam na leitura da nota por
chave na Sefin Nacional.

A empresa precisa de um certificado e-CNPJ A1 válido, o mesmo já
utilizado pela localização fiscal.

Configuration
=============

Canal queue_job
---------------

A distribuição reutiliza o canal ``root.dfe`` já registrado por
``l10n_br_fiscal_dfe``. Mantenha a capacidade desse canal em **1 job
simultâneo** para não disparar o limite de requisições do ADN (HTTP
429).

.. code:: ini

   [queue_job]
   channels = root:2,root.dfe:1

Empresa
-------

Em **Faturamento > Configuração > Empresas**, aba **Fiscal > NFS-e
DF-e**:

- **Ambiente ADN**: Produção ou Produção restrita. O padrão é produção
  restrita. Este campo não é o ambiente ``1``/``2`` da emissão
  municipal.
- **Busca automática**: liga o cron que chama
  ``_cron_dfe_search_documents('nfse')``.
- **Produto padrão de importação**: produto de serviço preenchido no
  assistente quando a NFS-e é importada.
- **Último NSU**: cursor da próxima consulta. Pode ser ajustado para
  reprocessar a partir de um ponto.

O certificado e-CNPJ fica na configuração fiscal já existente.

Usage
=====

Caixa de entrada
----------------

Acesse **Faturamento > Fiscal > Consultas DF-e > Third-party NFS-e**.

A listagem mostra as NFS-e em que a empresa é tomadora. O último NSU, a
próxima consulta e o ambiente ficam na empresa, na aba **Fiscal > NFS-e
DF-e**.

Em cada documento:

1. **XML**: baixa o arquivo nacional recebido do ADN.
2. **Importar**: abre o assistente de importação com o XML completo. O
   assistente cria um ``l10n_br_fiscal.document`` do tipo ``SE``
   (entrada), com o prestador como emitente e uma linha de serviço. Se o
   prestador ainda não existe, ele é criado na confirmação a partir do
   ``prest`` da DPS (o ``emit`` só completa dados quando o CNPJ é o
   mesmo). O produto e a operação fiscal podem ser ajustados antes de
   confirmar. Se ``l10n_br_account`` estiver instalado, a confirmação
   existente do assistente gera a fatura de fornecedor.

A pesquisa específica aceita a chave de acesso de 50 dígitos ou um NSU.
A nota é consultada na Sefin Nacional e os eventos no ADN. Não há
manifestação do destinatário neste fluxo: a NFS-e nacional já chega com
o XML da nota.

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_nfse_dfe%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
-------

* Escodoo

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

- `ESCODOO <https://escodoo.com.br>`__:

  - Marcel Savegnago <marcel.savegnago@escodoo.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-marcelsavegnago| image:: https://github.com/marcelsavegnago.png?size=40px
    :target: https://github.com/marcelsavegnago
    :alt: marcelsavegnago

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

|maintainer-marcelsavegnago| 

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

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