Como extrair dados de holerites espanhóis
para o Excel

O Que Torna o Holerite Espanhol Estruturalmente Diferente para Extração de Dados

Um holerite espanhol (nómina) não é uma lista de deduções de uma coluna como um contracheque anglo-americano. De acordo com 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 que é obrigatória desde 2015. Qualquer ferramenta de extração que espere uma única lista plana de números desalinhará os dados entre todos os quatro blocos.

Os quatro blocos são:

1. Encabezado (cabeçalho). Dados da empresa — CIF/NIF, razão social, endereço, código de conta de cotização (CCC) — mais dados do funcionário: NIF, número de afiliação à Seguridad Social (NAF), categoria profissional, grupo de cotização e antiguidade. Este bloco também especifica o período de pagamento (periodo de liquidación) — o mês e ano que o holerite cobre.
2. Devengos (proventos). Cada euro que o funcionário acumula naquele período. Começa com percepções salariais (rendimentos baseados em salário): salário base, complementos (antiguidade, idiomas, periculosidade, noturnidade), horas extras e pagas extras rateadas (pagamentos extras proporcionais — discutido abaixo). Também pode incluir percepções não salariais (compensações não salariais): diárias, quilometragem, indenizações. A parte inferior deste bloco mostra o Total Devengado (total acumulado).
3. Deducciones (deduções). Tudo que é subtraído do total acumulado. É aqui que a Espanha diverge de todos os outros holerites da UE: o bloco de deduções não mostra uma única linha de imposto. Ele detalha de quatro a cinco contribuições separadas à Seguridad Social (contingências comuns, desemprego, formação profissional, FOGASA e, desde 2023, MEI), mais a retenção do IRPF — Imposto sobre a Renda das Pessoas Físicas, o imposto de renda progressivo da Espanha retido na fonte — além de quaisquer deduções adicionais como adiantamentos ou penhoras. Cada dedução tem uma parcela do trabalhador (aportación del trabajador). O total de todas as deduções é 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) ao lado das bases de contribuição usadas para o cálculo. Este painel mostra a base de cotização para cada tipo de contingência, a alíquota aplicável (tipo %) e o valor da contribuição patronal. Nenhum outro formato de holerite da UE — nem o bulletin de paie francês, o Lohnabrechnung alemão, nem o cedolino italiano — exige que a contribuição patronal apareça na cópia do funcionário.

A consequência prática para extração: uma ferramenta genérica que lê o bloco de deduções de cima para baixo e gera uma coluna "Imposto" misturará as contribuições à Seguridad Social com a retenção do IRPF — dois valores que pertencem a lançamentos contábeis diferentes (conta 476 Organismo de la Seguridad Social acreedora vs. conta 4751 HP acreedora por retenciones). E a contribuição patronal, impressa na parte inferior da página, longe das deduções, será completamente ignorada.

Campos Obrigatórios da Nómina (Holerite) — 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 infração trabalhista nos termos da 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 valores reais. As empresas devem conservar as nóminas por pelo menos cinco anos. Aqui está o mapa de extração das colunas:

Trinta e três colunas parece muito. 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 os cinco descontos vão para colunas separadas em vez de uma única categoria "Imposto", e que o painel de contribuições do empregador na parte inferior não seja ignorado.

Se você já trabalhou com dados de folha de pagamento de outros países, a estrutura dos campos pode parecer familiar, mas sutilmente diferente. Um bulletin de paie francês agrupa as contribuições em cinco blocos de cotisation (Saúde, Aposentadoria, Desemprego, etc.) com uma parte salarial e uma parte patronal. Um Lohnabrechnung alemão separa Steuer (imposto) de 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 à Segurança Social — Por Que Cinco Colunas Separadas São Importantes

A parcela do empregado nos descontos da Segurança Social em uma nómina espanhola não é um único número. De acordo com a Orden PJC/297/2026, os tipos de contribuição de 2026 e suas alíquotas para o trabalhador (tipo del trabajador) são:

AT/EP (acidentes de trabalho e doenças profissionais) é exclusivo do empregador e varia conforme o CNAE (código de atividade), 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 funcionário no Excel não deve ser igual em todas as linhas, a menos que todos os funcionários trabalhem no mesmo código CNAE.

Cinco colunas de extração separadas — e não uma única coluna "Desconto SS" — são importantes 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: conta 642 (Segurança Social a cargo da empresa) para a contribuição total do empregador, enquanto a parcela do empregado passa pela conta 476 (Organismo da Segurança Social credor). Se sua extração agrupar todas as cinco contribuições em uma única célula "SS", a pessoa responsável pelo lançamento contábil terá que separá-las manualmente — exatamente a tarefa que a extração deveria eliminar. Segundo, uma alteração na alíquota de qualquer contribuição individual (como ocorreu em 2023, quando o MEI foi introduzido a 0,10% e aumentou para 0,15% em 2026) fica invisível se todas as cinco forem agrupadas. Você precisa de granularidade por coluna para responder à pergunta: "por que o desconto total de janeiro é 18,50 € maior que o de dezembro?"

