Sistema TMS

Gestión Integral de Logística y Transporte

¿Por qué elegir TMS?

Tiempo Real

Seguimiento en vivo de tus operaciones con actualización instantánea de datos.

Análisis Avanzado

Reportes y KPIs detallados para tomar decisiones informadas.

Seguridad

Control de acceso granular y auditoría completa de operaciones.

Automatización

Workflows automáticos que reducen trabajo manual y errores.

Integración

Webhooks y APIs para conectar con tus sistemas externos.

Multi-Dispositivo

Accede desde web, tablet o móvil con interfaz adaptativa.

Módulos Principales

📊

Dashboard

Panel de control con KPIs y métricas en tiempo real.

📦

Operaciones

Gestión de expediciones, viajes, recogidas y citas.

💼

Comercial

Clientes, tarifas, facturas y órdenes de compra.

🔧

Sistema

Configuración, usuarios, roles y permisos.

📈

Reportes

Análisis avanzado y exportación de datos.

🚚

Flota

Gestión de vehículos, conductores y rutas.

✨ Nuevas Funcionalidades 2026

NUEVO
🔔

Webhooks

Sistema automático de notificaciones y eventos en tiempo real.

  • Notificaciones automáticas de eventos
  • Integración con sistemas externos
  • Webhooks personalizables
  • Historial de eventos completo
NUEVO

Activación OC

Gestión completa de órdenes de compra y su activación.

  • Registro de órdenes de compra
  • Vinculación con citas (ASN)
  • Validación de mercancía
  • Reportes de compras
NUEVO
⚠️

Incidencias

Sistema de registro y seguimiento de incidencias operativas.

  • Clasificación automática de incidencias
  • Seguimiento de resolución
  • Análisis de tendencias
  • Notificaciones automáticas

Beneficios Comprobados

↓ 40%

Reducción de Costos

Optimización de rutas y recursos

↑ 35%

Productividad

Automatización de procesos

↑ 90%

Precisión

Menos errores y retrasos

24/7

Disponibilidad

Sistema siempre disponible

Bienvenido

Bienvenido al Manual Interactivo de TMS. Usa el menú de la izquierda para navegar por los diferentes módulos y funcionalidades.

Acerca de TMS

TMS (Transportation Management System) es una plataforma integral de gestión logística diseñada para optimizar operaciones de transporte, expediciones y gestión comercial en tiempo real.

¿Qué es TMS?

TMS es un sistema empresarial especializado en la gestión de operaciones logísticas y de transporte. Integra todos los procesos desde la recepción de órdenes hasta la entrega final, proporcionando visibilidad, control y automatización en toda la cadena de suministro.

Características Principales

Gestión en Tiempo Real

Seguimiento instantáneo de expediciones, viajes y operaciones con actualización de estados automática.

Análisis Avanzado

Reportes detallados y dashboards con métricas clave (KPI) para toma de decisiones.

Integración Externa

Conexión con sistemas ERP, WMS, portales de clientes y plataformas de e-commerce.

Control de Acceso

Roles y permisos granulares para diferentes usuarios y departamentos.

Interfaz Responsiva

Compatible con desktop, tablet y móvil. Aplicación web y mobile nativa.

Cloud o On-Premise

Flexible: hospedaje en la nube o en servidores locales según necesidad.

Módulos Principales
  • Operaciones: Expediciones, viajes, recogidas, citas, incidencias
  • Comercial: Clientes, órdenes de compra, tarifas, facturación
  • Flota: Vehículos, conductores, remolques, mantenimiento
  • Geografía: Sucursales, pueblos, regiones, rutas optimizadas
  • Liquidaciones: Cálculo y pago a proveedores/transportistas
  • Reportes: Análisis, métricas, exportación de datos
Beneficios Comprobados

📉 -40% Costos

Reducción de gastos operativos mediante optimización de rutas y recursos.

⚡ +35% Productividad

Automatización de procesos y eliminación de tareas manuales.

✓ +90% Precisión

Menos errores, menos retrasos, mayor confiabilidad en datos.

24/7 Disponibilidad

Acceso 24 horas, 7 días desde cualquier lugar con internet.

Documentación

Manual completo con guías de usuario, procedimientos y mejores prácticas para maximizar el uso de TMS.

Secciones del Manual
  • Introducción: Conceptos básicos y acceso al sistema
  • Producto: Características y beneficios del TMS
  • Ciclos de Vida: Procesos de expediciones, viajes, facturación y liquidaciones
  • Módulos: Guía detallada de cada módulo del sistema
  • Nuevas Funcionalidades: Webhooks, activación OC, incidencias
  • FAQ: Preguntas frecuentes y solución de problemas
