es_payslip

Nómina (España)

Recibo individual justificativo del pago de salarios: empresa (CIF, CCC), trabajador (NIF, NAF), periodo, devengos, deducciones, líquido a percibir, retención de IRPF y bases de cotización.

Categoría: Empleo
País: España
Campos que extrae: 14 campos
Coste: 1 crédito

es_payslipspecimen

Company
Employee
Period start
Period end
Days
Accruals
Total accrued
Deductions
Total deductions

Qué comprueba

Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).es_nif, es_nif, iban
Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
Antigüedad. Emitido hace menos de N días.
IBAN. Dígitos de control ISO 13616 y longitud por país.

Campos que extrae

Companycompany
Employeeemployee
Period startperiod_start
Period endperiod_end
Daysdays
Accrualsaccruals
Total accruedtotal_accrued
Deductionsdeductions
Total deductionstotal_deductions
Salario netonet_pay
Irpf percentirpf_percent
Contribution basescontribution_bases
Payment datepayment_date
IBANiban

Petición de ejemplo

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"
  }'

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_payslip",
    "label": "Nómina (España)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_payslip"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Nómina (España)."
      }
    ]
  },
  "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

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.

Crear cuenta gratis Hablar con ventas