1 · Introducción: qué es Opera (web)

Opera (web) es la aplicación móvil de campo del sistema de paquetería. Está diseñada para usarse desde el teléfono del operador y concentra todo lo que necesitas hacer fuera de la oficina: recoger paquetes en domicilios de clientes, salir a entregar en ruta, registrar la evidencia de cada entrega, gestionar intentos y devoluciones y registrar el ingreso de guías al almacén (CEDIS).

1.1 ¿Quién es «el operador»?

El operador es la persona que mueve físicamente los paquetes y registra en el sistema cada paso. Hay dos perfiles de trabajo que la misma app cubre:

1.2 Tu lugar en el flujo del paquete

Cada guía (paquete) recorre una cadena de eventos. Tú, como operador, eres quien confirma los eslabones marcados en azul:

Cuando un paquete no se puede entregar, en lugar de «Entregado» se registra un intento, un rechazo o una devolución, también con su evidencia (ver capítulo 8).

Cada vez que escaneas, el sistema registra un evento con hora y cuando es posible tu ubicación. Ese historial es lo que ve la administración, el cliente en su portal y quien audita la operación. Por eso escanear correctamente no es un trámite: es la fuente de la verdad de dónde está cada paquete.

💡 El término resaltado «cuando es posible» se explica en la sección Preguntas clave (FAQ) y en Solución de problemas: hay situaciones en las que el teléfono no puede aportar la ubicación (GPS apagado, permiso bloqueado o sin señal). En esos casos el evento igual se registra, pero sin coordenadas.

2 · Requisitos, instalación y acceso

2.1 Qué necesitas

• Un teléfono (Android o iPhone) con navegador moderno (Chrome, Safari, Opera o similar).
• Cámara funcional (para escanear códigos QR o de barras y tomar fotos de evidencia).
• Ubicación / GPS activado y permiso concedido al navegador.
• Conexión a internet (aunque la app sigue funcionando sin señal; ver capítulo 12).
• Un usuario y contraseña que te entrega el administrador.

2.2 Instalar la app en tu teléfono (PWA)

Opera (web) es una aplicación web instalable (PWA): se abre desde el navegador, pero puedes «instalarla» para que quede como un ícono en tu pantalla de inicio y se abra a pantalla completa, como cualquier app.

1. Abre en el teléfono el enlace que te compartió tu empresa (por mensaje, correo o código QR) e inicia sesión con tu usuario y contraseña.
2. Como tu rol es operador de ruta, entrarás directo a Opera (web), la app de campo.
3. En el menú del navegador elige «Agregar a pantalla de inicio» (Android) o «Añadir a pantalla de inicio» desde el botón Compartir (iPhone/Safari).
4. Confirma. Aparecerá el ícono 🚚 Opera en tu teléfono.
5. Ábrela desde ese ícono a partir de ahora: arranca directo en tu jornada activa.

3 · Inicio de sesión y selector de modo

3.1 Iniciar sesión

1. Escribe tu correo electrónico y tu contraseña.
2. Pulsa Entrar.
3. Si las credenciales son correctas, pasas al selector de modo.

3.2 «¿Qué vas a hacer hoy?» — el selector de modo

Tras iniciar sesión llegas al selector (la pantalla de acceso a módulos). Elige según tu trabajo del día:

3.3 Cuando vuelves a abrir la app: te deja donde estabas

No siempre pasas por el selector. Si ya venías trabajando y vuelves a abrir Opera (web) (porque se apagó la pantalla, la minimizaste o se recargó), la app te devuelve directo a lo que tenías abierto para que no reconfigures nada:

Si tienes las dos cosas activas a la vez, la jornada de ruta manda: abre en el Tablero. El almacén sigue guardado; para ir a él usa la flecha de volver → Almacén.

4 · Iniciar y administrar la jornada

4.1 Iniciar jornada (operador de ruta)

1. Selecciona tu vehículo por matrícula (se muestra también el número económico).
2. Selecciona la ruta asignada del día (solo aparecen las rutas activas).
3. Pulsa Iniciar jornada.
4. La app registra la jornada con la hora de inicio y tu ubicación de arranque (si el GPS está disponible) y te lleva al tablero.

4.2 El Tablero (dashboard)

Es tu pantalla de control. En la parte superior te saluda por tu nombre («Bienvenido, …») y muestra:

• Jornada activa: operador (a nombre de quién está la sesión), vehículo, ruta, hora de inicio de turno e indicador de Mi ubicación (ver cap. 13).
• Resumen de jornada con contadores en vivo, ubicado arriba de las opciones/accesos para que lo primero que veas sea tu pendiente del día:

Son cinco indicadores. «Recolectados a CEDIS» y «Por devolver a CEDIS» están separados para que distingas de un vistazo lo que falta ingresar (lo que recogiste) de lo que falta devolver (lo que no entregaste). Mientras el resumen carga, verás un esqueleto del mismo tamaño para que la pantalla no «salte».

También ves un desglose de entregas por cliente.

Guía de liquidación (aviso amarillo)

Si tienes paquetes pendientes, debajo del resumen aparece un aviso amarillo que ya no es un texto fijo: es una lista dinámica que te dice exactamente qué hacer con cada grupo antes de terminar la jornada. Según lo que tengas pendiente, verás uno o varios de estos puntos:

• Debes recolectar N paquetes que tienes pendientes.
• Debes entregar N paquetes a su destinatario.
• Llevas N paquetes recolectados que debes ingresar a CEDIS.
• Tienes N devoluciones que no entregaste y debes devolver a CEDIS.

La lista se arma sola: solo muestra los pasos que de verdad te faltan. Cuando todos desaparecen, ya puedes terminar la jornada.

4.3 Accesos del tablero

4.4 Menú de módulos (botón ☰) Nuevo

Dentro de cada módulo (Recolecciones, Ruta, Entregas, Intentos y devoluciones…) verás arriba a la izquierda un botón ☰. Ábrelo para desplegar un menú lateral que te deja saltar directo a otro módulo sin tener que volver al tablero ni al acceso a módulos.

