Como configurar Bairros e Taxas de Entrega no JuxtaPOS V3
imprimirA tela Áreas de Entrega permite visualizar os bairros atendidos pelo estabelecimento, identificar bairros sem taxa configurada, alterar valores existentes e cadastrar novos bairros com suas respectivas taxas.
Para que o recurso funcione corretamente, é necessário que o cadastro de bairros esteja configurado conforme descrito abaixo.
1. Configurar a lista de bairros
Acesse:
Gerenciamento → Entidades → Lista de Tipo de Entidade → Clientes → Campos Personalizados
Localize o campo:
Bairro
No campo Valores, devem estar cadastrados todos os bairros atendidos pelo estabelecimento.
Os bairros devem ser separados por vírgula.
Exemplo:
CENTRO,ALVORADA,CRISTO REDENTOR,JARDIM AMÉRICAImportante
A existência de bairros dentro de regras antigas de automação não substitui o cadastro dessa lista.
A tela Áreas de Entrega utiliza os valores do campo personalizado Bairro como a lista oficial de bairros. Isso corresponde ao funcionamento implementado atualmente no JuxtaPOS V3.
Se o campo Bairro existir, mas sua lista de valores estiver vazia, a tela poderá apresentar:
0 bairros
mesmo que existam regras antigas contendo nomes de bairros.
2. Acessar Áreas de Entrega
Depois de configurar os bairros, acesse:
Gerenciamento → Automação → Áreas de Entrega
A tela apresentará um resumo contendo:
- Bairros — quantidade total cadastrada;
- Com taxa — bairros com taxa identificada;
- Novos / Sem taxa — bairros que ainda precisam de configuração;
- Revisar — bairros cuja configuração apresenta conflito ou não pôde ser interpretada.
3. Configurar a taxa de um bairro existente
Quando um bairro estiver cadastrado, mas ainda não possuir uma regra de taxa, será exibido:
Status: Sem taxa
Informe a taxa desejada para o bairro e clique em:
Salvar alterações
O JuxtaPOS criará automaticamente a regra necessária.
As novas regras criadas pela tela recebem o padrão de identificação:
[JUXTA-DELIVERY] NOME DO BAIRROExemplo:
[JUXTA-DELIVERY] ALVORADA
[JUXTA-DELIVERY] CRISTO REDENTOR
[JUXTA-DELIVERY] JARDIM AMÉRICARegras antigas que já estejam funcionando são preservadas.
4. Adicionar um novo bairro
Também é possível cadastrar um bairro diretamente pela tela Áreas de Entrega.
No topo da tela:
- Informe o nome do bairro/região;
- Informe a taxa de entrega;
- Clique em Adicionar bairro;
- Confira os dados;
- Clique em Salvar alterações.
Ao salvar, o JuxtaPOS realiza as duas configurações necessárias:
1. Adiciona o bairro à lista de valores do campo personalizado Bairro;
2. Cria automaticamente a regra de taxa correspondente.
Esse comportamento é realizado pela rotina de salvamento da própria tela.
5. Regras antigas de taxa de entrega
A tela foi desenvolvida para preservar regras de entrega já existentes.
Portanto, uma regra antiga como:
TAXA DE ENTREGA 3,00pode continuar sendo utilizada normalmente ao lado das novas regras:
[JUXTA-DELIVERY] ALVORADA
[JUXTA-DELIVERY] MONGABEIRANão é necessário excluir ou recriar uma regra antiga que esteja sendo corretamente reconhecida.
6. Configuração técnica esperada da automação
Para que uma regra existente seja reconhecida pela tela Áreas de Entrega, a configuração precisa ser compatível com o mecanismo de taxa utilizado pelo sistema.
A ação utilizada deve possuir os parâmetros correspondentes à Taxa de Entrega e ao cálculo [:Entrega]. A tela procura essa estrutura para identificar automaticamente a ação responsável pela taxa.
A regra também deve possuir uma restrição correspondente ao bairro do cliente.
A ação vinculada deve possuir o parâmetro:
Entrega=VALORExemplo:
Entrega=4,00A regra utilizada como modelo para novos bairros também deve possuir mapeamento válido, normalmente para o tipo de comanda ENTREGA. As novas regras copiam esse mapeamento da regra existente utilizada como referência.
7. Solução de problemas
| Problema | O que verificar |
|---|---|
| Tela mostra 0 bairros | Verifique se o campo personalizado Bairro possui valores cadastrados |
| Bairro aparece como Sem taxa | O bairro existe, mas nenhuma regra de taxa correspondente foi localizada |
| Bairro aparece como Revisar | Verifique a regra e o parâmetro da ação de taxa |
| Bairro existe na regra, mas não aparece | Adicione-o aos valores do campo personalizado Bairro |
| Nova regra não pode ser criada | Verifique se existe uma regra válida que possa ser utilizada como modelo e se ela possui mapeamento |
| Taxa antiga não é identificada | Verifique a ação vinculada e se existe o parâmetro Entrega com um valor válido |
8. Padrão recomendado
Para instalações novas ou durante revisões de clientes existentes, utilize sempre este fluxo:
Cadastrar bairros → Conferir Áreas de Entrega → Configurar taxas → Salvar → Conferir se todos aparecem como “Configurado”.
O resultado esperado é:
Todos os bairros com taxa → 0 sem taxa → 0 para revisar.
JuxtaPOS V3 — Áreas de Entrega
Este procedimento deve ser utilizado sempre que for necessário cadastrar, revisar ou corrigir bairros e taxas de entrega.
