Como Extrair Dados de Holerites Espanhóis
Para o Excel

O que torna a nómina espanhola (holerite) estruturalmente diferente para a extração de dados

Uma nómina espanhola não é uma lista de descontos em uma única coluna como um holerite anglo-americano. Segundo o Artigo 29 do Estatuto de los Trabajadores e o modelo oficial definido pela Orden ESS/2098/2014, toda nómina na Espanha segue uma estrutura de quatro blocos obrigatória desde 2015. Qualquer ferramenta de extração que espere uma lista plana de números vai desalinhar os dados entre os quatro blocos.

Os quatro blocos são:

1. Encabezado (cabeçalho). Dados da empresa — CIF/NIF, razón social, domicilio, código de cuenta de cotización (CCC) — mais os dados do trabalhador: NIF, número de afiliación a la Seguridad Social (NAF), categoría profesional, grupo de cotización e antigüedad. Este bloco também especifica o período de liquidação (periodo de liquidación) — o mês e o ano cobertos pela nómina.
2. Devengos (ganhos). Cada euro acumulado pelo trabalhador no período. Começa com percepciones salariales (ganhos salariais): salario base, complementos (antigüedad, idiomas, peligrosidad, nocturnidad), horas extraordinarias (horas extras) e pagas extras prorrateadas (pagamentos extras proporcionais — discutidos abaixo). Também pode incluir percepciones no salariales (compensações não salariais): dietas, kilometraje, indemnizaciones. No fim deste bloco aparece o Total Devengado (total acumulado).
3. Deducciones (descontos). Tudo o que é subtraído do total acumulado. É aqui que a Espanha se diferencia de qualquer outra nómina da UE: o bloco de descontos não mostra uma única linha de imposto. Ele detalha de quatro a cinco contribuições distintas à Seguridad Social (contingencias comunes, desempleo, formación profesional, FOGASA e, desde 2023, MEI), além da retenção de IRPF — Impuesto sobre la Renta de las Personas Físicas, o imposto de renda progressivo espanhol retido na fonte — e quaisquer descontos adicionais como anticipos (adiantamentos) ou embargos (penhoras). Cada desconto tem uma cota do trabalhador (aportación del trabajador). O total de todos os descontos é o Total a Deducir.
4. Bases de cotización e contribuição patronal (painel inferior). Desde 2015, as nóminas espanholas devem exibir a contribuição patronal à Seguridad Social (aportación empresarial) junto com as bases de contribuição usadas no cálculo. Este painel mostra a base de cotización para cada tipo de contingência, a alíquota aplicável (tipo %) e o valor da contribuição patronal. Nenhum outro formato de nómina da UE — nem o bulletin de paie francês, nem o Lohnabrechnung alemão, nem o cedolino italiano — exige que a contribuição patronal apareça na cópia do trabalhador.

A consequência prática para a extração: uma ferramenta genérica que lê o bloco de descontos de cima para baixo e gera uma única coluna "Imposto" vai misturar as contribuições à Seguridad Social com a retenção de IRPF — dois valores que pertencem a lançamentos contábeis diferentes (cuenta 476 Organismo de la Seguridad Social acreedora vs. cuenta 4751 HP acreedora por retenciones). E a contribuição patronal, impressa no rodapé da página, longe dos descontos, passará completamente despercebida.

Os Campos Obrigatórios da Nómina (Holerite Espanhol) — Mapeando Cada Um para as Colunas da Sua Planilha

Toda nómina espanhola deve incluir os campos listados abaixo. Um campo ausente não é um descuido de formatação; é uma infracción laboral segundo a Ley sobre Infracciones y Sanciones en el Orden Social (LISOS), com multas que variam de leve (€60–€625) por não entregar um holerite correto a grave (€626–€6.250) por deturpar os valores reais. As empresas devem guardar as nóminas por pelo menos cinco anos. Aqui está o mapa de colunas de extração:

