Metadata-Version: 2.1
Name: odoo-addon-l10n_br_nfse_focus
Version: 18.0.3.0.0
Requires-Python: >=3.10
Requires-Dist: odoo-addon-l10n_br_nfse==18.0.*
Requires-Dist: odoo==18.0.*
Summary: NFS-e (FocusNFE)
Home-page: https://github.com/OCA/l10n-brazil
License: AGPL-3
Author: KMEE, 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 :: 4 - Beta
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

================
NFS-e (FocusNFE)
================

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

.. |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_nfse_focus
    :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_focus
    :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|

Esse módulo integra a emissão de Notas Fiscais de Serviços (NFSe) com a
API da FocusNFE permitindo assim, a criação, transmissão, consulta e
cancelamento de documentos fiscais do tipo NFSe.

O módulo suporta dois tipos de emissão:

- **NFSe Municipal:** Emissão de NFSe através da API municipal da
  FocusNFE
- **NFSe Nacional:** Emissão de NFSe através da API nacional da FocusNFE

Para mais informações, acesse: https://focusnfe.com.br/

**Table of contents**

.. contents::
   :local:

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

Para instalar esta funcionalidde, simplesmente instale o módulo e faça
as devidas configurações.

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

Após a instalação do módulo, siga os seguintes passos para configurá-lo
para a empresa desejada:

1. Definições > Usuários & Empresas > Empresas

2. Selecione a empresa desejada

3. Na visualização da empresa, clique na aba Fiscal

4. Na subseção NFS-e, configure os seguintes campos:

      - **Ambiente NFS-e:** Selecione a opção a ser usada no ambiente
        (Produção, Homologação)
      - **Provedor NFS-e:** Selecione a opção FocusNFE
      - **FocusNFe Token:** Informe o token de acesso da empresa. Obs.
        Este token é obtido através da plataforma da FocusNFE

        - **Token de Produção:** Token para ambiente de produção
          (visível quando Ambiente NFS-e = Produção)
        - **Token de Homologação:** Token para ambiente de homologação
          (visível quando Ambiente NFS-e = Homologação)

      - **Tipo FocusNFe NFSe:** Selecione o tipo de API a ser utilizada:

        - **NFSe:** Para emissão de NFSe Municipal (padrão)
        - **NFSe Nacional:** Para emissão de NFSe Nacional

      - **Valor Tipo de Serviço:** Se necessário configure o campo que
        deve preencher o valor de tipo de serviço (Service Type ou City
        Taxation Code)
      - **Valor Código CNAE:** Se necessário configure o campo que deve
        preencher o valor do Código CNAE (CNAE Code ou City Taxation
        Code)
      - **Formato Taxa:** Selecione o formato da taxa (Decimal ou
        Percentage)
      - **Incluir Documentos Autorizados na Verificação de Status:** Se
        marcado, documentos autorizados serão incluídos na verificação
        de status
      - **Forçar DANFSE Odoo:** Se marcado, o sistema sempre usará o
        DANFSE do Odoo ao invés do DANFSE da FocusNFE

Usage
=====

Para usar este módulo:

1. Configure a empresa conforme descrito na seção de Configuração.

2. Crie uma fatura com o tipo de documento fiscal 'SE'.

3. Preencha os detalhes necessários:

   - Para **NFSe Municipal:** Preencha o código tributário municipal,
     impostos e informações correlatas
   - Para **NFSe Nacional:** Preencha o código tributário nacional
     (NBS), código tributário municipal (se aplicável), impostos e
     informações correlatas

4. Valide o documento fiscal.

5. Envie o Documento Fiscal através do botão "Enviar Documento Fiscal".

6. Acompanhe o status de processamento do documento. O sistema
   verificará automaticamente o status através de um cron job, ou você
   pode verificar manualmente através do botão "Verificar Status".

7. Após a autorização, o DANFSE (Documento Auxiliar da Nota Fiscal de
   Serviço Eletrônica) será gerado automaticamente, a menos que a opção
   "Forçar DANFSE Odoo" esteja marcada na configuração da empresa.

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

* KMEE
* Escodoo

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

- `KMEE <https://www.kmee.com.br>`__:

  - André Marcos <andre.marcos@kmee.com.br>

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

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

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

|maintainer-mileo| |maintainer-marcelsavegnago| 

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

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