Almacenamiento de documentos y automatización de fotos
Recoge fotos de visa y escaneos de pasaporte de tus clientes a través del enlace de admisión, valídalos al subirlos y deja que el agente envíe la foto al portal oficial DS-160 automáticamente.
Cada formulario DS-160 tiene dos espacios de documentos — una foto de la solicitud y un escaneo del pasaporte. Tú y tus clientes pueden gestionarlos desde el panel o desde el enlace de admisión del cliente, y cuando se ejecuta un envío, el agente sube la foto al Sistema de Envío de Fotos del Departamento de Estado automáticamente.
1. Espacios de documentos
| Espacio | Nombre técnico | Formato | Límite de tamaño | Usado por |
|---|---|---|---|---|
| Foto de la solicitud | applicationPhoto | JPEG | 240 KB | El agente la sube al DS-160 |
| Escaneo del pasaporte | passportScan | JPEG, PNG o PDF | 10 MB | Se guarda en tu archivo para tus registros |
Cada formulario admite como máximo un documento activo por espacio. Subir uno nuevo elimina (soft-delete) la versión anterior — el archivo se borra del almacenamiento de objetos, pero los metadatos permanecen para la trazabilidad de auditoría.
El límite de 240 KB / solo JPEG de la foto de la solicitud es la especificación estricta del DS-160. Si activas la subida flexible de fotos (consulta «Permitir cualquier foto», sección 3), el espacio acepta los mismos formatos y el límite de 30 MB que el escaneo del pasaporte.
2. Dónde suben los clientes
Cuando generas un enlace de admisión para un cliente, este verá un paso de Documentos junto al cuestionario. Pueden:
- Arrastrar o seleccionar un archivo para cada espacio
- Ver los resultados de validación en línea (tamaño, formato, comprobaciones biométricas básicas para la foto)
- Reemplazar o eliminar lo que hayan subido
- Seguir completando el cuestionario aunque falten documentos — las subidas son independientes del resto del formulario
El cliente nunca ve una URL de almacenamiento ni credenciales de la agencia. La autenticación está limitada a su token de admisión; las subidas desde un enlace de cliente no pueden tocar documentos de otro formulario.
3. Foto de la solicitud — qué comprobamos
La foto pasa por el mismo validador que impulsa el verificador público de fotos de visa de EE. UU.. Por defecto, estos son rechazos duros — la subida falla (para aceptar cualquier foto y convertirlos en advertencias, consulta «Permitir cualquier foto» más abajo):
- El archivo no es JPEG, o está fuera del rango 10 KB – 240 KB
- Las dimensiones en píxeles están fuera de 600×600 – 1200×1200, o la proporción no es cuadrada
- La imagen no está en sRGB / 24 bits de color
- La compresión JPEG supera 20:1 (sobrecomprimida)
- El fondo no es mayoritariamente blanco / blanco roto
- No se detecta cara, hay varias caras, la cabeza queda fuera del 50–69% de la altura de la imagen, los ojos están cerrados o es una toma de perfil (cuando la detección facial está activada)
Advertencias informativas (la subida se completa, pero el cliente ve un aviso):
- La imagen no está a 300 DPI — solo es necesario para fotos impresas (visa de inmigrante DS-260, entrevista presencial); no se exige para subidas digitales del DS-160
- La imagen se imprimiría a un tamaño distinto a 2×2 inches — mismo contexto que el DPI
- Los metadatos EXIF sugieren que la foto podría tener más de seis meses
- La imagen se guardó como JPEG progresivo
- La foto parece subexpuesta o sobreexpuesta, o tiene un contraste inusualmente bajo
- La cara no está centrada en el encuadre
El texto de la advertencia se traduce al idioma seleccionado por el cliente; verás el mismo texto en su idioma en el log de auditoría.
Permitir cualquier foto (subida flexible)
Las comprobaciones estrictas anteriores impiden que un cliente suba algo que no cumpla exactamente la especificación de foto del DS-160. Es el valor por defecto adecuado para el autoservicio, pero frustra a los clientes cuyas fotos de móvil no son cuadradas, son demasiado grandes o tienen un fondo recargado — y acaban enviándote la foto por correo. Si prefieres recopilar cualquier foto y arreglarla tú mismo antes de enviar, activa la subida flexible de fotos:
- Por workspace — Workspace → Configuración → Recepción de clientes → Permitir cualquier foto. Esto se convierte en el valor por defecto de cada nuevo enlace de cliente.
- Por enlace de cliente — el mismo interruptor aparece al generar un enlace, ya rellenado con el valor por defecto del workspace, de modo que puedes anularlo para un cliente concreto.
Con la subida flexible activada, la foto de la solicitud se controla como el escaneo del pasaporte — se acepta cualquier JPEG, PNG o PDF de hasta 30 MB — y todas las comprobaciones de forma/biométricas anteriores se rebajan a advertencia informativa. El cliente (y tú, en el registro de auditoría) siguen viendo exactamente qué falla, pero la subida tiene éxito y puede continuar.
El modo flexible solo cambia lo que acepta el enlace de admisión del cliente. Nunca se exige una foto para enviar, así que nada posterior depende de ella — y el propio sistema de fotos del Departamento de Estado sigue validando la imagen cuando el agente la envía (consulta la sección 6), por lo que una foto no conforme aún puede rechazarse allí. Usa el modo flexible cuando tengas intención de revisar o reemplazar la foto tú mismo antes de que se ejecute el agente.
4. Escaneo del pasaporte — qué comprobamos
El validador solo mira la forma del archivo:
- El tipo MIME detectado (mediante huella de bytes mágicos, no solo la extensión) es JPEG, PNG o PDF
- El tamaño es igual o inferior a 10 MB
- El archivo no está vacío
Sin OCR, sin comprobaciones biométricas. El escaneo del pasaporte es para tus registros — no leemos ni analizamos su contenido.
5. Almacenamiento
Los documentos están cifrados en reposo.
Eliminar un documento — o reemplazarlo con una nueva subida — quita el archivo del almacenamiento de inmediato. Conservamos una fila de metadatos para el registro de auditoría, pero el archivo en sí desaparece en el momento en que confirmas la eliminación.
6. Subida automática de fotos
Cuando el agente ejecuta un envío con una foto de la solicitud adjunta, ahora gestiona el Sistema de Envío de Fotos del Departamento de Estado de principio a fin. Verás dos pasos nuevos en la vista de progreso del envío:
- Subir foto — el agente abre el sistema de fotos del Departamento de Estado, envía el JPEG y espera el resultado del control de calidad.
- Confirmar foto — el agente regresa al formulario DS-160 y avanza más allá de la pantalla Confirmar foto.
Ambos aparecen en la lista de pasos después de los pasos de las secciones del formulario y antes de la fase de Revisión/Firma. Se comportan como cualquier otro paso: estado de éxito / fallo, marcas de tiempo y el flujo estándar de reintento en caso de fallo.
Cuándo se ejecutan los pasos
Los pasos de la foto se añaden a la lista de pasos activa solo si el formulario tiene un documento applicationPhoto adjunto en el momento en que el agente obtiene sus parámetros de trabajo. Los formularios sin foto omiten ambos pasos — el agente envía el resto del formulario y luego se detiene en la fase de la Foto como antes.
Si adjuntas una foto después de que un envío ya haya comenzado, el agente que ya está en marcha no la recogerá; cancela y vuelve a enviar para volver a obtener los parámetros.
Cuando el Departamento de Estado rechaza la foto
Si el sistema de fotos del Departamento de Estado rechaza la subida (su motor de calidad ocasionalmente rechaza fotos que pasan nuestra prevalidación — nosotros somos más estrictos con la forma del archivo y más flexibles con casos límite biométricos), el agente falla el paso Subir foto con el mensaje de rechazo del Departamento de Estado adjunto. Verás el fallo en la vista de progreso del envío con la redacción exacta del Departamento de Estado, para que sepas si debes pedirle al cliente una foto nueva o si hay un problema de píxeles en el validador.
7. Registro de auditoría
Cada subida, reemplazo y eliminación se registra en el log de auditoría de campos con:
- El espacio afectado (
applicationPhoto/passportScan) - El origen (
client_linkcon el JTI del enlace, oauthenticated_usercon el ID y email del usuario) - Una marca de tiempo
- El nombre y tamaño del nuevo documento
Abre Resumen del formulario → Log de auditoría para ver la secuencia completa de ediciones — los campos del cuestionario y los documentos comparten la misma línea temporal.