post
https://example.com/api/accounts/persons/ocr-identity-document
Procesa una imagen de documento en base64 con OCR y devuelve los datos detectados.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Procesá una imagen de documento con OCR y obtené los datos detectados en la respuesta.
Antes de empezar
- Prepará la imagen del documento codificada en base64.
- Enviá la imagen completa y con buena calidad para mejorar la detección de los datos.
- Usá este endpoint cuando necesites extraer información del documento antes de continuar otros flujos de validación o alta.
Cómo procesar un documento por OCR
POST /api/accounts/persons/ocr-identity-document
Content-Type: application/jsonBody parameters
El body acepta un objeto OcrDocumentInput.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
base64_image | string | Sí | Imagen del documento codificada en base64. |
Ejemplo de request
{
"base64_image": "<base64_image>"
}Qué devuelve este endpoint
La respuesta devuelve los datos detectados en el documento procesado.
| Campo | Tipo | Descripción |
|---|---|---|
message | string | Mensaje de resultado del procesamiento. |
result | integer | Resultado numérico de la operación. |
tramite | integer | Número de trámite detectado. |
nombre | string | Nombre detectado en el documento. |
apellido | string | Apellido detectado en el documento. |
sexo | string | Sexo detectado en el documento. |
dni | integer | Número de DNI detectado. |
ejemplar | string | Ejemplar del documento. |
nacimiento | string | Fecha de nacimiento detectada, en formato DD/MM/YYYY. |
vencimiento | string | Fecha de vencimiento detectada, en formato DD/MM/YYYY. |
Respuesta esperada
{
"message": "Document processed successfully",
"result": 1,
"tramite": 123456789,
"nombre": "JUAN",
"apellido": "PEREZ",
"sexo": "M",
"dni": 34111112,
"ejemplar": "A",
"nacimiento": "15/12/1990",
"vencimiento": "15/12/2030"
}Recomendaciones para mejorar el OCR
- Enviá una imagen legible, completa y sin recortes.
- Evitá sombras, reflejos o desenfoque.
- Verificá que el base64 corresponda al archivo correcto antes de enviar la solicitud.
Errores frecuentes
422 Validation Error: faltabase64_imageo el body tiene un formato inválido.- Error de procesamiento: revisá que la imagen esté correctamente codificada en base64 y que el contenido del documento sea legible.
Siguiente paso
Usá los datos extraídos por OCR para validar la información del documento dentro de tu flujo de onboarding o para contrastarla con los datos cargados de la persona.