Sistema interno a la medida · en producción
La ruta cierra sola y el chofer vende sin señal: el ERP de Distribuidora del Golfo
De un Excel con tres bloques de columnas pegados a un sistema donde inventario, ruta, crédito y caja cuadran. Diecinueve módulos en seis fases, en producción desde agosto de 2026.
- Cliente
- Distribuidora del Golfo
- Industria
- Distribución mayorista y minorista con venta en ruta · Morelos, México
El problema
El documento de alcance lo resumía en una frase: Hoy el control es manual y disperso, en cuatro frentes a la vez: inventario, rutas, crédito a clientes y caja.
- El inventario de la bodega y el de cada carro se llevaban fuera de cualquier sistema: saber qué salió, qué se vendió y qué regresó dependía de que alguien lo cuadrara a mano.
- El crédito a clientes (límite, días, saldo, vencimientos) no tenía un lugar único ni una regla que impidiera fiar de más.
- El efectivo que entregaba cada chofer al final del día no se comparaba automáticamente contra lo que debía entregar.
- El negocio quería crecer en rutas y catálogo, y el control manual no aguanta ese crecimiento.
- Dos condiciones de campo descartaban un sistema enlatado: los choferes trabajan en zonas sin señal, con Android y iPhone mezclados, y el negocio tiene reglas propias (precios por carro, comisiones por chofer o producto, comida del chofer por ruta, el chofer no fía en la calle).
Antes
- Inventario: un archivo de Excel con tres bloques de columnas pegados lado a lado en la misma hoja: el catálogo, el inventario en ruta y las ventas semanales. Un solo precio por producto, sin distinguir mayoreo y menudeo ni bodega y carro, y sin costos de compra.
- Rutas, crédito y caja: control manual y disperso, según el alcance pactado.
Qué construimos
| Fase | Qué quedó funcionando |
|---|---|
| 1. Núcleo y catálogo | Base de datos y acceso por rol. Productos y categorías. Inventario independiente por almacén (bodega y cada carro) con precios de mayoreo y menudeo por producto y por almacén, existencia mínima e inventario valorizado. |
| 2. Almacén, rutas y punto de venta | Traspasos entre bodega y carros con folio y responsable. Rutas con cliente y chofer. Apertura y cierre de carga. Punto de venta de mostrador con ticket. App de chofer de cuatro pantallas: inicio, vender, cobrar y gasto. |
| 3. Crédito, cobranza y caja | Límite y días de crédito por cliente, estado de cuenta con antigüedad de saldos, bloqueo de la venta que excede el límite, cobranza diaria. Caja diaria con efectivo esperado contra entregado y diferencia calculada por la base de datos. |
| 4. Compras, costos, comisiones y utilidad | Proveedores y compras que suben el inventario solas; costo promedio y costo último; comisiones por chofer, producto y categoría con jerarquía de cinco niveles; utilidad por producto, cliente, vendedor y ruta. |
| 5. Reportes, alertas, panel y auditoría | Flujo por concepto, analíticas de producto, reporte por chofer. Cuatro alertas en vivo. Bitácora por disparadores sobre quince tablas; las ventas no se borran, se cancelan con motivo. Panel con nueve indicadores. |
| 6. Offline, carga masiva, respaldo y entrega | La app del chofer funciona el día entero sin señal y envía todo en orden al volver la red. Carga masiva desde el Excel del cliente con vista previa. Respaldo diario cifrado en dos sitios, uno de ellos la cuenta del cliente. Manual de uso dentro de la app. |
Ajustes después de la entrega
- Cantidades en enteros en toda captura y comisión del chofer descontada sola del efectivo al cerrar la carga.
- Costo de compra capturable a mano en la ficha del producto.
- Alta de carros por el propio dueño desde el sistema.
Cómo se desarrolló
- 01
Definición escrita del producto
Alcance de 19 módulos, reglas de negocio validadas con el dueño y plan de seis fases con el entregable de cada una. Nada se renegoció sin avisar.
- 02
Sistema de diseño antes de la primera pantalla
Un solo lenguaje visual para administración y app de chofer.
- 03
Plan por fase, pruebas primero, revisión
Cada tarea se construyó con pruebas escritas antes que el código y se revisó antes de integrarse.
- 04
Puerta de calidad antes de cerrar cada fase
Compilación sin errores y cuatro suites en verde. La corrida de entrega: 1,148 pruebas automatizadas, incluida una que verifica que inventario, caja, crédito y utilidad cuadren entre sí, y una de arranque en frío sin red.
- 05
Verificación con evidencia
El documento Requerimientos cumplidos compara los 19 módulos punto por punto contra la pantalla donde cada uno se cumple, y lista lo que falta con nombre.
- 06
Entrega y producción
Seis documentos en PDF, capacitación, restauración del respaldo probada. En vivo desde el 18 de agosto de 2026 con 183 productos importados del Excel del cliente.
Tecnología
Next.js 15, React 19 y TypeScript; Tailwind 4 con un sistema de diseño único; Supabase (PostgreSQL con permisos por fila, funciones atómicas por operación y bitácora por disparadores); PWA offline-first con cola de escrituras en IndexedDB; Vercel con dominio propio. Pruebas con Vitest, pgTAP y Playwright. 49 migraciones, 24 tablas y 6 vistas.
Cifras verificadas
- Módulos pactados
- 19
- Fases con entregable aceptado
- 6
- Pruebas automatizadas
- 1,148
- Tiempo de desarrollo
- ~6 semanas
- En producción desde
- 18 ago 2026
- Productos importados del Excel del cliente
- 183
- Migraciones · tablas · vistas
- 49 · 24 · 6
- Documentos de entrega
- 6
Métricas de negocio (tiempo de cierre de ruta, diferencias de caja, cartera vencida) se publicarán cuando el cliente las mida a los 90 días de uso. No estimamos ninguna.
Qué cambió
El chofer vende, cobra y registra gastos sin señal
Desde su teléfono; el sistema envía todo solo al volver la red, en orden y sin duplicar. No tener señal es el modo normal de trabajo, no una avería.
El cierre de ruta cuadra solo
Al cerrar la carga, el sistema calcula lo vendido, lo devuelto y la diferencia, y compara el efectivo que el chofer debe entregar contra lo que entrega.
El crédito tiene límite de verdad
Una venta a crédito que excede el límite del cliente se rechaza con saldo, límite y disponible a la vista antes de cobrar.
El corte de caja lo calcula la base de datos
Fondo inicial, ventas y abonos en efectivo, gastos y depósitos, con la diferencia pintada en rojo si no cuadra.
Todo en un solo lugar
Inventario por almacén, precios por carro, compras y costos, comisiones, cobranza y caja, con un panel de nueve indicadores al abrir el sistema.
El cliente es dueño de todo
Código, base de datos, dominio y respaldo diario cifrado con copia en su propia cuenta; el manual técnico permite que cualquier desarrollador continúe.
¿Tienes un problema parecido?
Inventario en Excel, vendedores en ruta, crédito que no se sabe hasta el viernes. Cuéntanos cómo lo llevan hoy y te decimos, en 20 minutos, si tiene sentido un sistema a la medida.