• El menú lista: Panel de jornada, Recolecciones, Ruta, Entregas e Intentos y devoluciones, y marca en cuál estás.
• Abajo tiene un acceso a «Acceso a módulos» (la pantalla de inicio).
• Cambiar de módulo con este menú no cierra tu jornada.

4.5 Nombre del operador visible Nuevo

5 · Módulo Recolecciones

Recolectar = ir a un domicilio del cliente remitente y recoger los paquetes que van a enviarse. Cada tanda de paquetes de un cliente viene agrupada en un manifiesto de recolección (con su folio).

5.1 Pestaña «Asignadas»

Lista los manifiestos de recolección asignados a tu vehículo. Cada tarjeta muestra folio, cliente, número de guías, peso total, fecha de creación e instrucciones especiales (si las hay). Con tres botones:

5.2 Pestaña «Capturar»: auto-asignarte una recolección

Si una recolección todavía no está en tu lista, puedes tomarla tú mismo:

1. Entra a la pestaña Capturar.
2. Escribe el folio del manifiesto, o escanea su código de barras (el folio va codificado en el papel del manifiesto).
3. La recolección queda asignada a ti y a tu vehículo, y aparece en «Asignadas».

5.3 Escanear paquetes (recolectar)

El escáner es el corazón del trabajo. Tiene dos modos: entrada (teclear o usar una pistola lectora) y cámara.

1. Pulsa Escanear en el manifiesto.
2. Apunta la cámara al código del paquete (o teclea el código). El tipo de código —QR o código de barras— lo define la configuración de la empresa.
3. Cada captura válida suena un pitido y marca la guía como recolectada.
4. Repite con todos los paquetes del manifiesto.

5.4 Cuando un paquete no se puede recoger

a) «No recolectar» una guía

Si un paquete de la lista no existe, no está listo o el cliente lo canceló, márcalo como no recolectado. El sistema registra ese estado para que no quede como pendiente eterno.

b) «Reportar problema» (incidencia con evidencia)

Cuando hay una anomalía que la administración debe conocer (paquete dañado, mal embalado, dirección incorrecta, etc.):

1. Abre Reportar problema sobre la guía.
2. Escribe una descripción / observación clara del problema.
3. Adjunta hasta 3 fotos de evidencia (opcional pero muy recomendable).
4. Pulsa Reportar problema. Se registra el evento de incidencia en cada guía seleccionada.

5.5 Cerrar la recolección

Cerrar registra el evento «Manifiesto cerrado» y da por finalizada la recolección. Solo es posible cuando todas las guías ya fueron procesadas (recolectadas o marcadas como no recolectadas).

6 · Módulo Ruta (salida a entrega)

Los paquetes que ya están en el CEDIS se agrupan en manifiestos de ruta para salir a entregar. En este módulo capturas la salida a ruta y sigues el orden de paradas. La entrega en sí (con su evidencia) se registra en el módulo Entregas (cap. 7).

6.1 Pestaña «Asignadas»

Muestra los manifiestos de ruta con folio, nombre de ruta, CEDIS de origen, número de guías, peso y un indicador de progreso: Todas capturadas o N por capturar.

6.2 «Ruta (N)» — hoja de ruta y orden de paradas

El botón Ruta abre la hoja con los puntos de entrega únicos (por destino). Ahí puedes:

• Ver la secuencia de paradas ordenada.
• Reordenar las paradas para optimizar tu recorrido (si es tu ruta).
• Abrir cada dirección en el mapa con un toque.

6.3 Capturar la salida a ruta

1. Pulsa Capturar en el manifiesto de tu ruta.
2. Escanea cada guía que cargas al vehículo para salir. Cada captura registra su salida a ruta.
3. El contador «por capturar» baja hasta llegar a «Todas capturadas».

6.4 Cerrar el manifiesto de ruta

Al cerrar se registra «Manifiesto cerrado». Pon atención a las guías sin capturar:

6.5 De la ruta a la entrega

Una vez que saliste a ruta, al llegar a cada parada entregas los paquetes al consignatario y registras la entrega en el módulo Entregas (cap. 7), donde capturas quién recibe y la evidencia (firma o foto). Lo que no logres entregar se gestiona en Intentos y devoluciones (cap. 8) y, si aplica, queda como Por devolver a CEDIS para liquidarlo (cap. 11).

7 · Módulo Entregas — evidencia de entrega Nuevo

Este módulo es donde confirmas en el sistema que entregaste un paquete y capturas la evidencia de esa entrega: quién lo recibió y su firma electrónica o la foto de la guía firmada. Sustituye y amplía lo que antes era solo «marcar entregado».

7.1 Dos formas de entregar

Al abrir Entregas eliges cómo vas a capturar:

7.2 Entrega por guía (paso a paso)

1. En Entregas elige Por guía.
2. Escanea con la cámara o teclea la guía / código de rastreo del paquete a entregar. La app la busca y abre el formulario de evidencia.
3. Completa la evidencia de entrega ver formulario y pulsa Confirmar entrega.
4. Suena el pitido de éxito y la app vuelve al escaneo lista para el siguiente paquete.

7.3 Entrega por guía madre (paso a paso)

1. En Entregas elige Por guía madre.
2. Captura el folio de la guía madre y pulsa Buscar. La app lista sus guías relacionadas.
3. Escanea cada guía relacionada. La lista marca en verde las escaneadas y una barra muestra el avance (por ejemplo «7/12 escaneadas»).
4. Cuando terminaste, pulsa Confirmar entrega de N guías.
5. Completa la evidencia (incluida la ubicación de la entrega, obligatoria en guía madre) y confirma.

7.4 La evidencia de entrega (formulario)

Tanto por guía como por guía madre, la evidencia es la misma. Los campos con * son obligatorios cuando el evento confirma la entrega:

7.5 Qué queda registrado

Al confirmar, la guía registra su evento de entrega con: nombre de quien recibe, comentarios, firma o foto, fotos extra y —cuando fue posible— la ubicación. La entrega se refleja de inmediato en tu resumen de jornada (contador de Entregas y entregas por cliente) y el paquete sale del contador «Por entregar».

