Limitação de Resultados no Endpoint de Feed de Pedidos

Olá comunidade, solicito o vosso apoio;
configurei o “feed” para retornar todos os pedidos existentes no site com o status (ready-for-handling).
Efectuando uma requisição get ao Endpoint:
https://servelec291.vtexcommercestable.com.br/api/orders/feed, o mesmo retorna somente o máximo 10 pedidos conforme o esperado e verificado na documentação.

Procedeu-se a devida configuração da paginação e configuração da quantidade de pedidos, porém o retorno continua limitado a 10 pedidos por requisição, desta forma, solicito o vosso apoio para proceder a devida configuração ou remover o limitador de retorno de pedidos de forma que possa retornar todos os pedidos existentes no site.

Como faço para buscar todas encomendas que se encontram no feed?

Cmpts

2 Likes

Olá comunidade, o pedido de apoio fica sem efeito. Feita a verificação!
Cmpts

Oi @Dercio_Luis tudo certo?

Na VTEX, o endpoint /api/orders/feed funciona como um fluxo contínuo de pedidos — não como uma listagem de todos os pedidos existentes. Ele não permite paginação tradicional e retorna no máximo 10 pedidos por chamada, como você observou corretamente.

:warning: Entendimento importante:

O Order Feed é baseado em fila (queue) — ele retorna somente os novos pedidos (com um status específico, ex: ready-for-handling) a partir de um lastId. Ou seja: não é um histórico completo, é uma espécie de “stream de eventos”.

Se você já “leu” um pedido, ele não aparece de novo (a não ser que você “resete” o lastId).

Para buscar todos os pedidos com esse status (inclusive antigos), você não deve usar o /feed, mas sim o endpoint:

GET /api/oms/pvt/orders

:wrench: Exemplo de uso:

GET https://{{accountName}}.vtexcommercestable.com.br/api/oms/pvt/orders?f_status=ready-for-handling&page=1&per_page=50

Parâmetros:

  • f_status=ready-for-handling → filtro pelo status desejado
  • page=1 → número da página (paginação manual)
  • per_page=50 → número de pedidos por página (até 100 é permitido)

Documentação para consulta:

:inbox_tray: 1. Orders Feed (Feed de Pedidos)

O Orders Feed é utilizado para integrar pedidos novos ou atualizações de status em tempo real. Ele retorna até 10 eventos por requisição e funciona como uma fila de eventos.

Esse guia explica como configurar o feed, os tipos de filtros disponíveis (FromWorkflow e FromOrders), e como consumir os eventos. Documentação developers.vtex.com

:page_facing_up: 2. Listagem de Pedidos (List Orders)

Para buscar todos os pedidos existentes, incluindo históricos, utilize o endpoint de listagem de pedidos:

Este artigo mostra como aplicar filtros na API de pedidos, semelhante aos filtros disponíveis no VTEX Admin.developers.vtex.com

:wrench: 3. Configuração de Integração de Pedidos

Para configurar a integração de pedidos, incluindo o uso do feed e hooks, consulte:developers.vtex.com+1developers.vtex.com+1

Esperamos ter ajudado. Marque como resposta caso positivo.

Abs,

At.te,
Diretoria Four2One