NFS-e Multiciudad, una Hoja de Cálculo:
Procesamiento por Lotes Sin Plantillas Municipales

Por qué el procesamiento por lotes de NFS-e es un problema diferente a la extracción de un solo documento

Si ha leído la guía de extracción de una sola NFS-e, conoce el mecanismo central: la extracción semántica lee una NFS-e comprendiendo el significado de cada campo: localiza el CNPJ do Prestador de 14 dígitos junto a la etiqueta "Prestador", la base de cálculo del ISS en la sección del ISS, la alícuota ISS donde el municipio la haya impreso. Un documento, un conjunto de definiciones de columnas, una fila de salida. El problema de la variación municipal se resuelve a nivel del documento.

El procesamiento por lotes introduce desafíos de otro tipo que la extracción de un solo documento no presenta. Cuando coloca 30 documentos NFS-e de proveedores de São Paulo (ISS 5% para consultoría de TI), Río de Janeiro (ISS 5% para el mismo servicio), Belo Horizonte (ISS 3%), Curitiba (ISS 4%) y otras seis ciudades en una sola cola de procesamiento, ocurren tres cosas que nunca suceden con un solo documento:

Primero, se vuelve necesaria la verificación de la tasa de ISS entre ciudades. Una sola NFS-e con ISS al 3% parece correcta de forma aislada. Pero cuando ve que el mismo código de servicio (ítem 1.01 — Análise e desenvolvimento de sistemas, o análisis y desarrollo de TI) aparece al 5% desde São Paulo, al 5% desde Río y al 3% desde Belo Horizonte en el mismo lote, la tasa de Belo Horizonte resalta de inmediato. Quizás sea correcta — Belo Horizonte fija sus propias tasas. Quizás el proveedor aplicó la tasa municipal incorrecta. Una vista a nivel de lote es la única forma de detectarlo.

Segundo, el seguimiento del ISS Retido na Fonte (ISS retenido en la fuente) se convierte en una tarea de cumplimiento a escala de lote. Cuando una NFS-e está marcada como "ISS Retido na Fonte = Sim", la obligación de remitir el ISS se transfiere del proveedor de servicios al tomador del servicio — usted. Cada ocurrencia requiere un pago por separado a la prefeitura (municipio) correspondiente, cada una con su propia fecha de vencimiento y sistema de pago. En 10 documentos de varias ciudades, rastrear qué facturas activan esta obligación y cuáles no, no es manejable como una lista de verificación manual.

Tercero, los datos en sí son más valiosos en conjunto. Los totales de ISS por proveedor, el gasto en servicios por ciudad, la proporción de impuesto retenido frente al impuesto pagado por el proveedor — nada de esto es visible con un solo documento a la vez. Solo surgen cuando todo el lote está en una sola hoja de cálculo.

No se trata de hacer el flujo de trabajo de un solo documento más rápido. Se trata de hacer algo que el flujo de trabajo de un solo documento no puede hacer en absoluto.

¿Qué Hace que el Procesamiento de NFS-e entre Municipios sea Fundamentalmente Diferente al Lote de Facturas Estándar?

El procesamiento estándar de lotes de facturas — 50 PDFs de 50 proveedores en EE. UU. o Europa — es principalmente un problema de volumen. Las facturas se ven diferentes, pero la lógica fiscal subyacente es consistente: IVA a la tasa nacional, impuesto a las ventas por estado, y los campos están en posiciones ampliamente predecibles con etiquetas también predecibles.

El procesamiento de lotes de NFS-e brasileñas añade una capa estructural que las facturas estándar no tienen. Como el ISS es un impuesto municipal regido por la Lei Complementar 116/2003, y cada municipio opera su propio sistema tributario, el mismo campo lógico — "la tasa de ISS" — puede tener un valor diferente para cada documento del lote, y ese valor determina si el impuesto de ese documento se calculó correctamente.

Aquí es donde la extracción basada en plantillas — el enfoque que usa la mayoría de las herramientas de extracción de documentos — se vuelve estructuralmente inviable. Una plantilla define una zona rectangular para cada campo: "CNPJ do Prestador está en la posición de píxel (x=150, y=320)". Eso funciona para un municipio. Pero falla para el siguiente. Mantener una biblioteca de plantillas para cada ciudad donde operan tus proveedores no es práctico cuando el número de ciudades posibles es 5.570 y el número de ciudades que actualizan activamente sus diseños — São Paulo lanzó la versión 3.2 de su manual de NFS-e en agosto de 2025 — crece constantemente.