8 · Módulo Intentos y devoluciones Nuevo

No todo se entrega a la primera. Cuando el destinatario no está, rechaza el paquete o hay que devolverlo al remitente, este módulo deja constancia de lo ocurrido con su evidencia. Funciona igual que Entregas, pero registra intentos de entrega, rechazos y devoluciones en vez de una entrega confirmada.

8.1 Cuándo usarlo

• Intento de entrega: fuiste al domicilio pero no se pudo entregar (nadie, cerrado, dirección no localizada…).
• Rechazo: el destinatario no quiso recibir el paquete.
• Devolución al remitente: el paquete regresa a quien lo envió.

Los eventos exactos disponibles los define tu operación; la app te muestra los que aplican al elegir el evento a registrar.

8.2 Cómo registrar

Es el mismo flujo del módulo Entregas, con Por guía y Por guía madre:

1. Abre Intentos y devoluciones y elige Por guía o Por guía madre.
2. Escanea la(s) guía(s) del paquete.
3. Elige el evento a registrar (intento, rechazo, devolución…).
4. Captura la evidencia: en este módulo la foto se etiqueta como «Foto de evidencia». El nombre de quien recibe solo es obligatorio si el evento confirma una entrega.
5. Pulsa Registrar evento.

9 · Mis paquetes — inventario de tu jornada Nuevo

Antes decía «Próximamente»; ya está habilitado. «Mis paquetes» es el inventario completo de guías de tu jornada: qué traes, en qué estado está cada una y dónde. Es tu lista de verificación para saber qué te falta liquidar. ver pantalla

9.1 Qué muestra

• Una lista de guías. Cada fila trae un punto de color (según su estado), el folio y el código de rastreo, y una etiqueta del grupo al que pertenece.
• Toca una fila para expandirla y ver: remitente, destinatario, destino, evento actual y vehículo.

9.2 Buscar y filtrar

• Buscador: escribe un número de guía o código de rastreo para encontrar un paquete al instante.
• Pastillas por estado: filtra por grupo con un toque. Cada pastilla trae su conteo:

Para no saturar el teléfono, la lista se muestra por bloques; usa «Ver más» para cargar el resto.

9.3 La sección «Otros»

10 · Módulo Almacén — Ingreso a CEDIS

Este modo registra que las guías llegaron físicamente al centro de distribución. Es independiente del vehículo y la ruta: puedes usarlo aunque no tengas jornada de ruta abierta.

10.1 Cómo registrar ingresos

1. Desde el selector de modo elige 🏬 Almacén — Ingreso a CEDIS.
2. Selecciona el CEDIS donde ingresarán las guías. La lista muestra únicamente los CEDIS habilitados para tu usuario.
3. Escanea el código de rastreo de cada guía que entra. Cada escaneo registra el evento «Ingresó a CEDIS».
4. Consulta «Mostrar mi historial» para revisar lo que llevas escaneado.

10.2 Por qué importa este paso

El ingreso a CEDIS es la «puerta de entrada» al almacén: sin él, una guía no puede asignarse a un manifiesto de ruta para salir a entregar. Si una guía no se escanea al llegar, quedará atascada en un estado anterior y nadie podrá programar su entrega. Además, es la misma acción con la que liquidas tanto lo recolectado como lo que traes por devolver (cap. 11).

11 · Liquidación y cierre de jornada

11.1 Terminar jornada

Al pulsar Terminar jornada, la app registra la hora y ubicación de salida y te regresa al selector de modo.

11.2 El «candado de liquidación»

Aparecerá el aviso «No puedes terminar la jornada» con el desglose de lo que falta:

Lo que traes recolectado (pendiente de ingresar al CEDIS) también debe liquidarse escaneándolo en Almacén → Ingreso a CEDIS. El aviso enumera solo los pasos que aún te faltan, igual que la guía dinámica del tablero (cap. 4.2).

Una vez que todos los contadores llegan a cero, el botón Terminar jornada funciona y cierras el turno.

12 · Trabajo sin conexión y sincronización

En campo la señal falla. Opera (web) está pensada para seguir funcionando sin internet y subir todo cuando vuelva la conexión.

12.1 Qué pasa sin señal

• Aparece un banner ámbar: «Sin conexión — los escaneos se sincronizarán al reconectarse».
• Puedes seguir escaneando: cada captura se guarda en la memoria del teléfono (cola local).
• El avance de una guía madre en Entregas/Devoluciones también se guarda y se puede reanudar (cap. 7.3).
• Las listas muestran los datos guardados de la última vez que hubo conexión.

12.2 Qué pasa al reconectarse

• Aparece un banner azul indicando cuántos escaneos hay pendientes de sincronizar.
• La app los sube automáticamente (verás «Sincronizando N escaneos…»). También puedes tocar el aviso para forzar la sincronización.
• Cuando el servidor confirma, los registros quedan como sincronizados.

13 · Ubicación / GPS del operador

El tablero muestra el estado de tu ubicación. El sistema la usa para registrar dónde inicias/terminas jornada, desde dónde recolectas y dónde entregas. La geolocalización es la del navegador (no depende de ninguna app de mapas externa).

14 · Glosario de estados y eventos

Estas son las palabras que verás en la app y en el historial de cada guía.

14.1 Conceptos

14.2 Eventos de una guía (su historial)

Los nombres exactos de los eventos de entrega, intento, rechazo y devolución dependen de la configuración de tu empresa; la app te muestra los que aplican al capturar.

14.3 Estados de un manifiesto

15 · Casos de uso paso a paso

16 · Preguntas clave (FAQ)

17 · Solución de problemas y buenas prácticas

17.1 Si algo falla

17.2 Buenas prácticas del operador