A aportación empresarial do empregador — o painel na parte inferior da nómina que mostra o que a empresa paga à Segurança Social por cada funcionário — é um alvo de extração separado. Em uma empresa de 50 funcionários, somar a coluna de aportación empresarial em todas as nóminas fornece o custo total mensal da mão de obra (coste laboral total) — o número que vai para a demonstração de resultados e para o arquivamento anual das cuentas anuales. Uma coluna negligenciada na parte inferior de cada contracheque se traduz em uma linha de P&L no valor de dezenas de milhares de euros por ano.

Retenção de IRPF no Holerite Espanhol — Extraindo e Verificando a Alíquota Correta

O IRPF (Imposto sobre a Renda das Pessoas Físicas) é o imposto progressivo de renda pessoal da Espanha, retido na fonte em todo holerite. A alíquota de retenção (tipo de retención) não é um percentual fixo. Ela é calculada individualmente para cada funcionário com base em sua renda anual estimada, situação familiar (número de filhos, estado civil), grau de deficiência e outras circunstâncias pessoais comunicadas via Modelo 145. As faixas de IRPF de 2026 para rendimentos do trabalho são:

Estas são faixas progressivas, ou seja, 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 no holerite — geralmente mostrada como um percentual ao lado da linha de dedução do IRPF ou no cabeçalho — é uma alíquota pré-calculada fornecida pela Agência Tributária (AEAT), não uma alíquota escolhida pelo empregador.

Por que extrair o IRPF em sua própria coluna, separada das deduções da Seguridade Social? Porque o IRPF não vai para a mesma conta. No lançamento contábil da folha de pagamento, a retenção do IRPF é creditada na conta 4751 (HP acreedora por retenciones practicadas), enquanto as deduções do trabalhador para a Seguridade Social vão para a conta 476. Misturá-los em uma única coluna e o Modelo 111 mensal (declaração de retenção de IRPF) e a RNT (Relação Nominal de Trabalhadores, a declaração de contribuição à Previdência Social) não serão conciliados com os dados extraídos — e a discrepância surgirá no pior momento possível: durante uma inspeção do trabalho (Inspección de Trabajo) ou auditoria fiscal.

Uma verificação rápida: o valor da retenção de IRPF no holerite é 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 de IRPF quanto a base sujeta, uma coluna calculada — Base Sujeta × Alíquota% − Valor de IRPF Extraído — sinaliza qualquer linha onde 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 Passo a Passo

O fluxo de extração é o mesmo, seja para processar uma única nómina para solicitação de visto ou 50 para conciliação de folha de pagamento de fim de mês. A diferença está no design das colunas e nas etapas de verificação.

Passo 1: Faça upload dos seus arquivos de nómina. Formatos aceitos 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 como PDF — como praticamente todos fazem — faça upload dos PDFs diretamente. O upload em lote está disponível: selecione todas as nóminas dos funcionários de um determinado mês e faça upload juntos. 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 exigem as ferramentas baseadas em modelos), você digita os nomes dos campos desejados — e a IA localiza cada valor entendendo o que ele significa, não onde 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á impresso explicitamente. Por exemplo, uma coluna chamada "Tipo de Contrato (opções: Indefinido/Temporal)" fará com que a IA leia a taxa de desemprego no holerite (1,55% = indefinido, 1,60% = temporário) e produza 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.

Passo 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 inferior de bases — 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 (uma nómina do a3asesor e uma nómina do Sage NominaPlus têm aparências diferentes, mas contêm o mesmo vocabulário de campos).

Passo 4: Baixar como Excel (XLSX). O resultado é uma planilha estruturada onde cada linha é um holerite e cada coluna é um campo extraído. Os formatos de saída suportados 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 de fórmula para verificação.

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

A estrutura da nómina oferece uma trilha de auditoria embutida: 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 € sinaliza um erro de extração ou um holerite com arredondamento que precisa de revisão manual.

Esta verificação não é opcional. Erros em dados de folha de pagamento se acumulam. Uma taxa de desemprego de 1,55% aplicada à base errada produz uma discrepância que, quando multiplicada por 12 meses e 50 funcionários, gera uma diferença de seis dígitos entre a declaração RNT (Relação Nominal de Trabalhadores) e os registros contábeis da empresa. A diferença entre encontrar isso no momento da extração e encontrá-lo durante uma Inspeção de Trabalho é a diferença entre corrigir uma coluna em cinco minutos e sofrer uma sanção nos termos do LISOS Art. 22.