La alternativa es la extracción semántica: en lugar de definir dónde está un campo en la página, le dices al motor de extracción lo que buscas — "el CNPJ de 14 dígitos etiquetado como Prestador" — y él lee el documento para encontrarlo. La posición no importa porque el motor entiende el contenido del documento, no sus coordenadas. Una NFS-e de São Paulo y una de Porto Alegre en el mismo lote se procesan con las mismas definiciones de columna, porque la IA busca significado, no una posición.

Para el desglose completo de cómo la extracción semántica maneja campos individuales de NFS-e — coincidencia de CNPJ, clasificación del servicio según LC 116, desglose del ISS — consulta la guía de extracción de NFS-e individual. El flujo de trabajo por lotes hereda todo eso y añade la capa de múltiples documentos.

Cómo la extracción semántica procesa 10 NFS-e de distintas ciudades en un solo lote

El flujo de extracción para el procesamiento por lotes de NFS-e se centra en la Extracción de Columnas Personalizadas: escribes los nombres de los campos que deseas en tu salida — "CNPJ del Prestador", "Código de Servicio (LC 116)", "Alícuota ISS", "Valor ISS", "ISS Retenido (Retido na Fonte)", "Número NFS-e" — y la IA localiza cada valor en cada documento al comprender el significado de la etiqueta. Estos nombres de columna se convierten en los encabezados de tu hoja de cálculo. Los defines una vez. Funcionan en todos los municipios del lote.

Pero el procesamiento por lotes de NFS-e se beneficia de ir más allá de la extracción directa. Dos modos de columna adicionales hacen posible la conciliación entre ciudades en el momento de la extracción, no en un ejercicio separado de hoja de cálculo:

Columnas calculadas te permiten definir una lógica de validación que se ejecuta durante la extracción. Para el procesamiento por lotes de NFS-e, la columna calculada más útil es una verificación del ISS: "¿Alícuota ISS × Base Imponible ISS = Valor ISS?" Cuando el total calculado coincide con el valor ISS extraído, la columna muestra "OK". Cuando no coincide, muestra la discrepancia, señalando a nivel de lote qué documentos necesitan una segunda revisión antes de importar los datos a tu ERP. En un solo documento, esta verificación toma 30 segundos. En 50 documentos, una columna calculada lo hace automáticamente, y ves el resultado en la misma hoja de cálculo que los datos extraídos.

Columnas inferidas permiten que la IA clasifique o etiquete documentos según su contenido. Agrega una columna llamada "Municipio (extraído del documento)" sin referencia de campo específica, y la IA lee el identificador de la prefeitura (ayuntamiento) de la NFS-e y completa el nombre de la ciudad. Ahora tu salida por lotes tiene una columna de municipio ordenable, lo que convierte los totales de ISS por ciudad y la declaración de impuestos por ciudad en una tabla dinámica, en lugar de un ejercicio manual de referencias cruzadas.

Estos tres tipos de columna — extracción directa, calculada e inferida — operan juntos en una sola ejecución por lotes. No extraes primero y validas después. La validación ocurre durante la extracción, y los resultados llegan a la misma hoja de cálculo.

Paso a paso: de una pila de NFS-e de varias ciudades a una hoja de cálculo

Este es el flujo de trabajo práctico para procesar por lotes documentos NFS-e de varios municipios brasileños en un solo archivo de Excel. Esta configuración se realiza una vez por lote: las mismas definiciones de columnas procesan cada documento sin importar la ciudad de origen.

Conciliación de ISS entre Municipios: La Vista por Lotes

El resultado más valioso del procesamiento por lotes de NFS-e no es el tiempo ahorrado — aunque pasar de 3 minutos por documento a 5-10 segundos por página es una mejora de 18x. El resultado más valioso es la vista de conciliación que solo existe cuando todos los documentos están en una misma tabla.

Esto es lo que esa vista permite hacer que el procesamiento individual no puede:

Totales de ISS por Ciudad

Agrupa los resultados por municipio y suma el monto del ISS. Obtienes el ISS total aplicado a tus compras de servicios en cada ciudad — datos relevantes por dos razones. Primero, indica si el ISS total de todos los proveedores en una ciudad coincide con tu asignación interna de costos para esa jurisdicción. Segundo, si eres el agente retenedor de ISS en alguna de estas facturas, el total por ciudad es el número que necesitas para conciliar con tus registros de pago de impuestos municipales. La guía fiscal global de Dentons señala que "los conflictos entre municipios donde ambos reclaman el ISS son bastante comunes" — una vista por lotes es tu pista de auditoría si un segundo municipio aparece reclamando.

Rastreo de ISS Retido na Fonte

