"Quanto tempo leva?" é a primeira pergunta de toda migração, e a resposta honesta é "depende do que você tem hoje". Este guia separa o que é rápido do que é demorado, mostra o que decide o cronograma e explica por que a vitrine pode ficar pronta em 9 dias úteis enquanto o projeto inteiro leva mais.
Migração são duas coisas diferentes
A confusão de prazo nasce de misturar dois trabalhos. O primeiro é a migração de plataforma: levar catálogo, clientes, integrações, pagamentos e logística para a conta VTEX. O segundo é a vitrine: a loja que o cliente vê, construída sobre essa conta.
A vitrine headless da Imediata fica pronta em 9 dias úteis, com design do zero, PageSpeed 100 como meta, busca, CMS e checkout certificado. Esse prazo vale sobre uma conta VTEX configurada. Quando a conta ainda não existe, os 9 dias começam depois da migração de plataforma. Quem promete "loja migrada em 9 dias" sem perguntar sobre o ERP está vendendo a vitrine e omitindo o resto.
As quatro coisas que decidem o cronograma
| Fator | Encurta | Estica |
|---|---|---|
| Integrações | ERP com conector VTEX pronto, gateway já homologado, transportadora via app do ecossistema | ERP sem conector, regra fiscal própria, antifraude sob medida, integrações que ninguém documentou |
| Catálogo | Dados limpos, categorias definidas, imagens em padrão, SKUs consistentes | Catálogo com duplicidade, atributos livres, imagens fora de padrão, milhares de SKUs sem regra |
| SEO | Estrutura de URL que pode ser mantida, poucas páginas ranqueando | Muitas URLs com tráfego orgânico, estrutura que muda, conteúdo espalhado em blog e landing pages |
| Decisões | Um responsável que decide, regras de negócio escritas | Comitê, regras "na cabeça de alguém", mudança de escopo no meio |
Em nossa experiência, o primeiro fator pesa mais que os outros três juntos. Uma operação com ERP integrado por conector homologado e gateway padrão migra em semanas. Uma operação com integração própria em cada ponta migra em meses, e o tempo vai quase todo em homologação, não em construção.
As etapas, com o que leva tempo em cada uma
- 1DiagnósticoInventário de integrações, catálogo, URLs com tráfego e regras de negócio. É aqui que o cronograma real nasce. Sem diagnóstico, todo prazo é chute.
- 2Configuração da conta VTEXPolíticas comerciais, canais de venda, docas e transportadoras, gateway, e-mails transacionais. Rápido quando as regras estão escritas; lento quando são descobertas na hora.
- 3CatálogoModelagem de categorias e atributos, carga por API ou planilha, imagens. O tempo é proporcional à sujeira dos dados de origem, não ao número de produtos.
- 4IntegraçõesERP, pagamento, logística, antifraude, marketplace. Cada uma com homologação de ponta a ponta: pedido, faturamento, envio, cancelamento, devolução.
- 5VitrineNativa, FastStore ou headless. A headless da Imediata leva 9 dias úteis a partir daqui, com a conta pronta.
- 6SEO e redirecionamentosMapa de URLs antigas para novas, 301 em tudo que mudou, canonical, sitemap. A etapa mais barata de fazer e a mais cara de esquecer.
- 7HomologaçãoPedido real de ponta a ponta em cada meio de pagamento, cada transportadora, cada cenário de troca. O que não foi testado aqui vira incidente na primeira semana.
- 8Go-liveCongelamento do catálogo, virada de DNS acompanhada, monitoramento de erros, pedidos e Search Console nas primeiras 48 horas.
O que normalmente não migra, e por quê
- Histórico de pedidos. Fica na plataforma antiga para consulta. Migrar é possível, caro e raramente necessário. A VTEX começa com os pedidos novos, e o atendimento consulta o antigo quando precisa.
- Avaliações de produto. Dependem da ferramenta usada. Quando a ferramenta é a mesma nas duas plataformas, migram; quando muda, costuma-se recomeçar.
- Regras de promoção antigas. São recriadas na VTEX, não importadas. É a oportunidade de limpar o que ninguém lembra por que existe.
SEO: onde as migrações quebram
Uma migração que perde tráfego orgânico não economizou nada. O trabalho é mecânico e precisa ser feito inteiro: lista de todas as URLs que recebem tráfego, destino de cada uma na nova loja, redirecionamento 301, canonical correto, sitemap novo submetido e acompanhamento do Search Console por algumas semanas. Quando a estrutura de URLs pode ser mantida, melhor. No headless da Imediata, categorias, produtos e coleções seguem os endereços da VTEX, o que simplifica o mapa.
A parte nova: presença nas IAs
Uma migração feita hoje precisa de um item que não existia há dois anos: garantir que os robôs de busca das IAs entram na loja nova. Firewall e proteção contra bots vêm com padrões que bloqueiam o ChatGPT e a Perplexity sem aviso. Vale rodar o checklist de loja AI-Ready antes de virar o DNS.
Qual vitrine escolher antes de migrar
A escolha entre Store Framework, FastStore e headless muda o cronograma, o time e o que a loja consegue fazer depois. Não é decisão para o meio do projeto. Comparamos os três no guia VTEX IO, FastStore ou Headless: qual escolher.
Então, quanto tempo?
Depois do diagnóstico, a Imediata entrega um cronograma fechado com um checkpoint por dia. Antes dele, a única resposta honesta é a faixa: semanas para operações com integrações padrão e catálogo limpo, poucos meses para operações com integrações próprias. E 9 dias úteis para a vitrine, contados a partir da conta pronta. Quem der um número antes de olhar o seu ERP está adivinhando.