NFS-e de Várias Cidades, Uma Planilha:
Lote Sem Modelos Municipais

Por que o Processamento em Lote de NFS-e é um Problema Diferente da Extração de Documento Único

Se você leu o guia de extração de NFS-e individual, conhece o mecanismo central: a extração semântica lê uma NFS-e compreendendo o significado de cada campo — localizando o CNPJ do Prestador de 14 dígitos ao lado do rótulo "Prestador", a base de cálculo do ISS na seção do ISS, a alíquota do ISS onde quer que a prefeitura a tenha impresso. Um documento, um conjunto de definições de colunas, uma linha de saída. O problema da variação municipal é resolvido no nível do documento.

O processamento em lote introduz uma classe diferente de desafios que a extração de documento único não revela. Ao enviar 30 documentos NFS-e de prestadores em São Paulo (ISS 5% para consultoria de TI), Rio de Janeiro (ISS 5% para o mesmo serviço), Belo Horizonte (ISS 3%), Curitiba (ISS 4%) e outras seis cidades para uma única fila de processamento, três coisas acontecem que nunca ocorrem com um documento único:

Primeiro, a verificação da alíquota do ISS entre cidades torna-se necessária. Uma NFS-e isolada com ISS de 3% parece correta por si só. Mas quando se observa que o mesmo código de serviço (item 1.01 — Análise e desenvolvimento de sistemas) aparece a 5% em São Paulo, 5% no Rio e 3% em Belo Horizonte no mesmo lote, a alíquota de Belo Horizonte se destaca imediatamente. Talvez esteja correta — Belo Horizonte define suas próprias alíquotas. Talvez o prestador tenha aplicado a alíquota municipal errada. Uma visão em nível de lote é a única forma de identificar isso.

Segundo, o acompanhamento do ISS Retido na Fonte torna-se uma tarefa de conformidade em escala de lote. Quando uma NFS-e está marcada como "ISS Retido na Fonte = Sim", a obrigação de recolher o ISS passa do prestador de serviços para o tomador — você. Cada ocorrência exige um pagamento separado à prefeitura correspondente, cada uma com sua própria data de vencimento e sistema de pagamento. Em 10 documentos de várias cidades, rastrear quais notas geram essa obrigação e quais não geram não é gerenciável como uma lista de verificação manual.

Terceiro, os dados em si são mais valiosos em conjunto. Totais de ISS por prestador, gastos com serviços por cidade, a proporção entre imposto retido e imposto pago pelo prestador — nada disso é visível a partir de um único documento. Essas informações só emergem quando todo o lote está em uma única planilha.

Não se trata de executar o fluxo de documento único mais rapidamente. Trata-se de fazer algo que o fluxo de documento único não consegue fazer de forma alguma.

O Que Torna o Processamento de NFS-e Entre Municípios Fundamentalmente Diferente do Lote de Notas Padrão

O processamento padrão de notas em lote — 50 PDFs de 50 fornecedores nos EUA ou na Europa — é principalmente um problema de volume. As notas são visualmente diferentes, mas a lógica tributária subjacente é consistente: IVA à alíquota nacional, imposto sobre vendas por estado, e os campos estão em posições amplamente previsíveis com rótulos amplamente previsíveis.

O processamento em lote de NFS-e brasileiras adiciona uma camada estrutural que o lote de notas padrão não possui. Como o ISS é um imposto municipal regido pela Lei Complementar 116/2003, e como cada município opera seu próprio sistema tributário, o mesmo campo lógico — "a alíquota do ISS" — pode ter um valor diferente para cada documento no lote, e esse valor determina se o imposto daquele documento foi calculado corretamente.

É aqui que a extração baseada em modelo — a abordagem usada pela maioria das ferramentas de extração de documentos — se torna estruturalmente inviável. Um modelo define uma zona retangular para cada campo: "CNPJ do Prestador está na posição de pixel (x=150, y=320)." Isso funciona para um município. Falha para o próximo. Manter uma biblioteca de modelos para cada cidade em que seus fornecedores operam não é prático quando o número de cidades possíveis é 5.570 e o número de cidades que atualizam ativamente seus layouts — São Paulo lançou a versão 3.2 do seu manual de NFS-e em agosto de 2025 — está em constante crescimento.

A alternativa é a extração semântica: em vez de definir onde um campo está na página, você informa ao mecanismo de extração o que está procurando — "o CNPJ de 14 dígitos rotulado como Prestador" — e ele lê o documento para encontrá-lo. A posição não importa porque o mecanismo entende o conteúdo do documento, não suas coordenadas. Uma NFS-e de São Paulo e uma NFS-e de Porto Alegre no mesmo lote são processadas com as mesmas definições de coluna, porque a IA procura significado, não corresponde a uma posição.

