Como Extrair Dados de NFS-e para Suas
Operações no Brasil (Guia 2026)

Por que a Nota Fiscal de Serviços Brasileira é Diferente de Todas as Outras Faturas 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 todo time de contas a pagar no Brasil ou que lida com fornecedores brasileiros precisa gerenciar. A NF-e é regulada em nível estadual pela SEFAZ (Secretaria da Fazenda Estadual), segue um único esquema XML nacional (versão 4.0 do leiaute) e inclui o ICMS — um imposto estadual sobre circulação de mercadorias. É complexa, mas é um sistema.

Já a nota fiscal de serviços (NFS-e) é regulada em nível municipal. O imposto que ela carrega é o ISS — Imposto Sobre Serviços — e a alíquota, o leiaute, 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 webservice de NFS-e. O Rio de Janeiro tem outro. 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 para 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 o time que recebe esses documentos — o auxiliar de contas a pagar abrindo um PDF de uma agência de marketing brasileira ou de um consultor de TI — a consequência prática é esta: nenhuma NFS-e tem a mesma aparência. 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 de um documento e em uma barra lateral de outro. Um modelo que funciona para São Paulo vai falhar para Campinas.

É por isso que o OCR baseado em modelos — a abordagem que a maioria das ferramentas de extração de documentos usa — falha sistematicamente na NFS-e. Modelos combinam coordenadas. Os municípios mudam as coordenadas. Para um olhar mais detalhado sobre como funciona o outro tipo principal de nota fiscal eletrônica brasileira, veja nosso guia de extração de XML de NF-e, que cobre a nota fiscal de mercadorias em nível estadual.

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. Cada NFS-e que você recebe contém 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. O município que valida a NFS-e verifica cada um deles antes de autorizar o documento. Isso significa que os dados necessários para o processamento preciso de contas a pagar já existem — foram verificados por uma autoridade fiscal governamental antes de a fatura chegar à sua caixa de entrada. A questão é se você consegue extraí-los do documento e colocá-los na sua planilha sem redigitá-los.

Quanto Custa à Sua Equipe Financeira a Digitação Manual de NFS-e

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

Um CNPJ digitado errado — um dígito incorreto em uma sequência de 14 — faz com que a conciliação do cadastro de fornecedores falhe, e você não consiga 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%) desvia o provisionamento de impostos para todo o período de apuração, podendo ser sinalizada em uma auditoria municipal. Um flag "ISS Retido na Fonte = Sim" perdido significa que você deixa de recolher o ISS que você — e não o prestador — é legalmente responsável por pagar à prefeitura.

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

Multiplique isso por um volume, mesmo que modesto. Uma empresa de médio porte com 10 prestadores de serviço brasileiros — uma consultoria de TI, uma agência de marketing, um escritório de advocacia, um contador, uma empresa de administração de condomínios e alguns freelancers — pode receber de 30 a 50 documentos NFS-e por mês. A 3 minutos por documento, são 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 retificação da declaração fiscal, a taxa de contabilidade 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 o município validou e o que seu ERP recebeu.

Como a Extração por IA Lida com Variações Municipais — Sem Modelos por Cidade

O principal desafio técnico da extração de NFS-e não é que os documentos sejam difíceis de ler. Uma nota fiscal de serviços (NFS-e) de qualquer cidade brasileira é um documento impresso de forma clara 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: "CNPJ do Prestador está nas coordenadas (x=150, y=320, w=200, h=30)". Isso funciona perfeitamente — para um município. Quebra para o próximo. Manter uma biblioteca de modelos para 5.570 cidades não é prático. Mesmo manter uma para as 20 cidades onde seus fornecedores 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 por sua posição, você o procura pelo que ele significa. 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 CPF/CNPJ do fornecedor — independentemente de onde ele está na página.

Isso é fundamentalmente diferente do OCR. O OCR converte pixels em caracteres. A extração semântica — alimentada por modelos de linguagem de visão — 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 está procurando uma posição. Ele está procurando um significado.

A abordagem de extração usa a Extração de Colunas Personalizadas: você digita os nomes dos campos desejados na sua saída — "CNPJ do Prestador", "Código do 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 colunas se tornam os cabeçalhos da sua planilha Excel final, então a saída está pronta para ser carregada no seu ERP ou sistema contábil sem reformatação.

Passo a Passo: Extrair Dados da NFS-e para o 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 com o PDF/DANFSE (o documento auxiliar impresso para serviços) quanto com o arquivo XML subjacente.

Lidando 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 prestador, um serviço, campos padrão. Mas fluxos financeiros reais enfrentam casos extremos que importam. Aqui estão três que complicam 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 para o tomador do serviço — ou seja, para si. Isto não é uma nota de entrada de dados. É um item de ação de conformidade fiscal. A sua equipa financeira deve: (1) identificar estas faturas na extração, (2) calcular o valor do ISS a recolher (a taxa × base indicada na fatura) e (3) efetuar o pagamento à prefeitura do município correto dentro do prazo.

Perder este passo significa que o ISS nunca foi pago a ninguém — o prestador não o pagou (porque declarou retido) e você não o pagou (porque perdeu a flag). Ambas as partes ficam expostas. Um fluxo de extração que sinaliza automaticamente estes documentos — extraindo o campo "ISS Retido" como uma coluna sim/não — transforma um risco de conformidade numa coluna de folha de cálculo ordená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 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, possivelmente 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 os códigos de serviço e valores de ISS por item, não apenas o total do documento.

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

Ao receber documentos NFS-e de cinco prestadores diferentes em cinco cidades distintas, 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ê carrega todos juntos. O mecanismo de extração os processa 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. Esta é 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 cenários de alto volume — 50, 100 ou mais documentos NFS-e por mês — a extração em lote de notas fiscais para Excel elimina a configuração por documento que faz o processamento manual escalar 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 eventualmente substituirá ISS e ICMS por um IBS unificado (Imposto sobre Bens e Serviços) e substituirá PIS/COFINS pela CBS (Contribuição sobre Bens e Serviços). A transição é gradual — até 2033 — mas os layouts da NFS-e já estão sendo atualizados. São Paulo publicou a versão 3.2 do seu manual da 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 ISS, alíquota de ISS, valor de 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 fiscais que contenham 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 pré-definidos, 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 (ex.: "Valor do IBS"), e a IA o localiza no documento. Nenhuma reconfiguração de modelo é necessária.

Para um guia prático sobre 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 — consulte 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 ambos os tipos de documento (ex.: "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 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 de NFS-e?

A reforma não altera o funcionamento da extração — ela muda quais campos aparecerão em futuros documentos NFS-e. À medida que os municípios atualizarem seus layouts para incluir campos de IBS e CBS junto com 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 permanece a mesma: adicione o novo nome da 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 para usar esta 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 fiscal. 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 colunas de saída — ela não interage com nenhum sistema tributário municipal.

Da Digitação por Documento ao Processamento por Lote

A NFS-e foi projetada 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 nela já foram verificados quanto à consistência. A ineficiência está inteiramente no lado do recebimento: o auxiliar de contas a pagar redigitando campos que uma máquina já verificou, de um documento que varia por cidade, em uma planilha que precisa estar correta para a reconciliaçã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 em 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 dos 3 minutos do benchmark manual para os segundos necessários para definir suas colunas uma vez e deixar a extração rodar.