Aller au contenu
Constaia
es_payslip

Bulletin de paie espagnol (nómina)

Bulletin de paie espagnol : employeur (CIF, CCC), salarié (NIF, NAF), période, éléments de rémunération, retenues, net à payer, taux d'IRPF et assiettes de cotisation.

Catégorie
Emploi
Pays
Espagne
Champs extraits
14 champs
Coût
1 crédit
es_payslipspecimen
Company
Employee
Period start
Period end
Days
Accruals
Total accrued
Deductions
Total deductions

Ce qui est contrôlé

  • Identifiants nationaux. Clé de contrôle ou format officiel du numéro (NIR, NIF, CPF, CURP…).es_nif, es_nif, iban
  • Titulaire. Nom, numéro ou date de naissance correspondent à l'attendu.
  • Ancienneté. Délivré il y a moins de N jours.
  • IBAN. Clés de contrôle ISO 13616 et longueur par pays.

Champs extraits

  • Companycompany
  • Employeeemployee
  • Period startperiod_start
  • Period endperiod_end
  • Daysdays
  • Accrualsaccruals
  • Total accruedtotal_accrued
  • Deductionsdeductions
  • Total deductionstotal_deductions
  • Salaire netnet_pay
  • Irpf percentirpf_percent
  • Contribution basescontribution_bases
  • Payment datepayment_date
  • IBANiban

Exemple de requête

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

Exemple de réponse

Données fictives. Réponse abrégée.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_payslip",
    "label": "Bulletin de paie espagnol (nómina)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_payslip"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Bulletin de paie espagnol (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

Constaia prouve-t-il que le document est authentique ?

Non. Il contrôle le type, la cohérence des données et vos règles, et signale des indices comme une possible retouche ou une photo d'écran. Cela ne prouve pas l'authenticité.

Une copie du document est-elle conservée ?

Non, sauf si vous le demandez. Avec storage "none" (par défaut), le fichier est supprimé à la fin de l'analyse.

Autres documents

Et pour valoir ce que de droit…

Créez votre compte, copiez la clé de test et validez votre premier document en cinq minutes.