• Verifica que la sesión sea la tuya (tu nombre arriba) antes de empezar a escanear.
• Escanea en el momento en que ocurre cada acción (recoges, cargas, entregas, devuelves). No lo dejes «para después».
• Captura la evidencia completa en cada entrega: nombre, firma o foto y, si puedes, ubicación.
• Registra también lo que no se entregó (intentos, rechazos, devoluciones): deja constancia.
• Cierra en cero. No termines la jornada con pendientes; liquida todo.
• Foto ante la duda. Cualquier anomalía, repórtala con evidencia.
• GPS siempre encendido durante el turno.
• Espera la sincronización antes de apagar el teléfono.
• Revisa las instrucciones del manifiesto (nota ámbar) antes de operar.
• Confirma la ruta correcta al iniciar jornada: define qué manifiestos puedes capturar.
• Batería. Lleva el teléfono cargado o un cargador; la app, el GPS y la cámara consumen energía.

B1 · Introducción: qué es el Portal de clientes

El Portal de clientes es la aplicación web con la que tú —el cliente remitente— operas tus envíos por tu cuenta: generas guías, les das seguimiento, pides recolecciones, das de alta a tus destinatarios y controlas a los usuarios de tu empresa que pueden usar el portal.

B1.1 ¿Para quién es?

El portal es para las cuentas de cliente de la paquetería: la empresa o persona que envía paquetes. Una cuenta puede tener varios usuarios (por ejemplo, distintas personas de tu área de logística), todos trabajando sobre la misma información.

B1.2 Qué puedes hacer

B2 · Acceso: iniciar sesión y entrar al portal

B2.1 Cómo entras

1. Abre el enlace del sistema que te compartió la paquetería.
2. Escribe tu correo electrónico y tu contraseña y pulsa Entrar.
3. Como tu usuario es de tipo cliente, el sistema te lleva directo al Portal de clientes. No tienes que buscar ninguna dirección.

B2.2 El menú del portal

A la izquierda tienes el menú lateral con todas las secciones: Inicio, Guías, Recolecciones, Consignatarios, Usuarios y Mi cuenta. Arriba aparece el nombre de tu empresa. En pantallas chicas el menú se abre con el botón ☰; en la computadora puedes colapsarlo para ganar espacio. Abajo del menú está Cerrar sesión.

B3 · Inicio del portal

Es la primera pantalla al entrar. Te saluda por tu nombre y te da una foto rápida de tu cuenta con tarjetas de resumen y accesos rápidos.

B3.1 Tarjetas de resumen

Cada tarjeta es un atajo: al tocarla te lleva a la sección correspondiente. Abajo, «Accesos rápidos» repite los enlaces a Guías, Recolecciones, Consignatarios, Usuarios y Mi cuenta.

B4 · Consignatarios y destinos

Un consignatario es un destinatario tuyo (a quién le envías), y cada consignatario tiene una o más direcciones de entrega (destinos). Este directorio es la base de tus envíos: al crear una guía elegirás a qué consignatario y a cuál de sus direcciones va.

B4.1 La lista de destinos

La tabla muestra una fila por dirección, con el consignatario, el nombre del destino, la dirección, si es una dirección propia del cliente y su estatus (activo/inactivo). Arriba tienes filtros por búsqueda, consignatario, estatus y dirección propia.

B4.2 Crear un consignatario

1. Pulsa Nuevo consignatario.
2. Escribe el nombre del consignatario y su estatus (Activo por defecto).
3. Elige el tipo de entrega:
   • Dirección de entrega — se entrega en el domicilio. Escribe el código postal, elige la colonia (el portal la busca por el CP), y completa calle y número exterior (interior es opcional).
   • Recolección en CEDIS (OCURRE) — el destinatario recoge el paquete en una sucursal. Elige el CEDIS en el selector; la dirección se toma sola del CEDIS y la ruta será «OCURRE + nombre del CEDIS».
4. Pulsa Crear consignatario.

B5 · Crear una guía

Una guía es la orden de envío de un paquete (o de un grupo de paquetes). En el portal la creas en dos momentos: primero como borrador y luego la activas para que reciba su folio y su código de rastreo.

B5.1 Abrir el formulario

Entra a Guías y pulsa Nueva guía. El formulario tiene tres bloques: Datos del envío (remitente y destinatario), Logística y Paquetes.

B5.2 Remitente y destinatario

B5.3 Logística

B5.4 Paquetes

Agrega uno o varios paquetes. De cada uno capturas:

• Embalaje (obligatorio; si eliges «Otro», descríbelo).
• Medidas (largo, ancho, alto en cm), peso real (kg), valor declarado y contenido.
• Replicar: repite ese mismo paquete varias veces sin recapturarlo.

El portal calcula solo el peso volumétrico (a partir de las medidas) y el peso facturable (el mayor entre el real y el volumétrico). El total de paquetes de una guía no puede pasar de 100.

B5.5 Guardar y activar

Al pulsar Guardar, la guía se crea como Borrador: ya existe, pero todavía no tiene folio. Para ponerla en marcha hay que activarla:

1. En la lista de guías, en la del borrador, pulsa Activar (o entra a su detalle y pulsa Activar guía).
2. Si la guía no tiene lote elegido, el portal te pide elegir uno: de ese lote sale el folio.
3. Al activar, la guía toma su folio y su código de rastreo y queda documentada, lista para recolectarse y viajar.

B6 · Guía madre y envíos múltiples

Cuando envías varios paquetes al mismo destino, conviene agruparlos bajo una guía madre: un folio «paraguas» que reúne varias guías relacionadas y permite moverlas y entregarlas juntas.

B6.1 Cómo se crea

En el formulario de Nueva guía, pon en Cantidad de guías un número 2 o mayor. El portal crea esa cantidad de guías idénticas (mismo destino y paquetes) y las agrupa automáticamente bajo una Guía Madre con su propio código (por ejemplo, GM-0456).

B6.2 Cómo la reconoces

• En la lista de guías, la columna Guía Madre muestra el código que agrupa a cada guía.
• Puedes filtrar por guía madre para ver todas las guías de un mismo grupo.

B7 · Rastrear tus guías

La sección Guías es tu tablero de seguimiento: qué tienes, en qué estado va cada envío y todo su historial. ver pantalla

B7.1 La lista

