Criar uma loja Wake: como planejar storefront, ERP e operação omnicanal

Criar uma loja na Wake não é escolher um tema e cadastrar produtos. É montar três camadas que precisam conversar: a plataforma, onde ficam catálogo, preço e checkout; o storefront, que é a vitrine; e, quando há lojas físicas ou vários centros de distribuição, a gestão de pedidos. O planejamento que evita retrabalho vem antes do layout: quais jornadas de compra a loja vai atender e qual sistema é dono de cada dado.

Este guia é para operações médias e grandes que já têm ERP, estoque em mais de um local ou lojas físicas, e que estão avaliando a Wake. A própria Wake apresenta a plataforma como headless e com solução omnicanal nativa, voltada a médias e grandes operações. Se você ainda está comparando opções desse porte, comece por como comparar plataformas para e-commerce empresarial.

Qual é a diferença entre plataforma, storefront e gestão de pedidos na Wake?

Misturar essas camadas é a origem de muitas propostas confusas. Cada uma tem uma equipe, uma API e um tipo de teste diferente.

A documentação técnica da Wake resume a divisão em uma regra: se o código roda no navegador do cliente ou no template da loja, usa-se a Storefront API; se roda em um servidor para sincronizar dados com a Wake, usa-se a API Pública. Na prática, isso significa que o projeto tem pelo menos duas frentes de trabalho. Uma é de front-end, com templates em HTML editável, a linguagem de template Scriban e ambiente de desenvolvimento local. A outra é de integração, que conecta ERP, OMS ou WMS por API e Webhook.

O OMS é uma peça à parte. A documentação da Wake OMS API lista como pré-requisito usar o sistema Wake OMS e ter um usuário habilitado para a API. Antes de desenhar a jornada de retirada ou de envio a partir da loja, confirme na proposta se o OMS está incluído.

Quais jornadas de compra, retirada e expedição precisam de validação?

Cada jornada omnicanal muda quem decide o estoque e quais sistemas entram no pedido. Liste todas as que a sua operação vai oferecer no lançamento e deixe as demais para uma segunda fase.

1. Compra no site, entrega a partir do centro de distribuição. É a jornada básica, mas já exige estoque por centro de distribuição correto e frete calculado na origem certa.
2. Compra no site, retirada na loja. A Wake documenta uma configuração de multi frete que mostra todas as lojas físicas disponíveis para retirada. A mesma página avisa que esse recurso só deve ser usado por lojas em construção; para loja em produção, é preciso acionar o suporte. Ou seja: decida antes do lançamento.
3. Loja física como ponto de envio. O OMS escolhe o estoque responsável pela entrega. A regra de prioridade entre lojas e centros de distribuição precisa estar escrita.
4. Pedido com itens de origens diferentes. O carrinho pode gerar pacotes de centros de distribuição distintos, cada um com seu frete.
5. Venda na loja com estoque da rede. É a prateleira infinita: o vendedor vende pelo aplicativo um item que está em outra unidade.
6. Ruptura. A loja recusa o pedido por falta de produto ou avaria, e o pedido precisa ser realocado ou cancelado.
7. Devolução. O OMS registra a solicitação e recebe os dados da nota fiscal de devolução gerada no PDV.

Mapa de jornada omnicanal (modelo)

O mapa abaixo é um modelo ilustrativo, montado a partir da documentação oficial consultada em 20/10/2026. Não é o resultado de um teste executado. Copie e preencha com as suas lojas, centros de distribuição e sistemas.

Que contratos de integração definir antes da virada?

Um contrato de integração diz, para cada fluxo, qual sistema é o dono do dado, em que direção ele viaja, o que dispara o envio e quem corrige o erro. Sem isso, o ERP e a loja disputam o mesmo número.

O ponto mais sensível é o estoque. A documentação da Wake descreve duas formas de controle, e elas são incompatíveis entre si:

• Estoque reservado pela plataforma. A configuração de controle de estoque pela plataforma fica habilitada. A reserva acontece na compra e é liberada quando o pedido muda para enviado, entregue, cancelado ou faturado; o estoque físico baixa nos status de enviado, entregue ou faturado. Nesse modo, o ERP não deve enviar a baixa, porque a plataforma já faz isso.
• Estoque controlado pelo ERP. A configuração fica desabilitada. A reserva também acontece na compra, mas só é liberada quando o ERP envia a atualização com SKU, centro de distribuição e quantidade. O ERP é responsável por baixar o estoque quando o pedido é enviado ou entregue.

Escolher um modo e configurar o outro gera baixa em dobro ou estoque que nunca é liberado. Registre a escolha no contrato.

Para pedidos, a documentação apresenta duas estratégias: consultas periódicas à API, que são mais simples mas não são em tempo real, ou Webhooks, em que a Wake avisa o integrador quando um pedido é criado ou alterado. No segundo caso, o integrador precisa manter um endpoint público, rápido e seguro, e tratar a mesma notificação recebida mais de uma vez sem duplicar o pedido. Defina qual estratégia cada fluxo usa. O token da API Pública é vinculado a um responsável técnico; registre quem é.

Ficha de contrato de integração (modelo copiável)

Os requisitos que costumam faltar nessa ficha estão no guia de requisitos da integração com ERP.

Como homologar catálogo, estoque e pedidos antes do lançamento?

A homologação transforma o mapa e a ficha em testes com resultado esperado. Rode cada linha em ambiente de testes, com produtos e lojas reais, e só marque como aprovado quando o resultado aparecer em todos os sistemas envolvidos.

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

• Preço sob consulta. As páginas oficiais consultadas não publicam valores de plano; a contratação passa por demonstração comercial. Peça na proposta o que está incluído: plataforma, storefront, OMS e Wake U.
• Implantação por parceiros. A Wake mantém programa de agências parceiras e de certificação para desenvolvedores. Pergunte se quem vai implantar é parceiro e quem responde pelo template e pelas integrações.
• Números de desempenho. As páginas da Wake trazem afirmações de desempenho e disponibilidade. Elas são do fornecedor; meça o seu catálogo na homologação.
• Ordem das decisões. Recursos como o multi frete com retirada em todas as lojas devem ser decididos com a loja ainda em construção.

Próximo passo

Se a sua loja já opera em outra plataforma, o passo seguinte é o checklist para migrar para a Wake, com equivalência de catálogo, reconciliação de pedidos e plano de corte. A SouLoja não implanta a Wake. Se você quer uma opinião sobre o porte do projeto antes de decidir, compare as opções na matriz para escolher a plataforma de e-commerce ou peça uma avaliação do seu projeto de loja virtual, considerando as plataformas que atendemos.