Como extrair dados de NFS-e para suas
operações no Brasil (guia 2026)

Por que uma Nota Fiscal de Serviços Brasileira é Diferente de Qualquer Outra Nota que Você Processa

Se você já trabalhou com documentos fiscais brasileiros antes, provavelmente conhece a NF-e — a nota fiscal eletrônica de mercadorias que toda equipe de contas a pagar no Brasil ou que lida com fornecedores brasileiros precisa processar. A NF-e é regulamentada em nível estadual pela SEFAZ (Secretaria da Fazenda Estadual), segue um único esquema XML nacional (layout versão 4.0) e contém ICMS — um imposto estadual sobre a circulação de mercadorias. É complexa, mas é um sistema.

A nota fiscal de serviços (Nota Fiscal de Serviços / NFS-e) é regulamentada em nível municipal. O imposto que ela contém é o ISS — Imposto Sobre Serviços — e a alíquota, o layout, o fluxo de validação e até os requisitos de certificado digital podem variar de uma cidade para outra. São Paulo tem seu próprio web service de NFS-e. Rio de Janeiro tem um diferente. Belo Horizonte tem um terceiro. E outros 5.567 municípios têm os seus.

Isso não é um caso isolado. É a realidade estrutural do federalismo fiscal brasileiro, consagrada na Lei Complementar 116/2003, que concede a cada município a autoridade de definir sua própria alíquota de ISS (2%–5%) e administrar sua própria arrecadação do imposto sobre serviços. O governo federal vem trabalhando para unificar isso por meio do Sistema Nacional de NFS-e (SNNFS-e), com mais de 1.280 municípios aderidos até o início de 2026. Mas a adesão é voluntária, e muitas grandes cidades ainda operam seus próprios sistemas.

Para a equipe que recebe esses documentos — o analista de contas a pagar que abre um PDF de uma agência de marketing brasileira ou de um consultor de TI — a consequência prática é esta: nenhum documento NFS-e é igual ao outro. Uma nota fiscal de serviços emitida em São Paulo coloca a base de cálculo do ISS em uma posição diferente daquela emitida em Porto Alegre. O CNPJ do prestador pode estar no cabeçalho em um documento e em uma barra lateral em outro. Um modelo que funciona para São Paulo vai falhar para Campinas.

É por isso que o OCR baseado em modelo — a abordagem que a maioria das ferramentas de extração de documentos usa — falha sistematicamente nas NFS-e. Modelos correspondem a coordenadas. Os municípios mudam as coordenadas. Para uma análise mais detalhada de como o outro principal tipo de nota eletrônica do Brasil funciona, veja nosso guia de extração de XML de NF-e, que cobre a nota fiscal estadual de mercadorias.

O que uma Nota Fiscal de Serviços (NFS-e) Realmente Contém

Antes de extrair dados de uma nota fiscal de serviços (NFS-e), você precisa saber o que ela contém — e, crucialmente, o que cada campo significa para sua contabilidade. Uma NFS-e não é apenas uma fatura. É um documento fiscal com campos obrigatórios por lei, cujos valores determinam suas obrigações tributárias, a correspondência com seu cadastro de fornecedores e sua trilha de auditoria.

Aqui estão os principais campos de uma NFS-e típica e por que cada um é importante para o recebimento:

A lista de códigos de serviço da LC 116 contém 40 categorias principais, cada uma com subitens que abrangem desde serviços de TI (categoria 1) até serviços jurídicos (item 17.14), engenharia (categoria 7) e saúde (categoria 4). A lista completa está disponível publicamente no anexo da Lei Complementar 116/2003. Toda NFS-e que você recebe traz um desses códigos, e esse código determina diretamente a alíquota de ISS que seu prestador deveria ter aplicado.

Nenhum desses campos é opcional. A prefeitura que valida a NFS-e verifica cada um deles antes de autorizar o documento. Isso significa que os dados necessários para um processamento preciso de AP já existem — foram verificados por uma autoridade fiscal governamental antes de a nota chegar à sua caixa de entrada. A questão é se você consegue extraí-los do documento e colocá-los na sua planilha sem redigitar.

O Que a Digitação Manual de NFS-e Custa para Sua Equipe Financeira

A suposição padrão é que inserir dados de notas fiscais manualmente é lento. E é — um documento médio de uma página leva cerca de 3 minutos para ser digitado em uma planilha. Mas, com NFS-e especificamente, a lentidão não é o problema mais caro. O problema mais caro é a propagação de erros pelos seus registros fiscais.