Para a análise completa de como a extração semântica lida com campos individuais de NFS-e — correspondência de CNPJ, classificação de código de serviço LC 116, detalhamento do ISS — consulte o guia de extração de NFS-e individual. O fluxo de trabalho em lote herda tudo isso e adiciona a camada de múltiplos documentos.

Como a Extração Semântica Processa NFS-e de 10 Cidades em Um Único Lote

O fluxo de extração para processamento de NFS-e em lote é centrado na Extração Personalizada de Colunas: você digita os nomes dos campos desejados na saída — "CNPJ do Prestador", "Código do Serviço (LC 116)", "Alíquota do ISS", "Valor do ISS", "ISS Retido na Fonte", "Número da NFS-e" — e a IA localiza cada valor em cada documento ao entender o significado do rótulo. Esses nomes de colunas se tornam os cabeçalhos da sua planilha. Você os define uma vez. Eles funcionam em todos os municípios do lote.

Mas o processamento de NFS-e em lote se beneficia de ir além da extração direta. Dois modos adicionais de colunas tornam a conciliação entre cidades possível no momento da extração, e não em um exercício separado de planilha:

Colunas calculadas permitem definir lógica de validação executada durante a extração. Para processamento de NFS-e em lote, a coluna calculada mais útil é uma verificação do ISS: "Alíquota do ISS × Base de Cálculo do ISS = Valor do ISS?" Quando o total calculado corresponde ao valor extraído do ISS, a coluna exibe "OK." Quando não corresponde, exibe a diferença — sinalizando, no nível do lote, quais documentos precisam de uma segunda análise antes de importar os dados para o seu ERP. Em um único documento, essa verificação leva 30 segundos. Em 50 documentos, uma coluna calculada faz isso automaticamente — e você vê o resultado na mesma planilha dos dados extraídos.

Colunas inferidas permitem que a IA classifique ou rotule documentos com base em seu conteúdo. Adicione uma coluna chamada "Município (extraído do documento)" sem referência de campo específica, e a IA lê o identificador da prefeitura da NFS-e e preenche o nome da cidade. Agora sua saída em lote tem uma coluna de município classificável — tornando os totais de ISS por cidade e a declaração fiscal por município uma questão de tabela dinâmica, em vez de um exercício manual de referência cruzada.

Esses três tipos de coluna — extração direta, calculada e inferida — operam juntos em uma única execução em lote. Você não extrai primeiro e valida depois. A validação ocorre durante a extração, e os resultados vão parar na mesma planilha.

Passo a Passo: De Pilha de NFS-e de Várias Cidades para uma Planilha

Veja o fluxo de trabalho prático para processar em lote documentos NFS-e de vários municípios brasileiros em um único arquivo Excel. Você configura isso uma vez por lote — as mesmas definições de colunas processam cada documento, independentemente da cidade de origem.

Conciliação de ISS entre Municípios: a Visão Exclusiva do Lote

O resultado mais valioso do processamento em lote de NFS-e não é o tempo economizado — embora passar de 3 minutos por documento para 5 a 10 segundos por página seja uma melhoria de 18 vezes. O resultado mais valioso é a visão de conciliação que só existe quando todos os documentos estão em uma única tabela.

Veja o que essa visão permite fazer que o processamento de documento único não permite:

Totais de ISS por Município

Agrupe a saída por município e some o valor do ISS. O resultado é o total de ISS aplicado às suas compras de serviços em cada cidade — um dado relevante por dois motivos. Primeiro, ele indica se o ISS total de todos os prestadores em uma determinada cidade está alinhado com a sua alocação interna de custos para essa jurisdição. Segundo, se você for o responsável pela retenção do ISS em alguma dessas notas, o total por município é o número que precisa ser conciliado com os seus registros de recolhimento municipal. O guia tributário global da Dentons observa que "conflitos entre diferentes municípios, onde ambos reivindicam o ISS, são bastante comuns" — uma visão em lote é a sua trilha de auditoria caso um segundo município venha a questionar.

Acompanhamento de ISS Retido na Fonte

Quando uma NFS-e traz o indicador "ISS Retido na Fonte = Sim", a sua empresa — e não o prestador de serviços — é responsável por recolher o ISS ao município do prestador. Isso não é uma anotação de cadastro; é uma ação de conformidade tributária com prazo e sistema de pagamento que varia por cidade. Em uma saída em lote, a ordenação pela coluna de ISS Retido fornece uma lista completa e unificada de todas as notas que exigem a sua ação. Sem precisar buscar em 30 PDFs individuais para encontrar as três que possuem o indicador.

