Critérios de homologação

Valide sua integração Order API atende aos requisitos de produção. Quando lojas falham em receber ou confirmar pedidos, clientes vivenciam cancelamentos.Todas as aplicações devem atender a estes critérios funcionais e não-funcionais antes de ir ao ar.

Pré-requisitos

Conta Profissional (CNPJ)
Aplicativo completo pronto para testes
Dados da loja de teste (ID e nome)
Conexão estável com infraestrutura

Checklist de requisitos

Atenda a todos os critérios abaixo antes de agendar homologação.

Requisitos obrigatórios

Consumo de eventos: Consulte /events:polling a cada 30 segundos ou processe webhooks; responda com /acknowledgment para todos os eventos
Confirmação: Confirme pedidos DELIVERY e TAKEOUT imediatos e agendados dentro do SLA
Cancelamento: Exiba motivos de /cancellationReasons e processe solicitações
Pagamento: Exiba bandeira do cartão e troco em dinheiro
Cupons: Exiba valor e responsabilidade (iFood ou Loja)
Informações: Exiba observações de itens, CPF/CNPJ, código de coleta
Duplicatas: Detecte e descarte eventos duplicados
Sincronização: Atualize status quando alterado por outros aplicativos
Negociação: Processe eventos da Plataforma de Negociação
Status de entrega: Notifique status READY_TO_PICKUP para pedidos de retirada (TAKEOUT) e DISPATCH para entrega própria do parceiro

Por categoria

Restaurantes

Exiba observações de entrega na comanda
Processe /readyToPickup para pedidos TAKEOUT
Processe /dispatch para entrega própria do parceiro

Supermercados, Farmácias e Outros

Importe pedidos via virtual-bag
Limite acknowledgment a 2000 IDs por requisição
Processe /dispatch após separação concluída

Fluxos por tipo de pedido

TAKEOUT (Retirada no balcão)

Teste o ciclo completo de retirada:

Receber pedido com orderType: "TAKEOUT" e orderTiming: "IMMEDIATE" ou "SCHEDULED"
Confirmar dentro do SLA (máx. 8 minutos)
Preparar — atualizar status interno
Notificar pronto — chamar PUT /orders/{id}/readyToPickup
- Sistema notifica cliente via push/SMS que pedido está pronto
- Validar resposta 202 Accepted
Cliente retira — pedido passa para CONCLUDED

Checklist TAKEOUT:

Pedido recebido e exibido corretamente
Confirmação dentro do SLA
/readyToPickup retorna 202 Accepted
Cliente recebe notificação de pronto
Pedido muda para CONCLUDED após retirada
Observações de entrega exibidas na comanda

DELIVERY com entrega própria

Teste o ciclo de entrega gerenciada pela loja:

Receber pedido com orderType: "DELIVERY" e deliveredBy: "MERCHANT"
Confirmar dentro do SLA (máx. 8 minutos)
Preparar — atualizar status interno
Notificar despacho — chamar PUT /orders/{id}/dispatch com payload:
```
{
  "deliveredBy": "MERCHANT"
}
```
Sistema marca como CONCLUDED automaticamente

Checklist DELIVERY com Entrega Própria:

Pedido recebido com deliveredBy: "MERCHANT"
Confirmação dentro do SLA
/dispatch retorna 202 Accepted
Pedido muda para DISPATCHED após chamada
Sistema marca automaticamente como CONCLUDED
Localizer do pedido está disponível para impressão

Requisitos técnicos

Renove tokens apenas quando expirados
Respeite rate-limit de cada endpoint

Agendar homologação

Teste primeiro no Gestor de Pedidos Web. Depois:

Abra requisição na Área de Chamados
Inclua descrição do app e dados da loja de teste
Aguarde contato da equipe para agendar

Se não aprovar, aguarde 15 dias antes de reagendar.

O que acontece na sessão

Um analista acessa seu ambiente para verificar recebimento de pedidos, fluxos de confirmação/cancelamento e conformidade com SLA (~45 minutos).Prepare:

ID da loja e nome
App implementado e acessível
Todos os critérios testados
Conexão estável
Equipe disponível

Resultado:

Aprovado: App liberado para produção
Não aprovado: Documentamos os requisitos não atendidos; tente novamente em 15 dias

Esta página foi útil?

Avalie sua experiência no novo Developer portal: