Saltar al contenido principal
Routal

Recetas

Walkthroughs end-to-end ejecutables — uno por cada ritmo operativo común.

Las páginas de esta sección son escenarios completos y ejecutables — no snippets sueltos. Cada una recorre desde el problema de negocio (la conversación que tiene un sales rep con un prospecto) hasta una integración production-ready (el runbook que necesita un platform team), en los tres lenguajes que la mayoría de integraciones de Routal entregan hoy.

Encuentra la receta más cercana a tu operación:

B2B / impulsado por ERP

  • Batch nocturno — distribución B2B — los pedidos cierran ayer a las 18:00, la flota sale al amanecer. El modo por defecto de distribuidores de alimentación, mayoristas de bebidas y suministro industrial.
  • Batch nocturno + dispatch en vivo — la mayoría del trabajo es el batch nocturno, pero llegan pedidos durante la operación que hay que encajar en rutas ya en marcha sin disrumpir a los conductores.
  • Distribución capacitada — peso, volumen, cadena de frío, cargas especiales. El optimizador respeta cada restricción declarada.
  • Logística inversa — recogidas, devoluciones, RMA, asset recovery. Rutas puras de recogida o mixtas delivery + pickup vía el chain de Routal.

B2C / customer-facing

Servicio y calendario

  • Servicio técnico con citas — técnicos, instaladores, fuerza móvil. Ventanas estrechas, asignación por habilidades, tasks de firma/foto/checklist.
  • Servicios recurrentes — mantenimiento, ITV, recargas de gas, ascensores. Mismo cliente cada N semanas en el mismo slot contratado — el calendario es el producto.

Cada receta abre con una tarjeta TL;DR (industria, ERPs, restricciones, flow en N pasos) más un botón "Open in AI" que pega el contexto del recipe en tu asistente favorito. Bajo la tarjeta, un perfil de negocio de un párrafo (para quién es, cuál es su dolor, cuál es su ritmo diario), luego las decisiones arquitecturales y el código production-ready.

Convenciones de todas las recetas

  • Los IDs en samples de código son placeholders. YOUR_KEY, YOUR_PROJECT_ID, PLAN_ID, ROUTE_ID, STOP_ID — sustituye por valores reales de 24 caracteres hex de tu tenant.
  • external_id es tu palanca de idempotencia. Cada receta asume que llevas un identificador estable desde tu sistema origen (número de pedido, matrícula, job ID, ticket ID).
  • Los timestamps son ISO 8601 UTC. Time windows en stops y vehicles van en segundos desde la medianoche ([28800, 61200] = 8h–17h en la zona local del proyecto).
  • Todos los snippets redactan private_key de los logs. La key en la URL es el vector de fuga más grande — consulta Authentication.
  • Los ejemplos son deliberadamente geography-agnostic. Los clientes de Routal operan en cinco continentes; coordenadas y nombres placeholder funcionan en cualquier jurisdicción.

El contenido técnico profundo de cada receta (production code en TS/Python/cURL, production hardening, common errors) vive en inglés. La tarjeta TL;DR y la sección "Para quién es" en español arriba bastan para auto-identificar si una receta encaja con tu operación.