Listar pedidos
Histórico de pedidos dos merchants do escopo, no contexto CRM — valores em centavos
items, page, pageSize, total); pageSize padrão 50, máximo 500. O campo storeId identifica o merchant dono de cada pedido — o mesmo id de Listar merchants.Modalidade (originChannel)
originChannel é a modalidade do pedido, num enum fechado — use-o também como filtro:
Filtros
- Por merchant:
storeId(opcional) restringe a um único estabelecimento — o mesmoidde Listar merchants. Omitido, retorna os pedidos de todos os merchants do escopo; umstoreIdinexistente ou fora do escopo responde404comMerchant not found.. - Por cliente:
customerIdentifierType+customerIdentifierValue(sempre em par) —custombusca pelo id do cliente na Repediu (o valor decustomer.identifiernas respostas);phone,email,documenteexternal_idseguem como entrada de busca. - Sincronização incremental: janelas
createdFrom/createdTo(data da venda) eupdatedFrom/updatedTo(última atualização), inclusive nas duas pontas.
O que vem em metadata
Cada pedido traz metadata.channel com a modalidade/canal da venda como texto livre (o nome do canal registrado na origem), ou null quando a venda não informou canal. Diferente de originChannel — que é um enum fechado e serve de filtro — o channel preserva o valor original, útil para relatórios que precisam do nome exato do canal.
Erros
Obter pedido
id retornado nesta listagem.Autorizações
Token de acesso emitido por POST /od/v2/oauth/token (fluxo client_credentials). Envie no header Authorization como Bearer <token>.
Parâmetros de consulta
Restringe a lista a um único merchant. Omitido, retorna os pedidos de todos os merchants do escopo. Id inexistente ou fora do escopo responde 404.
Tipo do identificador para busca. Use custom para buscar pelo id do cliente na Repediu. Exige customerIdentifierValue.
phone, email, document, external_id, custom Valor do identificador canônico (obrigatório quando customerIdentifierType é informado).
Filtra pela modalidade do pedido.
own_app, marketplace, in_store, qr_code, kiosk, delivery, takeout, other Início da janela de criação (inclusive). Deve ser anterior ou igual a createdTo. Filtra pela data da venda no fuso da loja (America/Sao_Paulo) — envie offset explícito (ex. -03:00).
Fim da janela de criação (inclusive). Filtra pela data da venda no fuso da loja (America/Sao_Paulo) — envie offset explícito (ex. -03:00).
Início da janela de atualização (inclusive). Deve ser anterior ou igual a updatedTo. Comparado em UTC.
Fim da janela de atualização (inclusive). Comparado em UTC.
Página, iniciando em 1.
Itens por página. Valores acima de 500 são limitados a 500.
x <= 500
