Taxa por bairro

Muitos restaurantes não pensam em quilômetros: pensam em bairros. "Centro e Vila Nova é R$ 5, Jardim América é R$ 8." A zona por bairro faz exatamente isso — você escolhe os bairros que atende e uma taxa para cada grupo. Não precisa de mapa, de coordenadas da loja nem de geocodificação.

Como funciona

1. Você escolhe os bairros da sua cidade em uma lista (a lista vem da base dos Correios) e define a taxa de cada grupo.
2. Quando o cliente pede uma entrega, o sistema descobre o bairro dele e aplica a taxa do grupo correspondente.
3. Se o bairro não estiver em nenhum grupo, vale a regra que você escolher: cobrar a taxa padrão da loja ou não entregar.

Cliente: "Rua das Flores, 12, Vila Nova"
                 │
                 ▼
   Bairro identificado: Vila Nova
                 │
                 ▼
   Grupo "Centro e Vila Nova" → taxa R$ 5,00

Como o sistema descobre o bairro do cliente

Na ordem, o sistema tenta:

1. Bairro escolhido ou informado — o bairro que o cliente escolheu na lista da loja online ou falou no WhatsApp, quando bate exatamente com um bairro cadastrado. É a palavra do cliente e vence as outras fontes.
2. CEP — se o cliente informou um CEP (ou ele veio no endereço), o bairro vem da base postal. No interior o CEP costuma ser da cidade inteira e não trazer bairro; por isso ele não passa na frente do que o cliente escolheu.
3. Bairro informado com grafia parecida — a IA confirma antes de cobrar (veja abaixo).
4. Texto do endereço — se o bairro aparece dentro do endereço ("Rua X, 10, Vila Nova").
5. Histórico — só quando nada acima identificou o bairro: para cliente que já pediu antes no mesmo endereço, o sistema reaproveita o bairro do último pedido, sem perguntar de novo. Um bairro escrito no endereço atual sempre vence o histórico.
6. Onde você já entregou — se você já entregou no mesmo número da rua, ou se duas ou mais entregas na mesma quadra (ou perto da localização que o cliente mandou) foram para o mesmo bairro, vale esse bairro. É o seu mapa: vale mais que o dos Correios e que o bairro do CEP.
7. A rua no Censo do IBGE — o IBGE anotou o bairro de cada casa da cidade, e a partir disso sabemos em que número cada rua muda de bairro. Quando o cliente manda rua e número (ou só a rua, se ela fica inteira num bairro, ou a localização) e o Censo aponta um bairro que é exatamente um dos seus, vale esse bairro. Na divisa entre dois bairros pode errar por um número ou outro. Cidades grandes ficam de fora, e loja que entrega em mais de uma cidade precisa saber de qual cidade é o endereço — o cliente dizer ou mandar o CEP.
8. Rua e número — pela base dos Correios da cidade, que diz em qual bairro fica cada trecho da rua ("Rua Rio Candeias, 356" → Parque São Pedro). Se a rua passa por mais de um bairro seu e o número não decide, a IA pergunta qual. Rua escrita errado ("Rio Candeia") é comparada com as ruas parecidas da cidade; se houver dúvida entre duas, a IA pergunta o bairro.

Se nada disso identificar o bairro — o cliente mandou só rua e número —, a IA pergunta "qual é o seu bairro?" uma vez (em loja que cobra só por bairro; com zona por raio ou polígono, quem decide é a localização). Se ele não souber, aí vale a regra de bairro não cadastrado (veja abaixo).

dica

Se o cliente informar um CEP de outra cidade, o bairro do CEP é ignorado — evita cobrar a taxa de um bairro homônimo de outro município. O mesmo vale quando ele diz a cidade na conversa ("no centro de Juazeiro do Norte", numa loja de Crato): o Centro da sua lista não é o Centro da outra cidade, e a IA avisa que não entrega lá.

Cliente digitou o bairro errado

Erro de digitação é normal: "vila aba" em vez de "Vila Abac", "jd europa" em vez de "Jardim Europa". O sistema tolera abreviações e acentos automaticamente (jd = jardim, vl = vila, "Bairro Centro" = "Centro"). Quando a grafia é parecida mas não igual, a IA nunca cobra em silêncio — ela confirma:

"Você quis dizer Vila Abac?"

Se o cliente confirmar, o endereço é salvo com a taxa certa e a grafia dele passa a ser reconhecida direto na próxima vez — para ele e para qualquer outro cliente da cidade que digitar igual.

Na loja online o cliente escolhe o bairro em uma lista, então esse problema não acontece. Em lojas com taxa por bairro, a lista é a primeira pergunta da entrega, antes do CEP: o bairro escolhido vale mesmo que o CEP aponte outro (a loja avisa quando divergem), e o CEP fica opcional, só para preencher rua e cidade.

Bairro que só a região conhece

A lista dos Correios nem sempre tem o nome que o pessoal usa. Se um bairro não aparece na busca, digite o nome e clique em "Adicionar como bairro da loja". Ele passa a valer para a sua loja: a IA reconhece, a loja online oferece e a taxa se aplica normalmente.

Configurando no painel

1. Vá em Configurações → Entrega
2. Clique em "Adicionar zona"
3. Selecione o tipo Bairros
4. Busque e marque os bairros do grupo (a lista carrega a partir da cidade cadastrada em Configurações → Perfil)
5. Preencha Taxa de entrega, e se quiser Pedido mínimo, Tempo estimado e Grátis acima de
6. Clique em Criar zona

Crie uma zona por taxa: "Centro e Vila Nova" (R$ 5), "Jardim América" (R$ 8), e assim por diante. Um bairro só pode estar em uma zona ativa — os que já estão em outra zona aparecem desabilitados na lista.

Entrega também na cidade vizinha

Se a loja fica na divisa e entrega em bairros da cidade ao lado, clique em outra cidade (ao lado de "Buscar bairro"), informe a cidade — a UF é a da loja, porque só vale cidade do mesmo estado — e marque os bairros de lá. Eles ficam gravados na cidade certa, e o cliente que manda o CEP ou diz a cidade é atendido. Para voltar à lista da sua cidade, clique em voltar à cidade da loja.

:::caution Não cadastre o bairro da cidade vizinha como bairro da sua Um "Castelo" adicionado à mão na lista de São Vicente fica sendo de São Vicente: quando o cliente informa o CEP ou diz que é em Santos, o pedido é recusado como "outra cidade". Use outra cidade e escolha o bairro na lista de lá. :::

:::tip Pelo assistente Você também pode falar com o assistente de entregas no painel: "Centro e Vila Nova R$ 5, Jardim América R$ 8". Ele confere os nomes na lista da cidade, cria as zonas e avisa quais bairros não estavam na base e foram cadastrados como bairros da loja. Pergunte "quais bairros tem na minha cidade?" para ver a lista. :::

Bairro não cadastrado

Depois de criar a primeira zona por bairro aparece o cartão "Bairro não cadastrado ou não identificado", com duas opções:

Opção	O que acontece
Entregar com a taxa padrão (padrão)	O pedido é aceito com a taxa de Configurações → Operação → Taxa de Entrega e chega com o selo Confirmar entrega, para você conferir se entrega naquele bairro
Não entregar	A IA avisa que ainda não atende o bairro e sugere retirada no local

Combinando com raio e polígono

Zonas por bairro convivem com zonas por raio e por polígono. O bairro é verificado primeiro; se o cliente não estiver em nenhum bairro cadastrado, valem as zonas por raio/polígono; por último, a regra de bairro não cadastrado.

Isso permite, por exemplo, taxa fixa por bairro para o entorno e raio para o resto da cidade.

Testando

Use "Testar endereço" na mesma tela. Digite um endereço com o bairro e veja o resultado: zona e taxa encontradas, pedido de confirmação ("Você quis dizer…") ou a regra de bairro não cadastrado sendo aplicada.

Próximos passos

• Zonas de entrega — raio, polígono e listas de CEP
• Taxas e cálculos — como a taxa entra no total do pedido
• Tipos de entrega — delivery, retirada e outros