Merchant

O que é o módulo Merchant?

• Descobrir lojas — Listar e obter detalhes de todas as lojas vinculadas ao seu token
• Monitorar status — Verificar disponibilidade em tempo real e identificar problemas
• Gerenciar operações — Configurar delivery, retirada e consumo no local
• Controlar horários — Definir horários de funcionamento por operação
• Pausar temporariamente — Criar interrupções sem alterar horários
• Gerar QR codes — Facilitar check-in de entregadores em lojas Groceries

Casos de uso comuns

Integração de dashboard de lojas

• Listar todas as lojas em um único painel
• Monitorar status de cada unidade
• Ativar/desativar operações rapidamente
• Configurar horários especiais para eventos

Automação de operações

• Pausar automaticamente quando há picos de demanda
• Reabrir após resolver problemas
• Ajustar horários para dias especiais
• Alertar gerentes sobre status ERROR persistente

Integrações com sistemas legacy

• Importar horários do sistema POS
• Sincronizar status de disponibilidade
• Gerenciar múltiplas lojas em massa

Fluxo básico de integração

1. Autenticar — Obtenha seu token Bearer
2. Descobrir — Liste lojas com GET /merchants
3. Monitorar — Consulte status com GET /merchants/{merchantId}/status
4. Controlar — Configure operações, horários e pausas
5. Homologar — Valide sua integração antes de produção

Autenticação

curl --location 'https://merchant-api.ifood.com.br/merchant/v1.0/merchants' \
  --header 'Authorization: Bearer YOUR_TOKEN'

Limite de requisições

• Implemente backoff exponencial ao receber 429 Too Many Requests
• Distribua requisições entre múltiplas lojas
• Use polling com intervalo mínimo de 30 segundos por loja

Estrutura de resposta

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Pizzaria Central",
  "status": "AVAILABLE",
  "createdAt": "2024-01-15T10:30:00"
}

{
  "code": "UNAUTHORIZED",
  "message": "Token inválido ou expirado",
  "details": {}
}

Próximos passos

• Como funciona — Entenda detalhadamente cada operação da API
• Endpoints — Documentação técnica de todos os endpoints
• Operações — Configure como sua loja atende pedidos
• Boas práticas — Implemente estratégias robustas
• Critérios de homologação — Prepare-se para produção

Suporte

• Centro de ajuda
• Referência completa da API
• Status do serviço