AUTOMATIZACIÓN DE GUIAS EN SYSLIMA
16/02/2025
Versión 1.0
Queda prohibido cualquier tipo de explotación y, en particular, la reproducción, distribución, comunicación pública y/o transformación, total o parcial, por cualquier medio, de este documento sin el previo consentimiento expreso y por escrito a overskull.
ÍNDICE
1. INTRODUCCIÓN Y OBJETIVOS
1.1 Contexto
1.2 Propósito
2. ALCANCE TÉCNICO
2.1 Automatización Operativa
2.2 Gestión de Impresión
2.3 Puntos de Control
3. COMPONENTES Y DATA DEL PROCESO
3.1 Entradas (Inputs)
3.2 Reglas de Negocio
3.3 Mapeo de Selectores
4. FLUJO OPERATIVO PASO A PASO
4.1 Navegación Inicial
4.2 Llenado de Formulario
4.3 Finalización
5. EVIDENCIAS TÉCNICAS (CAPTURA DE CÓDIGO Y SISTEMA)
5.1 Inspección del DOM
5.2 Logic Core
5.3 Resultados
6. GESTIÓN DE RIESGOS Y BUENAS PRÁCTICAS
6.1 Riesgos Detectados
6.2 Recomendaciones7.DIAGRAMA DE FLUJO
1. INTRODUCCIÓN Y OBJETIVOS
1.1 Contexto
La digitalización logística exige rapidez en el flujo de datos. El presente proyecto surge para optimizar el registro en el portal SYSLIMA, una plataforma que, debido a sus constantes validaciones internas, suele ralentizar el despacho manual de encomiendas.
1.2 Propósito
El objetivo principal es transformar una tarea mecánica en un proceso fluido. Al automatizar la entrada de datos, se busca liberar al personal de la carga operativa, permitiéndoles centrarse en la atención al cliente mientras el sistema garantiza la precisión en la información registrada.
2. ALCANCE TÉCNICO
2.1 Automatización Operativa
La solución abarca el ciclo de vida inicial de la guía: desde la autenticación segura del usuario hasta la navegación profunda en los menús de "Orden de Servicio", gestionando de forma inteligente los tiempos de carga del servidor.
2.2 Gestión de Impresión
El bot posee la capacidad de detectar ventanas emergentes, permitiendo interactuar con el módulo de impresión de forma aislada. Esto garantiza que la generación del PDF y la creación del código de seguridad se realicen sin bloqueos visuales.
2.3 Puntos de Control
Se ha definido un modelo híbrido. El bot se detiene en la selección del destino, permitiendo que el criterio humano decida la ruta logística final, lo que combina la velocidad de la máquina con la flexibilidad necesaria en el transporte.
3. COMPONENTES Y DATA DEL PROCESO
3.1 Entradas (Inputs)
El sistema se alimenta de tres pilares de datos: credenciales de acceso institucional, números de identidad (DNI/RUC) y una clave maestra de seguridad (9191) predefinida para la emisión de documentos.
3.2 Reglas de Negocio
Para evitar errores de "nombre no encontrado", el bot respeta pausas técnicas de entre 6 y 7 segundos. Este tiempo es vital para que la base de datos de Shalom sincronice la identidad del remitente y destinatario antes de proceder con el registro del teléfono.
3.3 Mapeo de Selectores
Se han extraído rutas específicas (XPaths) para cada campo. Se destaca el uso de identificadores estables como swal-input para la clave y telefonoEntrega para el contacto, asegurando que el bot siempre "sepa" dónde escribir, incluso si la página tiene elementos distractores.
4. FLUJO OPERATIVO PASO A PASO
El proceso comienza con el inicio de sesión y el despliegue del menú lateral. El bot localiza la sección de "Generales" y accede al formulario de orden de servicio de manera inmediata tras el ingreso.
4.2 Llenado de Formulario
El bot inyecta la información en bloques: primero el remitente con su validación, luego el destinatario. Posteriormente, selecciona el método de pago y el tipo de paquete (documentos) de forma automática a través de comandos de JavaScript.
4.3 Finalización
Una vez listo el formulario, se dispara la orden de impresión. El bot salta a la pestaña del PDF, ingresa la clave de seguridad en los campos de entrada y verificación, y finaliza pulsando el botón verde de generación de código.
5. EVIDENCIAS TÉCNICAS (CAPTURA DE CÓDIGO Y SISTEMA)
5.1 Inspección del DOM
A través de herramientas de desarrollo, se capturó la jerarquía de los elementos swal-input. Estas capturas demuestran que el bot interactúa con campos que tienen comportamientos automáticos (saltos de foco), los cuales fueron replicados en el código.
5.2 Logic Core
El núcleo del código utiliza la lógica de window_handles. Esta función permite que el bot mantenga la conexión con la ventana principal mientras opera en la ventana secundaria de impresión, una técnica avanzada para evitar que el proceso se pierda al abrirse nuevas pestañas.
5.3 Resultados
Como evidencia final, se adjuntan las capturas de las guías emitidas satisfactoriamente, donde se observa que tanto los datos de contacto como los códigos de seguridad fueron insertados sin intervención manual en el último tramo del proceso.
6. GESTIÓN DE RIESGOS Y BUENAS PRÁCTICAS
6.1 Riesgos Detectados
El principal riesgo es el mantenimiento de los selectores; si la web de Shalom se actualiza, el bot podría no encontrar los campos. Asimismo, una conexión a internet inestable podría requerir aumentar los tiempos de espera configurados.
6.2 Recomendaciones
Se sugiere realizar un monitoreo semanal de los XPaths y mantener el software de Chrome actualizado para que el webdriver funcione correctamente. Además, se recomienda no reducir las pausas de validación para evitar el bloqueo por parte del sistema de seguridad del portal.
7.Diagrama de Flujo