Você pode incorporar essa verificação diretamente na extração usando coluna calculada: defina uma coluna chamada "Verificação de Conciliação (Total Devengado − Total a Deducir − Liquido a Percibir)" e a IA calcula a diferença durante a extração. Qualquer linha diferente de zero é sinalizada antes mesmo de você abrir o arquivo Excel. Isso não é uma etapa de pós-processamento — está integrada ao próprio processo de extração.

Três outras 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 do empregado deve ser aproximadamente 4,70% da Base CC. Uma coluna calculada: Base CC × 4,70% − Valor Extraído de Cont. Comuns. Sinalize linhas fora de ±1 €.
• Consistência do IRPF. Se você extrair tanto a taxa (%) quanto o valor retido (€) do IRPF, verifique: Base Sujeita IRPF × Taxa% − Valor IRPF. A taxa de retenção do IRPF é calculada pela AEAT e pode incorporar arredondamentos, mas grandes desvios indicam uma incompatibilidade na 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 incompatibilidade nessa linha geralmente significa que a base errada foi lida — a ferramenta capturou 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. De acordo com o Artigo 31 do Estatuto de los Trabajadores, todo funcionário espanhol tem direito a duas pagas extras (pagas extraordinarias) por ano, geralmente 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 ratear (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 rateadas, a seção de devengos mostra um item de linha chamado "Prorrata Pagas Extras" ou "P.P. Extras". Quando não são rateadas, as nóminas de junho e dezembro mostram um bloco separado com um Total Devengado muito maior — geralmente quase o dobro dos outros meses.

Se você executar a extração em lote em uma mistura de funcionários com pagas rateadas e não rateadas em junho, as linhas não rateadas 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. Em seguida, sua tabela dinâmica do Excel pode filtrar ou separar esses meses para análise anual.

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

Variação da taxa de IRPF entre funcionários. Não há dois funcionários em uma empresa espanhola que necessariamente 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 de forma independente, 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 perseguir PDFs por e-mail. O funcionário envia sua nómina diretamente; ela chega automaticamente na sua fila de processamento.

Da Extração à Contabilização — Construindo 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 Plano Geral de Contabilidade (PGC). Os dados extraídos do Excel das suas nóminas mapeiam diretamente para as contas do PGC:

Se sua extração separa cada contribuição da Seguridad Social em sua própria coluna e separa o IRPF da SS, construir esse lançamento contábil é um SUMIF 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 mal classificada — 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.

É aqui também 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 pode dizer qual subconta está errada. Cinco colunas para cinco contribuições da 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, nos termos do Real Decreto 902/2020 sobre transparência salarial (igualdad retributiva), todas as empresas espanholas — independentemente do porte — devem manter um registro salarial (registro retributivo) que mostre 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 inclua uma auditoria salarial completa (auditoría retributiva), analisando diferenças salariais por categoria de cargo, antiguidade e outros fatores.

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

Perguntas Frequentes

Uma ferramenta de extração por 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 campos pelo significado, não pela posição. Um leitor de IA semântico — que identifica "Salário Base" ou "Líquido a Receber" reconhecendo o conceito em qualquer lugar da página, não por suas coordenadas de pixel — lida com variações de layout entre softwares de folha de pagamento. Uma nómina do a3asesor coloca o painel de bases de cotização à esquerda; uma nómina do NominaSol pode colocá-lo à direita. Uma ferramenta baseada em template treinada em um layout quebrará no outro. Uma ferramenta semântica lê ambos corretamente.

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

Sim. A IA lê o texto em espanhol exatamente como aparece no documento, incluindo caracteres acentuados. Os nomes das colunas que você define podem incluir termos acentuados como contexto para a IA (ex.: "Retenção de IRPF (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 escaneada em vez de um PDF digital?

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

Posso extrair apenas o total de descontos sem dividir em contribuições individuais para a Previdência Social?

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

Como a paga extra prorrateada é tratada nos dados mensais?

A parcela prorrateada 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 do Excel mostram o valor mensal prorrateado 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 não prorrateados.

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

Não. A ferramenta extrai o valor conforme impresso no recibo de vencimento. A validação do formato (padrão NIF: 8 dígitos + 1 letra de verificação, ou 1 letra + 7 dígitos + 1 caractere de verificação 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 — as taxas de IRPF diferem?

Sim. O IRPF é parcialmente cedido às comunidades autónomas. Embora os escalões estatais (mostrados na tabela acima) sejam uniformes em todo o país, cada comunidade autónoma define a sua própria escala autónoma que substitui a parte estatal autónoma. A taxa total de IRPF impressa na nómina já reflete a taxa combinada correta para a residência fiscal do funcionário. A ferramenta de extração lê esta taxa do recibo de vencimento; não precisa saber em que comunidade o funcionário reside. O valor e a taxa de retenção no recibo de vencimento são os valores definitivos.