The validation endpoint performs a comprehensive, read-only audit of a dossier. It does not modify any data. Use it to determine whether a dossier is ready for formal submission, identify missing documents, flag contact-data gaps, and review OCR coverage across uploaded files.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/gcapella0/agente-inteligente-expedientes/llms.txt
Use this file to discover all available pages before exploring further.
GET /validacion/expediente/
Run a full audit of the dossier identified bycedula. Returns a structured result with per-document presence/state, data-integrity checks, OCR coverage, alert messages, and a single estado_general classification.
No authentication is required for this endpoint.
Path Parameters
Venezuelan ID number of the docente to audit (digits only), e.g.
12345678.Query Parameters
Reserved for future use. Currently accepted but has no effect on the response payload.
Response
Response Field Reference
The cedula echoed back from the request path.
A fixed map of the 10 required document types (see list below). Each entry contains:
presente(boolean) — whether at least one document of this type exists in the dossierestado_validacion(string) — thevalidacion.estadoof the found document (pendiente,aprobado,rechazado,requiere_revision), or"N/A"if not presentobservaciones(string | null) — reviewer notes from the document’svalidacion.observacionesfield
Contact and address completeness checks derived from the docente record:
campos_contacto_validos—trueif thecontactosub-document is non-emptyemail_principal_presente—trueifdocente.contacto.email_personalis settelefono_presente—trueifdocente.contacto.telefono_principalis setdireccion_completa—trueifdocente.direccion.direccion_completais set
OCR coverage across all documents in the dossier (not just the 10 required):
documentos_procesados_ocr— count of documents whereocr.procesado == truedocumentos_pendientes_ocr— count of documents where OCR has not yet runconfianza_promedio— arithmetic mean ofocr.confianza_promedioacross processed documents (0 if none processed)
Single classification derived from completeness percentage and alert count. The logic evaluates in priority order:
Note: a dossier with
| Value | Condition |
|---|---|
apto | completitud >= 100% AND alertas is empty |
requiere_atencion | Not apto AND completitud >= 50% |
critico | completitud < 50% |
completitud >= 50% but outstanding alerts will be requiere_atencion, not apto. A dossier with completitud == 100% but at least one alert is also requiere_atencion.Human-readable alert messages. Generated for:
- Each missing required document:
"Documento faltante: {tipo}" - Missing phone:
"Teléfono no registrado" - Missing address:
"Dirección incompleta"
true only when completitud == 100% and the alertas array is empty. Equivalent to estado_general == "apto".The 10 Required Documents
The audit evaluates exactly these document types. A dossier reaches 100% completeness only when all 10 are present:| # | TipoDocumento |
|---|---|
| 1 | cedula_identidad |
| 2 | partida_nacimiento |
| 3 | rif |
| 4 | titulo_bachiller |
| 5 | certificado_notas_bachillerato |
| 6 | titulo_universitario |
| 7 | certificado_notas_pregrado |
| 8 | fondo_negro_titulo |
| 9 | acta_grado |
| 10 | resolucion_nombramiento |
The completeness percentage shown in
estado_general logic is sourced from completitud.porcentaje on the docente document, which is recalculated automatically whenever documents are added, updated, or deleted.Error Responses
| Status | Detail |
|---|---|
404 | "Docente no encontrado" |
500 | "Error en validación" |