# US-MAI010-001: Configurar esquema de pago **ID:** US-MAI010-001 **Módulo:** MAI-010 (Liquidaciones) **Prioridad:** Alta **Story Points:** 5 --- ## Historia de Usuario **Como** administrador de operaciones **Quiero** configurar diferentes esquemas de pago para los operadores **Para** tener flexibilidad en la compensación según el tipo de servicio y operador --- ## Criterios de Aceptación ### CA-001: Crear esquema de pago **Dado** que necesito definir cómo pagar a un operador **Cuando** creo un esquema de pago **Entonces** puedo especificar: tipo (km, viaje, %), montos y condiciones ### CA-002: Esquema por kilómetro **Dado** que algunos operadores se pagan por km **Cuando** configuro este tipo **Entonces** defino la tarifa por km y el sistema usa km reales del tracking ### CA-003: Esquema por viaje **Dado** que algunos operadores se pagan monto fijo por viaje **Cuando** configuro este tipo **Entonces** defino el monto fijo que aplica por cada viaje completado ### CA-004: Esquema por porcentaje **Dado** que algunos operadores se pagan % del flete **Cuando** configuro este tipo **Entonces** defino el porcentaje y se calcula sobre el flete facturado ### CA-005: Asignar esquema a operador **Dado** que tengo esquemas definidos **Cuando** asigno a un operador **Entonces** sus futuros viajes se calculan con ese esquema ### CA-006: Esquemas predefinidos **Dado** que hay esquemas comunes **Cuando** necesito asignar rápido **Entonces** puedo elegir de una lista de esquemas predefinidos --- ## Mockup / UI ``` ┌─────────────────────────────────────────────────────────────────┐ │ ESQUEMAS DE PAGO [+ Nuevo]│ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ESQUEMAS DISPONIBLES │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ ESQ-001: Operador Estándar │ │ │ │ Tipo: Por kilómetro │ │ │ │ Tarifa: $2.50/km + Bono OTIF $500 │ │ │ │ Operadores asignados: 12 [Editar] │ │ │ ├─────────────────────────────────────────────────────────┤ │ │ │ ESQ-002: Operador Senior │ │ │ │ Tipo: Porcentaje del flete │ │ │ │ Tarifa: 25% + Bono OTIF $800 │ │ │ │ Operadores asignados: 5 [Editar] │ │ │ ├─────────────────────────────────────────────────────────┤ │ │ │ ESQ-003: Ruta Local │ │ │ │ Tipo: Por viaje fijo │ │ │ │ Tarifa: $1,500/viaje │ │ │ │ Operadores asignados: 8 [Editar] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Crear Esquema de Pago ``` ┌─────────────────────────────────────────────────────────────────┐ │ NUEVO ESQUEMA DE PAGO ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ INFORMACIÓN BÁSICA │ │ │ │ Código: [ESQ-004] │ │ Nombre: [Operador Premium ] │ │ Descripción: [Esquema para operadores con doble articulado ]│ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ TIPO DE CÁLCULO │ │ │ │ Tipo principal: │ │ ( ) Por kilómetro recorrido │ │ (●) Porcentaje del flete │ │ ( ) Monto fijo por viaje │ │ ( ) Mixto (base + variable) │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ CONFIGURACIÓN DEL PORCENTAJE │ │ │ │ Porcentaje sobre flete: [30] % │ │ Mínimo garantizado: [$1,000.00] (por viaje) │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ BONOS ADICIONALES │ │ │ │ ☑ Bono por entrega a tiempo (OTIF) │ │ Monto: [$800.00] │ │ │ │ ☑ Bono por sin incidencias │ │ Monto: [$300.00] │ │ │ │ ☐ Bono por combustible eficiente │ │ Monto: [$______] │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ CONDICIONES ESPECIALES │ │ │ │ ☑ Aplica solo para viajes de ruta larga (>300 km) │ │ ☐ Aplica solo para ciertos clientes │ │ │ │ [Cancelar] [Guardar Esquema] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Asignar Esquema a Operador ``` ┌─────────────────────────────────────────────────────────────────┐ │ ASIGNAR ESQUEMA DE PAGO ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Operador: Juan Pérez García │ │ No. Empleado: OP-0025 │ │ Antigüedad: 3 años, 5 meses │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ ESQUEMA ACTUAL │ │ ESQ-001: Operador Estándar ($2.50/km + Bono) │ │ Vigente desde: 01-jun-2023 │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ NUEVO ESQUEMA │ │ │ │ Esquema: [ESQ-002: Operador Senior ▼] │ │ │ │ Resumen del esquema: │ │ • Tipo: Porcentaje del flete │ │ • Tarifa: 25% del flete │ │ • Bono OTIF: $800 │ │ • Sin incidencias: $300 │ │ │ │ Fecha inicio: [01-feb-2026] │ │ │ │ Motivo del cambio: │ │ [Promoción por buen desempeño ]│ │ │ │ [Cancelar] [Asignar] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Tipos de Esquema | Tipo | Descripción | Cálculo | |------|-------------|---------| | Por km | Pago por kilómetro | km_reales × tarifa_km | | Por viaje | Monto fijo | tarifa_viaje | | Porcentaje | % del flete | flete × porcentaje | | Mixto | Base + variable | base + (km × tarifa) | --- ## Notas Técnicas - Tabla: `settlements.esquemas_pago` para definiciones - Tabla: `settlements.esquema_operador` para asignaciones - El km real se obtiene de `tracking.eventos` (km recorridos) - El flete se obtiene de la tarifa aplicada al viaje (MAI-002) - Histórico de cambios de esquema por operador --- ## Definición de Done - [ ] CRUD de esquemas de pago - [ ] Soporte para los 4 tipos de cálculo - [ ] Configuración de bonos - [ ] Asignación de esquema a operador - [ ] Histórico de cambios de esquema - [ ] Validación de condiciones especiales - [ ] Tests de configuración