💡 Sugerencia: Navega por las diferentes secciones usando el menú principal para encontrar información específica según tu rol o necesidad.
Webhooks

Sistema avanzado de notificaciones que permite que TMS envíe eventos en tiempo real a tus sistemas externos. Perfecta para integraciones automáticas sin necesidad de polling.

¿Qué son Webhooks?

Los webhooks son callbacks HTTP que TMS envía a tu servidor cuando ocurren eventos importantes. En lugar de que tu sistema pregunte constantemente "¿hay cambios?", TMS te notifica inmediatamente diciendo "algo cambió". Es como una campanita que toca automáticamente.

Flujo de Información con Webhooks

TMS → Internet → Tu Servidor

1. Evento en TMS2. HTTP POST3. Tu API recibe datos

POST /tu-api/webhook
Content-Type: application/json
Authorization: Bearer token

{
  "evento": "expedicion.entregada",
  "timestamp": "2026-09-05T22:57:00Z",
  "datos": {
    "id_expedicion": "EXP-12345",
    "cliente": "ACME Corp",
    "estado": "entregada"
  }
}
Eventos por Entidad

📦 Expediciones

  • expedicion.creada
  • expedicion.confirmada
  • expedicion.en_transito
  • expedicion.entregada
  • expedicion.devuelta
  • expedicion.anulada

🚚 Viajes

  • viaje.planificado
  • viaje.confirmado
  • viaje.iniciado
  • viaje.en_ruta
  • viaje.completado
  • viaje.cancelado

📄 Facturas

  • factura.generada
  • factura.emitida
  • factura.pagada_parcial
  • factura.pagada_total
  • factura.vencida
  • factura.anulada

💵 Liquidaciones

  • liquidacion.generada
  • liquidacion.en_revision
  • liquidacion.aprobada
  • liquidacion.pagada
  • liquidacion.rechazada

⚠️ Incidencias

  • incidencia.reportada
  • incidencia.clasificada
  • incidencia.asignada
  • incidencia.en_revision
  • incidencia.resuelta
  • incidencia.cerrada

📅 Citas/ASN

  • cita.solicitada
  • cita.programada
  • cita.confirmada
  • cita.en_ejecucion
  • cita.completada
  • cita.cancelada
