Receitas

As páginas desta seção são cenários completos e executáveis — não snippets soltos. Cada uma percorre desde o problema de negócio (a conversa que um sales rep tem com um prospect) até uma integração production-ready (o runbook que um platform team precisa), nas três linguagens em que a maioria das integrações da Routal entrega hoje.

Encontre a receita mais próxima da sua operação:

B2B / impulsionado por ERP

• Batch noturno — distribuição B2B — os pedidos fecham ontem às 18:00, a frota sai ao amanhecer. O modo padrão de distribuidores de alimentos, atacadistas de bebidas e suprimento industrial.
• Batch noturno + dispatch ao vivo — a maioria do trabalho é o batch noturno, mas chegam pedidos durante a operação que precisam ser encaixados em rotas já em curso sem disruptar os motoristas.
• Distribuição capacitada — peso, volume, cadeia de frio, cargas especiais. O otimizador respeita cada restrição declarada.
• Logística reversa — coletas, devoluções, RMA, asset recovery. Rotas puras de coleta ou mistas delivery + pickup via o chain da Routal.

B2C / customer-facing

• Última milha e-commerce — pacotes B2C com tracking automático. Alta densidade de stops, SMS/email automáticos via customers app.
• Grocery — entrega no mesmo dia — dark stores e mercados same-day. Otimização por waves, cadeia de frio, SLAs sub-2h.

Serviço e calendário

• Serviço técnico com agendamento — técnicos, instaladores, força móvel. Janelas estreitas, atribuição por habilidades, tasks de assinatura/foto/checklist.
• Serviços recorrentes — manutenção, vistoria, recargas de gás, elevadores. Mesmo cliente a cada N semanas no mesmo slot contratado — o calendário é o produto.

Cada receita abre com um cartão TL;DR (indústria, ERPs, restrições, flow em N passos) mais um botão "Open in AI" que cola o contexto da receita no seu assistente favorito. Sob o cartão, um perfil de negócio de um parágrafo (para quem é, qual é a dor, qual é o ritmo diário), depois as decisões arquiteturais e o código production-ready.

Convenções de todas as receitas

• Os IDs nos samples de código são placeholders. YOUR_KEY, YOUR_PROJECT_ID, PLAN_ID, ROUTE_ID, STOP_ID — substitua por valores reais de 24 caracteres hex do seu tenant.
• external_id é sua alavanca de idempotência. Cada receita assume que você carrega um identificador estável do sistema de origem (número do pedido, placa, job ID, ticket ID).
• Os timestamps são ISO 8601 UTC. Time windows em stops e vehicles vão em segundos desde a meia-noite ([28800, 61200] = 8h–17h no fuso local do projeto).
• Todos os snippets redactam private_key dos logs. A chave na URL é o maior vetor de vazamento — veja Authentication.
• Os exemplos são deliberadamente geography-agnostic. Os clientes da Routal operam em cinco continentes; coordenadas e nomes placeholder funcionam em qualquer jurisdição.