Guia Completo VTEX: Tudo Sobre a Plataforma de E-commerce

A VTEX e uma das plataformas de e-commerce mais relevantes da America Latina. Fundada no Brasil em 2000, hoje atende mais de 2.500 lojas em 38 paises, processando bilhoes em GMV anualmente. O ecossistema VTEX vai muito alem de um simples carrinho de compras: inclui marketplace nativo, OMS (Order Management System), modulo de logistica, programa de sellers, CMS e um runtime de desenvolvimento completo. Este guia reune tudo o que voce precisa saber para tomar decisoes informadas sobre a plataforma, desde a arquitetura tecnica ate custos reais de implantacao e operacao.

Arquitetura VTEX: CMS, IO e FastStore

A VTEX passou por tres geracoes de frontend. O CMS Legado (Portal/Sites) e a versao original, baseada em templates HTML/CSS/JS com controles proprietarios. Ainda funciona, mas esta oficialmente depreciado e nao recebe novos recursos. O VTEX IO (Store Framework) e a segunda geracao: usa blocos React declarativos em JSON, tematizacao via CSS Handles e um ecossistema robusto de apps. E a versao estavel com o maior numero de apps disponiveis e a maior comunidade de desenvolvedores. O FastStore e a terceira geracao e a mais moderna. Construido sobre Next.js, entrega paginas server-rendered com hydration minima, scores de Lighthouse consistentemente acima de 90 e uma experiencia de desenvolvimento com React puro e Tailwind CSS. Para novos projetos em 2025, o FastStore e a escolha recomendada quando performance e prioridade. O Store Framework permanece valido para operacoes que dependem do ecossistema de apps existente ou que nao tem budget para reconstruir o frontend.

VTEX para quem? Perfil ideal

A VTEX atende primariamente operacoes de medio e grande porte. O perfil ideal inclui: faturamento acima de R$ 300 mil por mes, catalogo com mais de 1.000 SKUs, necessidade de marketplace (vender ou ser seller), integracao com ERPs como SAP, TOTVS ou Oracle, e operacoes B2B com regras de preco e condicoes comerciais complexas. Tambem e indicada para empresas que precisam de checkout customizado, multiplas politicas comerciais (preco por regiao, canal ou cluster de cliente) e logistica avancada com multiplos pontos de envio. Nao e indicada para operacoes pequenas com faturamento abaixo de R$ 100 mil por mes, a menos que o plano de crescimento justifique o investimento. O custo de entrada e alto e a complexidade operacional exige um time tecnico dedicado ou uma agencia parceira.

Ecossistema: Apps, integracoes e marketplace

O VTEX App Store tem centenas de apps nativas e de terceiros: reviews (Yotpo, Bazaarvoice), busca (Algolia, SearchandISe), pagamentos (Pagar.me, Adyen, PagSeguro), logistica (Intelipost, Frenet), marketing (Klaviyo, RD Station) e analytics (Google Analytics 4, Hotjar). O marketplace nativo da VTEX permite que qualquer loja se torne um marketplace recebendo sellers, ou que uma marca se conecte como seller em marketplaces existentes (B2W, Magazine Luiza, Mercado Livre) via integracao nativa. Integracoes com ERPs sao feitas via APIs REST e webhooks. SAP, TOTVS Protheus, Oracle e Bling possuem conectores prontos ou middleware dedicado. Para sistemas que nao tem conector, a VTEX expoe APIs documentadas para catalogo, pedidos, precos, estoque, logistica e CRM.

Performance e Core Web Vitals na VTEX

Performance e historicamente o calcanhar de Aquiles da VTEX. Lojas em CMS Legado ou Store Framework com muitas apps instaladas frequentemente apresentam scores de Lighthouse entre 30 e 50. O motivo: bundle JavaScript excessivo, apps de terceiros mal otimizadas, fontes sem font-display swap e imagens sem dimensoes definidas. Para atingir Lighthouse 90+, existem dois caminhos. O primeiro e otimizar dentro do Store Framework: auditar apps instaladas removendo as que nao sao essenciais, implementar lazy loading em imagens e componentes abaixo da fold, utilizar preload na imagem hero, configurar cache de GraphQL corretamente e minimizar CSS customizado. O segundo caminho e adotar FastStore ou um frontend headless como deco.cx. Nesse modelo o backend VTEX continua processando pedidos, mas o frontend leve entrega performance nativa sem precisar otimizar app por app. Para novos projetos onde performance e prioridade, o segundo caminho e o recomendado.

Quanto custa uma loja VTEX

O custo da VTEX se divide em tres pilares: taxa da plataforma, implantacao e sustentacao. A taxa da plataforma inclui uma mensalidade fixa mais um percentual sobre o GMV (revenue share), que varia conforme o contrato mas geralmente fica entre 1% e 3% do faturamento bruto. A implantacao de uma loja VTEX com tema personalizado, integracoes com ERP e go-live completo parte de R$ 20 mil para projetos simples e pode chegar a R$ 150 mil ou mais para operacoes complexas com marketplace, B2B e multiplas integracoes. A sustentacao mensal (manutencao, novas features, suporte) custa entre R$ 5 mil e R$ 20 mil dependendo do escopo e da complexidade da operacao. Para um detalhamento completo de custos, consulte nosso artigo dedicado sobre quanto custa uma loja VTEX.

VTEX IO vs FastStore: qual escolher

A escolha entre VTEX IO (Store Framework) e FastStore depende de tres fatores: maturidade da operacao, perfil do time tecnico e metas de performance. O Store Framework e a escolha certa quando a operacao depende de apps do ecossistema que nao existem no FastStore, quando o time e composto por desenvolvedores familiarizados com blocos e CSS Handles, ou quando o orcamento nao permite reconstruir o frontend. O FastStore e a escolha certa quando performance e diferencial competitivo, quando o time domina React e Next.js, quando a operacao esta comecando do zero ou quando a divida tecnica do Store Framework ficou insustentavel. Ambos coexistem no ecossistema VTEX e a VTEX continuara suportando o Store Framework no medio prazo. Para uma analise tecnica detalhada, consulte nosso comparativo completo entre Store Framework e FastStore.

Checklist de implantacao VTEX

Uma implantacao VTEX bem-sucedida segue etapas claras. Primeiro, definicao de escopo: catalogo, integracoes, politicas comerciais, regras de promocao e logistica. Segundo, setup da conta: configuracao de ambiente, politicas de acesso, workspaces de desenvolvimento e homologacao. Terceiro, integracao com ERP: sincronizacao de catalogo, precos, estoque e pedidos. Quarto, desenvolvimento do tema: Store Framework com blocos customizados ou FastStore com componentes React. Quinto, configuracao de checkout: meios de pagamento, calculo de frete, regras de promocao. Sexto, SEO e analytics: sitemap, meta tags, structured data, GTM e GA4. Setimo, QA e testes: testes de carga, testes de integracao, validacao de fluxos de compra em todos os dispositivos. Oitavo, go-live: apontamento de DNS, warmup de cache, monitoramento intensivo nas primeiras 48 horas. O prazo medio de implantacao e de 2 a 4 meses para projetos padrao e 4 a 8 meses para projetos complexos com marketplace e B2B.