O que você precisa fazer
1
Gere as credenciais de API
O
clientId e o clientSecret da empresa são obtidos em app.repediu.com.br/integrations (pesquise por “API” ou “Open Delivery”). Sem acesso à conta? Solicite uma conta de testes para o suporte técnico informando CNPJ, nome do software, breve descrição da solução (até 150 caracteres) e logo.2
Gere o token
Envie
clientId e clientSecret para Obter token e use o token retornado no header Authorization: Bearer <token> em todas as chamadas seguintes.3
Envie o histórico de vendas (carga inicial)
Mínimo de 3 anos de histórico, via Enviar venda. Pode ser feito no momento da ativação da integração.
4
Envie vendas diariamente ou em tempo real
Ideal ao fechar o caixa/expediente ou em tempo real. As vendas precisam chegar antes das 04:00 (horário de processamento diário).
5
Mantenha clientes, avaliações e cashback em dia
Atualizar clientes quando nome/telefone/CPF/e-mail/nascimento mudarem, Avaliação de pedido para pesquisas de satisfação, e Cashback para saldo e validade de cashback do cliente.
Limites e autenticação
- Autenticação: Bearer Token, obtido em Obter token.
- Limite por requisição: 500 itens (vendas, clientes, avaliações, cashback) — acima disso a requisição inteira é rejeitada.
- Rate limit: 60 requisições/minuto por token (janela fixa, sem fila — o excedente recebe
429na hora). Não se aplica à rota de obter token.
O que a homologação verifica
Os testes são feitos em produção, com uma conta de testes temporária (excluída após a homologação). A conferência cobre:- Carga inicial: histórico de vendas do estabelecimento (2–3 anos).
- Venda: canal (
salesChannel), data/hora (fuso horário), descontos, cupom (sponsorshipValue), dados de entrega/endereço (delivery), taxa de entrega (otherFees), marca/nome da cozinha (storeChannel). - Itens: categoria, valores, sabores, adicionais.
- Cliente: nome, CPF (
documentNumber), telefone, e-mail, data de nascimento, gênero, pontos de fidelidade (loyaltyPoints).
A unificação de clientes e o tratamento de duplicidade descritos originalmente para esta integração (por CPF/telefone e por janela de tempo) não são implementados nas rotas públicas em si — veja as notas específicas em cada página para o comportamento real verificado no código.

