Cómo usar Tramo, paso a paso

Esta guía te lleva desde "no tengo cuenta" hasta "ya tengo a la empresa operando". Asumimos que sos el dueño o administrador. Si sos operario o chofer, andá directamente al manual de tu rol.

Cómo se compone el sistema

Tramo es multi-tenant: cada empresa (tenant) tiene sus propios datos completamente aislados de las demás, a nivel de base de datos. Dentro de tu empresa hay 3 roles principales:

• Administrador — vos, el dueño o quien configura todo
• Operario — administrativos y despachadores que cargan viajes y liquidan
• Chofer — usuarios en la ruta, con vista mobile reducida

Hay un cuarto rol, Superadmin, que somos nosotros (Tramo): operamos la plataforma, no entramos a tu cuenta.

Paso 1. Registrá tu empresa

1. Andá a tramo.com.ar/registro-empresa
2. Cargá el nombre, CUIT y datos de contacto
3. Elegí el rubro principal (cerealero, lechero, hacienda, etc.) — Tramo se autoconfigura según esto: unidades de carga, documentos, categorías de gasto y tarifas quedan listas
4. Enviá la solicitud

Te activamos el acceso en menos de 24hs. Recibís un email con el link a tu subdominio (ej. mi-empresa.tramo.com.ar) y la contraseña inicial.

Paso 2. Primer login

1. Abrí el link que llegó por email
2. Ingresá con tu email y la contraseña inicial
3. Cambiá la contraseña desde Mi cuenta → Cambiar contraseña

Tu sesión usa cookies seguras (httpOnly). No necesitás guardar tokens en el navegador ni en el código.

Paso 3. Revisá la configuración del rubro

Andá a Administración → Configuración (/configuracion). Revisá que:

• Unidad de carga sea la correcta (Kg, Litros, Cabezas, m³, etc.)
• Documento de transporte tenga el label correcto (Carta de Porte, DTE, Remito, etc.)
• Módulos activos sean los que vas a usar (podés desactivar lo que no necesités, como AFIP, fumigaciones o calidad)
• Categorías de gasto estén alineadas con tu operación (combustible, peaje, lavado, viático…)
• Tipos de documento incluyan los que les vencen a choferes y camiones (carnet, VTV, seguro…)

Paso 4. Cargá los datos maestros

En este orden, para que después todo encadene bien:

1. Choferes (/choferes → Nuevo chofer) — nombre, DNI, contacto, modelo de pago (porcentaje, monto fijo o sueldo + km extra)
2. Camiones (/camiones → Nuevo camión) — patente, capacidad, tipo de vehículo
3. Dadores de carga (/dadores) si trabajás con terceros
4. Puntos de carga/descarga (/puntos) — los habituales (acopios, plantas, tambos…)
5. Tarifarios (/tarifarios) si tenés tarifas estandarizadas por ruta

Paso 5. Invitá a tu equipo

Andá a Administración → Usuarios (/usuarios):

1. Click en "Nuevo usuario"
2. Ingresá nombre, email y elegí el rol (operario o chofer)
3. El sistema genera una contraseña inicial que vas a compartir con el usuario
4. Cuando entre, le va a pedir cambiarla

Si tenés roles más finos en mente, podés editar permisos por rol desde /roles (admin). Por defecto los 3 roles tienen permisos sensatos para arrancar.

Paso 6. Tu primer viaje de prueba

Aunque no esté toda la flota cargada, registrá un viaje para verificar que el cálculo funciona como esperabas:

1. Operaciones → Viajes → Nuevo viaje
2. Elegí chofer, camión, origen y destino
3. Cargá la cantidad y la tarifa
4. Si trabajás con dador, indicá el porcentaje
5. Guardá

Vas a ver el viaje en el listado con el flete bruto, comisión dador, flete neto, monto al chofer y ganancia empresa calculados automáticamente.

Listo, ya operás

A partir de acá:

• Los operarios cargan viajes, gastos y generan liquidaciones (ver manual del operario)
• Los choferes ven sus viajes y cargan gastos desde el celular (ver manual del chofer)
• Vos como admin mirás los reportes, exportás y configurás (ver manual del admin)

Tip: Si tenés dudas, escribinos por WhatsApp. Respondemos en minutos en horario comercial.

