Criar conta grátis

Froc Entregas: integre sua loja e chame entregadores automaticamente

Pastelaria, lanchonete, restaurante, farmácia ou loja: quando entra um pedido no seu sistema, a Froc chama o entregador mais perto, o cliente acompanha pelo link e você recebe cada mudança de situação no seu sistema.

ComeçarSem programarAutenticaçãoCotaçãoCriar entregaConsultar e cancelarWebhooksErros e limites

Começar em 5 passos

  1. Crie a conta no app e vá em Conta › Froc para lojas.
  2. Envie o nome da loja, o CNPJ (MEI aceito), o telefone e o endereço de coleta. A equipe Froc confere e libera.
  3. Recarregue a carteira (Pix ou cartão). Cada entrega usa o saldo: o valor fica retido e só vai para o entregador quando o cliente informa o código de entrega.
  4. No painel da loja, crie uma chave de API (ela aparece uma única vez — guarde em local seguro, nunca no site ou no app do cliente).
  5. Cadastre o endereço do seu webhook e teste. Pronto: seu sistema já chama entregas sozinho.

Sem programar

Não tem sistema? Use o painel da loja dentro do app: digite o endereço do cliente, nome e telefone e toque em "Chamar entregador". Você vê o entregador no mapa e manda o link de acompanhamento para o cliente pelo WhatsApp.

Autenticação

Todas as chamadas vão para https://froc-x-uber.vercel.app/api/v1 com o cabeçalho:

Authorization: Bearer froc_live_SUA_CHAVE

A Froc guarda só a impressão digital (SHA-256) da chave. Se ela vazar, revogue no painel e crie outra. As chamadas são de servidor para servidor (não chame a API direto do navegador).

Cotação (preço antes de chamar)

POST https://froc-x-uber.vercel.app/api/v1/deliveries/quote
Content-Type: application/json

{
  "dropoff": { "address": "Rua das Flores, 120 - Centro, Campinas - SP", "lat": -22.9056, "lng": -47.0608 }
}

Resposta: { "price": 14.9, "currency": "BRL", "distanceKm": 4.3, "durationMin": 14, "surge": 1 }. Sem pickup, a coleta é o endereço cadastrado da loja.

Criar entrega

POST https://froc-x-uber.vercel.app/api/v1/deliveries
Content-Type: application/json

{
  "orderRef": "PED-1029",
  "dropoff": { "address": "Rua das Flores, 120 - apto 32", "lat": -22.9056, "lng": -47.0608 },
  "recipient": { "name": "Maria Souza", "phone": "19988887777" },
  "items": "2 pastéis de carne, 1 caldo de cana",
  "note": "Interfone 32. Troco não precisa.",
  "vehicle": "moto"
}

Resposta 201:

{
  "delivery": {
    "id": "8f1c...",
    "status": "procurando_entregador",
    "statusLabel": "Procurando entregador",
    "price": 14.9,
    "deliveryCode": "4821",
    "trackingUrl": "https://froc-x-uber.vercel.app/acompanhar/Xy7...",
    "orderRef": "PED-1029",
    "courier": null
  }
}

Envie ao cliente o link de acompanhamento e o código de entrega. O entregador só conclui a entrega quando o cliente informa o código — é isso que libera o pagamento.

Consultar e cancelar

GET  https://froc-x-uber.vercel.app/api/v1/deliveries/{id}
GET  https://froc-x-uber.vercel.app/api/v1/deliveries?status=saiu_para_entrega
POST https://froc-x-uber.vercel.app/api/v1/deliveries/{id}/cancel
GET  https://froc-x-uber.vercel.app/api/v1/me

Situações: procurando_entregador → entregador_a_caminho → entregador_na_loja → saiu_para_entrega → entregue (ou cancelada). Dá para cancelar até o entregador coletar o pedido; o valor volta para a carteira. Sem entregador em 20 minutos, a entrega é cancelada sozinha e o valor volta.

Webhooks (aviso automático no seu sistema)

A cada mudança, a Froc faz um POST JSON no endereço cadastrado (precisa ser https público). Eventos: delivery.created, delivery.courier_assigned, delivery.courier_at_pickup, delivery.picked_up, delivery.delivered, delivery.cancelled e webhook.test.

POST https://seusistema.com.br/froc/webhook
X-Froc-Event: delivery.picked_up
X-Froc-Signature: t=1763300000,v1=5f2c...
Content-Type: application/json

{ "id": "evt...", "type": "delivery.picked_up", "createdAt": "2026-11-16T18:20:00.000Z", "data": { "id": "8f1c...", "status": "saiu_para_entrega", ... } }

Confira a assinatura com o segredo whsec_... mostrado ao cadastrar o webhook (HMAC-SHA256 de t + "." + corpo):

import crypto from 'node:crypto';

export function assinaturaValida(segredo, corpoBruto, cabecalho) {
  const partes = Object.fromEntries(cabecalho.split(',').map((p) => p.split('=')));
  if (Math.abs(Date.now() / 1000 - Number(partes.t)) > 300) return false; // mais de 5 min: recusa
  const esperado = crypto.createHmac('sha256', segredo).update(partes.t + '.' + corpoBruto).digest('hex');
  const a = Buffer.from(esperado), b = Buffer.from(partes.v1 || '');
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Responda com status 2xx em até 5 segundos. Se falhar, a Froc tenta de novo em 1, 5, 15 e 60 minutos, 3 h e 12 h. Use o campo id do evento para não processar o mesmo aviso duas vezes.

Erros e limites

StatusQuando
400Dados inválidos (endereço, telefone, distância acima de 60 km). A mensagem explica o que corrigir.
401Chave ausente, inválida ou revogada.
402Saldo insuficiente na carteira da loja.
403Loja ainda não aprovada ou bloqueada.
404Entrega não encontrada (ou de outra loja).
409Ação impossível na situação atual (ex.: cancelar depois da coleta).
429Mais de 300 chamadas por minuto por chave.

Todas as respostas de erro têm o formato { "error": "mensagem em português", "code": "codigo_curto" }.

Regras para lojas (CNPJ, itens proibidos, bebidas para maiores de 18): veja regras e requisitos.

Pronto para começar?

Crie sua conta grátis. Inauguração em 10 de março de 2027 — quem se cadastra antes ganha o selo de membro fundador.

Criar conta grátis Quero ser motorista