Um CNPJ digitado errado — um dígito incorreto em uma sequência de 14 — faz sua conciliação com o cadastro de fornecedores falhar, e você não consegue creditar o ISS se sua empresa for a responsável pela retenção. Uma alíquota de ISS errada copiada para o seu ERP (2% inserido como 5%) desalinha sua provisão tributária por todo o período de apuração, podendo ser sinalizada em uma auditoria municipal. Uma flag "ISS Retido na Fonte = Sim" perdida significa que você deixa de recolher o ISS que você — não o prestador — é legalmente responsável por pagar à prefeitura.

Esses não são riscos hipotéticos. As autoridades fiscais brasileiras fazem cruzamento eletrônico entre emissores e tomadores de NFS-e. Se seu prestador informou ter recebido R$50.000 do seu CNPJ e seus registros no SPED mostram R$48.000 porque duas notas foram digitadas errado, a divergência gera uma notificação automática — e depois uma intimação formal.

Multiplique isso mesmo em um volume modesto. Uma empresa de médio porte com 10 prestadores de serviços brasileiros — uma consultoria de TI, uma agência de marketing, um escritório de advocacia, um escritório de contabilidade, uma empresa de gestão de instalações e alguns freelancers — pode receber de 30 a 50 documentos NFS-e por mês. A 3 minutos por documento, isso dá cerca de 2,5 horas de digitação manual. Mas o custo real não são as 2,5 horas. É o ciclo de correção: a planilha de conciliação que não fecha, a ligação para o prestador pedindo uma segunda via, a declaração fiscal retificada, a taxa contábil para resolver a divergência.

É aqui que a expressão "extração de documentos" se torna concreta. Não se trata de economizar tempo de digitação. Trata-se de eliminar a lacuna entre o que a prefeitura validou e o que seu ERP recebeu.

Como a Extração por IA Lida com a Variação Municipal — Sem Modelos por Cidade

O principal desafio técnico na extração de NFS-e não é que os documentos sejam difíceis de ler. Uma nota fiscal de serviços de qualquer cidade brasileira é um documento claramente impresso e, na maioria dos casos, gerado por máquina. O desafio é que o mesmo campo aparece em posições diferentes, com rótulos diferentes, em documentos de cidades diferentes.

O OCR tradicional baseado em modelos resolve isso definindo uma zona retangular para cada campo: "o CNPJ do Prestador está nas coordenadas (x=150, y=320, w=200, h=30)." Isso funciona perfeitamente — para um município. Quebra no próximo. Manter uma biblioteca de modelos para 5.570 cidades não é prático. Mesmo manter uma para as 20 cidades onde seus prestadores estão significa 20 modelos que quebram quando a prefeitura lança uma atualização de layout (o que São Paulo fez recentemente, em agosto de 2025, com a versão 3.2 do seu manual de NFS-e).

A alternativa é a extração semântica: em vez de procurar um campo pela posição, você o procura pelo significado. Você diz ao mecanismo de extração "preciso do CNPJ do prestador de serviços", e o mecanismo lê o documento, entende que um número de 14 dígitos rotulado como "CNPJ" ao lado de "Prestador" é o CNPJ do prestador — independentemente de onde ele esteja na página.

Isso é fundamentalmente diferente do OCR. O OCR converte pixels em caracteres. A extração semântica — alimentada por modelos de visão e linguagem — lê um documento mais como uma pessoa lê: entendendo rótulos, contexto e estrutura do documento. Quando o layout de São Paulo coloca "Prestador de Serviços" no canto superior esquerdo e Porto Alegre o coloca em um cabeçalho centralizado, um mecanismo semântico não se importa. Ele não procura uma posição. Ele procura um significado.

A abordagem de extração usa Extração de Colunas Personalizadas: você digita os nomes dos campos que deseja na sua saída — "CNPJ do Prestador", "Código de Serviço (LC 116)", "Valor do ISS", "Número da NFS-e" — e a IA localiza cada valor no documento entendendo o que o rótulo significa, não onde ele está. Esses nomes de coluna se tornam os cabeçalhos da sua planilha final do Excel, então a saída está pronta para ser carregada no seu ERP ou sistema contábil sem reformatação.

Passo a Passo: Extraia Dados de NFS-e para Excel

Aqui está o fluxo de trabalho prático para extrair dados dos seus documentos NFS-e recebidos para uma planilha estruturada. O processo funciona tanto se você tiver o PDF/DANFSE (o documento auxiliar impresso de serviços) quanto o arquivo XML subjacente.

Como lidar com retenção de ISS, múltiplos códigos de serviço e cenários em lote

A maioria das extrações de NFS-e é simples — um único prestador, um único serviço, campos padrão. Mas fluxos de trabalho financeiros reais encontram casos extremos que importam. Aqui estão três que atrapalham processos manuais:

ISS Retido na Fonte

