OdooWiki OCA HUB

NFS-e (FocusNFE)

l10n_br_nfse_focus folder_open OCA/l10n-brazil open_in_new
Uncategorised License: AGPL-3

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:

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Integrates Odoo with the FocusNFE service so companies can issue, transmit, check and cancel Brazilian service invoices (NFS-e), both municipal and national, directly from their fiscal documents.

This module connects Odoo to the FocusNFE online service to handle Brazilian service invoices (NFS-e). After configuring the provider and access tokens on the company, users can send service fiscal documents to the tax authority, follow their status and cancel them when needed.

  • Two emission modes are supported: municipal NFS-e and national NFS-e, chosen per company.
  • When a service document is sent, the module builds the data required by the service (provider, customer, service, taxes) and transmits it.
  • A scheduled job regularly checks documents that are in the 'sent' state and updates them to authorized, rejected or cancelled, also retrieving the official XML and PDF files.
  • Cancelling a document sends the cancellation reason to the service and records the cancellation event.
  • Company settings include production and homologation tokens, the NFS-e type, service and CNAE code options, tax rate format, and options to force Odoo's own PDF, to also refresh already authorized documents, to send the municipal registration, and to join all invoice lines into a single service description.

The module works on fiscal documents (l10n_br_fiscal.document) and company settings (res.company), and adds a scheduled action to keep invoice statuses up to date.

Depends on

l10n_br_nfse
Models and fields (5)
  • res.company · extends an existing modelprovedor_nfse, focusnfe_nfse_type (FocusNFe NFSe Type), focusnfe_tax_rate_format, focusnfe_production_token (FocusNFe Production Token), focusnfe_homologation_token (FocusNFe Homologation Token), focusnfe_nfse_cnae_code_value (NFSE CNAE Code Value), focusnfe_nfse_force_odoo_danfse (Force Odoo DANFSE), focusnfe_nfse_service_type_value (NFSE Service Type Value), focusnfe_nfse_nacional_send_im_prestador (Send Provider Municipal Registration (NFSe Nacional)), focusnfe_nfse_update_authorized_document_status (Include Authorized Documents in Status Check), focusnfe_nfse_nacional_concat_lines_discriminacao (Concatenate All Lines in Discriminação (NFSe Nacional))
  • focusnfe.nfse · new model
  • focusnfe.nfse.base · new model
  • focusnfe.nfse.nacional · new model
  • l10n_br_fiscal.document · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 18.0

Installation

Source · Odoo 18.0

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

Configuration

Source · Odoo 18.0

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

  • Definições \> Usuários & Empresas \> Empresas
  • Selecione a empresa desejada
  • Na visualização da empresa, clique na aba Fiscal
  • 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

Source · Odoo 18.0

Para usar este módulo:

  • Configure a empresa conforme descrito na seção de Configuração.
  • Crie uma fatura com o tipo de documento fiscal 'SE'.
  • 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
  • Valide o documento fiscal.
  • Envie o Documento Fiscal através do botão "Enviar Documento Fiscal".
  • 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".
  • 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.
info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.