Documentación Técnica — Ciclo Operativo

Trakkea conecta sellers con carriers.
El TMS que opera el ciclo completo.

Seis pasos — desde la creación del envío hasta la sincronización con la plataforma del seller. Este documento describe cómo funciona cada etapa operativa.

E-commerce & Plataformas

Tus pedidos se despachan sin cambiar tu operación. Trakkea lee tus etiquetas nativas — MercadoLibre, Shopify, Jumpseller.

Operadores Logísticos

Digitaliza toda tu operación de última milla desde una sola plataforma: colectas, drivers, rutas y entrega.

El Ciclo Completo

Haz clic en cada paso para ver los detalles
1
Shipment — Creación
El shipper o el carrier crea el envío con dirección, destinatario y tipo de servicio
PENDING Ver paso
2
Label — Etiqueta
QR único + código de barras. El driver la escanea para vincular el paquete al sistema
CREATED Ver paso
3
Pickup — Colecta
Al horario de corte, Trakkea consolida los envíos del día y asigna la colecta al driver
READY_FOR_PICKUP Ver paso
4
Driver Planning — Carga
El driver escanea cada paquete en el hub — el sistema valida y construye su planificación
LOADED Ver paso
5
Route — Ruta
Trakkea genera la ruta optimizada (Mapbox + HERE). Paradas agrupadas por dirección.
ON_ROUTE Ver paso
6
Entrega — Cierre
Foto o firma digital. Trakkea registra COMPLETED con GPS y sincroniza con la plataforma del seller
COMPLETED Ver paso

Shipment

Paso 1 de 6

El Shipment es la unidad central del sistema. Contiene la dirección de retiro, la dirección de entrega, el destinatario y el tipo de servicio. Todo lo que ocurre después gira en torno a él.

Así se ve en la app
Crear Shipment en Trakkea

Creación del Shipment

Shipper (E-commerce)

El seller crea el envío desde su sistema integrado. El shipper tiene control total sobre los datos del envío y puede hacer seguimiento en tiempo real.

Carrier (Transportista)

El operador logístico crea el envío para el shipper. Útil cuando el carrier recibe pedidos por canales externos y necesita registrarlos en el sistema.

Estado Inicial PENDING CREATED

Propiedades Clave

Campo Descripción
Dirección de Entrega Ubicación donde se entregará el paquete
Dirección de Retiro Ubicación donde se recogerá el paquete
Nombre Destinatario Persona que recibirá el envío
Teléfono Destinatario Contacto para coordinar entrega
Notas Instrucciones especiales de entrega
Tipo de Servicio Velocidad de entrega comprometida

Tipos de Servicio

SAME DAY
Colecta y entrega el mismo día calendario. El driver sale a retirar y entrega sin pasar por el hub.
NEXT DAY
Colecta hoy, entrega mañana. El estándar del e-commerce moderno — cobertura masiva a bajo costo operativo.
STANDARD
Entrega en 2 a 3 días hábiles. Para zonas de baja densidad o envíos donde el plazo no es crítico.
ON DEMAND
Ventana de entrega acordada con el destinatario. El driver se presenta en el horario confirmado.
RETURN
Flujo inverso — el driver retira desde el destinatario y devuelve al seller. Estados y confirmación simétricos.

Label — La Etiqueta

Paso 2 de 6

Cada Shipment tiene una etiqueta. El escaneo de esa etiqueta es el punto de entrada del paquete al sistema — sea etiqueta Trakkea o etiqueta nativa de la plataforma del seller.

Etiqueta real del sistema
Etiqueta de envío Trakkea

Qué contiene la etiqueta

QR único por envío
Código de barras
Dirección de entrega
Número de tracking

Escaneo de etiquetas nativas

Los drivers escanean etiquetas propias del seller — sin reemitir, sin reimprimir. Trakkea las reconoce e importa el envío automáticamente.

MercadoLibre

MercadoLibre

Etiqueta ML escaneada → shipment creado automáticamente

Jumpseller

Jumpseller

Etiqueta Jumpseller escaneada → importación directa al TMS

Shopify

Shopify

Etiqueta Shopify escaneada → tracking activo sin configuración extra

El carrier opera paquetes de múltiples orígenes sin fricción. El seller no cambia su proceso de etiquetado.

Pickup — Colecta

Paso 3 de 6

El carrier define un horario de corte con el seller. A esa hora, Trakkea consolida automáticamente todos los shipments del día en una colecta y la asigna al driver.

Detalle de colecta en app
Detalle de colecta en Trakkea

Flujo de Colecta Automática

Día 1 — durante el día
El seller crea shipments desde su integración. Cada nuevo envío queda en cola de colecta pendiente.
PENDING
Día 1 — 21:30 Horario de corte
Trakkea consolida todos los shipments del día en una colecta. El driver recibe la asignación automáticamente.
READY_FOR_PICKUP
Día 2 — mañana
El driver pasa a retirar los envíos del seller. Escanea y confirma cada paquete en la app.
PICKED_UP
Pickup completado
Envíos ingresan al hub. Trakkea actualiza el estado en MercadoLibre, Shopify y Jumpseller a "En tránsito" automáticamente — sin acción del seller.
RECEIVED_AT_HUB

Configuración del Acuerdo de Servicio

Activada
21:30
Depósito Central

Estados del Pickup

