Validation

La validation API ejecuta el pipeline completo: extrae datos estructurados del documento, los evalúa contra el conjunto de reglas configurado para (document_type, country_code, agreement_code), opcionalmente llama a validadores externos (consulta de CRM, validación de CID, elegibilidad), y devuelve un veredicto APPROVED / REJECTED / ERROR.

Siempre es async. Tiempo típico de procesamiento: 15-60 segundos. El resultado se entrega vía webhook firmado.

Cuándo utilizar

Escenario	Enfoque recomendado
El HIS ya identifica el tipo de documento	Llamar a POST /v1/provider-validation-requests con el document_type conocido. Se omite el classifier (más económico, más rápido).
No se conoce el tipo de documento	Llamar a POST /v1/classification-requests con auto_validate: true. DVS clasifica primero y luego valida.
Solo se desea classification (sin validation)	Llamar a POST /v1/classification-requests sin auto_validate.

Control de acceso

DVS aplica una matriz de default-deny: solo se pueden validar combinaciones de (document_type, country_code, agreement_code) que OSIGU haya autorizado explícitamente. Utilice GET /v1/document-types para descubrir qué está autorizado a validar el tenant. Ver Tipos de Documento.

Valores de final_status

Status	Significado	Acción
APPROVED	Todas las reglas de severidad ERROR pasaron. El documento es válido.	Continuar el flujo de facturación/autorización.
REJECTED	Al menos una regla de severidad ERROR falló. El documento no cumple los requisitos del payer.	Inspeccionar errors[] en el payload del webhook y resolver con el médico/operador.
ERROR	Falla técnica (OCR no pudo extraer, validador externo caído, etc.). No es un veredicto sobre el documento.	Reintentar a través del path de admin, o contactar a OSIGU si persiste.

Desglose de costos

Los costos de validation se rastrean en tres capas — extracción del documento, llamadas a validadores externos y overhead interno de DVS. Ver API Reference > Validation > Create para conocer qué se devuelve en la response.