Estructura del Payload (JSON)
{
  "id_webhook": "wh_123456789",
  "evento": "expedicion.entregada",
  "timestamp": "2026-09-05T22:57:30Z",
  "version": "1.0",
  "datos": {
    "id_expedicion": "EXP-12345",
    "numero_seguimiento": "TMS-2026-98765",
    "cliente": "ACME Corporation",
    "estado_anterior": "en_reparto",
    "estado_nuevo": "entregada",
    "fecha_entrega": "2026-09-05T22:30:00Z",
    "conductor": "Juan Pérez",
    "vehiculo": "MERCED-001",
    "firma_cliente": "base64_encoded_image"
  },
  "reintentos": 0,
  "intentos_restantes": 3
}
Configuración de Webhooks
✓ Pasos para configurar:
  1. Preparar URL: Tu servidor debe tener un endpoint POST (ej: https://miapi.com/webhook)
  2. Ir a Configuración → Webhooks en TMS
  3. Crear nuevo webhook: Agregar tu URL
  4. Seleccionar eventos: Elegir cuáles eventos quieres recibir
  5. Configurar opciones: Reintentos (3-5), Timeout (30s), Headers personalizados
  6. Enviar test: Probar con "Send Test Event"
  7. Validar respuesta: Tu servidor debe responder con HTTP 200-299
  8. Monitorear: Ver logs de intentos de entrega en Dashboard
Mejores Prácticas
💡 Recomendaciones:
  • Validar firma: TMS envía signature HMAC-SHA256 en header para validar autenticidad
  • Idempotencia: Tu endpoint debe manejar reintentos (mismo evento puede llegar 2+ veces)
  • Responder rápido: No procesar en el webhook, enqueuar y responder 200 inmediatamente
  • Logs detallados: Registrar todos los webhooks recibidos con timestamp y contenido
  • Dead letter queue: Guardar eventos que fallaron para reintento manual
  • Monitoreo: Alertas si no recibes eventos en X minutos
Activación OC

Módulo especializado para la gestión completa de órdenes de compra (OC), desde su recepción hasta el cierre final. Permite validar mercancía, generar citas de recepción y conectar con expediciones.

¿Qué es una OC?

Una Orden de Compra es un documento que emite el cliente como instrucción para comprar cierta cantidad de productos a un proveedor. En TMS, registramos y damos seguimiento a estas órdenes para coordinar su recepción, validación y conversión en expediciones.

Estados de una OC
1. Recibida OC llega del cliente
2. Registrada Ingresada al sistema
3. Agendada Cita programada
4. Recepción Cliente trae mercancía
5. Validada Mercancía verificada
6. Cerrada ✓ OC completada
Flujo de Activación OC
  1. 1. Recibir OC: El cliente envía la orden de compra (email, portal, EDI)
  2. 2. Registrar en TMS: Datos de OC, cliente, productos, cantidad y fecha esperada
  3. 3. Crear ASN/Cita: Agendar cita de recepción en mesón (fecha y hora disponible)
  4. 4. Notificar Cliente: Enviar confirmación de cita y ubicación
  5. 5. Recepción: Cliente se presenta en la cita con la mercancía
  6. 6. Validar: Verificar cantidad, calidad, documentación (facturas, certificados)
  7. 7. Ingresar Inventario: Registrar mercancía en sistema (si aplica)
  8. 8. Generar Expedición: Crear orden de envío hacia destino final
  9. 9. Cerrar OC: Marcar como completada y generar reportes
Validación de Mercancía

Verificación Física

Contar bultos, verificar códigos de barras, revisar pesos y dimensiones.

Documentación

Validar facturas, certificados, permisos sanitarios o de transporte según sea necesario.

Inspección Calidad

Revisar estado de mercancía (daños, fechas de vencimiento, códigos de lote).

Concordancia

Comparar lo recibido vs. lo facturado y lo esperado en la OC.

Incidencias en OC
  • Cantidad Faltante: Se recibe menos de lo solicitado
  • Cantidad Excedente: Se recibe más de lo solicitado
  • Producto Diferente: Se entrega artículo distinto al solicitado
  • Daño en Mercancía: Productos llegaron dañados o defectuosos
  • Documentación Incompleta: Falta factura, certificado o permiso
  • No Presentación: Cliente no se presenta a la cita agendada
✓ Recomendaciones:
  • Establecer ventanas de cita de 2-3 horas para flexibilidad
  • Usar códigos de barras para validación rápida
  • Mantener registro fotográfico de mercancía con incidencias
  • Comunicar problemas al cliente en el día (máximo 24h)
  • Definir tiempos SLA para resolución de discrepancias
Incidencias

Sistema integral de registro, seguimiento y resolución de incidencias operativas. Permite identificar problemas, documentar la situación y aplicar correcciones para mejorar continuamente los procesos logísticos.

¿Qué es una Incidencia?

Una incidencia es cualquier evento anómalo que afecta el cumplimiento normal de una operación logística. Puede ser operativa, comercial o de seguridad. El sistema captura, clasifica y rastrea cada incidencia hasta su resolución.

Tipos de Incidencias Operativas

Retraso de Entrega

Cuando una expedición se entrega después de la fecha/hora programada. Se registra el motivo, duración y impacto.

Daño en Mercancía

Roturas, golpes, manchas u otros daños físicos durante el transporte o manipulación.

Faltante de Bultos

Cuando la cantidad recibida es menor a la cantidad expedida (pérdida, robo, etc.).

Vehículo Averiado

Fallos mecánicos, eléctricos o de combustible que impiden la continuidad del viaje.

Accidente

Choque, vuelco u otro evento de seguridad vial. Requiere documentación de póliza de seguros.

Problema de Dirección

Direcciones incorrectas, inaccesibles o datos incompletos que impiden localizar el destino.

Ciclo de Vida de una Incidencia
1. Reportada Conductor o cliente reporta el problema
2. Clasificada Sistema identifica tipo y severidad
3. Asignada Se asigna a supervisor/gestor
4. En Investigación Se recopilan evidencias y hechos
5. Resuelta Se toma acción correctiva
6. Cerrada ✓ Validada e incorporada a reportes
Niveles de Severidad
🔴 Crítica

Afecta múltiples operaciones, seguridad o reputación. Requiere intervención inmediata.

Ej: Accidente grave, pérdida total de mercancía
🟠 Alta

Impacta significativamente un proceso. Requiere atención urgente (máx 24h).

Ej: Retraso mayor a 2 horas, daño parcial
🟡 Media

Problema notable pero contenible. Debe resolverse en 48h.

Ej: Retraso menor a 2 horas, 1-5 bultos faltantes
🟢 Baja

Incidencia menor. Se registra para análisis de tendencias.

Ej: Retraso menor a 30 min, daño cosmético
Proceso de Reportar una Incidencia
  1. Acceder a Incidencias: Menú principal → Operaciones → Incidencias
  2. Clic en "Reportar Nueva Incidencia"
  3. Seleccionar tipo: Elegir de la lista predefinida o crear personalizada
  4. Completar datos: Expedición afectada, fecha/hora, descripción detallada
  5. Adjuntar evidencia: Fotos, documentos, pruebas de lo sucedido
  6. Asignar a: Seleccionar responsable de resolver (supervisor, jefe de flota, etc.)
  7. Guardar: El sistema asigna automáticamente un número de incidencia
  8. Seguimiento: Monitorear estado hasta cierre
Análisis y Reportes de Incidencias
📊 Métricas Disponibles:
  • Total de incidencias por período
  • Distribución por tipo de incidencia
  • Severidad promedio y tendencias
  • Tiempo promedio de resolución
  • Incidencias por conductor/vehículo
  • Incidencias por ruta/zona
  • Causas raíz más frecuentes
  • Impacto financiero estimado
Mejores Prácticas para Reducir Incidencias
✓ Recomendaciones:
  • Validar datos de dirección antes de despachar
  • Capacitar conductores en manejo defensivo
  • Mantener vehículos con revisiones preventivas
  • Usar sistemas de tracking en tiempo real
  • Implementar doble verificación en picking
  • Revisar incidencias regularmente (reuniones semanales)
  • Implementar correcciones preventivas
  • Compartir lecciones aprendidas con el equipo
Ciclos de Vida

Comprende los flujos completos de los principales procesos en TMS. Cada ciclo representa el viaje de una operación desde su inicio hasta su cierre final.

¿Qué son los Ciclos de Vida?

Los ciclos de vida en TMS representan el recorrido completo de cada tipo de operación. Son procesos estandarizados que definen los pasos, estados y transiciones que debe seguir cada entidad (expedición, viaje, factura, etc.) desde su creación hasta su conclusión.

6 Ciclos Principales

📦 Expediciones

9 Estados: Desde Previa hasta Entregado. El envío individual más importante en TMS.

Incluye: Retiros, crossdocking, devoluciones, anulaciones

🚚 Viajes

6 Estados: Agrupación de expediciones bajo un vehículo y conductor.

Optimización: rutas, cargas, paradas programadas

💰 Facturas

5 Estados: Cargos al cliente generados por servicios prestados.

Estados especiales: Anulada, En litigio, Vencida

💵 Liquidaciones

6 Estados: Cierre financiero con proveedores/transportistas.

Cálculo de pagos por período

📋 Retiros

6 Estados: Ciclo inverso para devoluciones y rectificaciones.

Desde solicitud hasta recepción en depósito

📅 Citas/ASN

6 Estados: Agendamiento de recepción en mesón.

Optimiza recursos: recepción, validación, ingreso

Beneficios de Entender los Ciclos
✓ Importancia:
  • Visibilidad: Saber exactamente en qué estado está cada operación
  • Control: Validar transiciones correctas entre estados
  • Automatización: Dispara acciones automáticas al cambiar estado
  • Análisis: Métricas por estado (tiempo promedio, cuellos de botella)
  • Reportes: Filtrar y agrupar por estados
  • Integración: Notificar sistemas externos de cambios de estado
Selecciona un Ciclo en el Menú

Usa el dropdown "Ciclos" en el navbar superior para ver los detalles completos de cada ciclo:

  • Explicación de cada estado
  • Diagrama visual del flujo
  • Transiciones permitidas
  • Casos especiales y excepciones
  • Métricas e indicadores
💡 Tip: Los ciclos están interconectados. Por ejemplo, una Cita (ASN) genera una Expedición, que se agrupa en un Viaje, que genera una Factura, que finaliza en una Liquidación.
📦 Ciclo de Vida de Expediciones

Las expediciones son la unidad base de operación en TMS. Representa un envío individual del cliente que debe ser transportado desde un origen hasta un destino.

1. Previa Expedición registrada, pendiente de confirmación
2. Pendiente Confirmada, en espera de recoger
3. Confirmada Validada y con número de seguimiento
4. Origen En punto de recogida
5. Tránsito En camino hacia destino
6. Destino Llegó a destino, en espera de entrega
7. Asignada Reparto Asignada a conductor para entrega final
8. En Reparto Conductor en ruta de entrega
9. Entregado ✓ Entrega completada con éxito
Estados Finales:
  • Entregado: Completado exitosamente
  • Crossdocking: Transferencia entre puntos
  • Devolución: Retorno al origen (parcial o total)
  • Anulada: Cancelada antes de entrega
🚚 Ciclo de Vida de Viajes

Un viaje agrupa múltiples expediciones bajo un mismo vehículo, conductor y ruta. Representa la agrupación logística de envíos para optimizar la distribución.

1. Planificado Viaje creado en sistema
2. Confirmado Vehículo y conductor asignados
3. En Depósito Expediciones cargadas
4. Iniciado Viaje en movimiento
5. En Ruta Realizando entregas y recogidas
6. Completado ✓ Todas las paradas finalizadas
💰 Tarifas de Viajes - Costos e Ingresos

Comprende cómo se calculan los costos operativos y los ingresos por servicios de transporte. Sistema integrado de tarifas por ruta, distancia, volumen y especiales.

Estructura de Costos en Viajes

⛽ Combustible

  • Costo por km
  • Consumo del vehículo
  • Variación de precio
  • Ajuste por ruta

👤 Conductor

  • Salario/hora o viaje
  • Horas extra
  • Bonificaciones
  • Beneficios sociales

🔧 Mantenimiento

  • Revisiones preventivas
  • Reparaciones
  • Neumáticos
  • Aceites y filtros

🛡️ Seguros

  • Seguro vehículo
  • Cobertura mercancía
  • Responsabilidad civil
  • Soat/Multas

🚦 Peajes

  • Peajes autopistas
  • Accesos a ciudades
  • Puentes especiales
  • Estacionamientos

📦 Logística

  • Carga/descarga
  • Almacenamiento
  • Embalaje
  • Manejo especial
Cálculo de Tarifa por Viaje

Fórmula Base de Tarifa:

TARIFA TOTAL = (COSTO FIJO) + (COSTO VARIABLE × KM) + (COSTO ADICIONAL)

Ejemplo:
• Costo fijo: $50 (salario conductor parcial)
• Costo variable: $5/km × 200km = $1,000
• Peajes: $150
• Carga/descarga: $100

TARIFA TOTAL = $50 + $1,000 + $250 = $1,300
Ingresos por Servicios

Servicio de Transporte

  • Cargo base por km
  • Por tonelada/volumen
  • Servicio puerta a puerta
  • Urgentes (recargo)

Servicios Adicionales

  • Embalaje premium
  • Seguro mercancía
  • Manejo especial
  • Entrega con aviso

Recargos Especiales

  • Fin de semana (+15%)
  • Noche (+20%)
  • Tráfico pesado (+10%)
  • Distancia larga (+25%)

Márgenes de Ganancia

  • Margen típico: 20-35%
  • Volumen (descuento): -5 a -15%
  • Cliente prioritario: +10%
  • Contrato anual: -10%
Matriz de Tarifas por Tipo de Servicio
Tipo Servicio Tarifa Base Condiciones Tiempo Entrega
Estándar $4/km Horario normal, <1 tonelada 24-48 horas
Urgente $7/km (+75%) Prioridad, <500 kg 12 horas
Carga Completa $0.50/kg Volumen completo 48-72 horas
Especial (frío) $6/km Refrigerado, perecedero 12-24 horas
Contrato Anual $2.80/km (-30%) Volumen mínimo garantizado 24-48 horas
Análisis de Rentabilidad del Viaje

Ejemplo de Viaje Rentable:

Viaje: Santiago → Antofagasta (1,270 km)

COSTOS:
• Combustible: $2.540.000 (1,270 km × $2.000/km)
• Conductor (18h): $1.200.000 (salario diario de ruta larga)
• Mantenimiento/km: $508.000 (1,270 × $400)
• Peajes ruta (Ruta 5 Norte): $450.000
• Seguro viaje: $300.000
• Hospedaje conductor (1 noche): $80.000
COSTO TOTAL: $5.078.000

INGRESOS:
• 5 toneladas @ $3.800/km (distancia larga +10%): $4.826.000
• Seguro mercancía: $300.000
• Carga/descarga especializada: $400.000
• Recargo distancia larga: $500.000
INGRESO TOTAL: $6.026.000

GANANCIA: $948.000 (18.6% de margen) ✓
(Margen reducido por distancia, pero operación rentable con volumen)
Factores que Afectan Tarifas
✓ Factores que AUMENTAN tarifa:
  • Distancia larga (>500 km)
  • Horario especial (noche, fin de semana)
  • Mercancía frágil o refrigerada
  • Cantidad de paradas (entregas múltiples)
  • Recogida o entrega en zona remota
  • Documentación especial requerida
⚠️ Factores que DISMINUYEN tarifa:
  • Contrato anual (volumen garantizado)
  • Ruta frecuente (familiar para conductor)
  • Carga completa del vehículo
  • Horario normal (8am-6pm)
  • Cliente frecuente (descuento por lealtad)
  • Carga no frágil/estándar
Configuración de Tarifas en TMS
💡 Cómo configurar tarifas:
  1. Ir a Configuración → Tarifas → Crear Tarifa
  2. Definir cliente (o aplicar a todos)
  3. Seleccionar tipo de servicio (Estándar, Urgente, etc.)
  4. Establecer tarifa base por km o por tonelada
  5. Agregar costos fijos si aplica
  6. Definir recargos por distancia, horario, etc.
  7. Establecer margen de ganancia
  8. Guardar y activar la tarifa
📄 Ciclo de Vida de Facturas

Las facturas se generan automáticamente a partir de las expediciones entregadas. Representan los cargos al cliente por servicios prestados.

1. Generada Sistema crea factura automáticamente
2. Pendiente En espera de envío a cliente
3. Emitida Enviada al cliente
4. Pagada Parcial Cliente pagó parte del monto
5. Pagada Total ✓ Pago completo recibido
⚠️ Estados Especiales:
  • Anulada: Factura cancelada/reversada
  • En Litigio: Reclamo del cliente
  • Vencida: Factura sin pagar pasada fecha límite
💵 Ciclo de Vida de Liquidaciones

Las liquidaciones agrupan expediciones por período para calcular y pagar a proveedores (transportistas). Es el cierre financiero del ciclo operativo.

1. Preparación Agrupación de expediciones por período
2. Cálculo Sistema calcula montos a pagar
3. Generada Liquidación creada y lista para revisión
4. Revisión Validación de datos y montos
5. Aprobada Aprobada por supervisor
6. Pagada ✓ Pago realizado al proveedor
📋 Ciclo de Vida de Retiros

Los retiros son operaciones inversas donde la mercancía regresa del cliente al depósito. Se utilizan para devoluciones, cambios o rectificaciones.

1. Solicitado Cliente solicita retiro de mercancía
2. Confirmado Retiro confirmado, asignado conductor
3. En Ruta Conductor en camino al cliente
4. En Origen Conductor recolecta mercancía
5. En Tránsito Retiro transportado al depósito
6. Completado ✓ Recibido en depósito
📅 Ciclo de Vida de Citas (ASN)

Las citas o ASN (Advanced Shipping Notice) son agendamientos para recibir mercancía en el mesón. Permiten optimizar recursos de recepción.

1. Solicitada Cliente solicita cita de recepción
2. Programada Cita asignada a fecha y hora
3. Confirmada Cliente confirma asistencia
4. En Ejecución Cliente presentándose en mesón
5. Completada Recepción de mercancía finalizada
6. Cerrada ✓ Cita procesada y archivada
🔗 Integración Completa de Ciclos

Los ciclos de vida no funcionan de manera aislada. Están interconectados en un flujo integrado que representa el proceso logístico completo.

FLUJO OPERATIVO COMPLETO:

Cita (ASN) → Recepción en Mesón → ExpediciónViaje → Entrega a Cliente → FacturaLiquidación a Proveedor

Este es el flujo típico de un proceso logístico completo en TMS. Cada paso genera información que alimenta el siguiente, creando un ciclo integrado de operaciones.

💡 Notas Importantes:
  • Una expedición genera conceptos facturables
  • Múltiples expediciones se agrupan en un viaje
  • Las facturas se generan automáticamente al entregar
  • Las liquidaciones cierran el ciclo financiero
  • Los retiros son ciclos inversos de expediciones
  • Las citas optimizan la recepción
Integración vía API

TMS expone una API REST completa que permite integrar funcionalidades con sistemas externos. Todos los endpoints están documentados en Swagger y requieren autenticación.

¿Qué es la API REST de TMS?

La API REST permite que aplicaciones externas interactúen con TMS de forma programática. Puedes crear expediciones, consultar estados, generar reportes, y más, sin usar la interfaz web.

Endpoints Principales por Módulo

📦 Expediciones

  • GET /api/expediciones
  • GET /api/expediciones/{id}
  • POST /api/expediciones
  • PUT /api/expediciones/{id}
  • PATCH /api/expediciones/{id}/estado
  • GET /api/expediciones/{id}/tracking

🚚 Viajes

  • GET /api/viajes
  • GET /api/viajes/{id}
  • POST /api/viajes
  • PUT /api/viajes/{id}
  • PATCH /api/viajes/{id}/estado
  • GET /api/viajes/{id}/paradas

📄 Facturas

  • GET /api/facturas
  • GET /api/facturas/{id}
  • POST /api/facturas
  • PATCH /api/facturas/{id}/pago
  • GET /api/facturas/{id}/detalles
  • DELETE /api/facturas/{id}

💵 Liquidaciones

  • GET /api/liquidaciones
  • GET /api/liquidaciones/{id}
  • POST /api/liquidaciones
  • PATCH /api/liquidaciones/{id}/estado
  • GET /api/liquidaciones/{id}/detalle

⚠️ Incidencias

  • GET /api/incidencias
  • GET /api/incidencias/{id}
  • POST /api/incidencias
  • PATCH /api/incidencias/{id}/estado
  • POST /api/incidencias/{id}/comentario

📅 Reportes

  • GET /api/reportes/expediciones
  • GET /api/reportes/viajes
  • GET /api/reportes/kpi
  • GET /api/reportes/analytics
  • POST /api/reportes/exportar
Autenticación y Seguridad
✓ Métodos de Autenticación:
  • OAuth 2.0: Recomendado para aplicaciones web (Authorization Code Flow)
  • JWT Tokens: Para aplicaciones mobile y scripts backend
  • API Keys: Para integraciones simples (deprecado, usar solo testing)
  • mTLS: Certificados para integración B2B crítica
🔒 Seguridad Implementada:
  • HTTPS/TLS: Todo en tránsito encriptado (TLS 1.2+)
  • CORS: Whitelist de dominios permitidos
  • Rate Limiting: 1000 req/hora por token
  • Validación: JSON Schema en todos los endpoints
  • Logs: Auditoría de todas las llamadas
  • IP Whitelist: Restricción por IP origen (opcional)
  • Versioning: /api/v1/, /api/v2/ para compatibilidad
  • Throttling: Protección contra DDoS
Ejemplo de Integración
// 1. Obtener token
curl -X POST https://tms.local/api/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "tu_app_id",
    "client_secret": "tu_secret",
    "grant_type": "client_credentials"
  }'

