Sua plataforma manda os pedidos.
Volta rota pronta.

# Autenticação

Base URL https://rotapro.net.br/v1. Toda chamada exige sua API key no header — server-to-server apenas, nunca exponha a key no front-end.

copiarAuthorization: Bearer rl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Key ausente ou inválida → 401. Limite excedido → 429 (padrão 60 req/min, ajustável por contrato). Teste rápido: GET /v1/ping devolve pong com o nome da sua plataforma.

# Gerar rota

POST/v1/resolve

Recebe até 25 pedidos por chamada e devolve endereços geocodificados, ordem otimizada de entrega e link do Google Maps.

Requisição

copiar{
  "origin": { "lat": -26.4851, "lng": -49.0713, "city": "Guaramirim", "uf": "SC" },
  "orders": [
    {
      "external_id": "pedido-8841",
      "structured": {
        "numero_pedido": "8841",
        "cliente_nome": "Maria Silva",
        "telefone": "47999990000",
        "endereco": {
          "logradouro": "Rua 28 de Agosto", "numero": "2200",
          "bairro": "Centro", "cidade": "Guaramirim",
          "uf": "SC", "cep": "89270-000"
        }
      }
    },
    { "external_id": "pedido-8842", "text": "texto integral da comanda..." },
    { "external_id": "pedido-8843", "image": { "fileName": "comanda.jpg", "data": "<base64>" } }
  ]
}

Formas de entrada (exatamente uma por pedido)

Resposta 200

copiar{
  "success": true,
  "mapsLink": "https://www.google.com/maps/dir/?api=1&travelmode=driving&waypoints=...&destination=...",
  "orders": [
    {
      "external_id": "pedido-8841",
      "order": 1,                          // posição na rota otimizada
      "endereco": { ...validado... },
      "lat": -26.4702, "lng": -49.0028,
      "number_not_confirmed": false,  // true = número não confirmado pelo geocoder
      "city_mismatch": false          // true = cidade vizinha, dentro do raio
    }
  ],
  "rejected": [ { "external_id": "pedido-8842", "reason": "NO_GOOGLE_RESULTS" } ]
}

# Erros

Motivos de rejeição em rejected[].reason: INSUFFICIENT_DATA, NO_GOOGLE_RESULTS, EXTRACT_FAILED / EXTRACT_EMPTY.

# Boas práticas

• structured sempre que possível — mais barato, rápido e preciso
• Cacheie o origin — geocodifique o estabelecimento uma vez e reutilize as coordenadas
• Sempre envie external_id — é como você reconcilia resposta e rejeitados
• Agrupe pedidos da mesma leva numa única chamada — a otimização depende de vê-los juntos
• Trate os rejected no seu operador: corrigir endereço e reenviar

# Simule seu custo

Valores de referência por pedido processado — condições finais (incluindo piloto com desconto) no contrato de parceria. Sem taxa de setup. Seus primeiros 500 pedidos são grátis (30 dias) e o 1º mês não tem mensalidade. Pedido enviado como foto da comanda tem adicional de R$ 0,05 (repasse do custo de IA); texto cru não paga adicional.