1
Gatilho de Agendamento (Schedule Trigger)
n8n Core
O fluxo inicia de forma totalmente automática todos os dias, às 06h00 da manhã, extraindo a base atualizada de pedidos do dia/período anterior para alimentar a planilha antes do início da operação.
Frequência: Diária às 06:00 AM (Cron / Schedule Trigger).
2
Requisição à API de Pedidos VTEX (OMS)
HTTP Request
O n8n realiza uma chamada à endpoint do módulo OMS da VTEX solicitando a lista dos pedidos do período desejado, utilizando autenticação segura via App Key e App Token.
Endpoint: GET /api/oms/pvt/orders
Autenticação: X-VTEX-API-AppKey + X-VTEX-API-AppToken
3
Consulta de Detalhes & Aplanamento dos Dados
Looping & Code
Para cada ID retornado, o fluxo consulta o pedido completo para extrair origem, dados do cliente (CPF/E-mail), endereço (CEP/Cidade) e status. O JSON complexo é transformado em uma estrutura simples pronta para colunas de planilha.
Endpoint: GET /api/oms/pvt/orders/{orderId}
4
Divisão em Batches (Lotes Controlados)
Split In Batches
Estratégia Anti-Bloqueio: Em vez de disparar 1.000 requisições individuais ao Google Sheets (o que causa o estouro do limite da API), os pedidos são agrupados em lotes de 100 a 200 registros.
Regra: Processamento agrupado com pausa programada (pós-envio) de 1 a 2 segundos entre cada lote.
5
Gravação em Lote no Google Sheets
Google Sheets Node
O n8n envia todo o lote de pedidos em uma única chamada HTTP (operação Append / Upsert), reduzindo drasticamente o consumo do Rate Limit do Google.
Resultado: Gravação rápida, segura, sem erros de timeout ou bloqueios por excesso de requisições.