1. Introducción
Objetivo
Proporcionar una visión general de la plataforma Courier SaaS, su arquitectura multi-tenant y el propósito de automatización operativa.
Descripción
Courier SaaS es una solución integral Cloud diseñada para empresas de transporte de paquetes, mensajería urbana y courier. Resuelve el flujo operativo desde la recepción de planillas Excel hasta la entrega y devolución en tiempo real.
Requisitos
Navegador web moderno compatible con HTML5, JavaScript y PWA en dispositivos móviles o escritorio.
Procedimiento
Navegar a través del sistema utilizando las URLs privadas asignadas a cada empresa (/:slug).
Resultado Esperado
Comprensión del modelo de aislamiento multi-tenant y de las funciones disponibles por rol.
📷 Captura pendiente.
Notas Importantes
El sistema nunca almacena permanentemente archivos Excel en el servidor. Todos los datos se procesan temporalmente en memoria.
Problemas Frecuentes
Intentar ingresar sin especificar la URL personalizada de la empresa (/:slug/login).
2. Acceso y Servicio Cloud
Objetivo
Explicar el modelo de infraestructura Cloud SaaS y los requisitos de conectividad del servicio.
Descripción
Courier SaaS es una plataforma 100% en la nube. No requiere instalación local de software, servidores dedicados ni mantenimiento de bases de datos por parte de la empresa de mensajería.
Requisitos
Navegador web moderno (Google Chrome, Safari, Firefox, Microsoft Edge) con conexión a internet y dispositivo móvil o computador.
Procedimiento
- Abrir el navegador web en su computador o teléfono celular.
- Ingresar a la URL privada de su empresa (
https://couriersas.com/{empresa}/login).
- Iniciar sesión con sus credenciales autorizadas.
Resultado Esperado
Disponibilidad inmediata del sistema con almacenamiento seguro y actualizaciones automáticas.
📷 Captura pendiente.
Notas Importantes
El servicio incluye copias de respaldo automáticas y alta disponibilidad sin interrupciones del turno de trabajo.
Problemas Frecuentes
Interrupción de la conexión a internet durante el uso de la aplicación móvil.
3. Primer Acceso
Objetivo
Explicar los puntos de inicio de sesión para los usuarios de cada empresa.
Descripción
El acceso a la plataforma se realiza mediante la URL personalizada de cada empresa (https://couriersas.com/{empresa}/login).
Requisitos
Credenciales asignadas y URL de la empresa.
Procedimiento
Acceder a https://couriersas.com/{empresa}/login para ingresar usuario y clave.
Resultado Esperado
Redirección exitosa al panel administrativo o al modo escáner de la empresa según el rol asignado.
📷 Captura pendiente.
Notas Importantes
La ruta genérica /login redirige automáticamente a la Landing Page (/), garantizando la separación tenant.
Problemas Frecuentes
Intentar iniciar sesión en la URL de una empresa distinta a la asignada.
4. Configuración de la Empresa
Objetivo
Aprovisionamiento e implementación inicial de la empresa dentro de la plataforma Multi-Tenant.
Descripción
Configuración de la empresa con asignación de URL personalizada, identidad visual, usuario administrador inicial y cuota de licenciamiento por ciudades.
Requisitos
Configuración inicial del sistema aprobada y activa.
Procedimiento
- Ingresar a la URL asignada a la empresa:
https://couriersas.com/{empresa}/login.
- Iniciar sesión con las credenciales de administración inicial.
- Verificar el límite de ciudades contratado para la empresa.
Resultado Esperado
Empresa lista para la importación de planillas y creación de usuarios repartidores.
📷 Captura pendiente.
Notas Importantes
La URL personalizada de cada empresa es única e inalterable durante la operación activa.
Problemas Frecuentes
Intentar ingresar con una URL personalizada que no existe en la plataforma.
5. Crear Usuarios
Objetivo
Administrar el personal de la empresa otorgando credenciales para Administradores o Repartidores.
Descripción
Pestaña 'Usuarios' dentro del Panel Administrativo de la empresa.
Requisitos
Sesión activa como Administrador en la empresa.
Procedimiento
Completar Nombre, Usuario, Contraseña y Seleccionar Rol (`Administrador` o `Repartidor`).
Resultado Esperado
Usuario creado y habilitado para iniciar sesión en https://couriersas.com/{empresa}/login.
📷 Captura pendiente.
Notas Importantes
Los usuarios se crean únicamente bajo la organización correspondiente para garantizar el aislamiento.
Problemas Frecuentes
Ingresar un nombre de usuario que ya existe en el sistema.
6. Roles del Sistema
Objetivo
Definir los permisos, alcance y restricciones de los roles dentro de la empresa.
Descripción
Jerarquía de roles basada en Administrador de Empresa y Repartidor.
Administrador de Empresa
Control operativo completo de la empresa. Gestiona planillas, jornadas, asignaciones, devoluciones y usuarios.
Repartidor
Acceso exclusivo al Modo Escáner Móvil (https://couriersas.com/{empresa}/mobile). Redirección automática si intenta acceder al panel.
📷 Captura pendiente.
Notas Importantes
Los repartidores únicamente tienen acceso al Modo Escáner Móvil para lecturas en ruta o bodega.
7. Importador Excel
Objetivo
Cargar masivamente guías desde planillas .xls entregadas por transportadoras.
Descripción
Procesamiento en memoria, vista previa con Columna M posicional, exclusión de resúmenes y control de cuota por ciudades.
Procedimiento
Seleccionar archivo .xls -> Ver vista previa -> Confirmar importación.
Resultado Esperado
Guías cargadas exitosamente en la jornada abierta actual.
📷 Captura pendiente.
12. Modo Escáner Móvil
Descripción
Aplicación ScanApp PWA (https://couriersas.com/{empresa}/mobile) con tres métodos de captura y 6 herramientas flotantes.
Cámara
Lectura continua con mirilla overlay y alertas auditivas/táctiles.
Pistola USB
Buffer transparente para lectores de bodega.
Digitación Manual (⌨ Manual)
Modal deslizable para códigos ilegibles o dañados.
Importados & Historial
Consulta de planillas de la jornada abierta y bitácora de escaneos.
📷 Captura pendiente.