Saltar al contenido
Constaia
es_aeat_tax_id_card

Tarjeta de identificación fiscal (NIF, España)

Tarjeta acreditativa del NIF de una persona jurídica o entidad (AEAT), en formato electrónico con CSV.

Categoría
Impuestos
País
España
Campos que extrae
5 campos
Coste
1 crédito
es_aeat_tax_id_cardspecimen
Nombre del titular
DNI/NIE del titular
Tax address
Fecha de expedición
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.
  • Código Seguro de Verificación. Formato del CSV para cotejarlo en la sede emisora.
  • 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
  • Tax addresstax_address
  • Fecha de expediciónissue_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_aeat_tax_id_card",
    "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_aeat_tax_id_card",
    "label": "Tarjeta de identificación fiscal (NIF, España)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_aeat_tax_id_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Tarjeta de identificación fiscal (NIF, España)."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "ESPECIMEN S.L.",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "B12345674",
      "confidence": 0.98,
      "validated": null
    },
    "tax_address": {
      "value": "C/ MAYOR 1, 28013 MADRID",
      "confidence": 0.97,
      "validated": null
    },
    "issue_date": {
      "value": "2019-02-11",
      "confidence": 0.96,
      "validated": null
    },
    "csv_code": {
      "value": "ABCDEFGH12345678",
      "confidence": 0.99,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    },
    {
      "code": "csv_format",
      "passed": true,
      "message": "El CSV tiene un formato válido."
    }
  ],
  "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.