El admin tiene acceso a todo. Esta guía cubre las tareas que típicamente caen en tu silla: configurar la empresa, controlar la plata, ver reportes y gestionar el equipo.

Tu día desde el Dashboard

Dashboard (/dashboard) es tu pantalla de inicio. Tiene 6 zonas:

1. KPIs adaptados al rubro — ingresos, costos, rentabilidad, viajes, carga del mes
2. Alertas operativas — viajes sin facturar, gastos sin asignar
3. Saldos por chofer — quién tiene saldo pendiente
4. Vencimientos próximos — documentos que vencen en 30 días
5. Cheques por vencer — los que tenés en cartera
6. Actividad reciente — últimos viajes y gastos

Cada bloque es clickeable y te lleva a la pantalla detallada.

Configurar la empresa

Cambiar el rubro o los módulos activos

1. Andá a Administración → Configuración (/configuracion)
2. Cambiá las opciones que necesites
3. Guardá

Lo que podés ajustar:

• Rubro principal y secundarios
• Unidad de carga (kg / litros / cabezas / m³…)
• Etiqueta del documento de transporte (Carta de Porte / DTE / Remito)
• Modelo de tarifa por defecto (por peso / por volumen / por unidad / por km / fija)
• Módulos activos (AFIP, fumigaciones, calidad, etc.)
• Widgets del dashboard (qué KPIs querés ver)

Crear categorías de gasto a tu medida

Las que vienen por defecto cubren lo básico (combustible, peaje, lavado, viático). Si tenés algo específico:

1. /configuracion → sección "Categorías de gasto"
2. Click en "Nueva categoría"
3. Cargá el código y el nombre

El código no se ve, sirve para identificar la categoría en reportes y filtros.

Configurar tipos de documento que controla el sistema

1. /configuracion → sección "Tipos de documento"
2. Click en "Nuevo tipo"
3. Indicá si aplica a chofer o camion, si es obligatorio, y cuántos días antes querés que te avise

Ej: para choferes solés cargar carnet, libreta sanitaria; para camiones: VTV, seguro, RTO.

Manejar el equipo

Dar de alta un usuario

1. Administración → Usuarios (/usuarios)
2. Click en "Nuevo usuario"
3. Cargá nombre, email y rol (admin, operario, chofer)
4. El sistema te muestra una contraseña inicial que tenés que compartirle al usuario
5. Cuando entre, le va a pedir cambiarla

Editar permisos por rol

Los roles vienen con permisos sensatos por defecto. Si querés que un operario también pueda anular facturas, o que un chofer no pueda cargar gastos:

1. Administración → Roles y Permisos (/roles)
2. Elegí el rol que querés editar
3. Marcá/desmarcá permisos
4. Guardá

Los permisos siguen el formato <entidad>:<accion> (ej. viajes:write). El asterisco * significa "todos los permisos".

Resetear la contraseña de un usuario

1. /usuarios → buscá al usuario
2. Click en "Resetear contraseña"
3. El sistema genera una contraseña temporal que tenés que pasarle

Desactivar un usuario

1. /usuarios → buscá al usuario
2. Click en "Desactivar"

No lo borres si querés mantener el historial. Desactivado, no puede entrar más pero sus registros quedan vinculados (auditoría, viajes históricos, etc.).

Plata: liquidar, facturar y cobrar

Generar una liquidación de chofer

1. Operaciones → Liquidaciones → Nueva liquidación (/liquidaciones/nueva)
2. Seleccioná el chofer
3. Elegí el período (fecha desde / hasta)
4. El sistema te muestra los viajes pendientes del chofer en ese rango con el monto que le corresponde
5. Te muestra también los gastos y adelantos sin liquidar de ese chofer
6. Revisá lo que se incluye (podés excluir items)
7. Click en "Generar"

Se crea la liquidación en estado Pendiente con el cálculo automático:

total_flete_neto - total_monto_chofer - total_gastos - total_adelantos = total_neto a pagar

Marcar una liquidación como pagada

1. /liquidaciones → click en la liquidación
2. Botón "Cambiar estado" → Pagada

Una vez pagada, los viajes/gastos/adelantos asociados quedan marcados como liquidado y no aparecen más en futuras liquidaciones.

Emitir una factura

