NFS-e Nacional: Cómo Integrar en Su Sistema hasta Noviembre

El nuevo plazo de la NFS-e Nacional y lo que cambia para su empresa

Saber cómo integrar la NFS-e Nacional en mi sistema se ha convertido en una prioridad técnica y operativa para proveedores de servicios y desarrolladores. La Resolución CGSN nº 191/2026 estableció el aplazamiento oficial del plazo de obligatoriedad del 1º de septiembre al 1º de noviembre de 2026 para microempresas (ME) y empresas de pequeño porte (EPP) optantes del Simples Nacional que prestan servicios sujetos al ISS. Los Microemprendedores Individuales (MEI) ya utilizan el estándar obligatoriamente desde el 1º de septiembre de 2023.

Este cambio busca dar un respiro para la adecuación tecnológica, pero el calendario exige atención. Entre el 1º de noviembre y el 31 de diciembre de 2026, estará vigente un período de transición: la empresa pasará a emitir a través del sistema nacional, pero continuará siguiendo las reglas de tributación del Simples Nacional, sin aplicación inmediata de los nuevos tributos IBS y CBS. La recaudación por IBS y CBS en el Simples comenzará a regir a partir del 1º de enero de 2027, integrando el escenario de Reforma Tributaria en sistemas en 2026.

La adopción del estándar simplifica la rutina de quienes emiten facturas para diferentes municipios, ya que unifica el modelo fiscal. La adhesión ya alcanza cerca de 3.000 municipios, incluyendo 19 capitales, lo que representa aproximadamente el 80% del volumen nacional de facturas de servicio.

Puntos principales

• Plazo final: 1º de noviembre de 2026 para ME y EPP del Simples Nacional.
• Período de transición: del 1º de noviembre al 31 de diciembre de 2026 (IBS/CBS son válidos para el Simples a partir del 1º de enero de 2027).
• Modalidades de emisión: Web, aplicación móvil e integración vía API REST.
• Exigencias técnicas de la API: TLS con mTLS, certificado ICP-Brasil (A1/A3), XML 1.0 en UTF-8 firmado en XMLDSIG y payload en GZip con Base64.

Formas de emisión: ¿sitio web, aplicación o integración vía API?

La emisión de facturas en el estándar nacional solo puede realizarse a través del Emisor Nacional proporcionado por el gobierno federal, en tres modalidades distintas. La elección depende directamente del volumen de ventas de la empresa y de la necesidad de automatización de los procesos operativos.

La primera modalidad es la aplicación web disponible en la dirección oficial nfse.gov.br/EmissorNacional. La segunda opción es la aplicación móvil oficial. Ambas son gratuitas e indicadas para bajos volúmenes de facturas diarias, pero exigen un llenado manual en cada transacción. La tercera modalidad es la integración directa de su ERP o checkout vía API Web, recomendada para empresas que necesitan ganar escala y automatización.

Para ayudar en la toma de decisiones, consulte la comparación entre las opciones del panorama completo del estándar nacional:

Requisitos técnicos para integrar la API de la NFS-e Nacional

Integrar el emisor directamente en su software exige cumplir especificaciones de seguridad y formato rigurosas estipuladas por la documentación oficial. El canal de comunicación se construye sobre una arquitectura REST con envío y recepción de datos en JSON en las solicitudes principales.

Para establecer la conexión segura con los servidores, es obligatorio utilizar el protocolo TLS con autenticación mutua (mTLS). Esto significa que la aplicación necesita presentar un certificado digital ICP-Brasil válido (tipos A1 o A3) vinculado al responsable técnico del sistema durante el handshake de la conexión.

El flujo de datos del documento fiscal en sí requiere una estructura específica. El payload del servicio contiene el XML 1.0 codificado en UTF-8 y firmado digitalmente en el estándar XMLDSIG. Además, antes del envío por la API, el XML firmado debe ser compactado en formato GZip y convertido en una cadena Base64.

// Exemplo conceitual do fluxo de preparação do payload para a APIimport { gzipSync } from 'zlib';function prepararPayloadNFSe(xmlAssinadoUTF8: string): string {  // 1. Converter XML para Buffer UTF-8  const xmlBuffer = Buffer.from(xmlAssinadoUTF8, 'utf-8');    // 2. Compactar o buffer em GZip  const gzippedBuffer = gzipSync(xmlBuffer);    // 3. Converter para Base64 para envio na requisição JSON  return gzippedBuffer.toString('base64');}

Los endpoints disponibilizados por el webservice cubren todo el ciclo de vida del documento fiscal. Incluyen emisión de NFS-e, consulta de lotes y de facturas individuales, cancelación de documentos emitidos, recepción de eventos fiscales y la generación automática del DANFSE en formato PDF.

Acreditación, entorno de homologación y validación de esquema

El proceso de acreditación técnica exige que el responsable de la aplicación posea un CNPJ válido y un certificado digital e-CNPJ o e-CPF del responsable técnico. Para garantizar la protección de las claves privadas durante las operaciones del sistema, se recomienda encarecidamente el almacenamiento de las credenciales en un HSM (Hardware Security Module) o en una caja fuerte digital segura.

Antes de enviar solicitudes al entorno de producción, los desarrolladores tienen acceso a un entorno de homologación separado. En el Portal NFS-e, están disponibles archivos Swagger y especificaciones en YAML para facilitar la generación de clientes de API y el enrutamiento de pruebas.

Desde el 10 de diciembre de 2025, la estructura gubernamental disponibiliza un entorno restringido enfocado en los campos del grupo IBSCBS, alineado con la Nota Técnica 004 versión 2.0. Este entorno permite simular la estructura fiscal completa que entrará en vigor en las etapas de la transición tributaria.

Conforme las alertas de validación de esquema y documentación de API, el menor error de diseño, un campo obligatorio ausente o un tipo de dato inválido interrumpe inmediatamente la operación. De esta forma, implementar una capa rigurosa de validación de esquema XML localmente antes de disparar el paquete al webservice es un paso indispensable para evitar bloqueos en la cola de emisión.

Hoja de ruta práctica de implementación hasta noviembre

Para garantizar que su sistema esté funcionando sin contratiempos hasta el plazo límite del 1º de noviembre de 2026, vale la pena seguir un cronograma estructurado en cuatro etapas prácticas:

1. Auditoría de certificados digitales: Verifique si su empresa o los clientes de su software poseen certificados A1/A3 ICP-Brasil válidos y configure la caja fuerte digital o HSM para gestionar las claves de acceso mTLS.
2. Modelado del esquema y firma: Desarrolle los módulos de conversión para XML 1.0 UTF-8, firma XMLDSIG, compactación GZip y codificación Base64 dentro de su aplicación.
3. Pruebas en el entorno de homologación: Consuma la documentación Swagger en el Portal NFS-e y ejecute escenarios de prueba cubriendo emisión, consulta, cancelación y generación de DANFSE en PDF.
4. Validación de las reglas de transición: Utilice el entorno restringido con el grupo IBSCBS (Nota Técnica 004 v2.0) para garantizar que su estructura de base de datos y APIs ya estén preparadas para los cambios fiscales futuros.

Preguntas frecuentes

¿Cuál es el plazo final para que ME y EPP adopten la NFS-e Nacional?

El plazo final para microempresas y empresas de pequeño porte optantes del Simples Nacional es el 1º de noviembre de 2026. La fecha fue estipulada oficialmente por la Resolución CGSN nº 191/2026, alterando la obligación inicial que era septiembre de 2026.

¿El MEI necesita cambiar el sistema de emisión en noviembre de 2026?

No, el MEI no necesita hacer cambios en esa fecha. Los Microemprendedores Individuales ya están obligados a utilizar el estándar del Emisor Nacional de NFS-e desde el 1º de septiembre de 2023.

¿Cuáles son las exigencias de seguridad para conectar a la API Nacional?

Conectar a la API exige el uso de HTTPS con TLS y autenticación mutua (mTLS), utilizando un certificado digital ICP-Brasil A1 o A3 del responsable técnico. Las solicitudes viajan en JSON y exigen payloads que contengan XML firmado en XMLDSIG, compactado en GZip y codificado en Base64.

¿Dónde encontrar la documentación y el entorno de pruebas de la API?

La documentación oficial, los archivos Swagger y las especificaciones YAML están publicados en el Portal NFS-e del gobierno federal. El portal disponibiliza un entorno de homologación y un entorno restringido para validaciones de código.

Conclusión

La migración a la NFS-e Nacional es inevitable y el plazo extendido hasta el 1º de noviembre de 2026 ofrece la ventana perfecta para organizar el código sin prisas. Unificar la emisión bajo el estándar nacional elimina la complejidad de lidiar con múltiples diseños municipales y prepara su estructura para las exigencias fiscales de los próximos años.

Su recomendación práctica para hoy: acceda al Portal NFS-e, descargue la especificación Swagger actualizada de la API y configure el certificado digital de la empresa en el entorno de homologación para realizar las primeras pruebas.