Cada fila es una guía, con: folio, código de rastreo, guía madre (si aplica), consignatario, destino, ruta, evento actual, fecha de creación y fecha estimada de entrega. Toca una fila para abrir su detalle.

B7.2 Buscar y filtrar

Arriba tienes filtros para encontrar justo lo que buscas:

• Buscar por folio, destino o código de rastreo.
• Filtrar por consignatario, destino, guía madre o rango de fechas.
• Pegar varios folios o códigos de rastreo (uno por línea) para buscarlos en bloque.
• Filtrar por categoría de evento y por evento específico (creación, tránsito, entrega, etc.).

B7.3 El detalle de una guía

Al abrir una guía ves toda su ficha:

• Datos generales: destino, consignatario, dirección, referencia y observaciones.
• Logística: código de rastreo, guía madre y fecha de creación.
• Paquetes y totales (peso real y valor declarado).
• Historial de eventos: la línea de tiempo de todo lo que le ha pasado a la guía, con fecha y hora.

B8 · Imprimir, duplicar y cancelar guías

Desde la lista de guías (columna Acciones) o desde el detalle tienes las operaciones del día a día sobre cada guía.

B8.1 Imprimir la etiqueta

1. Pulsa Imprimir en la guía.
2. Elige el formato disponible (según la plantilla de tu paquetería; por ejemplo, etiqueta térmica o carta).
3. Se abre el visor con la etiqueta lista para imprimir o guardar como PDF.

Si una guía tiene varios paquetes, se genera una etiqueta por paquete.

B8.2 Duplicar

Duplicar crea una copia como borrador de una guía existente, con los mismos datos. Sirve para repetir un envío parecido sin capturarlo de nuevo; la copia entra como borrador para que la ajustes y actives cuando quieras.

B8.3 Cancelar

1. Pulsa Cancelar en la guía.
2. Escribe el motivo de la cancelación (obligatorio).
3. Confirma. La guía queda Cancelada.

B9 · Recolecciones

Una recolección es tu solicitud para que la paquetería pase a recoger los paquetes de tus guías. Tú eliges qué guías incluir; la paquetería asigna al chofer y al vehículo.

B9.1 Crear una recolección

1. Entra a Recolecciones y pulsa Nueva recolección.
2. Marca las guías disponibles que quieres que recojan. Solo aparecen las guías documentadas (ya activas), aún no recolectadas.
3. Agrega instrucciones si hace falta (horario, referencias del domicilio, etc.).
4. Pulsa Crear recolección. Se genera con su folio (por ejemplo, REC-000001).

B9.2 Seguir una recolección

La lista muestra folio, número de guías, peso total, último evento y fecha. Toca una para abrir su detalle (solo lectura), donde ves:

• El operador y el vehículo asignados (los asigna la paquetería).
• La pestaña Guías con las guías incluidas y su estado, y la pestaña Historial con los eventos del manifiesto.

También puedes imprimir el comprobante de la recolección, y saltar a la sección de guías filtrada por esa recolección con el número de guías.

B10 · Usuarios de la cuenta

Tu cuenta puede tener varios usuarios. La sección Usuarios es donde el titular los administra. Los demás usuarios pueden ver la lista, pero no modificarla.

B10.1 Crear un usuario

1. Pulsa Nuevo usuario.
2. Captura nombre, apellidos, correo electrónico y una contraseña (mínimo 6 caracteres).
3. Pulsa Crear usuario. Ya puede entrar al portal con ese correo y contraseña.

B10.2 Administrar usuarios existentes

B11 · Mi cuenta

Aquí ves los datos de tu cuenta y de tu perfil, y puedes cambiar tu contraseña.

B11.1 Datos de la cuenta y perfil

• Datos de la cuenta: nombre/razón social, tipo de persona, RFC, alias, correo y estatus. Los administra la paquetería.
• Mi perfil: tu nombre, apellidos y correo. También los gestiona la paquetería (o el titular); tú solo puedes cambiar tu contraseña.

B11.2 Cambiar mi contraseña

1. Escribe la nueva contraseña (mínimo 6 caracteres) y confírmala.
2. Pulsa Actualizar contraseña.

B12 · Glosario y conceptos clave

Estas son las palabras que verás en el portal.

B12.1 Conceptos

B12.2 Estados de una guía

B13 · Preguntas frecuentes (FAQ)

B14 · Solución de problemas y buenas prácticas

B14.1 Si algo falla

B14.2 Buenas prácticas del cliente

• Mantén tu directorio al día: consignatarios y direcciones correctas evitan problemas de cobertura y entrega.
• Revisa la cobertura antes de terminar la guía: el indicador verde te confirma que el destino se puede atender.
• Activa tus guías antes de solicitar la recolección; una guía en borrador no se recolecta.
• Usa la referencia interna para cruzar tus guías con tus pedidos.
• Agrupa con guía madre cuando envíes varios paquetes al mismo destino.
• Un usuario por persona: si varios usan el portal, que cada quien tenga su propio acceso.

C1 · Introducción y acceso al panel

El panel de administración es la herramienta de escritorio con la que la paquetería gestiona todo el sistema: la geografía y las coberturas, las rutas y los CEDIS, las guías y sus manifiestos, los clientes y sus usuarios, la flota, las plantillas y la configuración general. Mientras el chofer opera en campo (Parte A) y el cliente trabaja en su portal (Parte B), el administrador es quien configura y supervisa la operación completa.

C1.1 Quién entra al panel

El panel es para el personal interno. Al iniciar sesión, el sistema decide a dónde te lleva según tu rol:

• Rol interno (administrador, atención a clientes, almacén…) → entra al panel de administración.
• Cliente → va a su portal; no puede abrir el panel.
• Operador de ruta → entra directo a Opera (web), la app de campo.

C1.2 El menú del panel

A la izquierda está el menú lateral, organizado en grupos. Puedes colapsarlo para ganar espacio (se recuerda tu preferencia); en móvil se abre con el botón ☰. Abajo está Cerrar sesión.

C2 · Dashboard (Inicio)