Respuesta:
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

// 2. Usar token en request
curl -X GET https://tms.local/api/v1/expediciones/EXP-12345 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

// 3. Respuesta
{
  "id": "EXP-12345",
  "numero_seguimiento": "TMS-2026-98765",
  "cliente": "ACME Corp",
  "estado": "entregado",
  "fecha_entrega": "2026-09-05T22:30:00Z"
}
Documentación Completa
📚 Acceso a API Docs:
  • Swagger UI: https://tms.local/swagger (interfaz interactiva)
  • OpenAPI YAML: https://tms.local/api/openapi.yaml (especificación)
  • Postman Collection: https://tms.local/api/postman.json (importar a Postman)
  • Wiki: https://tms.local/docs/api (guías detalladas)
Carga y Manejo de Imágenes

Sistema completo para subir, almacenar, procesar y servir imágenes. Soporta múltiples formatos, optimización automática y galería.

¿Por qué Imágenes en TMS?

Las imágenes son críticas para logística: fotos de mercancía al recibir, firma digital del cliente en entrega, documentos escaneados, pruebas de incidencias, mapas de ruta, etc. Un sistema robusto de imágenes mejora la trazabilidad.

Tipos de Imágenes Soportadas

📋 Documentos

  • Facturas escaneadas
  • Guías de remisión
  • Permisos de transporte
  • Certificados