Cuando una NFS-e tiene la marca "ISS Retido na Fonte = Sim", su empresa — no el prestador del servicio — es responsable de remitir el ISS al municipio del prestador. Esto no es una nota de ingreso de datos; es una acción de cumplimiento tributario con un plazo y un sistema de pago que varía por ciudad. En un lote de salida, ordenar por la columna ISS Retido le da una lista completa y unificada de todas las facturas que requieren su acción. Sin tener que buscar entre 30 PDFs individuales para encontrar los tres que tenían la marca.

El marco legal sobre la retención de ISS ha sido probado en el tribunal más alto de Brasil. En 2020, el Supremo Tribunal Federal (STF) de Brasil falló en RE 1167509 que los municipios no pueden imponer obligaciones de retención de ISS a los tomadores de servicios cuando el prestador no está registrado en ese municipio — revocando el requisito de registro Cadastro de Prestadores de Outros Municípios (CPOM) de São Paulo. Pero las obligaciones de retención establecidas por ley federal, donde la combinación de tipo de servicio y municipio desencadena una retención legítima, siguen vigentes. Saber qué facturas tienen una obligación de retención válida requiere ver el lote.

Detección de Variación en la Tasa de ISS

La LC 116/2003 establece tasas de ISS entre el 2% y el 5% por municipio y tipo de servicio. Pero los municipios compiten con tasas para atraer empresas — el diagnóstico del PNUD sobre el sistema tributario brasileño señala "una guerra predatoria por incentivos fiscales de ICMS e ISS". Un prestador podría aplicar una tasa del 2% para un código de servicio que São Paulo grava al 5% porque el prestador está registrado en un municipio que redujo su tasa para atraer empresas. Si esa tasa es válida es una determinación fiscal que debe hacer su equipo de contabilidad. Pero detectarla requiere ver el lote. Un solo documento al 2% parece normal. Diez documentos al 5% y uno al 2%, todos para el mismo código de servicio — esa es una variación que vale la pena investigar.

Qué Significa el Estándar Nacional de NFS-e para el Procesamiento por Lotes

El Sistema Nacional da NFS-e (SNNFS-e) es el esfuerzo de Brasil por unificar los formatos de facturas de servicios entre municipios. Hasta agosto de 2025, 1463 municipios se habían adherido, pero la adopción es voluntaria y ciudades importantes como São Paulo han confirmado públicamente que mantendrán sus propios sistemas. El resultado es un panorama híbrido: algunos de sus proveedores emiten NFS-e bajo el estándar XML nacional, otros bajo el sistema de su propia ciudad, y usted no controla cuál.

Desde la perspectiva del procesamiento por lotes, este panorama híbrido refuerza el valor de la extracción independiente del diseño. Las herramientas basadas en plantillas ahora necesitan plantillas tanto para los diseños municipales previos al estándar como para el estándar SNNFS-e, además de rutas de actualización cuando las ciudades migran de uno a otro. La extracción semántica lee lo que esté en el documento, independientemente del estándar que lo haya producido. Una NFS-e de estándar nacional y una NFS-e de formato personalizado de São Paulo llegan al mismo lote, definen las mismas columnas y producen el mismo resultado. El proceso de estandarización cambia el contenido del documento, no el enfoque de extracción.

La reforma tributaria de 2026 — que reemplazará gradualmente el ISS con el IBS (Imposto sobre Bens e Serviços) hasta 2033 — añade otra capa. Durante la transición, los documentos NFS-e pueden incluir tanto campos heredados de ISS como nuevos campos de IBS/CBS. El enfoque de extracción se adapta agregando nuevos nombres de columna — "Monto IBS", "Monto CBS" — junto a las columnas existentes de ISS. Sin necesidad de rediseñar plantillas.

Si su organización también procesa facturas de bienes brasileñas, el flujo de trabajo de extracción de XML de NF-e se cubre en la guía de extracción de NF-e. Ambos tipos de documentos pueden coexistir en el mismo lote cuando sus definiciones de columnas son lo suficientemente amplias, aunque los campos específicos de NFS-e, como el código LC 116, estarán en blanco para documentos NF-e, lo cual es esperado y no causa errores.

Preguntas Frecuentes: Procesamiento por Lote de NFS-e

¿Puedo procesar por lote NFS-e de proveedores de diferentes ciudades juntos?

Sí — y este es el caso de uso principal. La extracción semántica lee cada documento de forma independiente al comprender el contenido, no al coincidir con el diseño de una ciudad específica. Una NFS-e de São Paulo (ISS 5%), una de Belo Horizonte (ISS 3%) y una de Curitiba (ISS 4%) en el mismo lote se procesan con las mismas definiciones de columna. La IA localiza el CNPJ do Prestador, la base de cálculo del ISS y demás campos en cada documento, sin importar dónde aparezcan en la página.

¿Cómo se maneja el ISS Retido na Fonte en la salida por lote?

