Metodología FleteQ v1.0

Última actualización: 18 Mayo 2026 · Versión: 1.0 (primera versión completa)

Esta página documenta públicamente cómo FleteQ calcula costos, márgenes y precios sugeridos para el transporte mexicano. Todo es auditable contra el código fuente abierto del proyecto en github.com/gabrielescamilla96-ops/fleteq-cotizador — la fuente única de verdad es siempre el código en producción.

Si encuentras algún error, discrepancia o quieres proponer una mejora, escribe a gabriel@fleteq.mx. Las correcciones se publican en el CHANGELOG público al final de esta página.

1. Los 35 contextos del transporte mexicano

FleteQ no es un cotizador genérico. Está diseñado desde el principio para reconocer que el transporte mexicano no es uno solo, sino la combinación de 5 operaciones distintas con 7 fuentes de energía distintas — 35 contextos totales con costos, rendimientos y patrones operativos propios.

Las 5 operaciones

La operación seleccionada determina rendimientos por default, factores de mantenimiento, ejes promedio y catálogos aplicables (por ejemplo, Carta Porte SAT 3.1 aplica solo a PESADO + MEDIANO; mensajería motorizada queda fuera de esa obligación fiscal).

Definición canónica en código: constante FQ_CATALOGO_OPERACIONES dentro de FleteQ_Cotizador.html.

Las 7 fuentes de energía

La energía seleccionada determina el precio de referencia del combustible, la unidad de consumo (km/L vs km/kWh vs km/m³) y el factor de emisiones de CO₂ usado en reportes ambientales futuros.

Definición canónica en código: constante FQ_CATALOGO_ENERGIAS.

El cruce operación × energía

No todas las combinaciones son operacionalmente comunes en México hoy (un Tracto Sencillo eléctrico foráneo todavía es atípico). Pero todas son calculables: cada combinación tiene parámetros configurables. Cuando el operador selecciona una combinación poco común, FleteQ aplica los defaults más cercanos del catálogo y le pide explícitamente verificar.

2. Los 3 perfiles de empresa

Más allá del tipo de unidad y combustible, el costo real de operar un viaje depende del tipo de empresa que lo opera. Un hombre camión con su unidad propia tiene costos fijos absolutos muy distintos a una empresa de 30 unidades con administrador dedicado. FleteQ reconoce 3 perfiles canónicos.

Perfil A — Hombre camión (HOMBRE_CAMION)

• 1 unidad operativa propia.
• Operador-dueño activo en el camino.
• Estructura administrativa mínima o nula (no hay nómina formal, no hay renta de oficina, contador externo por iguala mensual).
• Sueldo operador = retiro personal del dueño (declarado en sistema, típicamente $15,000-22,000 MXN/mes).
• Sin IMSS (régimen RIF o equivalente; el dueño cotiza por separado).
• Pago por viaje variable según negociación con cliente directo.

Perfil B — Empresa pequeña (EMPRESA_PEQUENA)

• 2 a 10 unidades operativas.
• Dueño activo en operación + 1-3 operadores en nómina.
• Contador externo + renta básica de oficina o patio de unidades.
• Sueldo operador con nómina mínima IMSS + alimentos.
• Estructura administrativa parcial (un administrador medio tiempo o el dueño hace doble función).

Perfil C — Empresa mediana-grande (EMPRESA_MEDIANA_GRANDE)

• 11 a 50 unidades operativas.
• Administrador o gerente operativo dedicado.
• IMSS completo + prestaciones laborales legales.
• Oficinas formales, sistema de GPS, equipo de despachadores.
• Estructura completa de costos fijos mensuales prorrateables por viaje.

Definición canónica en código: catálogos MARKET_DEFAULTS_BASE + MARKET_OVERRIDES.HOMBRE_CAMION + MARKET_OVERRIDES.EMPRESA_PEQUENA + MARKET_OVERRIDES.EMPRESA_MEDIANA_GRANDE. La función fqGetMarketDefault(id) resuelve cada parámetro buscando primero override del perfil activo y cayendo a base si no hay override.

3. Fórmulas de costo

El costo total de un viaje en FleteQ es la suma de componentes claramente nombrados, cada uno calculado por separado. El operador puede ver el desglose completo en la pantalla de Resumen Interno después de cada cotización. No hay "factor mágico" ni multiplicadores arbitrarios.

3.1 Combustible