📦 Mercancía

  • Fotos al recibir
  • Estado de bultos
  • Daños y roturas
  • Etiquetado

✍️ Firmas

  • Firma del cliente
  • Firma del conductor
  • Sello digital
  • Huella digital

⚠️ Incidencias

  • Foto de daño
  • Accidente de vehículo
  • Lugar de entrega
  • Evidencia de reclamo

🗺️ Rutas

  • Mapas de ruta
  • Heatmaps
  • Puntos de parada
  • Tracking GPS

📊 Reportes

  • Gráficos generados
  • Dashboards
  • Logos/Branding
  • Gráficas de datos
Especificaciones Técnicas
✓ Formatos Aceptados:
  • Imágenes: JPG, PNG, WebP, BMP, GIF (máx 20 MB)
  • Documentos: PDF, DOCX, XLSX (máx 50 MB)
  • Videos: MP4, MOV, AVI (máx 500 MB)
  • Resolución mínima: 640x480px
  • Resolución máxima: 8000x6000px
🔒 Seguridad y Privacidad:
  • Almacenamiento: Encriptado en reposo (AES-256)
  • Tránsito: HTTPS/TLS 1.2+
  • Acceso: Control de permisos por rol
  • Antivirus: Escaneo automático de uploads
  • Compresión: Automática sin perder calidad
  • CDN: Distribución rápida a nivel mundial
  • Retención: Políticas configurables (ej: 7 años)
