Skip to main content
Enquanto a API Open Delivery deste site serve para ler dados da Repediu, esta seção é para o caminho contrário: seu sistema envia dados para a Repediu, para que o CRM execute campanhas personalizadas, monitore resultados e gere retenção de clientes para o lojista.
Esta é uma API separada da Open Delivery: autenticação própria (clientId/clientSecret → Bearer, sem OAuth2 client_credentials), token com validade e escopo diferentes, e nenhuma relação com as rotas de open-delivery/, crm-parceiro/ ou metricas/. Um token de uma API não serve para autenticar chamadas na outra.

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 429 na 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).
Nem todo sistema tem todos esses campos disponíveis — quando tiver, vale a pena enviar para extrair o máximo potencial da ferramenta.
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.

Suporte técnico

Dúvidas ou problemas com a integração: Lucas Santana — lucas.santana@repediu.com.br. Para o detalhe de cada campo dos endpoints, veja também repediu.stoplight.io/docs/api.