# Verificación documental

La **verificación documental** permite validar la autenticidad de documentos de identidad oficiales (DNI, pasaportes, licencias, etc.) mediante análisis visual, extracción de datos OCR y validaciones estructurales o con fuentes oficiales. Es clave para procesos de onboarding, prevención de fraude y cumplimiento regulatorio.

***

### Servicios técnicos necesarios

**Frontend (SDKs)**

SDKs para la captura de documentos, compatibles con:

* Android / iOS (nativo)
* Web (JavaScript)
* Frameworks híbridos (Flutter, React Native, Cordova)

> 🔗 [Acceder a la documentación de SDKs Frontend →](https://facephi.github.io/sdk-mobile-documentation/es/)

**Requisitos de licenciamiento:**

* **Web:** Dominio o puerto de localhost
* **Mobile:** Package name (Android) / Bundle ID (iOS)

**Backend (vía API REST)**

| Servicio                                            | Endpoint                      | Descripción                                                      |
| --------------------------------------------------- | ----------------------------- | ---------------------------------------------------------------- |
| **Extracción de datos (OCR)**                       | Parte del SDK                 | Extrae información textual estructurada del documento            |
| **Validación con registro civil**                   | `POST /civilValidation`       | Verifica los datos del documento con registros oficiales         |
| **Validación morfológica del documento**            | `POST /documentValidation/v2` | Analiza la estructura, patrones y seguridad visual del documento |
| **(Opcional) Validación de país o tipo documental** | A definir según el país       | Aplica lógicas específicas por región/documento                  |

> 🔗 [Ver documentación de APIs →](https://docs.identity-platform.io/)

***

### Flujo técnico recomendado

1. **Captura del documento (anverso y reverso si aplica)**
2. **Extracción de datos vía OCR**
3. **Validación con fuentes oficiales o por morfología**
4. **(Opcional) Validación por metadatos/documentos admitidos**
5. **Retorno de resultados para toma de decisión**

***

### Arquitectura de referencia

> 🌍 Diagrama funcional y arquitectura estándar de integración: \[enlace al diagrama] *(a incluir en Confluence o embed)*

* SDK Document Capture → Middleware cliente → APIs de verificación documental

***

### Consideraciones técnicas

* Algunos documentos requieren captura de ambas caras
* Registro civil solo disponible para ciertos países
* Versionado: utilizar la versión 2 del endpoint de validación por morfología
* La validación morfológica no requiere conexión a bases externas, pero puede combinarse con otros servicios para mayor robustez

***

### Preguntas frecuentes (FAQ)

**¿Qué pasa si el documento no está soportado?**\
Puede retornarse un estado de "documento no reconocido" y continuar el flujo bajo supervisión manual.

**¿Qué diferencia hay entre validación morfológica y con registro civil?**\
La morfológica se basa en características visuales del documento; la de registro civil compara datos con bases oficiales del país.

**¿Se pueden validar documentos internacionales?**\
Depende del tipo de documento y país. La validación morfológica admite más variedad que el registro civil.

***

#### Casos relacionados

* Alta de nuevos usuarios (requiere validación documental previa)
* Verificación de edad (mediante lectura de fecha de nacimiento del documento)
* AML Screening (utiliza datos del documento como insumo)

***

#### Descarga de recursos

* SDKs y ejemplos: \[repositorio GitHub / portal privado]
* Documentación técnica completa por SDK: \[enlace]
* Diagrama funcional editable: \[enlace a Figma o PDF]

***

Esta guía permite integrar correctamente la validación documental, diferenciando entre tipos de verificación y aportando claridad para implementaciones técnicas en onboarding, KYC y procesos de seguridad documental.