combustible = (kilómetros del viaje / rendimiento km por unidad de combustible) × precio por unidad

Ejemplo Tracto Sencillo Diésel:
combustible = (920 km / 3.0 km/L) × $28.20 MXN/L = $8,648 MXN

El rendimiento depende de la operación + tipo de unidad (parámetros por default desde CANACAR / IMT, ajustables por el operador). El precio por default es el publicado por la CRE actualizado periódicamente; el operador puede sobrescribirlo con su precio real.

3.2 Tripulación (sueldo + alimentos + pago variable)

Tres modelos canónicos de pago al operador, configurables por la empresa en Mis Costos:

1. Modelo mensual: sueldo fijo mensual prorrateado por días del viaje. Fórmula: (sueldo mensual / días operativos del mes) × días del viaje.
2. Modelo por viaje: pago fijo por viaje (independiente de duración). Aplicable a operadores foráneos pesados de muchas empresas pequeñas y hombres camión que pagan a un segundo operador.
3. Modelo porcentaje del precio: pago como porcentaje del precio cobrado al cliente (típicamente 10-15%). Usado por algunos hombres camión empresa chica.

Cada modelo se suma con alimentos (típico $350 MXN/día × días del viaje) y, en su caso, IMSS prorrateado.

Implementación canónica: helper fqCalcularPagoOperador() dentro del cotizador.

3.3 Unidad (mantenimiento, llantas, depreciación, seguros)

3.4 Casetas

Por default, casetas se cobran una sola vez (sentido único). Si el viaje se marca como redondo, se duplica automáticamente. FleteQ tiene un catálogo interno de 114 rutas CAPUFE actualizado periódicamente; cuando la ruta no está en el catálogo, el operador puede capturar manualmente el monto o usar la integración opcional TollGuru (cuando esté configurada).

3.5 Casos especiales

• Custodia armada (carga sobredimensionada o de alto valor): se cobra como monto manual ingresado por el operador (rango típico Veracruz/Centro/Bajío: $8,000-15,000 MXN; otras rutas: $0-5,000).
• Escolta sobredimensionada + permiso DGAF: para cargas que exceden medidas estándar SAT (cobrado solo si aplica).
• Bonos al operador (puntualidad, asistencia, rendimiento foráneo, etc.): prorrateados según frecuencia (mensual / semanal / por viaje).
• Estadías ($/día de espera del operador en destino): $/día × días de estadía, default $450 MXN/día.

3.6 Administración prorrateada

Los costos fijos mensuales del negocio (renta de oficina, sueldo administrador, contador, internet, GPS, servicios públicos, permisos de operación) se suman y se prorratean por viaje usando la fórmula: (suma costos fijos mensuales / días operativos del mes) × días del viaje.

Esto es lo que distingue una cotización honesta de un cálculo "$/km" simplista: si tu administración cuesta $50,000 MXN/mes y operas 25 días al mes, cada día operado debe absorber $2,000 de costos fijos. Un viaje de 3 días absorbe $6,000 — independientemente de si el cliente paga mucho o poco.

3.7 Costo total + precio mínimo + precio sugerido

costo total = combustible + tripulación + unidad + casetas + casos especiales + administración

precio mínimo = costo total           (margen 0%; punto de equilibrio exacto)
precio sugerido = costo × (1 + margen / 100)
utilidad estimada = precio sugerido − costo total

Implementación canónica: función recalc() dentro de FleteQ_Cotizador.html. Esta función contiene la fórmula completa y se ejecuta en tiempo real cada vez que el operador modifica cualquier parámetro.

4. Fuentes de los defaults

FleteQ pre-carga valores por default para que el operador no tenga que llenar 60+ campos antes de su primera cotización. Pero todos los defaults son editables y ningún valor está oculto. Las fuentes públicas usadas:

La sección Mis Costos del cotizador permite al operador sobrescribir cualquier default con sus valores reales (precio que paga por diésel, sueldo real de su operador, llantas de marca específica, etc.). FleteQ no tiene preferencia por marca, proveedor o cadena; el operador es la fuente de verdad para su propia operación.

5. Anti-fraude del benchmark agregado

FleteQ ofrece (con consentimiento expreso del operador, ver Política de Telemetría) un benchmark anónimo del gremio: cuando un operador cotiza un corredor (ej. Monterrey → Guadalajara), puede ver el promedio de cómo lo están cotizando otros transportistas que comparten la misma operación + energía + rango de kilometraje.

