1. Vision General del Sistema
El sistema OCR de ImmigrationOS utiliza la API de Claude de Anthropic (Vision) para extraer datos automaticamente de documentos de inmigracion escaneados. El sistema procesa 13 tipos de documentos y puede autocompletar campos del formulario a partir de escaneos de pasaportes.
Tipos de Documentos Soportados
| Tipo de Documento | Datos Extraidos |
|---|---|
| Pasaporte | Nombre, fecha de nacimiento, lugar de nacimiento, sexo, numero de pasaporte, fecha de vencimiento |
| Acta de Nacimiento | Nombre completo, fecha y lugar de nacimiento, nombres de padres |
| Acta de Matrimonio | Nombres de conyuges, fecha y lugar del matrimonio |
| Acta de Divorcio | Nombres de las partes, fecha del divorcio |
| Declaraciones de Impuestos | Nombre del contribuyente, SSN/ITIN, ano fiscal, ingresos |
| Registro I-94 | Nombre, fecha de entrada, clase de admision, fecha de vencimiento |
| Green Card (Residencia Permanente) | Nombre, numero A, categoria, fecha de vencimiento |
| Permiso de Trabajo (EAD) | Nombre, numero A, categoria, fecha de vencimiento |
| Examen Medico I-693 | Nombre del solicitante, fecha del examen, nombre del medico |
| Aviso de Aprobacion | Numero de caso, tipo de formulario, fecha de aprobacion |
| Aviso de Recibo | Numero de recibo, tipo de formulario, fecha de recepcion |
| Registro del Servicio Selectivo | Nombre, numero de registro, fecha de registro |
- Autocompletado de campos del formulario a partir de escaneos de pasaporte (nombre, fecha de nacimiento, lugar de nacimiento, sexo, numero de pasaporte)
- Deteccion automatica de fechas de vencimiento de documentos
- Soporte para PDFs de multiples paginas
- Procesamiento impulsado por la API de Claude de Anthropic
2. Como los Clientes Usan el OCR
El cliente sube un documento en form.html usando la seccion de carga de documentos y hace clic en el boton "Escanear Documento".
El sistema envia la imagen a la funcion ocr-extract.js, que utiliza la API de Claude Vision para extraer los datos del documento.
Los datos extraidos se muestran en un resumen debajo de la seccion de carga para que el cliente los revise.
Para escaneos de pasaportes, el sistema autocompleta automaticamente los campos del formulario: nombre, fecha de nacimiento, lugar de nacimiento, sexo y numero de pasaporte.
Indicadores de Vencimiento
Despues del escaneo, el sistema muestra indicadores de vencimiento del documento:
- Valido — Documento vigente, sin problemas
- Vence pronto — Vence en menos de 90 dias — aconsejar al cliente que renueve
- Vencido — El documento ha expirado — no se puede usar para presentacion
3. Requisitos de Calidad de Documentos
Formatos Aceptados
| Formato | Tamano Maximo | Notas |
|---|---|---|
| 20 MB | Se procesan todas las paginas | |
| JPG / JPEG | 20 MB | Formato mas comun para fotos de documentos |
| PNG | 20 MB | Bueno para escaneos de alta calidad |
- Imagenes borrosas o desenfocadas
- Documentos parciales o recortados
- Capturas de pantalla del telefono de otros documentos en pantalla
- Imagenes con sombras, dedos o fondos oscuros
4. Manejo de Errores de OCR
| Situacion | Accion a Tomar |
|---|---|
| Resultados de baja confianza | Verificar manualmente los datos extraidos contra el documento original |
| "No se pudieron extraer datos" | Pedir al cliente que suba una imagen mas clara o en mejor resolucion |
| Datos extraidos incorrectos | El cliente debe corregir los campos del formulario manualmente |
| Tipo de documento no reconocido | Ingresar los datos manualmente en el formulario |
El OCR es una herramienta de ASISTENCIA — todos los datos extraidos deben ser verificados por Felix antes de cualquier presentacion ante USCIS. Nunca se debe confiar unicamente en los datos del OCR para presentaciones.
5. Gestion de Vencimiento de Documentos
El portal del cliente muestra advertencias de vencimiento para todos los documentos escaneados que contienen fechas de expiracion. El personal debe monitorear estas alertas y comunicarse con los clientes de manera proactiva.
Niveles de Alerta
| Estado | Indicador | Accion Requerida |
|---|---|---|
| Vigente | Valido | Ninguna — documento aceptable para presentacion |
| Vence pronto (<90 dias) | Vence pronto | Advertencia amarilla — aconsejar al cliente que renueve el documento |
| Vencido | Vencido | Alerta roja — no se puede usar para presentacion, el cliente debe renovar primero |
Vigencias Comunes de Documentos
| Documento | Vigencia Tipica |
|---|---|
| Pasaporte | 10 anos |
| Green Card (Permanente) | 10 anos |
| Green Card (Condicional) | 2 anos |
| Permiso de Trabajo (EAD) | 1-2 anos |
| I-94 (Registro de Entrada) | Varia segun clase de admision |
6. Privacidad y Seguridad
La proteccion de datos del cliente es critica durante el procesamiento OCR. Los siguientes controles de seguridad estan implementados:
| Aspecto | Detalle |
|---|---|
| Procesamiento API | Los documentos son procesados por la API de Claude de Anthropic — sin retencion de datos segun los terminos de la API |
| Datos Extraidos | Los datos extraidos se muestran solo del lado del cliente — no se almacenan por separado en el servidor |
| Archivos Originales | Los archivos originales se suben a Google Drive (cuando el Shared Drive esta configurado) |
| Cumplimiento | Los datos del cliente estan protegidos bajo la Politica de Privacidad y el DPA con Anthropic |
Nunca comparta documentos escaneados de clientes a traves de canales no autorizados (correo personal, WhatsApp, etc.). Utilice unicamente los sistemas internos aprobados (Google Drive, ImmigrationOS).
7. Solucion de Problemas
| Problema | Causa Probable | Solucion |
|---|---|---|
| El boton "Escanear Documento" no aparece | JavaScript esta deshabilitado en el navegador del cliente | Verificar que JavaScript este habilitado. Probar en otro navegador. |
| El escaneo tarda demasiado (>30 segundos) | El archivo es demasiado grande o la conexion es lenta | Comprimir la imagen o reducir la resolucion. El limite maximo es 20 MB. |
Error de ANTHROPIC_API_KEY |
La variable de entorno no esta configurada o ha expirado | Verificar las variables de entorno en Netlify: Site settings > Environment variables |
| OCR devuelve datos vacios | El documento no es uno de los 13 tipos soportados | Verificar el tipo de documento. Si no esta soportado, ingresar datos manualmente. |
| Autocompletado de pasaporte no funciona | El documento subido no fue identificado como pasaporte | Asegurar que la pagina de datos del pasaporte sea claramente visible en la imagen. |
8. Calendario de Revision
| Revision | Frecuencia | Responsable |
|---|---|---|
| Revision y actualizacion del SOP | Trimestral | Felix (Administrator) |
| Proxima revision programada | 21 de junio de 2026 | Felix (Administrator) |