Como integrar a BeeFood ao Entregas Expressas

Com a integração, cada pedido de entrega aceito na BeeFood (PDV, cardápio digital, WhatsApp e marketplaces) entra sozinho no Entregas Expressas, com endereço, cliente, itens, forma de pagamento e troco. Quando o entregador coleta, o pedido passa a despachado na BeeFood; quando entrega, a entregue. Se o pedido for cancelado na BeeFood antes da coleta, a entrega é cancelada aqui automaticamente.

1. Crie a credencial na BeeFood

1. Acesse o portal de desenvolvedor da BeeFood em developer.beefood.com.br e entre com o e-mail e a senha da sua conta BeeFood.

2. No menu lateral, clique em Credenciais e depois em + Nova credencial.

3. Em Permissões, ligue pelo menos Loja (leitura) e Pedidos (leitura e escrita).

4. Em Ambiente, troque Sandbox por Produção e deixe a credencial Ativa. Importante: o portal vem com Sandbox selecionado, que é só um ambiente de testes — com uma credencial de Sandbox, os pedidos reais da sua loja não chegam ao Entregas Expressas.

5. Clique em Criar credencial e copie o clientId e o clientSecret. Se perder o secret, ele pode ser consultado de novo pelo ícone de chave na lista de credenciais.

2. Cadastre a integração no Entregas Expressas

1. No painel, vá em Configurações › Integrações › BeeFood e clique em Cadastrar integração.

2. Escolha o Cliente (o estabelecimento dono da loja na BeeFood).

3. Em Lojas, dê um nome à loja (opcional), cole o Client ID e o Client Secret e clique em Testar credencial. A mensagem de sucesso mostra o nome da loja na BeeFood.

4. Preencha o local de coleta, a forma de pagamento padrão e o tipo de serviço.

5. Clique em Salvar. A tela abre a integração no passo do webhook (próximo item).

Tem mais de uma loja? Use + Adicionar loja e informe a credencial de cada uma.

3. Escolha como os pedidos viram entrega

• Quando a loja aceita o pedido (recomendado): o entregador é chamado assim que o pedido é aceito na BeeFood.

• Quando a loja marca o pedido como pronto: o entregador só é chamado com o pedido pronto para sair.

• Assim que o pedido chega: o entregador é chamado antes de a loja aceitar. Se o pedido for recusado depois, a entrega é cancelada aqui.

• Pedidos do iFood e da 99Food que chegam pela BeeFood só entram se você marcar as opções correspondentes. Pedidos entregues pela logística do marketplace nunca viram entrega.

• Exigir retorno só quando houver dinheiro a devolver: pedido já pago na BeeFood dispensa o retorno do entregador à loja.

• Atualizar o status do pedido na BeeFood: marca o pedido como despachado na coleta e entregue na entrega. Desmarque se a loja faz isso à mão.

• Chamar entregador após aproximadamente X segundos: o tempo de espera depois que o pedido entra. Em pedido agendado, conta a partir do horário do agendamento.

4. Cadastre o webhook na BeeFood (obrigatório)

O webhook é o que faz a BeeFood avisar cada pedido na hora. A integração só fica completa com ele.

1. Logo depois de salvar, a tela abre a integração. Na loja, o bloco Webhook (obrigatório) mostra a URL, o Usuário e a Senha. Use os botões de copiar.

2. No portal da BeeFood, vá em Webhooks › + Novo webhook.

3. Em URL de destino, cole a URL. Informe seu e-mail, deixe todos os eventos ligados, escolha o ambiente Produção (o mesmo da credencial), preencha Usuário e Senha com os valores da tela e clique em Criar webhook.

4. Quando a loja aceitar o próximo pedido, o bloco fica verde, com o status recebendo. Até lá, ele fica vermelho, com aguardando o primeiro envio.

Se o bloco mostrar com falha, algum pedido não chegou pelo webhook. A BeeFood desativa o webhook depois de 5 falhas seguidas: no portal dela, em Webhooks, confira se ele está ativo e reative. Enquanto isso, o Entregas Expressas faz uma conferência de segurança a cada 10 minutos, para nenhum pedido se perder.

5. Pronto: acompanhe os pedidos

Os pedidos de entrega aparecem no painel com a observação PEDIDO VIA BEEFOOD, o número do pedido, o canal de venda, o valor a receber, o troco, os dados do cliente e os itens. A tela da integração mostra a hora da última sincronização e avisa se a BeeFood recusar a credencial.

Dúvidas frequentes

Pedido de retirada ou de mesa entra? Não. Só pedidos de entrega viram entrega.

A tela mostra "ambiente de testes (sandbox)" ao lado da loja. A credencial foi criada no ambiente Sandbox. Crie outra em Produção no portal da BeeFood, cole os novos Client ID e Client Secret na loja e salve.

A credencial foi recusada. Confira se ela está ativa, se é de Produção e se tem as permissões de Loja (leitura) e Pedidos (leitura e escrita).

Pedido cancelado na BeeFood depois da coleta. A entrega segue, porque o entregador já está com o pacote. O cancelamento fica registrado no histórico do pedido.

Os pedidos antigos entram quando ligo a integração? Não. Só entram pedidos feitos depois que a integração foi ativada.