Es la pantalla de arranque. Resume el estado del sistema con indicadores (KPIs) y gráficas, y ofrece pestañas para ver distintos tableros.

C2.1 Pestañas del dashboard

C2.2 El tablero de coberturas

• KPIs: total de asentamientos, con cobertura, sin cobertura, estados con cobertura y municipios con cobertura.
• Coberturas por día de la semana: cuántos asentamientos están programados cada día, y cuántos están sin frecuencia.
• Mapa de la República: intensidad de color por la cobertura de cada estado.
• Tablas por estado y por municipio: con búsqueda y el filtro «solo con cobertura». Los números «Con» y «Sin» son enlaces que te llevan al módulo de Coberturas ya filtrado.

C3 · Geografía — Catálogo de asentamientos y CPs

El catálogo geográfico es la base de todo: asentamientos (colonias), códigos postales, municipios y estados. Guías, destinos y coberturas se apoyan en él.

C3.1 Qué contiene

• Una tabla enorme de asentamientos con su código postal, municipio y estado.
• Buscador y filtros para ubicar cualquier colonia o CP.

C4 · Distribución — Rutas

Las rutas de distribución son las zonas de reparto. A cada ruta se le asignan asentamientos (su cobertura) y una frecuencia por día de la semana. El operador inicia su jornada eligiendo una ruta.

C4.1 Gestionar rutas

1. Pulsa Nueva ruta.
2. Captura su nombre y descripción, y los días de la semana en que opera (frecuencia).
3. Guarda. La ruta queda disponible para asignarle coberturas y para las jornadas.

Desde la tabla puedes buscar, editar y activar/desactivar rutas.

C5 · Distribución — CEDIS

Los CEDIS (centros de distribución / almacenes) son los puntos por donde pasan las guías. El ingreso a CEDIS es un evento clave del flujo del paquete.

C5.1 Catálogo de CEDIS

• Registra cada CEDIS con su alias, dirección y datos. Puedes adjuntar la foto de la bodega.
• Los CEDIS son la base de los permisos por CEDIS de los usuarios (C19) y de la modalidad OCURRE de los destinatarios (C15).

C6 · Distribución — Coberturas

Aquí se asignan asentamientos a rutas. Un asentamiento «con cobertura» es uno que ya pertenece a alguna ruta; sin esa asignación, no se puede enviar a ese destino.

C6.1 Asignar cobertura

1. Filtra por estado, municipio o por «sin cobertura» para ver qué falta.
2. Selecciona los asentamientos y asígnalos a una ruta.
3. Define su frecuencia (días) si aplica. Para quitar cobertura, usa Quitar de la ruta.

Puedes descargar la cobertura filtrada. El dashboard (C2) enlaza directo a esta pantalla ya filtrada por el área que elijas.

C7 · Distribución — Inventarios

La bitácora de entradas y salidas de guías en los CEDIS. Es la trazabilidad física de qué guías están dónde.

• Registra movimientos de guías (entradas/salidas) y consulta el histórico.
• Permite acciones masivas sobre varias guías seleccionadas y agregar un nuevo movimiento.

C8 · Distribución — Opera (web)

Desde el menú, la opción Opera (web) abre la app de campo del operador en una pestaña nueva. Sirve para que el personal interno con permiso pueda apoyar en tareas de campo o almacén sin cambiar de cuenta.

C9 · Operación — Guías de Envío

El registro y seguimiento de todas las órdenes de paquetería. Es la versión administrativa —y más completa— de lo que el cliente ve en su portal: aquí el administrador crea, documenta, agrupa, imprime, reasigna y cancela guías de cualquier cliente.

C9.1 Crear y documentar

El alta es igual a la del portal (remitente, destinatario, logística y paquetes), pero el administrador elige el cliente. La guía nace como Borrador y se pone en marcha al Confirmar (documentar): toma su folio (de un lote, C16) y su código de rastreo.

C9.2 Acciones sobre una guía

La tabla tiene filtros potentes: por cliente, consignatario, destino, folio, código de rastreo, guía madre, fechas, categoría de evento y evento. Incluye acciones masivas (por ejemplo, cancelar varias).

C10 · Operación — Manifiestos de Recolección

Los manifiestos de recolección agrupan las guías que se van a recoger de un cliente. Aquí el administrador los crea o revisa los que llegan del portal, y les asigna operador y vehículo.

C10.1 Gestionar recolecciones

• Nuevo manifiesto de recolección: elige las guías documentadas a recoger e instrucciones.
• Asignar / modificar el operador y el vehículo que harán la recolección.
• Asignar evento a guías, cerrar o cancelar el manifiesto, e imprimir el formato de embarque.
• Ver la ubicación del operador en el mapa y saltar a las guías del manifiesto.

C11 · Operación — Manifiestos de Ruta

Los manifiestos de ruta agrupan las guías que salen del CEDIS a entregarse. Definen qué lleva cada operador y en qué orden.

C11.1 Flujo del manifiesto

1. Nuevo manifiesto de ruta: agrupa las guías a repartir.
2. Asignar / modificar operador y vehículo, y reordenar las paradas (arrastrando).
3. Dar salida a los paquetes: registra la salida a ruta de las guías del manifiesto.
4. Cerrar el manifiesto cuando termina.

La captura en campo de esa salida y de las entregas la hace el operador en Opera (web) (Parte A, caps. 6 y 7).

C12 · Operación — Jornadas de Operador

El registro de las jornadas de los operadores: inicio, fin y ubicación de cada turno de trabajo.

• Consulta qué operador trabajó, con qué vehículo y ruta, a qué hora inició y terminó, y su ubicación de arranque y cierre.
• Es la vista de supervisión de la actividad en campo.

C13 · Operación — Liquidaciones

Muestra los paquetes asignados que siguen pendientes por operador: lo que cada operador aún debe entregar o devolver para «cerrar en cero».

• Ve, por operador, cuántas guías quedan pendientes y de qué tipo.
• Salta a esas guías en el módulo de Guías e imprime el manifiesto de liquidación.

C14 · Administración — Clientes