Quando uma NFS-e está marcada como "ISS Retido na Fonte = Sim", a obrigação de recolher o ISS ao município passa do prestador de serviços para o tomador — ou seja, para você. Isso não é uma anotação de entrada de dados. É uma ação de conformidade fiscal. Sua equipe financeira deve: (1) identificar essas notas na saída da extração, (2) calcular o valor do ISS a recolher (a alíquota × base exibida na nota) e (3) emitir o pagamento para a prefeitura do município correto dentro do prazo.

Perder essa etapa significa que o ISS nunca foi pago a ninguém — o prestador não pagou (porque declarou como retido) e você não pagou (porque perdeu o sinalizador). Ambas as partes ficam expostas. Um fluxo de extração que sinaliza esses documentos automaticamente — extraindo o campo "ISS Retido" como uma coluna sim/não — transforma um risco de conformidade em uma coluna de planilha classificável.

Múltiplos Códigos de Serviço em uma Única Nota Fiscal

Uma única NFS-e pode conter vários itens, cada um com seu próprio código de serviço da LC 116 e sua própria alíquota de ISS. Uma consultoria de TI pode cobrar separadamente por "Análise e desenvolvimento de sistemas" (código 1.01, ISS 5% em São Paulo) e "Suporte técnico" (código 1.07, potencialmente com alíquota diferente). Se você extrair apenas o total de ISS da nota, perde a classificação por item que determina se cada linha foi tributada corretamente. Defina suas colunas para extrair códigos de serviço e valores de ISS por item, não apenas o total do documento.

Processamento em Lote para Múltiplos Prestadores de Serviço

Quando você recebe documentos NFS-e de cinco prestadores diferentes em cinco cidades diferentes, a vantagem do processamento em lote se multiplica. Em vez de abrir cada PDF individualmente e copiar campos para linhas separadas de uma planilha, você envia todos juntos. O mecanismo de extração processa tudo em paralelo — uma única página leva de 5 a 10 segundos — e produz uma planilha consolidada com os dados de todos os prestadores nas mesmas colunas. Essa é a resposta prática para o problema da fragmentação municipal: a IA lida automaticamente com as diferenças de layout de cada documento, e sua equipe lida com um único arquivo de saída. Para a análise estrutural de por que essa fragmentação existe e o que ela custa, veja por que o processamento de NFS-e no Brasil é mais caro do que a maioria das equipes financeiras imagina.

Para cenários de volume — 50, 100 ou mais documentos NFS-e por mês — extração de notas fiscais em lote para Excel elimina a configuração por documento que faz o processamento manual crescer linearmente com a quantidade de documentos.

A Reforma Tributária de 2026: O Que Muda na Extração de NFS-e

O Brasil está no meio de uma reforma tributária que vai eventualmente substituir o ISS e o ICMS por um IBS unificado (Imposto sobre Bens e Serviços) e substituir o PIS/COFINS pela CBS (Contribuição sobre Bens e Serviços). A transição é gradual — até 2033 — mas os layouts de NFS-e já estão sendo atualizados. São Paulo publicou a versão 3.2 do seu manual de NFS-e em agosto de 2025, introduzindo campos para a nova estrutura tributária. Outros municípios seguirão o mesmo caminho.

Do ponto de vista da extração de dados, isso significa duas coisas. Primeiro, os campos que você extrai hoje (base de cálculo do ISS, alíquota do ISS, valor do ISS) serão eventualmente complementados ou substituídos por campos de IBS/CBS em futuros documentos NFS-e. Segundo, durante o período de transição, você pode receber notas que trazem tanto os campos legados de ISS quanto os novos campos de IBS — e você precisará extrair ambos para conciliação.

A abordagem de extração descrita acima lida com isso naturalmente. Como ela não depende de posições fixas de campos ou modelos codificados, novos campos em um layout atualizado de NFS-e são extraídos da mesma forma que os existentes: você adiciona o nome da coluna (por exemplo, "Valor do IBS"), e a IA o localiza no documento. Nenhuma reconfiguração de modelo é necessária.

Para um guia prático de extração de dados fiscais de notas fiscais de mercadorias brasileiras — que contêm ICMS, IPI, PIS e COFINS e são regidas por um arcabouço regulatório diferente — veja nosso guia de extração de XML de NF-e. Se você também processa documentos de folha de pagamento brasileiros, nosso guia de extração de holerite cobre esse fluxo de trabalho.

Perguntas Frequentes: Extração de Notas Fiscais de Serviço Eletrônicas (NFS-e)

Consigo extrair dados de um PDF de NFS-e se não tiver o XML?