Hay dos caminos: factura manual o factura electrónica AFIP (si tenés el módulo activo).

Factura manual:

1. Operaciones → Facturas → Nueva factura (/facturas)
2. Elegí tipo (emitida o recibida)
3. Cliente/proveedor, número de comprobante, importe, fecha
4. Vinculá los viajes que se facturan (opcional)
5. Guardá

Factura electrónica AFIP (necesita el módulo y certificados cargados):

1. Operaciones → AFIP (/afip)
2. Click en "Nuevo comprobante"
3. Elegí tipo (A/B/C), cliente, importe e IVA
4. Click en "Emitir"
5. El sistema pide el CAE a AFIP y devuelve el comprobante autorizado

Solo el admin puede emitir notas de crédito. Los operarios emiten facturas normales pero no notas de crédito.

Configurar AFIP por primera vez

1. /afip → pestaña "Configuración"
2. Cargá CUIT, razón social, condición frente al IVA, punto de venta
3. Subí el certificado (certificate.pem) y la clave privada
4. Elegí ambiente (homologacion para probar, produccion para emitir)
5. Click en "Test de conexión" — si sale OK, marcá Habilitado

Cargar un cheque recibido

1. Operaciones → Cheques → Nuevo cheque (/cheques)
2. Número, banco, fecha de vencimiento, importe
3. Estado inicial: cartera
4. Subí la foto del cheque si querés

Después podés cambiar el estado a depositado o rechazado.

El dashboard te muestra cheques por vencer en 30 días. Configurá la alerta desde /alertas.

Plata: cuándo te entra y cuándo te sale

Flujo de caja proyectado

1. Andá a Administración → Flujo de Caja (/flujo-caja)
2. Elegí el rango de fechas
3. Vas a ver:
   • Ingresos proyectados: facturas a cobrar
   • Egresos proyectados: liquidaciones pendientes, cheques propios a vencer, gastos
   • Saldo acumulado por día/semana

Cuenta corriente de un chofer

1. /choferes → click en un chofer → "Ver cuenta" (también /choferes/[id]/cuenta)
2. Tabla de movimientos: viajes, adelantos, gastos
3. Saldo neto al día

Mirar el negocio: reportes

Andá a Administración → Reportes (/reportes). Tenés:

Todos exportables a CSV.

Exportar datos a CSV (solo admin)

Cada reporte tiene un botón "Exportar". También podés ir directo a las pantallas y exportar:

• /viajes → Exportar viajes
• /liquidaciones → Exportar liquidaciones
• /gastos → Exportar gastos
• /facturas → Exportar facturas

Auditoría y seguridad

Ver quién hizo qué

1. Administración → Logs de Auditoría (/audit-logs)
2. Filtrá por usuario, entidad o rango de fechas
3. Cada log muestra: usuario, acción (Create/Update/Delete), entidad, fecha, IP

Los logs son append-only: nadie puede borrarlos ni editarlos. Es tu evidencia ante cualquier auditoría externa.

Centro de alertas

1. Administración → Alertas (/alertas)
2. Configurá qué alertas querés que el sistema te muestre:
   • Documentos vencidos / por vencer
   • Cheques por vencer
   • Viajes sin facturar
   • Liquidaciones pendientes
   • Gastos sin viaje asignado
3. Activá / desactivá según tu operación

Las alertas también se ven inline en el dashboard. Si no querés ruido, podés desactivarlas individualmente.

Truco diario

Si entrás cada mañana y mirás estos tres lugares, vas siempre al día:

1. Dashboard — para ver el estado general de un vistazo
2. Alertas — para resolver vencimientos y pendientes
3. Flujo de Caja — para no llevarte sorpresas a fin de mes

El operario es el motor de la operación diaria: carga viajes, controla documentos, prepara liquidaciones y emite facturas. Esta guía cubre las tareas que vas a hacer todos los días.

Lo primero que ves: tu Dashboard

Dashboard (/dashboard) te muestra:

• Viajes y carga del mes
• Alertas operativas (lo que tenés que resolver)
• Saldos pendientes por chofer
• Documentos por vencer

Lo más útil del dashboard: te avisa qué chofer está esperando que le liquides.

Trabajar con viajes

Cargar un viaje nuevo

1. Operaciones → Viajes → Nuevo viaje (/viajes/nuevo)
2. Elegí fecha, chofer y camión
3. Cargá origen y destino (podés elegir un punto guardado o escribir nuevo)
4. Cantidad de carga y unidad (kg, litros, etc.)
5. Tarifa: si tenés tarifarios cargados, el sistema sugiere la del par origen-destino
6. Tipo de viaje: propio o dador — si es dador, elegilo y el sistema calcula la comisión
7. Número de documento de transporte (Carta de Porte / DTE / Remito según rubro)
8. Si el rubro lo pide, completá campos regulatorios (CTG, DTE, HAZMAT)
9. Click en "Guardar"

El sistema calcula automáticamente: flete_bruto = cantidad × tarifa, comisión_dador, flete_neto, monto_chofer y ganancia_empresa.

Duplicar un viaje (para rutas repetitivas)

1. En /viajes, click en los tres puntos de la fila
2. "Duplicar"
3. Se abre el formulario pre-cargado con todos los datos
4. Cambiá fecha (y lo que cambie) y guardá

Editar un viaje

1. /viajes → click en la fila
2. Se abre /viajes/[id]/editar
3. Modificá y guardá

Si el viaje ya está liquidado o facturado, algunos campos quedan bloqueados. Si necesitás cambiarlos, hablá con el admin para que anule la liquidación/factura primero.

Importar viajes desde CSV

Si venís de Excel:

1. /viajes/importar
2. Subí el archivo CSV (columnas: fecha, chofer, camión, origen, destino, cantidad, tarifa, etc.)
3. Mapeá las columnas
4. Vista previa
5. Click en "Importar"

El sistema valida que choferes y camiones existan. Los que no encuentre te los marca para corregir antes de importar.

Rutas programadas (las que se repiten)

Si una ruta es recurrente (ej. acopio → puerto todos los lunes y miércoles):

1. Operaciones → Rutas → Nueva ruta programada
2. Cargá nombre, chofer, camión, origen, destino, tarifa
3. Marcá los días de la semana que aplica
4. Activá la ruta

Después, para generar los viajes:

1. /rutas-programadas → "Generar viajes"
2. Elegí el rango (ej. próxima semana)
3. El sistema crea automáticamente todos los viajes según los días configurados

Cargar mediciones de calidad

Si el rubro tiene módulo de calidad activo (típicamente lechero, alimentos, suero):

1. Abrí el viaje
2. Pestaña "Calidad"
3. Cargá cada medición (temperatura, humedad, grasa, sólidos, lo que aplique)
4. El sistema te avisa si está fuera de rango

Cargar paradas multi-stop

Para viajes con varias cargas/descargas (típico lechero o construcción):

1. Abrí el viaje
2. Pestaña "Paradas"
3. Agregá cada parada en orden: punto, tipo (carga/descarga), cantidad, hora
4. Guardá

Trabajar con gastos

Cargar un gasto

1. Operaciones → Gastos → Nuevo gasto (/gastos)
2. Fecha, chofer (quién lo hizo)
3. Tipo (combustible, peaje, lavado, viático…)
4. Monto, lugar, número de factura (si aplica)
5. Si es gasto de viaje específico, vinculalo al viaje
6. Subí la foto del comprobante (opcional)
7. Guardá

Asignar un gasto a un viaje (post-carga)

A veces el gasto se carga sin viaje (porque no se sabía cuál). Después:

1. /gastos → click en el gasto
2. Campo "Viaje asignado" → buscá el viaje
3. Guardá

Los gastos vinculados a viajes inciden en la rentabilidad del viaje en los reportes.

Cargar un adelanto a un chofer

1. Operaciones → Adelantos → Nuevo adelanto (/adelantos)
2. Chofer, monto, fecha, descripción
3. Guardá

El adelanto se va a descontar automáticamente en la próxima liquidación del chofer.

Liquidar choferes

Generar la liquidación de la semana

1. Operaciones → Liquidaciones → Nueva liquidación (/liquidaciones/nueva)
2. Elegí el chofer
3. Período: fecha desde / hasta
4. El sistema te muestra:
   • Viajes pendientes del chofer en ese rango
   • Gastos pendientes
   • Adelantos sin liquidar
5. Revisá lo que entra (podés excluir items)
6. Click en "Generar"