Para evitar que este benchmark se convierta en un canal de re-identificación o de espionaje comercial, FleteQ aplica 3 protecciones acumuladas:

5.1 K-anonimato N ≥ 50

El endpoint del benchmark solo entrega promedios cuando hay al menos 50 cotizaciones distintas de operadores distintos para el corredor solicitado. Si hay 49 o menos, el endpoint responde con n_cotizaciones: <N> sin entregar ningún promedio. Esto impide ataques de inferencia donde alguien con conocimiento previo intente identificar la cotización de un operador específico.

5.2 Buckets en lugar de valores exactos

• Kilometraje agrupado en buckets: <100, 100-300, 300-500, 500-1000, >1000. Nunca la distancia exacta.
• Geografía agrupada por estado origen → estado destino. Nunca dirección completa ni colonia.
• Tipo de unidad agrupado por operación (PESADO / MEDIANO / etc.). Nunca el modelo específico ni placas.

5.3 Lista explícita de qué NUNCA se envía al servidor

El payload de telemetría rechaza activamente (validación de schema en el endpoint, defensa en profundidad) los siguientes campos. Si llegan, el endpoint responde HTTP 400 y descarta el evento:

• Identificador del operador titular de la cuenta (user_id).
• RFC, razón social, datos fiscales del operador o de su cliente.
• Nombre del cliente final, correo, teléfono, dirección.
• Origen ni destino reales (solo el bucket de kilometraje).
• Detalle de costos del operador (sueldo, diésel, llantas, ningún p-* numérico individual).
• Cifras monetarias absolutas (pbox-eq, pbox-mg, utilidad, etc.).
• IP del operador ni geolocalización del dispositivo.

El operador puede activar o desactivar la telemetría en cualquier momento desde Configuración → Privacidad y telemetría. El default es OFF (opt-in expreso, conforme a Arts. 8 y 9 de la LFPDPPP vigente).

6. Versionado del schema

El Recibo de Margen Verificable (la URL pública app.fleteq.mx/v/{slugId} que el operador puede compartir con su cliente final para validar una cotización) tiene un schema versionado y firmado criptográficamente. Esto garantiza que ningún cambio futuro de FleteQ pueda alterar retroactivamente un Recibo emitido en el pasado.

6.1 Versión actual

schemaVersion: '1.0' — vigente desde mayo 2026.

6.2 Política de cambios futuros

6.3 Firma HMAC-SHA256

Cada Recibo Verificable lleva una firma HMAC-SHA256 generada con una clave secreta del servidor (variable de entorno FQ_QUOTE_SIGNING_KEY). Esto impide que alguien manipule el JSON del Recibo y lo presente como auténtico. El servidor verifica la firma al servir cada Recibo público; si la firma no coincide, devuelve HTTP 401.

La clave HMAC nunca se expone al cliente ni se loggea en consola. Aislamiento estricto.

6.4 Idempotencia

Si el operador guarda la misma cotización dos veces (mismo slug, mismos parámetros), el endpoint detecta la duplicación y responde con alreadyRegistered: true sin crear un registro adicional. Esto evita inflado artificial de la base de datos por bugs del cliente.

7. Reproducibilidad — caso canónico MTY → GDL Caja Seca

La mejor prueba de que la metodología es auditable es que cualquier operador puede tomar los mismos parámetros y reproducir el mismo número en una hoja de cálculo. FleteQ tiene un baseline canónico que se verifica automáticamente en cada deploy mediante pruebas E2E.

7.1 Caso baseline

7.2 Resultado canónico

Si el operador activa la opción de custodia armada $10,000 MXN + escolta sobredimensionada $5,000 + permiso DGAF $3,000, el costo total sube a $41,459 MXN (suma directa de los componentes adicionales).

7.3 Cómo reproducirlo manualmente

1. Abre FleteQ_Cotizador.html en tu navegador (o accede a app.fleteq.mx con tu cuenta).
2. Sin tocar Mis Costos (deja todos los defaults), ve a Cotizar Modo Simple.
3. Captura: Origen Monterrey, Destino Guadalajara, Equipo Caja Seca. Margen 30%.
4. Si el sistema no detecta automáticamente km y casetas, abre Modo Completo y captura manualmente: km = 920, casetas = 2000, ejes = 5.
5. El hero del Cotizador debe mostrar $30,497 sugerido + $7,038 ganas + badge "Margen óptimo" verde.
6. Si el resultado difiere, alguno de los defaults fue modificado en Mis Costos. Usa "Restaurar ejemplos" para volver a los defaults canónicos.