Estado Descripción
REQUESTED Colecta solicitada, pendiente de asignación
ASSIGNED_TO_DRIVER Driver asignado para realizar la colecta
ON_ROUTE Driver en camino al punto de retiro
ARRIVED Driver llegó al punto de retiro
COMPLETED Colecta completada, envíos recogidos
RECEIVED_AT_HUB Envíos llegaron al centro de distribución
Sincronización Automática

Cuando un pickup se completa, Trakkea actualiza automáticamente el estado en MercadoLibre, Jumpseller y Shopify a "En tránsito".

Driver Planning — Carga

Paso 4 de 6

Antes de salir del hub, el driver escanea cada paquete que cargará en su vehículo. Cada escaneo exitoso registra el envío como LOADED y lo incorpora a su planificación del día.

Cómo funciona el proceso de carga

1
Driver abre la app
Ve los envíos asignados para el día
2
Escanea cada etiqueta
Trakkea, MercadoLibre, Jumpseller o Shopify
3
Sistema valida en tiempo real
Confirma que el envío le pertenece a ese driver
Etiquetas escaneadas
Etiquetas escaneadas por el driver
Estado
LOADED
Planificación generada
Tareas planificadas del driver
Envío registrado como LOADED
Queda vinculado a ese driver en el sistema
Aparece en su planificación
Con dirección, destinatario y orden de entrega
Listo para iniciar la ruta
Una vez cargados todos los envíos del día

Estado del Hub

150
Envíos en Hub
5
Drivers
3
Rutas
Driver 1
45 / 150 envíos
Driver 2
50 / 150 envíos
Driver 3
55 / 150 envíos

Por qué el escaneo importa

Trazabilidad exacta

El sistema sabe en tiempo real qué driver físicamente tiene cada paquete dentro del vehículo

Cero envíos en el vehículo equivocado

Si una etiqueta no le pertenece a ese driver, la app lo alerta de inmediato antes de salir del hub

Planificación automática

Cada escaneo exitoso construye la lista de tareas del día sin trabajo manual del operador

Route — Optimización

Paso 5 de 6

Una vez que el driver tiene todos los paquetes cargados, Trakkea genera la ruta optimizada usando Mapbox y HERE Routing. Los envíos con la misma dirección se agrupan en una sola parada.

Optimización en curso en la app
Optimizando ruta

Ruta Optimizada

Ruta Optimizada
#1234
Driver asignado
Juan Pérez
12
Paradas
45 km
Distancia
3.5 h
Tiempo Est.
Optimización via Mapbox + HERE Routing
Por cada parada, el driver ve:
Nombre del destinatario
Dirección exacta con navegación
Notas especiales del envío
Estado en tiempo real de cada parada

Estructura de una Ruta

RUTA
Parada 1 → Entregar Envío #001
Parada 2 → Entregar Envío #002
Parada 3 → Entregar Envíos #003, #004
(Misma dirección — Agrupados)
Parada 4 → Entregar Envío #005
Agrupación Inteligente

Cuando múltiples envíos tienen la misma dirección, se agrupan en una sola parada para optimizar el tiempo.

Estados de la Ruta

Estado Descripción
PENDING Ruta creada, pendiente de optimización
PROCESSING Optimización en curso
COMPLETED Ruta optimizada, lista para ejecutar
STARTED Driver inició la ruta
FINISHED Ruta completada

Entrega — Cierre del Ciclo

Paso 6 de 6

El driver abre el envío en la app, entrega el paquete y confirma con foto o firma digital. Trakkea registra COMPLETED con timestamp y GPS, y sincroniza el estado con la plataforma del seller en menos de 1 segundo.

Shipment completado en la app
Entrega completada en Trakkea

Qué hace el driver al llegar

1
Abre el envío en la app
Ve la dirección, nombre del destinatario y notas de entrega
2
Entrega el paquete
Confirma en la app con foto o firma digital del receptor
3
Trakkea cierra el ciclo
El estado cambia a COMPLETED con timestamp, GPS y evidencia fotográfica
Estado final registrado
COMPLETED · DELIVERED · GPS + foto almacenados
Camino A
Entrega Exitosa
Driver confirma la entrega en la app
Foto/firma del receptor queda registrada
Seller recibe notificación instantánea
Plataformas (ML, Shopify, Jumpseller) actualizadas automáticamente
Estado final del envío
COMPLETED
Camino B
Intento Fallido
El driver registra el motivo:
BAD_ADDRESS
NO_ANSWER
REFUSED
ABSENT
MISSING_DATA
RESCHEDULED
El envío no muere — vuelve al ciclo
ATTEMPTED → queda disponible para la siguiente ruta

Sincronización automática en <1 segundo

En cuanto el driver confirma la entrega, Trakkea dispara webhooks a todas las plataformas del seller. Sin intervención humana. Sin delay.

TR
Trakkea
COMPLETED
Webhook automático
< 1 seg
MercadoLibre
MercadoLibre
Envío actualizado a "Entregado"
Shopify
Shopify
Fulfillment marcado como completado
Jumpseller
Jumpseller
Pedido cerrado automáticamente
El ciclo completo en 6 pasos
Desde la creación hasta la entrega confirmada — todo en Trakkea
Shipment
PENDING
Etiqueta
CREATED
Pickup
PICKED_UP
Carga
LOADED
Ruta
ON_ROUTE
Entregado
COMPLETED