Se crea en estado pendiente con todos los cálculos hechos:

• Flete neto que generó
• Lo que le corresponde por contrato (porcentaje / monto fijo / sueldo + km extra)
• Gastos a descontar
• Adelantos a descontar
• Neto a pagar

Marcar como pagada

1. /liquidaciones → click en la liquidación
2. "Cambiar estado" → Pagada

Una vez pagada, ya no podés editarla. Si tenés un error, el admin la puede anular.

Documentos: que nada venza sin enterarte

Cargar un documento

1. Operaciones → Documentos → Nuevo documento (/documentos)
2. Tipo (carnet, libreta sanitaria, RTO, seguro, VTV, lo que esté configurado en /configuracion)
3. ¿De qué chofer / camión?
4. Fecha de vencimiento
5. Días de anticipación para alerta (por defecto 30)
6. Subí el archivo si tenés la foto

Ver qué vence próximamente

1. /documentos → pestaña "Vencimientos"
2. El sistema te lista lo que vence en los próximos 30 días (configurable)
3. Renová y subí el nuevo cuando lo tengas

Facturas

Emitir una factura manual

1. Operaciones → Facturas → Nueva factura (/facturas)
2. Tipo: emitida
3. Cliente, número de comprobante, importe, fecha
4. Vinculá los viajes que estás facturando (opcional)
5. Subí la imagen si querés
6. Guardá

Emitir una factura electrónica AFIP

Necesitás que el admin haya configurado AFIP primero.

1. Operaciones → AFIP → Nuevo comprobante (/afip)
2. Elegí tipo (A/B/C según el cliente)
3. Cliente: CUIT, razón social, condición IVA
4. Importes (neto, IVA, total)
5. Asociá viajes (opcional)
6. Click en "Preview" para revisar
7. Click en "Emitir"

El sistema pide el CAE a AFIP y vuelve con el comprobante autorizado. Podés descargar el PDF desde el listado.

Las notas de crédito las emite solo el admin. Si necesitás anular una factura, pedísela.

Marcar una factura como pagada / recibida

1. /facturas → click en la factura
2. Editar → estado o cargá el cheque recibido

Cheques recibidos

Cargar un cheque

1. Operaciones → Cheques → Nuevo cheque (/cheques)
2. Número, banco, vencimiento, importe
3. Estado: cartera
4. Foto del cheque (opcional)

Después, cuando lo deposites:

1. Click en el cheque → "Cambiar estado" → Depositado

Si rebota: "Rechazado".

Recursos: choferes, camiones, dadores, puntos

Dar de alta un chofer

1. Recursos → Choferes → Nuevo chofer (/choferes)
2. Nombre, DNI, teléfono
3. Si el chofer también tiene usuario para entrar al sistema, vinculalo (admin lo crea desde /usuarios y vos lo asociás acá)
4. Modelo de pago:
   • Porcentaje: cobra un % del flete neto (lo más común)
   • Monto fijo: cobra un monto por viaje
   • Sueldo + km extra: sueldo fijo mensual + tarifa por km extra sobre un mínimo

Dar de alta un camión

1. Recursos → Camiones → Nuevo camión (/camiones)
2. Patente, marca, modelo, año
3. Tipo de vehículo (camión, acoplado, semirremolque, refrigerado, etc.)
4. Capacidad y unidad (kg/litros)
5. Si transporta materiales peligrosos, marcá HAZMAT habilitado

Dar de alta un dador de carga

1. Recursos → Dadores → Nuevo dador (/dadores)
2. Nombre, CUIT, contacto
3. Porcentaje habitual: el % de comisión que cobra ese dador por viaje
4. Condición frente al IVA (para emitirle facturas)

Crear un punto de carga/descarga

1. Recursos → Puntos → Nuevo punto (/puntos)
2. Nombre (ej. "Acopio La Pampa")
3. Dirección, localidad, provincia
4. Contacto si lo tenés

Los puntos quedan disponibles en el autocomplete cuando cargás viajes. Te ahorra escribir lo mismo cada vez.

Tip diario

Si seguís esta rutina, no se te escapa nada:

1. A la mañana: cargá los viajes del día anterior (los que faltan)
2. Cargá los gastos que vinieron por WhatsApp / papel
3. Revisá las alertas — resolvé documentos por vencer
4. A fin de semana: generá las liquidaciones de los choferes
5. Cuando facturás a un dador, vinculá los viajes