Trinta e três colunas parecem muitas. Mas os mesmos requisitos legais que tornam a nómina densa também a tornam previsível: todo holerite gerado por a3asesor, Sage NominaPlus, NominaSol, PayFit ou Cegid contém exatamente esses campos. Diferente das faturas espanholas, cujo layout pode variar drasticamente conforme o fornecedor, o layout da nómina segue uma estrutura regulamentada. O desafio não é encontrar os campos — é garantir que as cinco deduções vão para colunas separadas em vez de um único bloco "Imposto", e que o painel de contribuições do empregador na parte inferior não seja ignorado.

Se você também já trabalhou com dados de folha de pagamento de outros países, a estrutura de campos pode parecer familiar, mas sutilmente diferente. Um bulletin de paie francês agrupa as contribuições em cinco blocos de cotisation (Santé, Retraite, Chômage, etc.) com uma parte salariale e uma part patronale. Um Lohnabrechnung alemão separa o Steuer (imposto) do Sozialversicherung (seguro social) com um identificador Steuer-ID. A nómina espanhola é a única entre essas que imprime a contribuição do empregador diretamente na cópia do funcionário.

Detalhamento das Contribuições à Seguridad Social — Por Que Cinco Colunas Separadas Importam

A parte do empregado nas deduções da Seguridad Social em uma nómina espanhola não é um único número. Segundo a Orden PJC/297/2026, os tipos de contribuição de 2026 e suas alíquotas do trabalhador (tipo del trabajador) são:

AT/EP (accidentes de trabajo y enfermedades profesionales — acidentes de trabalho e doenças profissionais) é exclusivo do empregador e varia conforme o CNAE (código de atividade), indo de 0,90% a mais de 7%, dependendo da classificação de risco. Não é uma alíquota fixa, o que significa que a contribuição total do empregador por empregado no Excel não deve ser a mesma em todas as linhas, a menos que todos os empregados trabalhem no mesmo código CNAE.

Cinco colunas de extração separadas — e não uma única coluna "Dedução SS" — importam por dois motivos. Primeiro, o lançamento contábil (asiento contable) da folha de pagamento na Espanha divide a contribuição do empregador em várias subcontas: cuenta 642 (Seguridad Social a cargo de la empresa) para a contribuição total do empregador, enquanto a parte do empregado passa pela cuenta 476 (Organismo de la Seguridad Social acreedora). Se sua extração joga todas as cinco contribuições em uma única célula "SS", a pessoa que faz o lançamento contábil precisa separá-las manualmente — que é exatamente a tarefa que a extração deveria eliminar. Segundo, uma mudança de alíquota em qualquer contribuição individual (como aconteceu em 2023, quando o MEI foi introduzido a 0,10% e aumentou para 0,15% em 2026) fica invisível se todas as cinco estiverem agrupadas. Você precisa de granularidade no nível da coluna para responder à pergunta: "por que a dedução total de janeiro é 18,50 € maior que a de dezembro?"

A aportación empresarial do empregador — o painel na parte inferior da nómina mostrando o que a empresa paga à Seguridad Social por cada empregado — é um alvo de extração separado. Em uma empresa com 50 empregados, somar a coluna de aportación do empregador em todas as nóminas dá o custo trabalhista total mensal (coste laboral total) — o número que entra no demonstrativo de lucros e perdas e na declaração anual de cuentas anuales. Uma coluna negligenciada na parte inferior de cada holerite se traduz em uma linha do P&L que vale dezenas de milhares de euros por ano.

Retenção de IRPF na Folha de Pagamento Espanhola — Extraindo e Verificando a Alíquota Correta

O IRPF (Impuesto sobre la Renta de las Personas Físicas) é o imposto de renda pessoal progressivo da Espanha, retido na fonte de toda nómina. A alíquota de retenção (tipo de retención) não é um percentual fixo. Ela é calculada individualmente para cada funcionário com base na renda anual estimada, situação familiar (número de hijos, estado civil), grau de deficiência e outras circunstâncias pessoais informadas via Modelo 145. As faixas do IRPF de 2026 para rendimentos do trabalho são:

Essas são faixas progressivas, o que significa que um funcionário que ganha 30.000 €/ano não paga 30% sobre o valor total. Os primeiros 12.450 € são tributados a 19%, os próximos 7.750 € a 24%, e o restante a 30%. A alíquota efetiva (tipo efectivo) é sempre menor que a faixa marginal. A alíquota de retenção impressa na nómina — frequentemente exibida como percentual ao lado da linha de dedução do IRPF ou no cabeçalho — é uma alíquota pré-calculada fornecida pela Agencia Tributaria (AEAT, autoridade tributária espanhola), não uma alíquota escolhida pelo empregador.

