Migrar para Wake: checklist de catálogo, estoques e canais

Migrar para a Wake é reconstruir a operação em outro sistema, não copiar a loja. A planilha de produtos é a parte menor do trabalho. O que decide o sucesso é provar que preço, promoção, estoque por centro de distribuição e frete se comportam como na loja atual (ou de forma diferente, mas de propósito) e que a troca não perde pedido nem URL indexada.

Este checklist serve para operações que já vendem em outra plataforma e têm ERP, mais de um estoque, lojas físicas ou marketplaces. Ele parte do princípio de que a Wake já foi escolhida. Se a decisão ainda está aberta, leia antes como criar uma loja Wake, que explica as camadas da plataforma, e o guia geral de planejamento da migração de plataforma.

Quais origens de dados e canais precisam ser mapeados?

Comece por um inventário. Para cada dado, anote onde ele está hoje, qual sistema é o dono e como vai chegar à Wake. O inventário revela dados que ninguém lembrava, como cupons ativos, assinaturas e pedidos em aberto.

Depois, liste os canais. Cada canal é uma fonte de pedido e uma saída de estoque: site, aplicativo, lojas físicas e PDV, venda assistida, marketplaces e venda para empresas. A documentação da Wake inclui recursos para sellers de marketplace, origem do pedido e parceiros. Para cada canal, registre se ele continua, muda de sistema ou será desligado na migração.

Como validar a equivalência de catálogo, preço, promoções e logística?

Equivalência se prova com o mesmo carrinho nas duas lojas. Monte de dez a vinte carrinhos de teste que cubram as regras reais da operação e compare total, desconto, frete e prazo entre a loja atual e a Wake em homologação.

Matriz de equivalência (modelo copiável)

A coluna “Na Wake” foi preenchida a partir dos títulos e páginas da documentação oficial consultada em 20/10/2026, sem teste prático. Onde diz “verificar”, a confirmação depende da Wake ou do implantador.

Diferenças podem ser aceitáveis, mas precisam ser decididas pelo negócio antes do lançamento, nunca descobertas pelo cliente.

Para a carga do catálogo, a documentação de operações massivas orienta usar os recursos em lote para preço e estoque e informa limite de 50 produtos por requisição nessas operações (consultado em 20/10/2026). A página de Webhook recomenda ativar a inscrição só depois de terminar a importação dos produtos, para o integrador não receber uma avalanche de notificações durante a carga.

O controle de estoque também entra na equivalência. A Wake documenta dois modos: estoque reservado e baixado pela plataforma, ou estoque controlado pelo ERP, que libera a reserva e faz a baixa. Se na loja atual o ERP baixa o estoque e na Wake a plataforma também passar a baixar, o estoque vai cair em dobro.

Como definir testes, reconciliação de pedidos, URLs e plano de corte?

Reconciliação de pedidos

Durante a homologação e nas primeiras semanas depois do corte, compare todos os dias:

• quantidade de pedidos por status na Wake, no ERP e no gateway;
• valor total pago, por forma de pagamento;
• estoque de uma amostra de SKUs em cada centro de distribuição;
• pedidos que existem em um sistema e não no outro.

A documentação de consumo de pedidos ajuda a desenhar essa rotina. Nas consultas periódicas, a listagem retorna até 50 pedidos por página, e buscas a partir da página 200 (10 mil registros) são tratadas como paginação profunda; a recomendação é consultar intervalos curtos, como 30 minutos ou uma hora (consultado em 20/10/2026). Nos Webhooks, o integrador pode receber a mesma notificação mais de uma vez e precisa tratá-la sem duplicar o pedido. O índice da API Pública também lista recursos para consultar pedidos não integrados e marcar pedidos como integrados, úteis para achar o que ficou para trás.

URLs

Monte a planilha de correspondência entre cada URL antiga e a nova: produtos, categorias, marcas, páginas institucionais e posts. A documentação de SEO do Storefront orienta uma única canonical por página, com categorias apontando para a URL limpa, sem parâmetros de filtro ou ordenação. Confirme com a Wake ou com o implantador como os redirecionamentos 301 das URLs antigas são cadastrados: o recurso de “termo redirecionado” que aparece na API trata de termos de busca, que é outra coisa.

Plano de corte (modelo)

Escreva também o critério de volta atrás: o que precisa dar errado, e até quando, para religar a loja antiga. Sem esse critério, a decisão vira discussão no meio da madrugada.

Quais condições e limitações considerar?

• Decisões que precisam acontecer antes do lançamento. A Wake avisa que o multi frete com cotação para todas as lojas de retirada só deve ser usado em lojas em construção. Em uma migração, defina esse recurso durante a implantação.
• Versão do storefront. A documentação menciona Storefront 1.0 e 2.0, e alguns recursos citados acima são descritos para o 2.0. Confirme em qual versão a nova loja será construída.
• Front-end headless. O Storefront separa a vitrine dos dados, o que dá liberdade de interface e exige equipe para manter o template. Veja quando avaliar e-commerce headless.
• Preço e escopo. As páginas consultadas não publicam valores. Peça na proposta a separação entre plataforma, OMS, template e integrações.
• Números do fornecedor. Afirmações de desempenho e de resultados de clientes nas páginas da Wake são do fornecedor e não substituem a medição do seu catálogo.

Próximo passo

Leve o inventário, a matriz de equivalência e o plano de corte para a conversa com a Wake e com a agência implantadora. A SouLoja não implanta a Wake. Se você quer conferir se a migração é mesmo o melhor caminho, use a matriz para escolher a plataforma de e-commerce ou peça uma avaliação do seu projeto de loja virtual, com as plataformas que atendemos.