Flujo de Carga de Imagen
1. Usuario selecciona imagen

2. Sistema valida formato/tamaño

3. Escaneo antivirus

4. Compresión automática

5. Almacenamiento encriptado

6. Generación de miniaturas

7. Indexación en CDN

8. URL disponible para acceso
API para Cargar Imágenes
// Upload de imagen multipart
POST /api/v1/archivos/upload
Content-Type: multipart/form-data
Authorization: Bearer TOKEN

Parámetros:
- archivo: (file) Imagen a subir
- entidad: "expedicion" | "viaje" | "incidencia" | "documento"
- entidad_id: "EXP-12345" (ID de la entidad)
- tipo: "foto" | "firma" | "documento" | "otro"
- descripcion: "Foto de mercancía recibida" (opcional)

Respuesta:
{
  "id": "ARQ-987654",
  "nombre_original": "IMG_2026.jpg",
  "url": "https://cdn.tms.local/archivos/2026/09/IMG_987654.jpg",
  "url_miniatura": "https://cdn.tms.local/archivos/2026/09/IMG_987654_thumb.jpg",
  "tamaño_original": 5242880,
  "tamaño_comprimido": 1024000,
  "formato": "image/jpeg",
  "ancho": 4000,
  "alto": 3000,
  "fecha_carga": "2026-09-05T23:10:00Z",
  "tamaño_compresion": "80% reducido"
}
Mejores Prácticas
⚠️ Recomendaciones:
  • Metadatos: Adjuntar descripción y categoría en cada upload
  • Timestamps: Registrar hora exacta de captura (GPS timestamp)
  • Geoetiquetado: Incluir coordenadas GPS si está disponible
  • Galería: Permitir múltiples fotos por evento (antes/después)
  • Watermark: Marcar imágenes sensibles (datos personales)
  • Rotación: Detectar y corregir automáticamente
  • OCR: Extraer texto de documentos escaneados
  • Borrado seguro: Borrar con overwrite de datos