Por que extrair o IRPF em sua própria coluna, separado das deduções da Seguridad Social? Porque o IRPF não vai para a mesma conta. No lançamento contábil da folha, a retenção de IRPF é creditada na cuenta 4751 (HP acreedora por retenciones practicadas), enquanto as deduções do trabalhador para a Seguridad Social vão para a cuenta 476. Misture-os em uma coluna e o Modelo 111 mensal (declaração de retenção de IRPF) e a RNT (Relación Nominal de Trabajadores, a declaração de contribuição à SS) não vão conciliar com os dados que você extraiu — e a discrepância vai aparecer no pior momento possível: durante uma fiscalização trabalhista (Inspección de Trabajo) ou auditoria fiscal.

Uma verificação rápida: o valor da retenção de IRPF na nómina é calculado aplicando a alíquota percentual à base sujeta a IRPF (base tributável do IRPF), que aparece na parte inferior do holerite, perto do painel de bases de cotización. A base sujeta geralmente é o Total Devengado menos quaisquer valores isentos (como certas dietas dentro dos limites legais). Se sua extração capturar tanto a alíquota do IRPF quanto a base sujeta, uma coluna calculada — Base Sujeta × Rate% − Extracted IRPF Amount — sinaliza qualquer linha em que a diferença exceda ±1 €. Essa fórmula transforma uma planilha de 200 linhas em uma lista de investigação de três linhas.

Como Extrair Dados de Holerites Espanhóis para Excel — Fluxo de Trabalho Passo a Passo

O fluxo de extração é o mesmo, seja você processando uma nómina para um pedido de visto ou 50 para reconciliação de folha de pagamento no fim do mês. A diferença está no design das colunas e nas etapas de verificação.

Passo 1: Envie seus arquivos de nómina. Os formatos suportados incluem PDF, JPG, PNG e capturas de tela da web. Se o seu software de folha de pagamento (a3asesor, Sage NominaPlus, NominaSol, PayFit) exporta nóminas em PDF — como praticamente todos fazem — envie os PDFs diretamente. O envio em lote está disponível: selecione todas as nóminas dos funcionários de um determinado mês e envie-as juntas. O sistema processa até centenas de arquivos em um único lote, mesclando os resultados em uma única pasta de trabalho do Excel.

Passo 2: Defina suas colunas de extração. É aqui que a Extração de Colunas Personalizadas faz o trabalho pesado. Em vez de desenhar retângulos ao redor de cada campo (como as ferramentas baseadas em modelo exigem), você digita os nomes dos campos que deseja — e a IA localiza cada valor entendendo o que ele significa, não onde ele está na página. Para uma nómina espanhola, sua lista de colunas pode ser assim:

Você também pode definir colunas inferidas — colunas que a IA preenche com base no conteúdo do documento, mesmo quando o valor não está explicitamente impresso. Por exemplo, uma coluna chamada "Contract Type (options: Indefinido/Temporal)" fará a IA ler a taxa de desempleo no holerite (1,55% = indefinido, 1,60% = temporário) e gerar o tipo de contrato correto. Isso é útil ao construir um banco de dados mestre de funcionários onde a classificação do contrato precisa ser consistente.

Etapa 3: a IA processa os arquivos. Cada holerite leva de 5 a 10 segundos para ser processado. A IA lê a página inteira — cabeçalho, devengos, deducciones e o painel de bases na parte inferior — e preenche todas as colunas que você definiu. Como a IA entende o documento semanticamente, e não pela posição na grade, ela lida com variações de layout entre diferentes softwares de folha de pagamento (um nómina do a3asesor e um nómina do Sage NominaPlus parecem diferentes, mas contêm o mesmo vocabulário de campos).

Etapa 4: baixe como Excel (XLSX). A saída é uma planilha estruturada em que cada linha é um holerite e cada coluna é um campo extraído. Os formatos de saída compatíveis são Excel (XLSX), CSV e JSON — o XLSX é a escolha padrão para conciliação de folha de pagamento porque preserva formatos de número, formatos de data e permite colunas com fórmulas para verificação.

