Pular para o conteúdo
ISBI
Integrações

VTEX · E-commerce

Dados de VTEX consolidados fora da plataforma

Operação em VTEX já tem estrutura e volume. O que costuma faltar é uma base única que junte pedido, estoque, mídia e financeiro para responder sem depender de exportação de cada módulo.

Onde isso costuma travar

Quem está em VTEX normalmente é o topo da nossa faixa de porte: operação estruturada, times separados, módulos diferentes para pedido, catálogo e logística. Aí o problema muda de natureza. Não falta dado, falta um lugar só onde ele se encontre. Cada área extrai o seu, e a reunião de resultado começa discutindo de onde saiu cada número.

O que é específico do VTEX

Cada sistema tem os seus próprios pontos cegos, e generalizar aqui não ajuda ninguém. Estes são os do VTEX.

    01

    Cada módulo responde por um pedaço

    Gestão de pedido, catálogo, logística e pagamento vivem em módulos distintos, com dados próprios. A pergunta de negócio quase sempre atravessa dois ou três, e atravessar exige reunir tudo fora deles.

    02

    Uma credencial por integração, ou nenhuma rastreabilidade

    O acesso às rotas privadas usa um par de chave e token de aplicação, enviado nos cabeçalhos X-VTEX-API-AppKey e X-VTEX-API-AppToken. Operação que reaproveita a mesma credencial em várias integrações perde a noção de quem chamou o quê, e revogar uma passa a derrubar todas.

    03

    Limite por conta e por rota

    O controle de chamadas varia conforme a rota e a conta, e o retorno 429 chega sem aviso prévio. Carga histórica escrita sem recuo progressivo trava no meio e deixa dado pela metade, o que é pior do que não ter começado.

    04

    Rentabilidade continua fora do alcance

    Custo de produto, gasto de mídia e taxa de meio de pagamento não estão na plataforma. A conta de margem por linha de produto depende de fontes externas, e é sempre ela que a diretoria pede.

Como tiramos o dado de lá

Leitura programada, sem exportação manual

    01

    Chave e token de aplicação no cabeçalho

    As rotas privadas são autenticadas por um par de chave e token gerado no painel administrativo, enviado em cabeçalhos próprios. Permissão por escopo, o que permite dar à integração somente leitura.

    02

    Paginação e recuo progressivo

    As listagens são paginadas e o limite varia por rota. A carga trabalha com recuo exponencial em cima do 429, retomando de onde parou em vez de reiniciar a extração inteira.

    03

    Base única sobre módulos separados

    Os módulos são lidos separadamente e reunidos na modelagem, com uma definição só para cada métrica. É o que faz a reunião começar pela decisão e não pela conferência de origem do número.

O que trazemos

  • Pedidos, itens e status
  • Catálogo, SKU e preço
  • Estoque por depósito
  • Logística e prazo de entrega
  • Pagamento e antifraude
  • Devoluções e trocas

Costuma vir junto com

Sistema de origem sozinho responde pouco. A pergunta de gestão quase sempre exige cruzar dois ou três, e é esse cruzamento que não existe pronto em nenhum deles.

O que muda

As perguntas que passam a ter resposta

    Qual a margem por linha de produto, com custo e mídia inclusos

    Onde o prazo de entrega derrapa e quanto isso custa em cancelamento

    Qual canal de aquisição traz cliente que recompra

    Como o estoque por depósito afeta a venda perdida

    Qual o resultado por região, com frete real

Perguntas frequentes

Temos time de tecnologia. Onde vocês entram?+

Normalmente no que o time interno não tem folga para manter: a camada de dados e sua operação contínua. Time de produto costuma estar ocupado com a loja, e pipeline de dados é trabalho que precisa de dono todo dia, não de um projeto pontual.

Já usamos as ferramentas de relatório da própria VTEX. Some com elas?+

Não. Elas continuam úteis para leitura operacional dentro da plataforma. A base que construímos serve à pergunta que atravessa módulos e fontes externas, o que nenhuma ferramenta interna alcança.

A extração afeta a performance da loja?+

Não. A leitura usa as rotas administrativas, separadas da vitrine, com limite respeitado e execução em janela de baixo uso.

Conseguem juntar com o nosso ERP?+

Sim, e é quase sempre necessário. O custo do produto e o financeiro moram no ERP; a venda mora na VTEX. A margem real só existe cruzando os dois.

Usa VTEX? Vamos ver o que dá para extrair dele

Seis perguntas, cerca de dois minutos. Roda no seu navegador e não pede e-mail para mostrar o resultado.