es_social_security_number_document

Documento de afiliación a la Seguridad Social (NUSS)

Resolución o documento de asignación del número de la Seguridad Social (TGSS); PDF firmado.

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

es_social_security_number_documentspecimen

Nombre del titular
DNI/NIE del titular
Fecha de expedición
Social security number
Fecha de nacimiento
Código Seguro de Verificación

Qué comprueba

Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).es_nif
Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
Firma electrónica del PDF. Se verifica la firma PAdES si llega el PDF original.

Campos que extrae

Nombre del titularholder_name
DNI/NIE del titularholder_id
Fecha de expediciónissue_date
Social security numbersocial_security_number
Fecha de nacimientobirth_date
Código Seguro de Verificacióncsv_code

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_social_security_number_document",
    "checks": {
      "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_social_security_number_document",
    "label": "Documento de afiliación a la Seguridad Social (NUSS)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_social_security_number_document"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Documento de afiliación a la Seguridad Social (NUSS)."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "JUAN ESPAÑOL ESPAÑOL",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "99999999R",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2004-09-01",
      "confidence": 0.97,
      "validated": null
    },
    "social_security_number": {
      "value": "281234567840",
      "confidence": 0.96,
      "validated": null
    },
    "birth_date": {
      "value": "1985-07-30",
      "confidence": 0.99,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    }
  ],
  "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