A Verificação de Conciliação de Uma Linha que Detecta Erros de Extração

A estrutura do nómina oferece uma trilha de auditoria integrada: Total Devengado − Total a Deducir deve ser igual a Líquido a Percibir. Se essas três colunas forem extraídas, uma fórmula do Excel em uma quarta coluna — Total Devengado − Total a Deducir − Líquido a Percibir — deve retornar zero. Qualquer valor acima de ±0,50 € indica um erro de extração ou um holerite com arredondamento que precisa de revisão manual.

Essa verificação não é opcional. Erros em dados de folha de pagamento se acumulam. Uma alíquota de desempleo de 1,55% aplicada à base errada produz uma discrepância que, multiplicada por 12 meses e 50 funcionários, cria uma divergência de seis dígitos entre a declaração RNT (Relación Nominal de Trabajadores) e os registros contábeis da empresa. A diferença entre encontrar isso no momento da extração e encontrá-lo durante uma Inspección de Trabajo é a diferença entre corrigir uma coluna em cinco minutos e sofrer uma sanção com base no LISOS Art. 22.

Você pode incorporar essa verificação diretamente na extração usando colunas calculadas: defina uma coluna chamada "Reconciliation Check (Total Devengado − Total a Deducir − Liquido a Percibir)" e a IA calcula a diferença durante a extração. Qualquer linha com valor diferente de zero é sinalizada antes mesmo de você abrir o arquivo do Excel. Isso não é uma etapa de pós-processamento — está integrado à própria passagem de extração.

Outras três verificações que vale a pena adicionar às suas colunas de extração:

• Verificação da taxa SS. O valor extraído de Contingências Comuns SS do funcionário deve ser aproximadamente 4,70% da Base CC. Uma coluna calculada: Base CC × 4,70% − Cont. Comuns Extraídas. Sinalize linhas fora de ±1 €.
• Consistência do IRPF. Se você extrair tanto a taxa de IRPF (%) quanto o valor da retenção de IRPF (€), verifique: Base Sujeita IRPF × Taxa% − Valor IRPF. A taxa de retenção do IRPF é calculada pela AEAT e pode incluir arredondamento, mas desvios grandes indicam uma divergência de extração.
• Sanidade da contribuição patronal. A CC patronal (23,60% da Base CC) deve corresponder à linha de aportación empresarial dentro da tolerância de arredondamento. Uma divergência nessa linha geralmente significa que a base errada foi lida — a ferramenta pegou a base AT/EP em vez da base CC.

Processamento em Lote de Vários Funcionários — Lidando com Pagas Extras Proporcionais e Deduções Variáveis

Processar uma única nómina é simples. Processar 50 — entre funcionários com diferentes tipos de contrato, diferentes taxas de IRPF e diferentes estruturas de pagas extras — introduz três desafios que não existem na extração de um único arquivo.

Pagas extras proporcionais vs. não proporcionais. Segundo o Artigo 31 do Estatuto de los Trabajadores, todo funcionário espanhol tem direito a duas pagas extras (pagas extraordinarias) por ano, normalmente no verão (junho/julho) e no Natal (dezembro). Cada paga extra é de no mínimo 30 dias de salário base. Muitas empresas optam por proporcionalizar (prorratear) esses pagamentos — dividindo o valor total anual da paga extra por 12 e incluindo um doze avos em cada nómina mensal. Quando as pagas extras são proporcionalizadas, a seção de devengos mostra uma linha chamada "Prorrata Pagas Extras" ou "P.P. Extras". Quando não são proporcionalizadas, as nóminas de junho e dezembro mostram um bloco separado com um Total Devengado muito maior — frequentemente quase o dobro dos outros meses.

Se você executar a extração em lote em uma mistura de funcionários com pagas proporcionais e não proporcionais em junho, as linhas não proporcionais mostrarão valores de Total Devengado que parecem erros. A solução não é excluir essas linhas. É extrair uma coluna chamada "Paga Extra Incluída (opções: Sim/Não)" como uma coluna inferida — a IA lê se a nómina atual contém uma paga extra e a marca. Depois, sua tabela dinâmica do Excel pode filtrar ou separar esses meses para análise anual.

