Skip to main content
POST
Enviar venda
Envia vendas para a Repediu, no mesmo formato de payload do padrão Open Delivery (itens, descontos, entrega, cliente). Suporta até 500 vendas por requisição.
items e customer são obrigatórios de fato: uma venda sem items ou sem customer causa um erro interno (HTTP 500), não um 400 com mensagem clara. Sempre envie os dois. O campo merchant é aceito mas ignorado — o estabelecimento é resolvido pelo token, não por este campo.

Comportamento síncrono x assíncrono

Em produção, o processamento é sempre assíncrono (enfileirado) — a venda fica disponível no dia seguinte. O texto retornado varia conforme o horário do envio: "Sales saved successfully" durante a janela de manutenção diária (03:00–08:00 UTC) ou "Sales queued successfully" fora dela — em ambos os casos a venda é enfileirada. Processamento síncrono (venda aparece imediatamente) só ocorre em homologação.

Deduplicação

A deduplicação aplicada nesta rota é por colisão de canal: se o salesChannel de uma venda coincide (após normalização — minúsculas, sem espaços/traços/underscores, sem sufixo de versão) com o nome de outra integração ativa da mesma empresa, a venda é descartada silenciosamente (sem erro visível). Deduplicação adicional por id repetido ou por proximidade de horário entre vendas do mesmo cliente pode ocorrer em etapas posteriores de processamento, fora desta rota.

Erros

Atualizar clientes

Depois de enviar vendas, mantenha os dados de clientes atualizados.

Autorizações

Authorization
string
header
obrigatório

Token emitido por POST /authentication/users/accessToken. Envie no header Authorization como Bearer <token>. Válido por 6 horas.

Corpo

application/json
Maximum array length: 500
id
string
obrigatório
items
object[]
obrigatório
customer
object
obrigatório
type
string

Valor livre — DELIVERY, TAKEOUT e INDOOR são os únicos mapeados internamente.

displayId
string
sourceAppId
string
salesChannel
string

Usado para filtro de deduplicação por canal entre integrações da mesma empresa.

storeChannel
string
createdAt
string<date-time>
lastEvent
string

Aceito mas não processado por esta API.

preparationStartDateTime
string<date-time>
discounts
object[]
total
object
delivery
object
otherFees
object[]
merchant
object

Aceito pela API mas não utilizado na resolução do estabelecimento — o merchant é resolvido pelo token, não por este campo.

Resposta

Vendas recebidas (síncrono) ou enfileiradas (assíncrono) com sucesso.

result
string | null
error
object | null
timeGenerated
string<date-time>
success
boolean