> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repediu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Envio de Dados

> Envie vendas, clientes, avaliações e cashback para a Repediu — o sentido inverso do Open Delivery, onde o parceiro lê dados da Repediu

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.

<Warning>
  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.
</Warning>

## O que você precisa fazer

<Steps>
  <Step title="Gere as credenciais de API">
    O `clientId` e o `clientSecret` da empresa são obtidos em [app.repediu.com.br/integrations](https://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.
  </Step>

  <Step title="Gere o token">
    Envie `clientId` e `clientSecret` para [Obter token](/envio-de-dados/obter-token) e use o token retornado no header `Authorization: Bearer <token>` em todas as chamadas seguintes.
  </Step>

  <Step title="Envie o histórico de vendas (carga inicial)">
    Mínimo de 3 anos de histórico, via [Enviar venda](/envio-de-dados/enviar-venda). Pode ser feito no momento da ativação da integração.
  </Step>

  <Step title="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).
  </Step>

  <Step title="Mantenha clientes, avaliações e cashback em dia">
    [Atualizar clientes](/envio-de-dados/atualizar-clientes) quando nome/telefone/CPF/e-mail/nascimento mudarem, [Avaliação de pedido](/envio-de-dados/avaliacao-pedido) para pesquisas de satisfação, e [Cashback](/envio-de-dados/cashback) para saldo e validade de cashback do cliente.
  </Step>
</Steps>

## Limites e autenticação

* **Autenticação**: Bearer Token, obtido em [Obter token](/envio-de-dados/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.

<Info>
  A [unificação de clientes](/envio-de-dados/atualizar-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.
</Info>

## Suporte técnico

Dúvidas ou problemas com a integração: **Lucas Santana** — [lucas.santana@repediu.com.br](mailto:lucas.santana@repediu.com.br).

Para o detalhe de cada campo dos endpoints, veja também [repediu.stoplight.io/docs/api](https://repediu.stoplight.io/docs/api/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.