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.
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
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:
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
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
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