7.4 Garantía de baseline

Este caso canónico está protegido por la suite de pruebas E2E (Playwright) en el spec tools/e2e-tests/tests/03-baseline-canon.spec.js. Cada vez que se hace deploy de una nueva versión, la suite ejecuta este cálculo automáticamente. Si el resultado difiere de $23,459, el deploy se bloquea. Esta es la garantía técnica de que ningún cambio futuro del cotizador altera silenciosamente el baseline canónico sin que se detecte en CI.

Más casos canónicos verificados:

• Spec 10 (custodia $41,459)
• Spec 21 (12 rutas reales canónicas con tolerancia ±15%)
• Spec 17 (Carta Porte CFDI mock 7 sub-casos)
• Specs 27-30 (Dashboard, Mis Costos vista resumen, Historial, Rutas)

8. Glosario y conceptos clave

Costo total

La suma de todos los componentes operativos de un viaje (combustible + tripulación + unidad + casetas + casos especiales + administración prorrateada). Representa el punto de equilibrio — lo que el operador necesita cobrar para no perder dinero.

Precio mínimo

Igual al costo total. Vender por debajo de este valor genera pérdida directa.

Precio sugerido

Costo total multiplicado por (1 + margen / 100). Es el precio que el operador debería cobrar para alcanzar la rentabilidad deseada.

Margen sobre costo

Utilidad / costo. Ejemplo: si vendes en $130 algo que te costó $100, tu margen sobre costo es 30%. Esta es la métrica que FleteQ usa por default porque refleja directamente "cuánto gano por encima de lo que invertí en este viaje".

Margen sobre venta

Utilidad / precio. Para el mismo ejemplo anterior, el margen sobre venta es 23.08%. Siempre es menor que el margen sobre costo. FleteQ muestra ambos para que el operador pueda compararse con métricas que algunos clientes corporativos exigen.

Break-even (punto de equilibrio)

El nivel de operación (en viajes, kilómetros o ingresos) en el que el operador cubre exactamente sus costos. Por encima del break-even, hay ganancia; por debajo, hay pérdida.

Prorrateo de costos fijos

Distribución de los gastos mensuales fijos (renta, sueldos administrativos, contador, GPS, etc.) entre los días que efectivamente operas. Fórmula canónica FleteQ: (suma de costos fijos / días operativos del mes) × días del viaje. Sin prorrateo, un viaje corto se ve artificialmente rentable.

Días operativos

El número de días al mes que el operador efectivamente sale a operar (no necesariamente 30). Para un hombre camión foráneo típico son 24-26 días/mes. Este parámetro afecta directamente el prorrateo §3.6.

Custodia armada

Servicio de escolta privada armada para cargas de alto valor o de alto riesgo en corredores específicos (Veracruz/Centro/Bajío). Se cotiza como monto manual; FleteQ no recomienda proveedores específicos.

Carta Porte 3.1

Complemento obligatorio del CFDI 4.0 que documenta el traslado de mercancías por autotransporte federal en México. Obligación fiscal desde 2022; sanciones por incumplimiento $19,700 a $112,650 MXN (Art. 84 fracc IV CFF, según RMF 2026 Anexo 5), más posibilidad de cancelación del CSD y sanción penal de 3 a 6 años.

PAC (Proveedor Autorizado de Certificación)

Empresa autorizada por el SAT para timbrar CFDIs en nombre del contribuyente. FleteQ se integrará con un PAC autorizado (Facturama o Diverza) para emisión real de Carta Porte timbrada. Estado actual del producto: modo demostración pre-launch hasta junio 2026.

K-anonimato

Técnica estadística que garantiza que ningún dato agregado puede atribuirse a un individuo específico. FleteQ aplica K-anonimato N≥50 en su benchmark gremial: ningún promedio se entrega si hay menos de 50 cotizaciones distintas para el corredor solicitado.

Recibo de Margen Verificable

URL pública opcional (app.fleteq.mx/v/{slugId}) que el operador puede compartir con su cliente final para que éste pueda validar criptográficamente (firma HMAC-SHA256) que la cotización original no fue manipulada después de su envío.

CHANGELOG