Modo Delivery: o que eu configurei antes do primeiro pedido
Tudo o que precisa estar decidido antes de abrir a entrega própria, do script de banco à fila que chega na cozinha.
O primeiro dia de entrega própria foi uma tarde inteira de correria. O modo delivery estava ligado, os pedidos entravam, e alguém tinha que gritar cada um deles para a cozinha porque a sincronização não tinha sido testada. Sete pedidos e já estava um caos. Eu tinha configurado o que aparecia na tela e esquecido do que acontece atrás dela.
O recurso é configurável e aceita catálogo vindo da Loja ou do Foods, taxa de entrega por bairro com fallback, valor fixo ou cotação SuperFrete, pedido mínimo, finalização e rastreamento, além de sincronizar os pedidos com a Central de Pedidos e o KDS do Foods.
Diferente de um site com envio, o delivery tem janela curta. O pedido nasce, é preparado e sai em minutos. Qualquer configuração ambígua vira problema na mesma hora, não pendência para a semana que vem. Para a política de área e valores, veja taxa de entrega por bairro.
Pré-requisitos do modo delivery
- Script manual `database/loja_modo_delivery.sql` aplicado no ambiente.
- Script manual `database/loja_cliente_tokens.sql` aplicado, para os tokens de cliente.
- Host configurado, porque o tenant é identificado por ele.
- Frete definido de verdade, e não rascunhado.
- Pagamento configurado no Hub, com credencial e ambiente conferidos.
Nenhum desses itens é opcional. O recurso depende dos scripts manuais e das configurações reais de host, frete e pagamento para funcionar de ponta a ponta. Pular um deles produz falha que parece aleatória e consome uma tarde inteira de investigação.
A primeira decisão é a origem do catálogo
O Modo Delivery aceita catálogo originado da Loja ou do Foods. Isso não é preferência visual: define onde o item é mantido, como o preço é administrado e por qual caminho o pedido chega à produção. Cardápio estruturado tende a se dar melhor com a origem Foods. Varejo de produto embalado costuma ficar na Loja.
Os critérios objetivos, com os dois cenários lado a lado, estão em catálogo da Loja ou do Foods.
Configuração, na ordem que eu sigo hoje
- Aplique os scripts manuaisAntes de habilitar qualquer coisa. Sempre antes.
- Habilite o Modo DeliveryAtive na configuração da loja virtual e confirme o host que vai atender.
- Defina a origem do catálogoLoja ou Foods, conforme a natureza do que você vende e produz.
- Configure a cobrança de entregaTaxa por bairro com fallback, valor fixo ou cotação SuperFrete.
- Estabeleça o pedido mínimoSe fizer sentido, defina o corte e garanta que ele apareça antes da finalização.
- Valide a sincronização com a produçãoConfirme que os pedidos chegam à Central de Pedidos e ao KDS. Esse foi o passo que me faltou.
- Teste finalização e rastreamentoPedidos reais de valor baixo, acompanhados até a entrega concluída.
A cozinha precisa enxergar a fila sozinha
Os pedidos do delivery são sincronizados com a Central de Pedidos e o KDS do Foods. Essa integração é o que elimina a etapa manual de retransmitir pedido para a produção, que é onde a maior parte dos erros acontece: item trocado, observação perdida, endereço mal digitado, complemento que ficou no papel.
Pedido mínimo, finalização e rastreamento
Os três andam juntos no Modo Delivery. O rastreamento é o que corta a maior parte do contato de pós-venda, porque responde sozinho a pergunta mais repetida do delivery. Quem espera comida quer saber onde ela está, e vai perguntar se você não contar antes.
| Recurso | O que ele faz | O que você ganha |
|---|---|---|
| Pedido mínimo | Define um valor de corte | Protege a margem nas faixas distantes |
| Taxa por bairro | Aproxima cobrança do custo | Reduz prejuízo por deslocamento |
| Fallback | Responde fora da cobertura | Evita checkout travado e venda perdida |
| Rastreamento | Informa o andamento | Menos mensagem perguntando do pedido |
| Sincronização com KDS | Leva o pedido à produção | Ninguém precisa retransmitir nada |
Pagamento no delivery é o mesmo caminho
O pagamento online e a consulta de status seguem pelo Hub de Pagamentos, igual ao resto da loja. Credenciais, ambiente, meios aceitos e prioridade por empresa, com webhooks idempotentes sustentando a mudança de estado. Os detalhes estão em pagamento online na loja virtual.
O que aparece na primeira semana
- Bairro sem faixa e sem fallback, travando o checkout de quem queria comprar.
- Pedido mínimo ligado, porém comunicado só na hora de finalizar.
- Origem de catálogo trocada no meio do caminho, gerando divergência de preço.
- Sincronização testada só com um pedido, e a fila desmoronando no pico.
Próximo passo
Terminada a configuração, o desafio vira rotina. Monte o dia a dia com a rotina diária do delivery e alinhe a produção com o módulo de food service.