Pular para o conteúdo principal

Lista pedidos

GET 
/orders

Lista os pedidos da empresa autenticada — endpoint compartilhado entre Outbound (default IDStatusOrder=1 + OrderBy=ASC), Pedidos, Retirada em Mãos (IDStatusOrder=17&Budget=0&SkuView=0) e demais telas que listam pedidos. Paginação fixa em 2000 registros por página (Page=N → offset N*2000).

Etapas internas (OrdersGet):

  1. Resolve IDCompany a partir do prefix da conta + accountname do header. Quando o usuário tem mais de uma conta vinculada, busca a posição correspondente em IDCompanyList (CSV indexado por accountnamelist).
  2. Se o usuário tem centros de distribuição vinculados, restringe à lista dele. Querystring IDStockKeepingUnitDistributionCenter é validada contra essa lista — se não pertence, retorna [] imediatamente.
  3. Quando Search é informado, limita IDOrder aos últimos 3 meses (busca rápida só varre essa janela).
  4. Quando o usuário é vendedor (Salesman=1) com restrictaccesssalesman=1, restringe aos pedidos cujos consumidores estão vinculados ao usuário em ConsumerSalesman.
  5. Em duas etapas: primeiro resolve os IDOrder paginados (2000 por página); depois carrega cada pedido completo com todos os dados resolvidos (status, integração, nota fiscal, transportadora, faturador, CD).
  6. SkuView=1 muda o segundo passo para retornar Items agregados (array JSON de SKUs do pedido com nome, quantidade, valor unitário, kit, inconformidade e imagem principal) em vez das colunas planas. Frontend usa para preview de linha expandida.

Busca rápida (Search) — quando informada, casa contra qualquer um dos campos:

  • Order.
  • ConsumerNameCorporateName / ShippingReceiverName (exige ≥4 caracteres alfabéticos).
  • ConsumerEmail.
  • ConsumerCpfCnpj (apenas dígitos, comprimento entre 11 e 14).
  • NfeNumber (apenas dígitos, ≤9).
  • IDOrder (apenas dígitos, ≤11).
  • OrderFrom (qualquer marketplace).
  • PackId (apenas dígitos com comprimento > 15).

Endpoint compartilhado por várias telas — esta documentação cobre o conjunto completo de querystrings; cada tela usa um subconjunto.

Request​

Responses​

Array de pedidos. Retorna até 2000 itens por página. Cada item traz o pedido + status + integração + NF principal + transportadora + faturador + CD. Quando SkuView=1, traz também o array Items com os SKUs do pedido. Quando nenhum pedido casa com os filtros, retorna [] (com 200).

Última atualização em