OdooWiki OCA HUB

NFS-e (FocusNFE)

l10n_br_nfse_focus folder_open OCA/l10n-brazil open_in_new
Sin categoría Licencia: AGPL-3

Este módulo integra la emisión de Notas Fiscais de Serviços (NFSe) con la API de FocusNFE permitiendo así, la creación, transmisión, consulta y cancelación de documentos fiscales del tipo NFSe.

El módulo soporta dos tipos de emisión:

  • NFSe Municipal: Emisión de NFSe a través de la API municipal de FocusNFE
  • NFSe Nacional: Emisión de NFSe a través de la API nacional de FocusNFE

Para más informaciones, acceda a:

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Integra Odoo con el servicio FocusNFE para que las empresas puedan emitir, transmitir, consultar y cancelar facturas de servicios brasileñas (NFS-e), tanto municipales como nacionales, directamente desde sus documentos fiscales.

Este módulo conecta Odoo con el servicio en línea FocusNFE para gestionar facturas de servicios brasileñas (NFS-e). Tras configurar el proveedor y los tokens de acceso en la compañía, los usuarios pueden enviar documentos fiscales de servicios a la autoridad fiscal, seguir su estado y cancelarlos cuando sea necesario.

  • Se admiten dos modos de emisión: NFS-e municipal y NFS-e nacional, elegidos por compañía.
  • Cuando se envía un documento de servicio, el módulo construye los datos requeridos por el servicio (proveedor, cliente, servicio, impuestos) y los transmite.
  • Un trabajo programado comprueba periódicamente los documentos que están en estado 'sent' y los actualiza a autorizado, rechazado o cancelado, recuperando también los archivos XML y PDF oficiales.
  • La cancelación de un documento envía el motivo de cancelación al servicio y registra el evento de cancelación.
  • Los ajustes de la compañía incluyen tokens de producción y homologación, el tipo de NFS-e, opciones de código de servicio y CNAE, formato de tasa de impuestos, y opciones para forzar el PDF propio de Odoo, para actualizar también documentos ya autorizados, para enviar la inscripción municipal y para unir todas las líneas de factura en una única descripción de servicio.

El módulo trabaja sobre documentos fiscales (l10n_br_fiscal.document) y ajustes de compañía (res.company), y añade una acción programada para mantener actualizados los estados de las facturas.

Depende de

l10n_br_nfse
Modelos y campos (5)
  • res.company · amplía un modelo existenteprovedor_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 · modelo nuevo
  • focusnfe.nfse.base · modelo nuevo
  • focusnfe.nfse.nacional · modelo nuevo
  • l10n_br_fiscal.document · amplía un modelo existente

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

Fuentes · Odoo 17.0

Confirmado el 2026-11-03 en la rama 17.0 de OCA/l10n-brazil.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Instalación

Fuente · Odoo 18.0

Para instalar esta funcionalidad, simplemente instale el módulo y realice las configuraciones correspondientes.

Configuración

Fuente · Odoo 18.0

Tras la instalación del módulo, siga los siguientes pasos para configurarlo para la empresa deseada:

  • Ajustes \> Usuarios y empresas \> Empresas
  • Seleccione la empresa deseada
  • En la vista de la empresa, haga clic en la pestaña Fiscal
  • En la subsección NFS-e, configure los siguientes campos: > - Ambiente NFS-e: Seleccione la opción a usar en el ambiente > (Producción, Homologación) > - Proveedor NFS-e: Seleccione la opción FocusNFE > - FocusNFe Token: Informe el token de acceso de la empresa. Obs. > Este token se obtiene a través de la plataforma de FocusNFE > - Token de Producción: Token para ambiente de producción (visible cuando Ambiente NFS-e = Producción) > - Token de Homologación: Token para ambiente de homologación (visible cuando Ambiente NFS-e = Homologación) > - Tipo FocusNFe NFSe: Seleccione el tipo de API a utilizar: > - NFSe: Para emisión de NFSe Municipal (predeterminado) > - NFSe Nacional: Para emisión de NFSe Nacional > - Valor Tipo de Servicio: Si es necesario configure el campo que > debe rellenar el valor de tipo de servicio (Service Type o City Taxation Code) > - Valor Código CNAE: Si es necesario configure el campo que debe > rellenar el valor del Código CNAE (CNAE Code o City Taxation Code) > - Formato Tasa: Seleccione el formato de la tasa (Decimal o Percentage) > - Incluir Documentos Autorizados en la Verificación de Estado: Si está marcado, los documentos autorizados se incluirán en la verificación de estado > - Forzar DANFSE Odoo: Si está marcado, el sistema siempre usará el DANFSE de Odoo en lugar del DANFSE de FocusNFE > - Enviar Inscripción Municipal del Prestador (NFSe Nacional): Visible > cuando Tipo FocusNFe NFSe = NFSe Nacional. Por defecto la Inscripción > Municipal registrada en la empresa se envía en la DPS. Algunos municipios > (ej.: Porto Alegre/RS) no tienen la Inscripción Municipal del > prestador registrada en el CNC NFS-e nacional; en esos casos, desmarque > esta opción para que el campo se omita y evitar el rechazo de la > DPS.

Uso

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

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.