Pular para o conteúdo
Última atualização

Pedidos

O fluxo de pedidos é divido nas seguintes etapas:

  1. Recebimento de eventos — por polling (padrão do Open Delivery) ou webhook (opcional, recomendado por ser mais rápido).

  2. Detalhes do pedido — antes de aceitar, consulte GET /v1/orders/{orderId} para verificar itens e endereço. Retorna 200; ID inválido retorna 404.

  3. Atualizações de status — confirme ou peça cancelamento dentro da janela definida pela Keeta; depois, marque como pronto.

  4. Cancelamento — pode partir do merchant, do cliente, da Keeta ou do entregador.

  5. Reembolso — o cliente solicita; o merchant aceita ou recusa.

Máquina de Estados dos Eventos de Pedidos

Esta visão geral apresenta o fluxo de pedidos e como ele interage com o software de gestão do estabelecimento e a Keeta.

Delivery Takeout

Prazos e consequências

  • Aceite: pedido não aceito em 5 minutos é cancelado automaticamente pelo sistema, e a loja pode ser fechada temporariamente.
  • Aceite o quanto antes para reduzir cancelamentos do cliente.

Cancelamentos em excesso geram penalidades (ex.: fechamento temporário).

Entendendo o Fluxo de Pedidos

Fluxo de pedidos

Privacidade dos dados do cliente

Dados pessoais chegam criptografados com prefixo ENC_. Campos afetados:

  • customer.phone.number
  • delivery.deliveryAddress.district
  • delivery.deliveryAddress.number
  • delivery.deliveryAddress.complement
  • delivery.deliveryAddress.formattedAddress
Quem entregaPode descriptografar?
Merchant (entrega própria)Sim, via POST /v1/batchDecrypt
3PL contratado pelo merchantSim, via POST /v1/batchDecrypt
Keeta (full service)Não — dados ficam mascarados (a LGPD e o fato de não serem necessários para a entrega justificam)

Conteúdo