Tipo de contrato e variação da taxa de desempleo. Um contrato por tempo indeterminado (contrato indefinido) aplica uma taxa de desempleo de 1,55% para o funcionário. Um contrato temporário (contrato temporal) aplica 1,60%. Um contrato fixo-descontínuo (fijo-discontinuo) — comum no turismo e na agricultura — também usa a taxa de contrato por tempo indeterminado. Se você estiver processando uma força de trabalho que mistura contratos indefinidos e temporários, e estiver verificando a dedução de desempleo em relação à base, aplicar uma única taxa a todas as linhas gerará falsos alertas em aproximadamente metade delas. Extraia a taxa de desempleo como sua própria coluna, ou use uma coluna inferida para classificar o tipo de contrato a partir da taxa impressa na nómina.

Variação da taxa de IRPF entre funcionários. Não é necessário que dois funcionários de uma empresa espanhola compartilhem a mesma taxa de retenção de IRPF. Um funcionário que ganha 22.000 €/ano com dois filhos pode ter uma taxa de retenção de 12%; um colega que ganha 28.000 €/ano sem dependentes pode ter 19%. Extrair a taxa como sua própria coluna e o valor como outra permite verificar cada linha independentemente, em vez de aplicar uma taxa presumida em todo o lote e se perguntar por que metade das linhas falha.

Para empresas que precisam coletar holerites de funcionários que trabalham remotamente ou em vários locais, configurar um pipeline de coleta de holerites elimina a etapa de ficar correndo atrás de PDFs por e-mail. O funcionário envia sua nómina diretamente; ela cai na sua fila de processamento automaticamente.

Da Extração à Contabilización — Montando o Lançamento Contábil da Folha a Partir dos Seus Dados do Excel

Um lançamento contábil de folha de pagamento (asiento de nómina) na contabilidade espanhola segue uma estrutura padrão codificada no Plan General de Contabilidad (PGC). Os dados extraídos do Excel das suas nóminas mapeiam diretamente para as contas do PGC:

Se a sua extração separa cada contribuição à Seguridad Social em sua própria coluna e separa o IRPF da SS, montar esse lançamento contábil é um SOMASE de cinco células no Excel — não uma reordenação manual de 600 pontos de dados. O total de débito (640 + 642) deve ser igual ao total de crédito (476 + 4751 + 465). Se não for, os dados extraídos contêm uma dedução classificada incorretamente — mais comumente, o IRPF foi acidentalmente agrupado na coluna da SS, ou a contribuição AT/EP do empregador não foi incluída na conta 642.

É também aqui que ter colunas separadas para cada tipo de dedução prova seu valor. Uma única coluna "Total de Deduções" pode equilibrar o lançamento contábil, mas não consegue dizer qual subconta está errada. Cinco colunas para cinco contribuições à SS mais uma para o IRPF significa que você pode rastrear a discrepância até uma linha de dedução específica em menos de um minuto.

Transparência Salarial e o Registro Retributivo — Quando a Extração se Torna Infraestrutura de Conformidade

Desde abril de 2021, sob o Real Decreto 902/2020 sobre transparência salarial (igualdad retributiva), todas as empresas espanholas — independentemente do porte — devem manter um registro salarial (registro retributivo) mostrando salários médios e complementos desagregados por gênero e categoria profissional. Empresas com 50 ou mais funcionários devem ir além: o registro salarial deve alimentar um plano de igualdade (plan de igualdad) que inclui uma auditoria salarial completa (auditoría retributiva), analisando diferenças salariais por categoria de cargo, senioridade e outros fatores.

Os dados que alimentam essa obrigação estão na nómina. Cada linha — salario base, complementos, antigüedad, pagas extras — deve ser desagregada por gênero para calcular a remuneração média e mediana por categoria e detectar qualquer diferença (brecha salarial) superior a 25%, o que aciona justificativa obrigatória. Uma empresa que extraiu seus dados da nómina para o Excel estruturado por funcionário, por mês e por componente de remuneração consegue produzir o registro retributivo em uma tarde de tabelas dinâmicas. Uma empresa que ainda tem os dados presos em PDFs enfrenta uma semana de transcrição manual, maior risco de erro e exposição à não conformidade sob o LISOS Art. 7.13, que classifica a ausência de registro salarial como infração grave.

