Saltar para o conteúdo
Constaia
es_payslip

Recibo de vencimento espanhol (nómina)

Recibo de vencimento espanhol: empresa (CIF, CCC), trabalhador (NIF, NAF), período, abonos, descontos, líquido, retenção de IRPF e bases de contribuição.

Categoria
Emprego
País
Espanha
Campos extraídos
14 campos
Custo
1 crédito
es_payslipspecimen
Company
Employee
Period start
Period end
Days
Accruals
Total accrued
Deductions
Total deductions

O que verifica

  • Identificadores nacionais. Checksum ou formato oficial do número (NIF, CPF, CURP, RUT…).es_nif, es_nif, iban
  • Titular. Nome, número ou data de nascimento coincidem com o esperado.
  • Antiguidade. Emitido há menos de N dias.
  • IBAN. Dígitos de controlo ISO 13616 e comprimento por país.

Campos extraídos

  • Companycompany
  • Employeeemployee
  • Period startperiod_start
  • Period endperiod_end
  • Daysdays
  • Accrualsaccruals
  • Total accruedtotal_accrued
  • Deductionsdeductions
  • Total deductionstotal_deductions
  • Remuneração líquidanet_pay
  • Irpf percentirpf_percent
  • Contribution basescontribution_bases
  • Payment datepayment_date
  • IBANiban

Exemplo de pedido

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "es_payslip",
    "checks": {
      "max_age_days": 90,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Exemplo de resposta

Dados fictícios. Resposta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_payslip",
    "label": "Recibo de vencimento espanhol (nómina)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_payslip"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "O documento é: Recibo de vencimento espanhol (nómina)."
      }
    ]
  },
  "fields": {
    "company": {
      "value": {
        "name": "ESPECIMEN S.L.",
        "tax_id": "B12345674",
        "address": "C/ MAYOR 1, 28013 MADRID",
        "ccc": "28123456789"
      },
      "confidence": 0.99,
      "validated": true
    },
    "employee": {
      "value": {
        "name": "JUAN ESPAÑOL ESPAÑOL",
        "tax_id": "99999999R",
        "social_security_number": "281234567840",
        "category": "Técnico"
      },
      "confidence": 0.98,
      "validated": null
    },
    "period_start": {
      "value": "2026-08-01",
      "confidence": 0.97,
      "validated": null
    },
    "period_end": {
      "value": "2026-08-31",
      "confidence": 0.96,
      "validated": null
    },
    "days": {
      "value": 30,
      "confidence": 0.99,
      "validated": null
    },
    "accruals": {
      "value": [
        {
          "concept": "Salario base",
          "amount": 1800
        },
        {
          "concept": "Prorrata pagas extra",
          "amount": 300
        }
      ],
      "confidence": 0.98,
      "validated": null
    },
    "total_accrued": {
      "value": 2100,
      "confidence": 0.97,
      "validated": null
    },
    "deductions": {
      "value": [
        {
          "concept": "Contingencias comunes 4,83 %",
          "amount": 101.43
        },
        {
          "concept": "Desempleo 1,55 %",
          "amount": 32.55
        },
        {
          "concept": "Formación profesional 0,10 %",
          "amount": 2.1
        },
        {
          "concept": "IRPF 12 %",
          "amount": 252
        }
      ],
      "confidence": 0.96,
      "validated": null
    },
    "total_deductions": {
      "value": 388.08,
      "confidence": 0.99,
      "validated": null
    },
    "net_pay": {
      "value": 1711.92,
      "confidence": 0.98,
      "validated": null
    },
    "irpf_percent": {
      "value": 12,
      "confidence": 0.97,
      "validated": null
    },
    "contribution_bases": {
      "value": {
        "common": 2100,
        "professional": 2100,
        "irpf": 2100
      },
      "confidence": 0.96,
      "validated": null
    },
    "payment_date": {
      "value": "2026-08-31",
      "confidence": 0.99,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    },
    {
      "code": "iban_checksum",
      "passed": true,
      "message": "iban_checksum"
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

A Constaia prova que o documento é autêntico?

Não. Verifica o tipo, a coerência dos dados e as suas regras, e assinala sinais como possível edição ou fotografia de ecrã. Isso não prova autenticidade.

É guardada uma cópia do documento?

Não, a menos que o peça. Com storage "none" (por omissão) o ficheiro é apagado quando a análise termina.

Outros documentos

E para que conste…

Crie a sua conta, copie a chave de teste e valide o seu primeiro documento em cinco minutos.