Preguntas Frecuentes

Accede a través de tu navegador ingresando la URL del servidor TMS (por defecto: https://localhost:44302) con tus credenciales de usuario. Si es tu primer acceso, contacta al administrador para que te cree una cuenta.

TMS funciona en Chrome, Firefox, Safari y Edge (versiones recientes). Se recomienda mantener el navegador actualizado para mejor compatibilidad y seguridad.

Sí, contáctanos a través del correo de soporte para asistencia técnica. Respondemos consultas en horario laboral (lunes a viernes, 8:00 AM - 5:00 PM).

Accede a la sección "Operaciones → Expediciones" y haz clic en "Nueva Expedición". Completa los campos requeridos: origen, destino, cliente, mercancía y haz clic en "Guardar". El sistema te asignará un número de tracking automáticamente.

Ingresa el número de tracking (proporcionado al crear la expedición) en la sección "Consultar Tracking". El sistema mostrará el estado actual, ubicación, conductor asignado y fecha estimada de entrega en tiempo real.

Accede a "Operaciones → Incidencias" y selecciona "Reportar Nueva Incidencia". Detalla el problema (retraso, daño, faltante, etc.), adjunta evidencia si es posible y envía. Un supervisor analizará tu caso y te contactará con actualizaciones.

Ve a "Reportes" y selecciona el tipo de reporte que necesitas (expediciones, viajes, liquidaciones, etc.). Configura los filtros de fecha, cliente o región y haz clic en "Generar". Puedes descargar en Excel, PDF o enviar por correo.

Haz clic en tu perfil (esquina superior derecha) y selecciona "Cambiar Contraseña". Ingresa tu contraseña actual, la nueva contraseña (mínimo 8 caracteres con mayúsculas, minúsculas y números) y confirma. El cambio se aplicará inmediatamente.

Sí, la mayoría de los listados en TMS incluyen botones "Exportar" (icono de descarga). Selecciona los registros que necesitas y haz clic en exportar. El archivo Excel se descargará a tu computadora con toda la información filtrada.

Un webhook es una notificación automática que TMS envía a tu sistema cuando ocurren eventos importantes (expedición entregada, viaje iniciado, etc.). Permite integraciones en tiempo real sin necesidad de consultar constantemente. Configúralos en "Configuración → Webhooks".
💡 ¿No encontraste tu pregunta?
Contacta al equipo de soporte a través del correo support@tms.local o abre un ticket en el portal de soporte.