Saltar al contenido
Constaia
es_aeat_census_certificate

Certificado de situación censal (AEAT)

Certificado de la Agencia Tributaria con el domicilio fiscal, epígrafes de IAE, regímenes y obligaciones periódicas; PDF firmado con CSV.

Categoría
Impuestos
País
España
Campos que extrae
9 campos
Coste
1 crédito
es_aeat_census_certificatespecimen
Nombre del titular
DNI/NIE del titular
Fecha de expedición
Tax address
Activities
Vat regime
Income tax regime
Registration date
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.
  • Antigüedad. Emitido hace menos de N días.
  • 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
  • Fecha de expediciónissue_date
  • Tax addresstax_address
  • Activitiesactivities
  • Vat regimevat_regime
  • Income tax regimeincome_tax_regime
  • Registration dateregistration_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_census_certificate",
    "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_aeat_census_certificate",
    "label": "Certificado de situación censal (AEAT)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_aeat_census_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Certificado de situación censal (AEAT)."
      }
    ]
  },
  "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": "2026-09-01",
      "confidence": 0.97,
      "validated": null
    },
    "tax_address": {
      "value": "C/ MAYOR 1, 28013 MADRID",
      "confidence": 0.96,
      "validated": null
    },
    "activities": {
      "value": [
        "763 - Programadores y analistas de informática"
      ],
      "confidence": 0.99,
      "validated": null
    },
    "vat_regime": {
      "value": "General",
      "confidence": 0.98,
      "validated": null
    },
    "income_tax_regime": {
      "value": "Estimación directa simplificada",
      "confidence": 0.97,
      "validated": null
    },
    "registration_date": {
      "value": "2020-01-01",
      "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.