Tu vista de Tramo está pensada para usarse desde el celular en la ruta. Es simple: ves tus viajes del día, cargás los gastos cuando pasan y consultás tu saldo cuando querés.

Lo que ves cuando entrás

Tu inicio es Mi Cuenta → Inicio (/chofer):

• Viajes de hoy — los que te asignaron para el día
• Resumen del día — cuántos viajes, cuánta carga, gastos cargados
• 4 botones grandes de acceso rápido

Los 4 botones son:

1. Registrar Parada — cuando hacés una parada en un viaje
2. Gasto Rápido — para cargar un gasto al toque
3. Mis Viajes — el listado completo de tus viajes
4. Mi Estado — saldo y movimientos

Cargar un gasto en el momento

Cuando pasás por un peaje, cargás combustible, lavás el camión, lo que sea:

1. Tocá Gasto Rápido (también podés ir a /gastos/rapido)
2. Elegí el tipo (combustible, peaje, lavado, viático…)
3. Cargá el monto
4. Descripción corta (ej. "YPF Ruta 9 km 230")
5. Sacale foto al ticket y subila (el botón sube directo desde la cámara)
6. Guardá

Listo. Queda registrado y el operario lo ve al instante.

No tenés que asignarlo a un viaje. Si fue de un viaje específico, el operario lo asocia después desde su pantalla.

Registrar una parada

Cuando llegás a un punto de carga o descarga, o hacés una parada técnica:

1. Tocá Registrar Parada (también /chofer/parada)
2. Elegí el viaje del día
3. Tipo de parada: carga, descarga, combustible, control, descanso, reparación
4. Ubicación (escribilo o elegí un punto guardado)
5. Si es carga/descarga, cargá la cantidad
6. Hora de llegada / salida (se llenan automáticamente con la hora actual, podés ajustar)
7. Observaciones si querés
8. Guardá

Esto le permite al admin/operario ver dónde estuviste y con qué cargas.

Ver tus viajes

Mi Cuenta → Mis Viajes (que apunta a /viajes filtrado para vos):

• Listado completo de los viajes asignados
• Filtros por fecha, estado de liquidación
• Click en un viaje para ver el detalle

Solo ves tus viajes, no los de otros choferes. Es lectura — no podés editarlos.

Ver tu saldo

Mi Cuenta → Mi Estado (/chofer/cuenta) te muestra:

• Flete pendiente — lo que generaste con tus viajes y todavía no se liquidó
• Gastos — gastos que cargaste y todavía no se liquidaron
• Adelantos — adelantos que te dieron y todavía no se descontaron
• Saldo neto — flete - gastos - adelantos. Si es positivo (verde), te van a pagar. Si es negativo (rojo), tenés un saldo en contra.

Más abajo: tabla de los últimos movimientos con fecha, tipo y monto.

Tus documentos

Si tenés documentos vencidos o por vencer (carnet, libreta sanitaria, etc.), el admin o el operario los cargan en el sistema y vos los ves desde la app (sin poder editarlos).

Si te vence algo, hablalo con el admin para que te lo carguen actualizado antes de que sea un problema en la ruta.

Cambiar tu contraseña

1. Tocá tu nombre arriba a la derecha
2. "Cambiar contraseña" (/cuenta/contrasena)
3. Cargá la actual y la nueva (dos veces)
4. Guardá

Lo que NO podés hacer (y por qué)

Tu rol es de lectura + carga rápida de gastos. No vas a poder:

• Crear, editar o eliminar viajes (lo hace el operario o el admin)
• Ver ni editar los datos de otros choferes
• Ver reportes globales o rentabilidad de la empresa
• Cambiar configuración del sistema

Si necesitás algo de eso, hablá con tu admin u operario.

Truco diario

1. A la mañana, abrí el inicio (/chofer) y mirá tus viajes del día
2. Cada vez que cargás combustible o pagás un peaje: 30 segundos para sacar la foto y cargarlo en Gasto Rápido
3. Cuando llegás a un punto, Registrar Parada (te toma 20 segundos)
4. A fin de semana o de mes, mirá Mi Estado para ver tu saldo