Módulo Delivery

O que é o módulo Delivery

O módulo Delivery do Bunto ERP cuida de toda a operação de entregas: cadastro de entregadores, criação de entregas, despacho, rastreamento em tempo real e integração com o app do entregador. É um módulo independente dos módulos Restaurante, PDV, Vendas e da integração iFood.

Ele pode ser usado por qualquer empresa que precise entregar ao cliente final — pizzaria, hamburgueria, loja de conveniência, distribuidora — e também serve como base para operações mais complexas que envolvam rota e logística de última milha.

Como acessar

No menu lateral, acesse Operações → Delivery → Dashboard. Rota: /delivery.

No menu lateral, entre em Delivery. As páginas disponíveis são:

• /delivery — dashboard com kanban de entregas.
• /delivery/nova-entrega — criação manual de entrega.
• /delivery/entregadores — cadastro de entregadores.
• /delivery/zonas — zonas de entrega e taxas.
• /delivery/historico — entregas finalizadas e canceladas.
• /delivery/configuracao — configurações do módulo.

Dashboard

O dashboard é um painel no estilo kanban com três colunas:

• Pendentes — entregas aguardando despacho.
• Em andamento — entregas atribuídas, aceitas, coletadas ou em rota.
• Entregues — concluídas no dia.

No topo aparecem indicadores em tempo real:

Cards de entrega

Cada card mostra o cliente, endereço, valor, forma de pagamento e, quando aplicável, indicadores como:

• Origem — manual, telefone, PDV, iFood, app ou cardápio digital.
• Grupo — selo âmbar quando a entrega faz parte de um despacho em lote.
• Troco — destaque em laranja para entregas pagas em dinheiro.
• Tempo em rota — há quanto tempo o entregador está com a entrega.
• Status — cor do card conforme o estado atual.

Entregadores

Cadastro

Em Entregadores, você cadastra quem vai levar os pedidos. O cadastro aproveita a busca de pessoas já existentes no ERP e, se necessário, oferece cadastro rápido de um novo contato. Informe:

• Nome — vinculado ao cadastro de pessoas.
• Tipo de veículo — moto, bicicleta, carro ou a pé.
• Placa — quando aplicável.

Código de acesso para o app

Depois de cadastrado, gere o código de acesso do entregador. O sistema exibe um código de nove dígitos e um QR Code. O entregador entra no app e digita o código ou escaneia o QR para receber o token — a partir daí ele vê e opera as entregas pelo celular.

Status online

O entregador fica marcado como disponível (online) ou indisponível (offline) com base no status informado pelo app. Só entregadores online podem receber entregas no despacho automático.

Zonas de entrega

As zonas representam as regiões que você atende, com taxa e tempo próprios. Cada zona tem nome (por exemplo, "Centro", "Jardim América"), taxa em reais, tempo estimado em minutos e ordem de exibição no cardápio digital.

As zonas aparecem na criação de entregas, no checkout público do cardápio digital e no cálculo automático de taxa.

Criação de entrega

Na página Nova Entrega (ou pelo menu de contexto do dashboard) você informa:

• Cliente — nome, telefone e, opcionalmente, vínculo com um cadastro existente.
• Endereço — logradouro completo, bairro, cidade, complemento e ponto de referência.
• Zona de entrega — quando informada, traz taxa e tempo automaticamente.
• Valor do pedido — total dos itens.
• Taxa de entrega — calculada pela zona ou digitada.
• Forma de pagamento — já pago, dinheiro, cartão de crédito, cartão de débito ou pix.
• Troco para — opcional, usado em pagamentos em dinheiro.
• Descrição dos itens — texto livre (ex.: "2x X-Burger, 1 Coca 600ml").
• Observações — instruções adicionais para o entregador.

Ao salvar, o sistema geocodifica o endereço automaticamente (via serviço de mapas compartilhado) e gera um código de rastreamento único para o cliente acompanhar a entrega.

Despacho

Despacho individual

Selecione uma entrega pendente e escolha o entregador que vai levar. O status muda para atribuída, o entregador recebe notificação no app e pode aceitar ou rejeitar.

Despacho em lote

Selecione várias entregas na coluna Pendentes, clique em Despachar em lote e escolha um entregador. Todas as entregas recebem o mesmo código de grupo, e no app elas aparecem agrupadas. O app oferece o botão Rota otimizada, que usa a API de rotas do Google para calcular a melhor ordem de entrega.

Despacho automático

Quando a configuração Despacho automático está ativa, entregas novas são atribuídas automaticamente ao entregador online com menos entregas em aberto. Útil em operações de alto volume.

Ticket de impressão

Se a configuração Imprimir ticket da entrega está ativa, o ticket é emitido automaticamente no momento do despacho. Traz cliente, endereço, itens, valores e o QR Code de rastreamento.

Status das entregas e transições

Cada transição carimba um timestamp para auditoria: data de despacho, aceite, coleta e entrega.

Rastreamento em tempo real