O arcabouço legal em torno da retenção do ISS já foi testado na mais alta corte do Brasil. Em 2020, o Supremo Tribunal Federal (STF) decidiu no RE 1167509 que os municípios não podem impor obrigações de retenção do ISS aos tomadores de serviços quando o prestador não está registrado naquele município — derrubando a exigência de cadastro no CPOM (Cadastro de Prestadores de Outros Municípios) de São Paulo. Mas as obrigações de retenção estabelecidas por lei federal, em que a combinação de tipo de serviço e município gera retenção legítima, permanecem em vigor. Saber quais notas possuem uma obrigação de retenção válida exige a visão do lote.

Detecção de Variação da Alíquota do ISS

A LC 116/2003 estabelece alíquotas de ISS entre 2% e 5% por município e tipo de serviço. Mas os municípios competem por alíquotas para atrair empresas — a revisão diagnóstica do PNUD sobre o sistema tributário brasileiro observa "uma guerra predatória de incentivos fiscais de ICMS e ISS". Um prestador pode aplicar uma alíquota de 2% para um código de serviço que São Paulo tributa a 5% porque o prestador está registrado em um município que reduziu sua alíquota para atrair empresas. Se essa alíquota é válida é uma determinação fiscal que a equipe contábil faz. Mas identificá-la exige enxergar o lote. Um único documento a 2% parece normal. Dez documentos a 5% e um a 2%, todos para o mesmo código de serviço — isso é uma variação que vale investigar.

O que o Padrão Nacional da NFS-e Significa para o Processamento em Lote

O SNNFS-e (Sistema Nacional da NFS-e) é o esforço do Brasil para unificar os formatos de notas fiscais de serviços entre municípios. Em agosto de 2025, 1.463 municípios haviam aderido — mas a adoção é voluntária, e grandes cidades como São Paulo confirmaram publicamente que manterão seus próprios sistemas. O resultado é um cenário híbrido: alguns prestadores emitem NFS-e sob o padrão nacional de XML, outros sob o sistema próprio da cidade, e não há controle sobre qual será usado.

Do ponto de vista do processamento em lote, esse cenário híbrido reforça o valor da extração independente de layout. Ferramentas baseadas em modelos agora precisam de modelos tanto para os layouts municipais anteriores ao padrão quanto para o padrão SNNFS-e — além de caminhos de atualização quando os municípios migram de um para o outro. A extração semântica lê o que está no documento, independentemente do padrão que o gerou. Uma NFS-e no padrão nacional e uma NFS-e no formato personalizado de São Paulo chegam no mesmo lote, definem as mesmas colunas e produzem a mesma saída. O processo de padronização muda o conteúdo do documento, não a abordagem de extração.

A reforma tributária de 2026 — que substituirá gradualmente o ISS pelo IBS (Imposto sobre Bens e Serviços) até 2033 — adiciona outra camada. Durante a transição, os documentos NFS-e podem conter tanto campos legados de ISS quanto novos campos de IBS/CBS. A abordagem de extração se adapta adicionando novos nomes de colunas — "Valor do IBS", "Valor da CBS" — ao lado das colunas existentes de ISS. Nenhum redesenho de modelo é necessário.

Se a organização também processa notas fiscais de mercadorias brasileiras, o fluxo de extração de XML NF-e é abordado no guia de extração NF-e. Os dois tipos de documento podem coexistir no mesmo lote quando as definições de colunas são amplas o suficiente, embora campos específicos de NFS-e, como o código LC 116, fiquem em branco para documentos NF-e — o que é esperado e não causa erros.

Perguntas Frequentes: Processamento em Lote de NFS-e

Posso processar em lote documentos NFS-e de prestadores de diferentes cidades juntos?

Sim — e este é o principal caso de uso. A extração semântica lê cada documento de forma independente, entendendo o conteúdo, e não combinando com o layout de uma cidade específica. Uma NFS-e de São Paulo (ISS 5%), uma de Belo Horizonte (ISS 3%) e uma de Curitiba (ISS 4%) no mesmo lote são processadas com as mesmas definições de colunas. A IA localiza o CNPJ do Prestador, a base de cálculo do ISS e os demais campos em cada documento, independentemente de onde aparecem na página.

Como o ISS Retido na Fonte é tratado na saída do lote?

