Pesquisar pedidos

Pesquisa pedidos por diversos critérios.

O parâmetro query aceita:

  • ID do pedido (UUID)
  • CNPJ do comprador (14 dígitos; pontos, hífens e barras são ignorados)
  • Nome do comprador (busca parcial)
  • ID externo do pedido (busca parcial)
  • Chave de acesso da NF-e (NFe + 44 dígitos) ou da NFS-e (NFS + 50 dígitos)
  • Chave de acesso sem o prefixo, com ou sem espaços — busca parcial, pode retornar outras notas do mesmo emitente
  • Número da nota fiscal (nNF, até 10 dígitos — busca parcial)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

A consulta a ser pesquisada.

string

Filtra pedidos pelo identificador do lote.

status
array of arrays

Considerar apenas pedidos com estes status.

status
date-time

Considerar apenas pedidos criados em ou após esta data.

date-time

Considerar apenas pedidos criados antes ou em esta data.

number
≥ 1
Defaults to 1

Qual página retornar da lista de pedidos. Começa em 1.

number
1 to 100
Defaults to 20

Limite de pedidos a serem retornados.

taxId
object

Filtro de Tax ID do comprador.

enum

Filtrar por tipo de desembolso. Upfront = antecipado; OnDueDate = pós-vencimento; OnBuyerPayment = pós-pagamento. Multi-select = união: 'Sem antecipação' são os dois valores OnDueDate e OnBuyerPayment. Um valor único continua aceito e é tratado como uma lista de um. Os valores anteriores (Anticipated, Scheduled, OnPayment) continuam aceitos como sinônimos. Omitir retorna todos.

displayStatus
array of strings

Filtro pelo status efetivo exibido na coluna Status da lista. Aceita status de ciclo de vida e estados de desembolso; multi-select = união, igual ao filtro status. Supersede status para a UI da lista — os valores casam exatamente com o que a coluna mostra.

displayStatus
Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json