Enquanto o entregador está em rota, o app envia a localização periodicamente. As coordenadas alimentam:

• Mapa do dashboard — visualização interna para o operador.
• Link público de rastreamento — o cliente acessa /delivery/rastreamento/[código] sem precisar de login e vê o status, tempo estimado e a posição do entregador no mapa quando o status é Em rota.

O canal em tempo real usa Socket.IO — tanto o ERP quanto o app refletem mudanças de status e localização instantaneamente.

App do entregador

O app do entregador é um aplicativo React Native que roda em Android. O fluxo típico é:

1. Login com o código gerado no ERP.
2. Marca-se como online.
3. Recebe notificação de nova entrega atribuída.
4. Aceita ou rejeita.
5. Ao chegar no estabelecimento, marca como coletada.
6. Aciona rota otimizada quando há várias entregas.
7. Inicia rota — a partir deste ponto o GPS passa a ser enviado.
8. Ao chegar no cliente, confirma a entrega. Se a configuração exige, tira uma foto do comprovante antes de confirmar.
9. Se a forma de pagamento for cartão ou pix, pode cobrar via SmartTEF, que aciona a maquininha conectada.

Histórico

O entregador vê o próprio histórico de entregas no app, incluindo entregas canceladas e rejeitadas.

Configurações do módulo

Geral

• Habilitado — liga ou desliga o módulo.
• Modo de taxa — por zona, por quilômetro ou taxa fixa.
• Taxa fixa — valor usado no modo fixa.
• Taxa por km — valor por quilômetro no modo km.
• Raio de cobertura — distância máxima atendida (usada como estimativa no modo km).
• Tempo médio — tempo padrão quando não há zona informada.

Operação

• Despacho automático — atribui entregas a entregadores online automaticamente.
• Habilitar rastreamento público — ativa o link público de acompanhamento.
• Foto de comprovante obrigatória — exige foto antes de confirmar a entrega.
• Imprimir ticket ao despachar — emite o ticket automaticamente.

Notificações

• Alerta sonoro — som tocado ao chegar um novo pedido (som 1, 2, 3 ou nenhum).
• Alerta de timeout de despacho — aviso quando uma entrega fica pendente por muito tempo.

Integrações com outros módulos

Cadastros de pessoas

Entregador e cliente usam a base de pessoas do ERP. Novos contatos podem ser criados rapidamente pelo próprio fluxo de Delivery.

Mapas

O módulo usa o serviço compartilhado de mapas para geocodificar endereços no momento da criação e para otimizar rotas no app do entregador (Google Routes API v2).

Finanças

A forma de pagamento é registrada na entrega. A cobrança via SmartTEF dispara o gateway configurado no módulo Finanças. Entregas pagas online geram um link de pagamento via gateway de cobrança.

Restaurante e cardápio digital público

O checkout público do cardápio digital cria entregas no Delivery automaticamente, com o cliente se autenticando pelo telefone e um código enviado por SMS.

PDV, Vendas e iFood

Em integrações avançadas, entregas podem ser originadas do PDV, de uma venda ou de pedidos importados do iFood. Cada origem fica registrada no campo origem da entrega e aparece como selo no card.

Socket.IO

Eventos em tempo real (nova entrega, status atualizado, localização) são publicados em salas específicas por empresa, usadas pelo dashboard e pelo app do entregador.

Permissões

No modelo atual, qualquer usuário autenticado da empresa pode operar o módulo Delivery (criar, despachar e consultar entregas, entregadores e zonas). O acesso via app do entregador é feito por token próprio, distinto da autenticação do ERP. O rastreamento público usa apenas o código de rastreamento, sem exigir login.

Perguntas frequentes

Posso usar o Delivery sem cardápio digital ou iFood?

Sim. O módulo funciona como solução independente: crie a entrega manualmente, despache para um entregador cadastrado e acompanhe.

O que acontece quando o entregador rejeita uma entrega?

A entrega volta ao status Aguardando despacho e pode ser despachada novamente para outro entregador.

Como o cliente acompanha a entrega?

Cada entrega tem um código único. O link /delivery/rastreamento/[código] é público e mostra o status e, quando o entregador está em rota, a posição dele em tempo real.

Como funciona o despacho em lote?

Você seleciona várias entregas pendentes, despacha todas para o mesmo entregador e elas recebem um código de grupo. O app agrupa visualmente e permite rotear todas as entregas em sequência com a rota otimizada.

Consigo exigir foto do comprovante de entrega?

Sim. Ative Foto de comprovante obrigatória nas configurações. O entregador só consegue confirmar a entrega depois de tirar a foto.

O Delivery funciona offline no celular do entregador?

O app mantém os dados em cache e sincroniza assim que a conexão volta. GPS e mudanças de status entram numa fila local para envio posterior.

Posso cobrar no cartão direto com o entregador?

Sim, se você tiver a integração SmartTEF configurada. No momento da entrega, o app aciona a maquininha e registra o pagamento automaticamente na entrega.