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
- Crie a conta no app e vá em Conta › Froc para lojas.
- Envie o nome da loja, o CNPJ (MEI aceito), o telefone e o endereço de coleta. A equipe Froc confere e libera.
- 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.
- 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).
- 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"
}
orderRef: o número do pedido no seu sistema. Mandou duas vezes? A Froc devolve a mesma entrega (não cobra em dobro).dropoff: envielatelng. Só tem o endereço em texto? Envieaddress— a Froc localiza quando a busca de endereços está ativada na plataforma.vehicle:moto,carroouqualquer(padrão).- Até 60 km e 20 kg em moto. Para cargas maiores, use o módulo Cargas.
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
| Status | Quando |
|---|---|
| 400 | Dados inválidos (endereço, telefone, distância acima de 60 km). A mensagem explica o que corrigir. |
| 401 | Chave ausente, inválida ou revogada. |
| 402 | Saldo insuficiente na carteira da loja. |
| 403 | Loja ainda não aprovada ou bloqueada. |
| 404 | Entrega não encontrada (ou de outra loja). |
| 409 | Ação impossível na situação atual (ex.: cancelar depois da coleta). |
| 429 | Mais 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