Cómo Crear un Cadete
Guía completa para dar de alta repartidores en el sistema, configurar su información, vehículo y método de pago.
💡 Antes de comenzar: Solo los administradores pueden crear y gestionar cadetes. Asegúrate de tener permisos de administrador antes de continuar.
Inicio Rápido
- Ve a Panel Admin → Cadetes
- Haz clic en "Nuevo Cadete"
- Completa la información básica (nombre, teléfono, email)
- Configura el PIN de acceso (4 dígitos)
- Selecciona el tipo de vehículo
- Configura el método de pago (fijo, porcentaje o distancia)
- Asigna sucursales (opcional, para multi-sucursal)
- Haz clic en "Guardar"
Paso a Paso Detallado
1. Acceder al Módulo de Cadetes
Ruta: /[slug]/admin/cadetes
- Inicia sesión como administrador
- Ve al menú lateral y haz clic en "Cadetes"
- Verás la lista de cadetes existentes (si hay alguno)
- En la parte superior, encontrarás el botón "Nuevo Cadete"
2. Información Básica del Cadete
Al hacer clic en "Nuevo Cadete", se abrirá un formulario con los siguientes campos:
Campos Obligatorios
El nombre del repartidor. Se generará automáticamente un "slug" para la URL.
Número de contacto del cadete. Puede ser usado para WhatsApp.
Email del cadete (opcional). Puede usarse para notificaciones.
PIN de 4 dígitos para que el cadete acceda a su panel. Se guardará encriptado.
⚠️ Seguridad del PIN: El PIN se encripta automáticamente con bcrypt antes de guardarse en la base de datos. Nunca se almacena en texto plano. Entrega el PIN al cadete de forma segura.
3. Configuración del Vehículo
Configura el tipo de vehículo que usa el cadete para las entregas:
Moto (motorcycle)
Entregas rápidas en áreas urbanas. Puede evitar tráfico fácilmente.
Bicicleta (bicycle)
Ideal para distancias cortas y zonas peatonales. Ecológico.
Auto (car)
Para pedidos grandes o entregas a larga distancia.
A pie (walking)
Muy corta distancia, zonas peatonales o edificios cercanos.
Información Adicional del Vehículo
Registro del vehículo. Útil para motos y autos.
Fabricante del vehículo. Ej: "Honda", "Yamaha"
Modelo específico. Ej: "Wave 110", "Titan 150"
4. Configuración del Método de Pago
Define cómo se calculará el pago por cada entrega. Hay tres opciones:
💵 Pago Fijo por Entrega
El cadete recibe un monto fijo por cada entrega completada, sin importar el valor del pedido o la distancia.
Configuración:
Ejemplo: Si configuras $500, el cadete gana $500 por cada pedido entregado.
📊 Porcentaje del Pedido
El cadete recibe un porcentaje del valor total del pedido. Incentiva ventas altas.
Configuración:
Ejemplo: Pedido de $1000 con 10% → Cadete gana $100
Pedido de $2500 con 10% → Cadete gana $250
📍 Pago por Distancia
Pago base más un monto por kilómetro recorrido. Justo para entregas largas.
Configuración:
Fórmula: Tarifa Base + (Distancia × Por Km)
Ejemplo: Entrega a 5km → $300 + (5 × $50) = $550
💡 Tip: Puedes cambiar el método de pago de un cadete en cualquier momento editando su perfil. Los cambios aplicarán solo para entregas futuras, no afectan pedidos ya completados.
5. Asignación de Sucursales (Multi-Store)
Si tu negocio tiene múltiples sucursales, puedes configurar:
La sucursal principal donde trabaja habitualmente este cadete.
Lista de sucursales a las que puede atender. Puede ser una o varias.
⚠️ Nota: Si no asignas sucursales específicas, el cadete podrá atender pedidos de cualquier sucursal del tenant.
6. Estado del Cadete
Solo los cadetes activos pueden recibir pedidos y acceder a su panel. Puedes desactivar temporalmente un cadete sin eliminarlo del sistema.
7. Guardar el Cadete
- Revisa que todos los datos obligatorios estén completos
- Verifica que el PIN sea correcto (4 dígitos)
- Confirma la configuración de pago
- Haz clic en "Guardar" o "Crear Cadete"
- El sistema creará el cadete y lo agregará a la lista
✓ Confirmación: Una vez creado, verás una notificación de éxito y el cadete aparecerá en la lista principal.
Después de Crear el Cadete
Entregar Credenciales al Cadete
Proporciona al cadete la siguiente información:
- • URL de acceso:
https://tu-dominio.com/[slug]/cadete/[id-del-cadete] - • PIN de acceso: El PIN de 4 dígitos que configuraste
- • Instrucciones: Cómo usar el panel de cadete
Acceso al Panel del Cadete
El cadete podrá acceder a su panel usando el enlace específico:
/[slug]/cadete/[id-del-cadete]
Donde [id-del-cadete] es el ID único generado al crear el cadete.
Ejemplo: https://mirestaurante.com/mi-negocio/cadete/64a1b2c3d4e5f6g7h8i9j0
Funcionalidades del Panel del Cadete
Una vez que el cadete acceda, podrá:
- Ver pedidos asignados en tiempo real
- Marcar su estado como "online" u "offline"
- Ver detalles de cada pedido (cliente, dirección, total, items)
- Contactar al cliente por WhatsApp
- Confirmar entregas completadas
- Ver historial de entregas realizadas
- Ver sus ganancias acumuladas
Gestión Posterior
Editar Información del Cadete
Puedes modificar la información del cadete en cualquier momento:
- Ve a la lista de cadetes
- Haz clic en "Editar" en el cadete deseado
- Modifica los campos necesarios
- Guarda los cambios
⚠️ Cambio de PIN: Si cambias el PIN, el cadete deberá usar el nuevo PIN la próxima vez que inicie sesión. Infórmale del cambio.
Desactivar vs. Eliminar
Desactivar
- • Mantiene el historial
- • No puede recibir nuevos pedidos
- • Puede reactivarse después
- • Recomendado para ausencias temporales
Eliminar
- • Elimina el registro completamente
- • Pierde todo el historial
- • No se puede deshacer
- • Solo para casos permanentes
Problemas Comunes
❌ El slug se genera con caracteres raros
El sistema convierte automáticamente el nombre a un formato URL-friendly. Si el nombre tiene acentos o caracteres especiales, se normalizan (ej: "José" → "jose"). Esto es normal y no afecta la funcionalidad.
❌ Error: "Cadete con ese slug ya existe"
Ya existe un cadete con un nombre similar que genera el mismo slug. Agrega un apellido, número o diferenciador al nombre (ej: "Juan 2", "Juan Pérez").
❌ El cadete no puede acceder con su PIN
Verifica que: 1) El cadete esté activo, 2) El PIN sea correcto (4 dígitos), 3) Esté accediendo al enlace correcto con su ID.
❌ No aparecen sucursales para asignar
Esto ocurre si tu sistema no es multi-sucursal o no tienes sucursales creadas. En ese caso, el cadete trabajará para la sucursal principal automáticamente.
Mejores Prácticas
✅ PINs únicos: Asigna un PIN diferente a cada cadete para mantener la seguridad.
✅ Método de pago claro: Explica al cadete cómo se calcula su pago antes de comenzar.
✅ Información completa del vehículo: Registra patente y datos del vehículo para fines legales.
✅ Capacitación inicial: Muestra al cadete cómo usar el panel antes de su primera entrega.
✅ Desactiva en lugar de eliminar: Mantén el historial desactivando en lugar de borrar.
¿Te fue útil este artículo?