Perguntas Frequentes

Uma ferramenta de extração com IA consegue lidar com nóminas de diferentes softwares de folha de pagamento — a3asesor, Sage e NominaSol — no mesmo lote?

Sim, desde que a ferramenta entenda os campos pelo significado e não pela posição. Um leitor semântico de IA — que identifica "Salario Base" ou "Líquido a Percibir" reconhecendo o conceito em qualquer lugar da página, não por suas coordenadas de pixel — lida com a variação de layout entre softwares de folha de pagamento. Uma nómina do a3asesor coloca o painel de bases de cotización à esquerda; uma nómina do NominaSol pode colocá-lo à direita. Uma ferramenta baseada em modelo treinada em um layout vai falhar no outro. Uma ferramenta semântica lê ambos corretamente.

A extração preserva os acentos nos nomes de campos em espanhol (nómina, retención, cotización)?

Sim. A IA lê o texto em espanhol como ele aparece no documento, incluindo caracteres acentuados. Os nomes de colunas que você define podem incluir termos acentuados como contexto para a IA (por exemplo, "IRPF Withholding (Retención IRPF)"), e os valores extraídos preservam o texto original do holerite.

O que acontece se a nómina de um funcionário for uma imagem digitalizada em vez de um PDF digital?

A IA processa documentos digitalizados, fotos e capturas de tela da mesma forma que processa PDFs nativos. Ela usa compreensão visual para ler o texto, independentemente de ele vir de um arquivo digital ou de uma digitalização — nenhum pré-processamento de OCR separado é necessário. A qualidade de impressão importa: uma digitalização legível gera a mesma precisão que um PDF digital. Fotocópias de baixa qualidade com texto desbotado podem produzir menor confiança em alguns campos.

Posso extrair apenas o total de deduções sem dividir em contribuições individuais da Seguridad Social?

Sim, mas isso não é recomendado para conciliação. Se você extrair apenas Total a Deducir, seu lançamento contábil vai fechar, mas você perde a capacidade de vincular cada tipo de dedução à sua declaração correspondente (Modelo 111 para IRPF, RNT para Seguridad Social). O investimento de cinco minutos para definir colunas separadas economiza horas de investigação quando surge uma discrepância. Se o seu caso de uso for leve — um resumo de renda pessoal para um pedido de visto, por exemplo — extrair apenas Total a Deducir é suficiente.

Como a paga extra prorrateada é tratada nos dados mensais?

A parcela proporcional dos pagamentos extras aparece como um item de linha na seção de devengos, rotulada como "Prorrata Pagas Extras" ou "P.P. Extras" na nómina. Quando você extrai isso como uma coluna própria, seus dados no Excel mostram o valor proporcional mensal separadamente do salário base. Isso é útil para análise da estrutura salarial: você pode calcular a remuneração anual total (salario base × 12 + pagas extras) sem o pico de junho/dezembro nas linhas dos funcionários sem proporcionalidade.

A ferramenta valida o formato do NIF ou NAF na extração?

Não. A ferramenta extrai o valor conforme impresso no holerite. A validação de formato (padrão do NIF: 8 dígitos + 1 letra de controle, ou 1 letra + 7 dígitos + 1 caractere de controle para pessoas jurídicas) deve ser feita no Excel usando uma fórmula ou formatação condicional após a extração.

E quanto a empresas com funcionários em várias comunidades autônomas (comunidades autónomas) — as alíquotas do IRPF são diferentes?

Sim. O IRPF é parcialmente cedido às comunidades autônomas. Embora as faixas estaduais (mostradas na tabela acima) sejam uniformes em todo o país, cada comunidade autónoma define sua própria escala autônoma que substitui a parcela autônoma estadual. A alíquota total do IRPF impressa na nómina já reflete a alíquota combinada correta para a residência fiscal do funcionário. A ferramenta de extração lê essa alíquota do holerite; ela não precisa saber em qual comunidade o funcionário mora. O valor e a alíquota da retenção no holerite são os valores definitivos.