O que é o VTEX
A VTEX é a plataforma de comércio digital mais usada por operações médias e grandes no Brasil, com catálogo, preço, promoção e um OMS próprio que orquestra o pedido do pagamento à entrega.
A integração aqui é menos sobre 'mandar pedido para o ERP' e mais sobre respeitar o ciclo do OMS: o pedido passa por estados e a integração precisa reagir ao estado certo, não ao primeiro evento que chegar.
O que a API entrega
Conjunto amplo de APIs REST separadas por domínio — catálogo, preço, estoque, OMS, logística — com autenticação por chave de aplicação. A separação é boa para clareza e exige entender qual API é dona de cada dado.
O OMS emite notificação de mudança de estado do pedido, que é o gancho correto para integrar. Reagir ao evento errado do ciclo é a causa mais comum de pedido faturado antes da hora.
Catálogo tem processamento assíncrono: enviar um produto não significa que ele já está publicado. Integração que assume resposta síncrona cria inconsistência difícil de rastrear.
Fluxos que construímos
Catálogo do ERP para a VTEX
Produto, SKU, especificação e imagem publicados com a estrutura que a plataforma espera, respeitando o processamento assíncrono do catálogo.
Preço e promoção
Tabela de preço por política comercial, separada do cadastro — que é como a plataforma modela e como a operação costuma precisar.
Pedido pelo OMS
Integração ancorada no estado do pedido, com faturamento e envio disparados no momento certo do ciclo, não na aprovação do pagamento.
Estoque por depósito
Saldo por centro de distribuição, com a política de logística respeitada — vender do depósito errado gera frete que come a margem.
O que costuma quebrar
Reagir ao estado errado do pedido
Faturar na aprovação de pagamento em vez de no estado correto do ciclo gera nota emitida para pedido que ainda pode ser cancelado.
Assumir catálogo síncrono
O envio retorna sucesso e o produto ainda não está publicado. Sem conferência posterior, a operação acredita que o item está no ar.
Preço em lugar errado
Escrever preço no cadastro em vez da política de preço quebra promoção e diferenciação por canal.
Estoque agregado em operação multi-depósito
Somar tudo num saldo só ignora a logística e produz venda que sai do depósito mais caro.
Prazo típico
- 4 a 8
- semanas para catálogo, preço e pedido
- +2
- semanas para multi-depósito e logística
- assíncrono
- catálogo exige conferência posterior
Perguntas frequentes
Precisamos de conector pronto ou desenvolvimento?
Se existe conector para o seu ERP e ele cobre suas regras, use. Desenvolvimento se justifica quando a operação tem política comercial, logística ou fiscal que o conector não modela — o que é comum em operação média e grande.
Como lidar com o processamento assíncrono do catálogo?
Com uma etapa de conferência: depois de enviar, o fluxo verifica se o item foi realmente publicado e sinaliza o que ficou pelo caminho. Sem isso, produto sumido só aparece quando alguém procura na loja.
Dá para integrar mantendo o conector atual?
Dá, e é comum: o conector cuida do caminho padrão e a camada nova cobre o que ele não faz. O cuidado é definir quem é dono de cada campo, senão os dois se sobrescrevem.
Quanto tempo leva um projeto típico?
Entre 4 e 8 semanas para catálogo, preço e pedido em produção. Multi-depósito, logística própria e regra fiscal específica costumam somar mais duas a quatro semanas.