Sim. O PDF/DANFSE contém todos os campos fiscais obrigatórios exigidos pela prefeitura para validação. Diferentemente do DANFE da NF-e — que omite cerca de 90% dos dados do XML subjacente — o documento impresso da NFS-e é mais completo, pois os municípios não compartilham um padrão único para o que vai no XML versus o que aparece no documento auxiliar impresso. O conjunto completo de campos listados na tabela de anatomia acima (CNPJ prestador/tomador, código LC 116, detalhamento do ISS, número da NFS-e, número do RPS) geralmente está presente no PDF. No entanto, se você tiver acesso ao XML, use-o — ele garante 100% de cobertura dos campos e elimina a variação de precisão relacionada ao OCR.

A extração funciona com documentos NFS-e de qualquer cidade brasileira?

A extração semântica lê os campos entendendo o conteúdo do documento, não combinando com o layout de uma cidade específica. Funciona em NFS-e de São Paulo, Rio de Janeiro, Belo Horizonte, Porto Alegre ou qualquer outro município sem exigir um modelo por cidade. No entanto, a precisão da extração em documentos NFS-e manuscritos — que são raros (quase todas as NFS-e são geradas por máquina) — será menor do que em documentos impressos ou digitais. O reconhecimento de manuscrito funciona, mas é inerentemente menos preciso do que a leitura de texto impresso.

E o ISS retido na fonte — como lidar com a obrigação de recolhimento do imposto?

Extraia o campo "ISS Retido na Fonte" como uma coluna dedicada. Qualquer nota fiscal em que este campo seja igual a "Sim" deve ser encaminhada para seu fluxo de conformidade fiscal, e não lançada como uma entrada de AP padrão. A alíquota do ISS e a base de cálculo do ISS na nota informam o valor a ser recolhido; o município do prestador informa onde recolher. A ferramenta de extração fornece os dados. O recolhimento do imposto em si é uma etapa de conformidade separada que sua equipe contábil ou fiscal deve executar através do sistema de pagamento da prefeitura relevante.

Posso processar documentos NFS-e em lote junto com faturas internacionais comuns?

Sim. Se suas definições de colunas forem amplas o suficiente para cobrir os dois tipos de documento (por exemplo, "Número da Fatura", "Nome do Fornecedor", "Valor Total"), você pode incluir documentos NFS-e brasileiros no mesmo lote que faturas internacionais. O mecanismo de extração lê cada documento de forma independente e preenche os campos que encontrar. No entanto, para campos específicos de NFS-e — como o código de serviço da LC 116 ou o valor do ISS — essas colunas ficarão vazias para faturas não brasileiras, o que é esperado e não causa erros.

Como a reforma tributária de 2026 afeta a extração de campos da NFS-e?

A reforma não muda como a extração funciona — ela muda quais campos aparecem nos futuros documentos NFS-e. À medida que as prefeituras atualizam seus layouts para incluir campos de IBS e CBS junto ou no lugar do ISS, você precisará atualizar suas definições de colunas para incluir os novos nomes de campos. A abordagem de extração continua a mesma: adicione o novo nome de coluna, e a IA localiza o valor correspondente. A transição gradual até 2033 significa que você provavelmente processará documentos com campos de impostos antigos e novos durante o período de sobreposição.

Preciso de um CNPJ brasileiro para usar essa abordagem de extração?

Não. A extração de dados de uma NFS-e recebida é uma tarefa de processamento de documentos, não uma ação de declaração de impostos. Você não precisa de um CNPJ para extrair dados de um PDF ou XML de NFS-e para uma planilha. Os campos de CNPJ no documento identificam o prestador e o tomador do serviço; a ferramenta de extração os lê como pontos de dados e os coloca nas suas colunas de saída — ela não interage com nenhum sistema tributário municipal.

Da Digitação por Documento ao Processamento em Lote

A NFS-e foi criada para tornar a arrecadação de impostos eficiente para o governo — e ela cumpre esse papel. Toda fatura de serviço emitida no Brasil é validada por uma autoridade tributária municipal antes de chegar até você, o que significa que os dados já foram verificados quanto à consistência. A ineficiência está totalmente no lado do recebimento: o assistente de contas a pagar redigitando campos que uma máquina já verificou, de um documento que varia por cidade, para uma planilha que precisa estar correta para a conciliação fiscal.

A extração semântica muda o lado do recebimento dessa equação. Os campos já estão lá, já validados, já legíveis por máquina (ou quase). Colocá-los na sua planilha em um único lote é uma decisão de fluxo de trabalho, não um avanço técnico. Teste no seu próximo lote de documentos NFS-e — veja se o tempo por documento cai do benchmark manual de 3 minutos para os segundos que leva para definir suas colunas uma vez e deixar a extração rodar.