Skip to main content
Odoo Community Association

NFS-e (FocusNFE)

Beta License: AGPL-3 OCA/l10n-brazil Translate me on Weblate Try me on Runboat

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

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

    • Enviar Inscrição Municipal do Prestador (NFSe Nacional): Visível quando Tipo FocusNFe NFSe = NFSe Nacional. Por padrão a Inscrição Municipal cadastrada na empresa é enviada na DPS. Alguns municípios (ex.: Porto Alegre/RS) não possuem a Inscrição Municipal do prestador registrada no CNC NFS-e nacional; nesses casos, desmarque esta opção para que o campo seja omitido e evitar a rejeição da DPS.

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. 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.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • KMEE

  • Escodoo

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

Current maintainers:

mileo marcelsavegnago

This module is part of the OCA/l10n-brazil project on GitHub.

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

Release files for odoo-addon-l10n-br-nfse-focus 17.0.3.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-l10n-br-nfse-focus 17.0.3.2.0
File Interpreter ABI Platform
odoo_addon_l10n_br_nfse_focus-17.0.3.2.0-py3-none-any.whl Python 3 none any Details

Release files / odoo_addon_l10n_br_nfse_focus-17.0.3.2.0-py3-none-any.whl

Download URL odoo_addon_l10n_br_nfse_focus-17.0.3.2.0-py3-none-any.whl
Size 60.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a82657232b86de7ea8b453e6d25f1c5fe2a42b36eb6bec01559dd408f4fbfca4
BLAKE2b-256 checksum
How to use checksums
638068e2fc4953d364a5f92b90940d9db1f590292fbcd2f65c54c8e4d2f62b3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

17.0.3.2.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page