Zonas de entrega
Zonas de entrega definem a área geográfica que o seu restaurante atende. Quando um cliente faz um pedido de delivery pelo WhatsApp, o sistema verifica automaticamente se o endereço dele está dentro de uma das suas zonas — e aplica a taxa de entrega correspondente.
Por que configurar zonas?
Sem zonas de entrega configuradas, qualquer endereço é aceito e nenhuma taxa de entrega é cobrada automaticamente. Ao configurar suas zonas, você ganha:
- Controle da área de atendimento — evita pedidos para bairros muito distantes
- Taxas automáticas por distância — cada zona pode ter sua própria taxa
- Pedido mínimo por zona — exija um valor mínimo para entregas mais distantes
- Tempo estimado por zona — o cliente sabe quanto tempo vai demorar
Como funciona
Quando o cliente envia o endereço no WhatsApp, o sistema:
- Converte o endereço em coordenadas geográficas (geocodificação)
- Calcula a distância em linha reta até o seu restaurante
- Verifica em qual zona a distância se encaixa
- Aplica a taxa de entrega e o pedido mínimo da zona correspondente
Restaurante (centro)
│
│ 0-3 km → Zona 1: R$ 5,00
│
│ 3-6 km → Zona 2: R$ 8,00
│
│ 6-10 km → Zona 3: R$ 12,00
│
│ > 10 km → Fora da área de entrega
Tipos de zona
Zonas por raio (km)
A forma mais comum. Você define anéis concêntricos a partir da localização do restaurante:
| Zona | Raio interno | Raio externo | Taxa | Pedido mínimo |
|---|---|---|---|---|
| Centro | 0 km | 3 km | R$ 5,00 | R$ 0,00 |
| Intermediária | 3 km | 6 km | R$ 8,00 | R$ 25,00 |
| Distante | 6 km | 10 km | R$ 12,00 | R$ 40,00 |
Cada zona tem um raio interno e externo. O sistema encontra a primeira zona onde a distância do cliente se encaixa.
Zonas por polígono (área personalizada)
Nem sempre círculos concêntricos representam bem a sua área de entrega. Com zonas por polígono, você desenha a área exata no mapa. Isso é ideal para:
- Bairros com formato irregular — um círculo pode incluir áreas que você não atende (do outro lado de um rio, rodovia, etc.)
- Zonas específicas — atender apenas um condomínio, região comercial ou bairro isolado
- Áreas mistas — combinar zonas de raio (para o entorno geral) com polígonos (para áreas específicas)
| Característica | Raio | Polígono |
|---|---|---|
| Formato | Círculo concêntrico | Área livre desenhada no mapa |
| Melhor para | Áreas uniformes ao redor do restaurante | Bairros irregulares, barreiras geográficas |
| Configuração | Definir raio interno e externo em km | Desenhar pontos no mapa |
| Precisão | Menor — inclui áreas indesejáveis | Maior — você controla cada limite |
Você pode combinar zonas de raio e polígono. Por exemplo: use raio para a área próxima (0-3 km) e polígonos para bairros específicos mais distantes que você atende por ter um motoboy na região.
Zonas nomeadas
Você pode dar nomes descritivos para suas zonas (ex: "Centro", "Zona Sul", "Bairro Industrial"). Os nomes aparecem nos relatórios e ajudam a organizar sua operação.
Configurando zonas no painel
Criando uma zona por raio
- No painel, vá em Configurações → Entregas → Zonas de entrega
- Clique em "Nova zona"
- Selecione o tipo Raio
- Preencha:
- Nome — ex: "Centro", "Até 5 km"
- Raio interno (km) — onde a zona começa (0 para a mais próxima)
- Raio externo (km) — onde a zona termina
- Taxa de entrega — valor em reais
- Pedido mínimo — valor mínimo para aceitar pedidos nessa zona
- Tempo estimado — previsão de entrega em minutos
- Entrega grátis acima de (opcional) — pedidos acima desse valor têm frete grátis nessa zona
- Clique em Salvar
Criando uma zona por polígono
- No painel, vá em Configurações → Entregas → Zonas de entrega
- Clique em "Nova zona"
- Selecione o tipo Polígono
- No mapa, clique para adicionar pontos que formam a área desejada
- Clique em cada vértice da área
- O sistema conecta os pontos automaticamente
- Você pode arrastar os pontos para ajustar
- Preencha taxa de entrega, pedido mínimo e tempo estimado
- Clique em Salvar
Ao desenhar o polígono, certifique-se de que a área está fechada (o último ponto conecta ao primeiro). O sistema não permite salvar zonas com polígonos incompletos.
Comece com 2 ou 3 zonas simples. Você sempre pode ajustar depois com base nas estatísticas de pedidos rejeitados.
Entrega grátis acima de um valor
Cada zona pode ter um valor de entrega grátis configurado individualmente. Quando o subtotal do pedido atinge esse valor, a taxa de entrega da zona é zerada automaticamente.
Exemplo: na zona "Centro" com taxa de R$ 5,00 e entrega grátis acima de R$ 50,00, um pedido de R$ 55,00 terá frete grátis.
Isso também funciona em conjunto com a configuração global de frete grátis da loja. A prioridade é: valor da zona > valor global da loja.
Listas de CEP (whitelist e blocklist)
Para situações em que o raio não é suficiente, você pode usar listas de CEP:
- Whitelist (lista de permissão) — CEPs aceitos sempre, mesmo que fora do raio. Útil para bairros atendidos por um motoboy parceiro.
- Blocklist (lista de bloqueio) — CEPs bloqueados sempre, mesmo que dentro do raio. Útil para áreas de difícil acesso.
A ordem de prioridade é: whitelist > blocklist > raio.
CEPs devem ser informados com 8 dígitos, sem traço (ex: 01310100). O limite é de 50 CEPs por lista.
O que o cliente vê
Endereço dentro da zona
A IA confirma o endereço e mostra a taxa de entrega:
"Entrega para Rua das Flores, 123 — taxa de entrega: R$ 8,00. Deseja continuar?"
Endereço fora da zona
A IA informa que o endereço está fora da área:
"Infelizmente, o endereço informado está fora da nossa área de entrega. Você pode tentar um endereço mais próximo ou optar pela retirada no local."
Endereço não reconhecido (falha na geocodificação)
Quando o sistema não consegue localizar o endereço no mapa, o pedido de delivery é recusado com uma mensagem amigável:
"Não consegui localizar esse endereço. Pode tentar novamente com mais detalhes, como o CEP? Exemplo: Rua das Flores, 123 — CEP 01310-100."
Desde a atualização de geofencing fail-closed, endereços que o sistema não consegue geocodificar são recusados por segurança. Antes, esses pedidos passavam sem verificação. Isso evita entregas para endereços incorretos ou muito distantes.
Testando suas zonas
Antes de ativar as zonas em produção, use a ferramenta de teste:
- Vá em Configurações → Entregas → Zonas de entrega
- Clique em "Testar endereço"
- Digite um endereço completo e clique em Validar
- O sistema mostrará: zona encontrada, distância, taxa e tempo estimado
Teste com endereços reais de clientes frequentes para confirmar que tudo funciona.
Solução de problemas
"Meu cliente está perto, mas o pedido foi recusado"
Causas mais comuns:
- Endereço incompleto ou genérico — "Rua das Flores" sem número pode geocodificar para outra cidade. Peça para o cliente incluir número e CEP.
- CEP incorreto — um CEP errado pode localizar o endereço em outro bairro. Confirme o CEP com o cliente.
- Rua recém-criada — ruas novas podem não estar nos mapas. Adicione o CEP do cliente na whitelist como solução imediata.
Sempre que possível, oriente seus clientes a enviar o endereço com CEP. Isso melhora muito a precisão da geocodificação.
"Quero saber quais endereços estão sendo rejeitados"
No painel, vá em Configurações → Entregas → Zonas de entrega → Oportunidades perdidas. Essa seção mostra os prefixos de CEP mais rejeitados nos últimos dias. Se você vir um CEP que deveria ser atendido, considere expandir o raio ou adicionar o CEP na whitelist.
Dicas para otimizar suas zonas
- Evite cruzar barreiras físicas — rodovias, rios e linhas de trem aumentam o tempo real de entrega. Use polígonos para excluir áreas do outro lado dessas barreiras.
- Ajuste com base em dados reais — consulte a seção "Oportunidades perdidas" para ver quais CEPs estão sendo rejeitados. Se um bairro próximo aparece com frequência, considere expandir.
- Não exagere no número de zonas — 3 a 5 zonas são suficientes para a maioria dos restaurantes. Muitas zonas dificultam a manutenção.
- Teste antes de ativar — use a ferramenta "Testar endereço" com endereços reais de clientes frequentes.
- Revise periodicamente — conforme seu volume de pedidos muda, suas zonas podem precisar de ajuste. Confira pelo menos uma vez por mês.
Zonas por polígono são especialmente úteis em cidades com geografia irregular (morros, rios, áreas industriais). Se o seu restaurante fica em uma área plana e uniforme, zonas por raio podem ser suficientes.
Próximos passos
- Taxas e cálculos — entenda como as taxas são aplicadas
- Tipos de entrega — delivery, retirada e outros
- Retirada no local — configure a opção de retirada
- Ciclo de vida do cliente — entenda o perfil dos seus clientes