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). - 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 canônico do cliente. Exige customerIdentifierValue.
phone, email, document, external_id 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.
Fim da janela de criação (inclusive).
Início da janela de atualização (inclusive). Deve ser anterior ou igual a updatedTo.
Fim da janela de atualização (inclusive).
Página, iniciando em 1.
Itens por página. Valores acima de 500 são limitados a 500.
x <= 500