O campo "ISS Retido" é extraído como uma coluna dedicada — normalmente contendo "Sim" ou "Não". Na planilha de saída do lote, classificar por esta coluna fornece uma lista completa de todas as notas fiscais onde sua empresa é a fonte retentora. A partir daí, você calcula o valor a recolher (a alíquota de ISS × base de cada nota sinalizada) e direciona cada uma para o sistema de pagamento da prefeitura correta. A ferramenta de extração fornece os dados. O recolhimento do imposto em si permanece uma etapa de conformidade separada que sua equipe contábil realiza através do portal de pagamento de cada município.

E se um prestador emitir uma NFS-e com erros de layout ou campos ausentes?

O motor de extração lê o que está no documento. Se um campo obrigatório — o CNPJ, por exemplo — estiver ausente ou ilegível, essa célula na saída ficará em branco. Isso é útil: uma célula em branco na saída do lote identifica imediatamente qual documento precisa de acompanhamento com o prestador, enquanto a digitação manual de 30 documentos pode fazer você perder um campo em branco entre os demais. A visualização em lote torna as omissões visíveis.

Posso misturar documentos NFS-e com faturas de serviços internacionais no mesmo lote?

Sim. Se suas definições de colunas abrangerem ambos os tipos de documento — como "Número da Nota Fiscal", "Nome do Fornecedor", "Valor Total", "Valor do Imposto" — faturas internacionais e documentos NFS-e podem coexistir no mesmo lote. Colunas específicas de NFS-e, como "Código de Serviço LC 116" ou "Alíquota de ISS", ficarão em branco para documentos não brasileiros, e colunas específicas de documentos internacionais, como "Número de IVA", ficarão em branco para documentos NFS-e. Ambos os comportamentos são esperados e não causam erros.

O mecanismo de extração lida com os campos da reforma tributária de 2026 (IBS/CBS) em documentos NFS-e?

Sim — quando um município atualiza o layout da NFS-e para incluir campos de IBS ou CBS, basta adicionar os nomes das colunas correspondentes (por exemplo, "Valor do IBS", "Valor da CBS") à definição do lote. O mecanismo de extração localiza esses novos campos compreendendo o conteúdo do documento, da mesma forma que localiza os campos existentes de ISS e CNPJ. Não é necessária reconfiguração de modelo. Durante o período de transição até 2033, é possível executar lotes contendo documentos NFS-e com campos de ISS e IBS — defina colunas para ambos, e a saída preencherá os campos presentes em cada documento.

Como o processamento em lote se compara à integração direta com a API de cada município?

A integração com APIs municipais exige criar e manter uma conexão separada para cada cidade onde os prestadores operam — cada uma com seu próprio método de autenticação, esquema e cronograma de atualização. O padrão nacional SNNFS-e simplifica isso para os municípios participantes, mas grandes cidades como São Paulo optaram por não aderir. A extração semântica em lote processa os documentos já recebidos — PDFs, XMLs, impressões de DANFSE — sem exigir acesso por API a qualquer sistema municipal. Não é uma alternativa à integração por API para a emissão de NFS-e de saída. É a solução do lado do recebimento, para quando se é o tomador do serviço, não o emissor.

Para uma visão mais ampla da extração de documentos em lote além da NFS-e, veja como funciona a extração de notas fiscais em lote para Excel em diferentes tipos de documentos e moedas.

Da Digitação por Município à Conciliação por Lote

A NFS-e foi criada para tornar a arrecadação de impostos eficiente para o governo — e cumpre esse papel. Cada nota fiscal de serviço recebida foi validada por uma autoridade tributária municipal antes de chegar à caixa de entrada. O CNPJ foi verificado. A alíquota do ISS foi conferida em relação ao código de serviço. O número da nota foi atribuído. Esses dados existem. São precisos. Passaram por uma etapa de validação governamental que a maioria das notas internacionais nunca vê.

A ineficiência está inteiramente no lado do recebimento: redigitar campos validados de documentos que variam por cidade em uma planilha que precisa estar correta para a conciliação no SPED. A extração semântica em lote elimina essa lacuna não ao tornar a digitação mais rápida, mas ao removê-la — e, ao fazê-lo, proporciona a visão entre municípios que a entrada manual jamais poderia produzir.

Na próxima vez que receber uma pilha de NFS-e de prestadores de São Paulo, Rio, Belo Horizonte e outras cidades, tente processá-las como um único lote. Defina as colunas uma vez. Deixe a extração rodar. Depois, classifique por município e confira os totais do ISS. Veja se a visão do lote revela algo que os documentos individuais não mostravam.