NFS-e de Múltiplas 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 avulsa, conhece o mecanismo central: a extração semântica lê uma NFS-e entendendo 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 o município 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. Quando você coloca 30 documentos de 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 mais seis cidades em uma única fila de processamento, três coisas acontecem que nunca acontecem com um único documento:

Primeiro, a verificação da alíquota de ISS entre cidades se torna necessária. Uma NFS-e isolada com ISS de 3% parece normal. Mas quando você vê 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 maneira de perceber isso.

Segundo, o acompanhamento do ISS Retido na Fonte se torna 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 relevante, cada uma com sua própria data de vencimento e sistema de pagamento. Em 10 documentos de várias cidades, rastrear quais notas fiscais acionam essa obrigação e quais não, não é gerenciável como uma lista de verificação manual.

Terceiro, os próprios dados são mais valiosos em conjunto. Totais de ISS por prestador, gastos com serviços por cidade, a proporção de imposto retido versus imposto pago pelo prestador — nada disso é visível a partir de um documento por vez. Eles só emergem quando todo o lote está em uma única planilha.

Não se trata de fazer o fluxo de trabalho de documento único mais rápido. Trata-se de fazer algo que o fluxo de trabalho de documento único não pode fazer de forma alguma.

O Que Torna o Processamento de NFS-e Intermunicipal Fundamentalmente Diferente do Lote de Notas Fiscais Padrão

O processamento padrão de lotes de notas fiscais — 50 PDFs de 50 fornecedores nos EUA ou Europa — é principalmente um problema de volume. As notas têm aparências diferentes, mas a lógica tributária subjacente é consistente: IVA à taxa 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 template — a abordagem usada pela maioria das ferramentas de extração de documentos — se torna estruturalmente inviável. Um template 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. Quebra para o próximo. Manter uma biblioteca de templates para cada cidade onde seus fornecedores operam não é prático quando o número de cidades possíveis é 5.570 e o número de cidades atualizando 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 busca significado, não correspondência de 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 — veja o guia de extração de NFS-e única. 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 represente 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 consegue:

Totais de ISS por Município

Agrupe a saída por município e some o valor do ISS. O resultado é o ISS total aplicado às suas compras de serviços em cada cidade — dados importantes por dois motivos. Primeiro, indica se o ISS total de todos os prestadores em uma determinada cidade está alinhado com sua alocação interna de custos para aquela jurisdição. Segundo, se você é o responsável pela retenção do ISS em alguma dessas notas, o total por município é o número necessário para conciliar com 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 nível de lote é sua trilha de auditoria caso um segundo município venha cobrar.

Rastreamento de ISS Retido na Fonte

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

O arcabouço legal sobre a retenção de ISS foi testado no mais alto tribunal 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 de ISS aos tomadores de serviço quando o prestador não está registrado naquele município — derrubando a exigência de registro no Cadastro de Prestadores de Outros Municípios (CPOM) de São Paulo. Mas as obrigações de retenção estabelecidas por lei federal, onde a combinação de tipo de serviço e município gera retenção legítima, permanecem em vigor. Saber quais notas fiscais possuem uma obrigação de retenção válida exige visualizar o lote.

Detecção de Variação de Alíquota de 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 em alíquotas para atrair negócios — 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 negócios. Se essa alíquota é válida é uma determinação fiscal que sua equipe contábil faz. Mas identificá-la exige visualizar 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 a pena investigar.

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

O Sistema Nacional da NFS-e (SNNFS-e) é o esforço do Brasil para unificar os formatos de notas fiscais de serviços entre os municípios. Em agosto de 2025, 1.463 municípios haviam aderido — mas a adesã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 de seus fornecedores emitem NFS-e no padrão XML nacional, outros no sistema da própria cidade, e você não controla isso.

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 templates 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 migrarem de um para o outro. A extração semântica lê o que está no documento, independentemente de qual padrão o produziu. Uma NFS-e do 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 altera 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 do CBS" — junto com as colunas existentes de ISS. Nenhum redesenho de template é necessário.

Se sua organização também processa notas fiscais de mercadorias brasileiras, o fluxo de extração XML da NF-e é abordado no guia de extração de NF-e. Os dois tipos de documento podem coexistir no mesmo lote quando suas definições de colunas são amplas o suficiente, embora campos específicos da 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 seu layout de NFS-e para incluir campos de IBS ou CBS, você adiciona os nomes das colunas correspondentes (ex.: "Valor IBS", "Valor CBS") à sua definição de lote. O mecanismo de extração localiza esses novos campos entendendo o conteúdo do documento, da mesma forma que localiza campos existentes de ISS e CNPJ. Não é necessário reconfigurar modelos. Durante o período de transição até 2033, você pode 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 construir e manter uma conexão separada para cada cidade onde seus fornecedores atuam — 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 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 que você já recebe — PDFs, XMLs, impressões de DANFSE — sem exigir acesso à API de qualquer sistema municipal. Não é uma alternativa à integração de API para emissão de NFS-e. É a solução do lado do recebimento para quando você é o tomador do serviço, não o emissor.

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

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

A NFS-e foi projetada para tornar a arrecadação de impostos eficiente para o governo — e ela cumpre esse papel. Cada nota fiscal de serviço que você recebe foi validada por uma autoridade fiscal municipal antes de chegar à sua caixa de entrada. O CNPJ foi verificado. A alíquota de 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 validação governamental que a maioria das notas fiscais 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 reconciliação do SPED. A extração semântica em lote elimina essa lacuna não tornando a digitação mais rápida, mas eliminando-a — e, ao fazê-lo, oferece a visão entre municípios que o lançamento manual jamais poderia produzir.

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