La gestión de clientes: las empresas o personas que envían paquetes. Aquí se dan de alta, se registran sus contactos y su dirección operativa, y se habilita su acceso al portal.

C14.1 Crear y administrar clientes

1. Nuevo cliente: captura razón social, tipo de persona (física/moral), RFC, alias y su dirección operativa.
2. Registra sus contactos.
3. Restablece la contraseña de acceso cuando el cliente lo necesite.

C14.2 La aplicación del cliente — activar la API Nuevo

Cada cliente puede tener una aplicación: la vía para que otro sistema del cliente (su tienda en línea, su ERP, etc.) cree guías directamente por API, sin capturarlas a mano. Aquí solo se explica qué es y cómo habilitarla; el funcionamiento técnico (cómo se conecta y qué hace ese otro sistema) está en el apartado Herramientas para el desarrollador.

En la tabla de Clientes, el botón «Aplicación» abre el panel para gestionar sus API keys (las llaves de acceso que autentican a ese sistema externo):

1. Estado: la aplicación aparece como Habilitada cuando el cliente tiene al menos una API key activa, o Deshabilitada si no tiene ninguna.
2. Generar una key: escribe un nombre que la identifique (p. ej. «Tienda web») y pulsa Generar. El token se muestra una sola vez —tiene la forma pqx_live_…— con un botón para copiarlo. Cópialo y entrégaselo a quien hará la integración: el sistema solo guarda su huella (hash), nunca el token completo, así que no se puede volver a ver.
3. Revisar: cada key del listado muestra su nombre, su estado (Activa / Revocada), su prefijo, la fecha de creación y su último uso (o «sin uso»).
4. Revocar: el botón Revocar desactiva la key de inmediato; el sistema externo que la use pierde el acceso al instante. Un cliente puede tener varias keys y revocar solo la que quieras.

C15 · Administración — Consignatarios y Destinatarios

El directorio de destinatarios por cliente y sus direcciones. Es la versión administrativa del directorio que cada cliente ve en su portal.

• Consulta y administra los consignatarios de cada cliente y sus destinos (direcciones o modalidad OCURRE en CEDIS).
• Importa destinatarios desde un CSV (hay una plantilla descargable) y descarga los destinatarios filtrados.

C16 · Administración — Lotes de Guías

Los lotes son rangos numéricos reservados por cliente. De un lote sale el folio de cada guía al documentarla.

C16.1 Crear un lote

1. Pulsa Nuevo lote y elige el cliente.
2. Define el rango (inicio y fin). El sistema calcula los folios disponibles.
3. Actívalo. Al documentar una guía de ese cliente, el folio se toma de aquí.

C17 · Administración — Plantillas de Guías

Define el diseño de la etiqueta que se imprime para cada guía. Eliges un formato y lo configuras.

• Selecciona un diseño y ajusta sus opciones (tamaño de papel y formato de etiqueta).
• Esta plantilla es la que se usa al imprimir guías, tanto en el panel como en el portal del cliente.

C18 · Administración — Vehículos

El catálogo de unidades de auto transporte: la flota con la que se recolecta y se reparte.

• Registra cada vehículo por placa y número económico, y actívalo/desactívalo.
• Los vehículos activos son los que el operador puede elegir al iniciar su jornada y los que se asignan a manifiestos de recolección y de ruta.

C19 · Administración — Usuarios y permisos de CEDIS

La gestión de accesos y roles del personal interno. Aquí se crean los usuarios del sistema, se les asigna rol y —según el rol— sus permisos por CEDIS.

C19.1 Crear un usuario

1. Nuevo usuario: captura nombre, apellidos, correo, contraseña inicial y rol.
2. Si el rol es Operador de Ruta (o un administrador que también opere), captura sus datos de operador (por ejemplo, su zona geográfica).
3. Guarda. El usuario ya puede iniciar sesión con su correo y contraseña.

Desde la tabla puedes editar, filtrar por rol, y restablecer la contraseña («Nueva contraseña»).

C19.2 Permisos por CEDIS

Para los roles de almacén (almacenista, auxiliar, supervisor y atención a clientes/administrador), defines a qué CEDIS tiene acceso y con qué nivel:

C20 · Administración — Configuración general

Personaliza la apariencia e identidad del sistema. Lo que ajustes aquí se refleja en el panel, en el portal del cliente y en Opera (web).

C20.1 Identidad y color

C20.2 Folios — proyección y avances Nuevo

Este apartado muestra, por cada tipo de código (recolección, ruta, guía madre y guía), cómo va el consumo de folios. Cada tipo usa un código con un prefijo y un cuerpo aleatorio; la longitud crece automáticamente cuando los emitidos alcanzan el 60 % de las combinaciones posibles, para no quedarse nunca sin folios disponibles.

C21 · Glosario y buenas prácticas

C21.1 Conceptos del panel

C21.2 Buenas prácticas del administrador

• Primero la geografía y la cobertura: sin asentamientos asignados a rutas, los clientes no pueden enviar.
• Habilita lotes a tiempo: un cliente sin folios disponibles no puede activar guías.
• Asigna operador y vehículo a cada manifiesto antes de la operación del día.
• Vigila las liquidaciones: ningún operador debe quedarse con pendientes sin resolver.
• Cuida los permisos por CEDIS: da «manipular» solo a quien deba operar; «ver» para consulta.
• Mantén la configuración (nombre, logo, color) al día para una imagen consistente en los tres perfiles.

D1 · Qué es la API y qué permite hacer

Este apartado es para quien programa la integración: la persona o el equipo que conecta el sistema del cliente (su tienda en línea, su ERP o cualquier software propio) con la paquetería. Aquí se explica qué es, cómo funciona y cómo se usa, en lenguaje sencillo y también técnico.

D1.1 En palabras sencillas

Una API es una «ventanilla» automática de la plataforma: en vez de que una persona entre al portal y capture una guía a mano, el sistema del cliente lo hace directamente, de computadora a computadora. Con ella ese sistema puede crear guías y consultar el detalle de una guía (para rastrearla).

