O fluxo de pedidos é divido nas seguintes etapas:
Recebimento de eventos — por polling (padrão do Open Delivery) ou webhook (opcional, recomendado por ser mais rápido).
Detalhes do pedido — antes de aceitar, consulte
GET /v1/orders/{orderId}para verificar itens e endereço. Retorna200; ID inválido retorna404.Atualizações de status — confirme ou peça cancelamento dentro da janela definida pela Keeta; depois, marque como pronto.
Cancelamento — pode partir do merchant, do cliente, da Keeta ou do entregador.
Reembolso — o cliente solicita; o merchant aceita ou recusa.
Esta visão geral apresenta o fluxo de pedidos e como ele interage com o software de gestão do estabelecimento e a Keeta.

- 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).

Dados pessoais chegam criptografados com prefixo ENC_. Campos afetados:
customer.phone.numberdelivery.deliveryAddress.districtdelivery.deliveryAddress.numberdelivery.deliveryAddress.complementdelivery.deliveryAddress.formattedAddress
| Quem entrega | Pode descriptografar? |
|---|---|
| Merchant (entrega própria) | Sim, via POST /v1/batchDecrypt |
| 3PL contratado pelo merchant | Sim, 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) |