El campo "ISS Retenido" se extrae como una columna dedicada — que generalmente contiene "Sim" (sí) o "Não" (no). En la hoja de cálculo de salida por lote, ordenar por esta columna le da una lista completa de cada factura donde su empresa es el agente de retención. A partir de ahí, calcula el monto a remitir (la tasa de ISS × la base de cada factura marcada) y dirige cada una al sistema de pago de la prefectura correspondiente. La herramienta de extracción proporciona los datos. La remisión del impuesto en sí sigue siendo un paso de cumplimiento separado que su equipo de contabilidad realiza a través del portal de pago de cada municipio.

¿Qué sucede si un proveedor emite una NFS-e con errores de diseño o campos faltantes?

El motor de extracción lee lo que está en el documento. Si un campo obligatorio — el CNPJ, por ejemplo — falta o es ilegible, esa celda en la salida estará en blanco. Esto es realmente útil: una celda en blanco en la salida por lote identifica de inmediato qué documento necesita seguimiento con el proveedor, mientras que ingresar manualmente 30 documentos podría hacer que pase por alto un campo en blanco entre los demás. La vista por lote hace visibles las omisiones.

¿Puedo mezclar documentos NFS-e con facturas de servicios internacionales en el mismo lote?

Sí. Si sus definiciones de columna cubren ambos tipos de documentos — como "Número de Factura", "Nombre del Proveedor", "Monto Total", "Monto del Impuesto" — las facturas internacionales y los documentos NFS-e pueden coexistir en el mismo lote. Las columnas específicas de NFS-e como "Código de Servicio LC 116" o "Tasa de ISS" estarán en blanco para documentos no brasileños, y las columnas específicas internacionales como "Número de IVA" estarán en blanco para documentos NFS-e. Ambos comportamientos son esperados y no causan errores.

¿El motor de extracción maneja los campos de la reforma tributaria de 2026 (IBS/CBS) en documentos NFS-e?

Sí — cuando un municipio actualiza su diseño de NFS-e para incluir campos de IBS o CBS, usted agrega los nombres de columna correspondientes (ej.: "Monto IBS", "Monto CBS") a su definición de lote. El motor de extracción localiza estos nuevos campos al comprender el contenido del documento, de la misma forma que localiza los campos existentes de ISS y CNPJ. No se requiere reconfiguración de plantillas. Durante el período de transición hasta 2033, puede ejecutar lotes que contengan documentos NFS-e con campos tanto de ISS como de IBS — defina columnas para ambos, y el resultado completará los campos presentes en cada documento.

¿Cómo se compara el procesamiento por lotes con la integración directa de la API de cada municipio?

La integración de API municipal requiere construir y mantener una conexión separada para cada ciudad donde operan sus proveedores — cada una con su propio método de autenticación, esquema y calendario de actualizaciones. El estándar nacional SNNFS-e simplifica esto para los municipios participantes, pero ciudades grandes como São Paulo han optado por no adherirse. La extracción semántica por lotes procesa los documentos que ya recibe — PDFs, XMLs, impresiones DANFSE — sin requerir acceso API a ningún sistema municipal. No es una alternativa a la integración de API para la emisión de NFS-e saliente. Es la solución del lado receptor cuando usted es el tomador del servicio, no el emisor.

Para una visión más amplia de la extracción de documentos por lotes más allá de NFS-e, vea cómo funciona la extracción de facturas por lotes a Excel en distintos tipos de documentos y monedas.

Del Tipeo por Municipio a la Conciliación por Lote

La NFS-e fue diseñada para hacer eficiente la recaudación de impuestos para el gobierno — y lo logra. Cada factura de servicio que recibe fue validada por una autoridad fiscal municipal antes de llegar a su bandeja de entrada. El CNPJ fue verificado. La tasa de ISS fue validada contra el código de servicio. El número de factura fue asignado. Esos datos existen. Son precisos. Han pasado por un paso de validación gubernamental que la mayoría de las facturas internacionales nunca ven.

La ineficiencia está enteramente del lado receptor: reescribir campos validados de documentos que varían por ciudad en una hoja de cálculo que debe ser correcta para la conciliación SPED. La extracción semántica por lotes cierra esa brecha no haciendo el tipeo más rápido, sino eliminándolo — y al hacerlo, le brinda la visión intermunicipal que el ingreso manual nunca podría producir.

La próxima vez que reciba un lote de NFS-e de proveedores de São Paulo, Río, Belo Horizonte y más allá, intente procesarlos como un solo lote. Defina sus columnas una vez. Deje que la extracción se ejecute. Luego ordene por municipio y revise los totales de ISS. Vea si la vista del lote revela algo que los documentos individuales no mostraban.