El caso típico: una tienda en línea recibe un pedido y, sin intervención humana, genera la guía de envío, obtiene su folio y su código de rastreo, y más tarde consulta ese código para mostrarle al comprador en qué va su envío.

D1.2 En términos técnicos

La API es un servicio HTTP tipo REST sobre el mismo endpoint /api/externa/guias, autenticado con una API key (un token secreto por cliente). Tiene dos operaciones:

• POST con cuerpo JSON → crea una guía (y opcionalmente la activa, devolviendo folio y código de rastreo). Ver D4.
• GET con un parámetro de búsqueda → consulta el detalle completo de una guía, incluido su historial de eventos. Ver D5.

D2 · Antes de empezar: activar la función

La API no se activa desde aquí. Se habilita por cliente desde el panel de administración, generando una API key. Sin una key activa, todas las peticiones se rechazan.

D2.1 Dónde se activa

Un administrador la habilita en el portal del administrador → módulo Clientes → botón «Aplicación». El paso a paso (generar, copiar y revocar keys) está documentado en C14.2 · La aplicación del cliente.

1. El administrador genera la API key del cliente y copia el token (pqx_live_…), que se muestra una sola vez.
2. Ese token se le entrega, por un canal seguro, a quien hará la integración.
3. El sistema externo guarda el token y lo envía en cada petición (D3).

D3 · Autenticación

Cada petición debe llevar la API key en una cabecera HTTP. Se acepta cualquiera de estas dos formas:

Authorization: Bearer pqx_live_xxxxxxxx...

x-api-key: pqx_live_xxxxxxxx...

D4 · Crear una guía

Una sola petición crea la guía. Puedes dejarla como Borrador o activarla en la misma llamada para obtener de inmediato su folio y código de rastreo.

Petición: POST /api/externa/guias · Cabecera: Content-Type: application/json

D4.1 Campos del cuerpo (JSON)

D4.2 Ejemplo — crear y activar

curl -X POST https://TU-DOMINIO/api/externa/guias \
  -H "Authorization: Bearer pqx_live_xxxxxxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "destino_id": 789,
    "lote_id": 42,
    "referencia_interna": "PEDIDO-1001",
    "activar": true,
    "paquetes": [
      { "tipo_embalaje": "CAJA", "peso_real_kg": 2.5, "contenido": "Ropa" }
    ]
  }'

D4.3 Respuestas del POST

Creada y activada (201):

{ "ok": true, "id": 1234, "estado": "Confirmada",
  "folio": "A0001", "ruta_nombre": "RUTA CENTRO",
  "codigo_rastreo": "G7F3K9Q2" }

Creada como borrador (201):

{ "ok": true, "id": 1234, "estado": "Borrador",
  "folio": null, "codigo_rastreo": null }

Fallo al activar — la guía queda como borrador y se puede reintentar (400):

{ "ok": false, "id": 1234, "estado": "Borrador",
  "error": "La guía no tiene un lote seleccionado. Elige un lote antes de activar." }

D5 · Consultar y rastrear una guía Nuevo

Devuelve el detalle completo de una guía —lo mismo que muestra el módulo de guías al abrirla, incluido su historial de eventos—. Es la base para una página de rastreo propia del cliente.

Petición: GET /api/externa/guias, autenticada con la API key. Se busca por uno de estos parámetros:

Ejemplo:

curl "https://TU-DOMINIO/api/externa/guias?codigo_rastreo=G7F3K9Q2" \
  -H "Authorization: Bearer pqx_live_xxxxxxxx..."

Respuesta (200) — resumen del objeto guia:

{ "ok": true, "guia": {
  "id": 1234, "estado": "Confirmada", "folio": "A0001",
  "codigo_rastreo": "G7F3K9Q2", "referencia_interna": "PEDIDO-1001",
  "clientes": { … }, "consignatarios": { … }, "destinos": { … },
  "rutas": { "nombre_ruta": "RUTA CENTRO" },
  "guia_paquetes": [ { "numero_paquete": 1, "peso_real_kg": 2.5, "contenido": "Ropa" } ],
  "guia_historial": [
    { "estado_nuevo": "Borrador",   "created_at": "…", "catalogo_eventos_guia": { "nombre": "Borrador" } },
    { "estado_nuevo": "Confirmada", "created_at": "…", "catalogo_eventos_guia": { "nombre": "Documentado" } }
  ] } }

D6 · Límites de uso y condiciones Nuevo

La API tiene límites de solicitudes para protegerse de abuso. Una integración normal no los alcanza; una que dispara demasiadas peticiones recibe 429 y debe reintentar más tarde.

D6.1 Límites aplicados

D6.2 Condiciones de uso

• Solo por HTTPS. Nunca envíes la API key por un canal sin cifrar.
• La key es secreta y por cliente. No la compartas ni la incrustes en apps móviles o JavaScript de navegador; guárdala en el servidor del integrador.
• Un uso, un cliente. Cada key opera únicamente sobre las guías de su cliente.
• Sin garantía de disponibilidad. El servicio puede limitar, suspender o bloquear el acceso ante uso abusivo, sin previo aviso.

D7 · Buenas prácticas y seguridad

• Guarda el token en el servidor (variables de entorno), nunca en el cliente/navegador ni en repositorios públicos.
• Maneja los errores por su código: un 400 al activar deja la guía como borrador; puedes corregir el dato (p. ej. el lote) y reintentar la activación sin recrearla.
• No mandes cliente ni consignatario: se deducen del destino. Asegúrate de que el destino_id pertenezca al cliente de la key para no recibir 403.
• Ten un lote con folios disponibles antes de activar (C16); sin folios, la activación falla con 400.
• Aplica backoff ante un 429: respeta la cabecera Retry-After y no reintentes en bucle, o tu IP puede quedar bloqueada (D6).
• Para rastrear, guarda el codigo_rastreo que devuelve la creación y consúltalo con el GET (D5); no consultes en un bucle constante, hazlo cuando el usuario abra la página de seguimiento.
• Rota las keys: si sospechas que un token se filtró, pide al administrador revocarlo y generar uno nuevo (C14.2).