Nova solução kits de produtos

Como configurar:

Para implementar essa solução no front-end das lojas, é necessário considerar a data de geração dos arquivos, de acordo com os dois cenários abaixo:

Os templates já vêm preparados para operar o novo recurso de kit nativo da plataforma. Isso significa que todo o funcionamento esperado de compra já está disponível e funcional, não sendo necessária nenhuma implementação de front-end além dos ajustes visuais para adequação à identidade da marca.

Lojas geradas antes de 15/09/25:

Atualizar a versão do script productPurchase.js e todas as suas dependências para a versão mais recente (disponível no Template Maker ou em novas lojas já criadas).
Atualizar a versão do script store.js (localizado na pasta de components), responsável pelas ações de adição ao carrinho.
Com os scripts atualizados, implementar a estrutura visual no front-end utilizando Liquid.
Referência com passo a passo: Exemplo de implementação no GitLab.

⚠️ IMPORTANTE:
A loja precisa operar com o productPurchase.js.

Lojas mais antigas que utilizam variants.js + store.js único precisam migrar para o productPurchase.js antes, o que pode demandar mais tempo.
Como validar se a loja já utiliza o productPurchase.js:
1. Acesse uma PDP.
2. Abra o console do navegador.
3. Digite window.productVariants.
4. Se retornar uma lista de produtos organizada por IDs, significa que o script está em uso.
5. Se a variável não existir, a loja ainda não utiliza o productPurchase.js.

Seller solicita ativação do kit nativo no admin.
Equipe de N2 Olist Ecommerce libera a feature na base da loja (staging e produção).
Demanda é enviada ao time de Onboard para inclusão na sprint de front-end.

Prazos:

Execução normal: 4 dias úteis.
Lojas que precisam migrar primeiro para o productPurchase.js: 8 dias úteis.
- O time de front sinalizará essa necessidade caso seja identificado esse cenário.

O comprador acessa a página do produto Kit e seleciona a composição desejada.
No cart-drawer/checkout, é adicionado apenas o produto Kit, com a informação da composição escolhida.
Ao concluir o pedido:
- Na página de confirmação, o comprador visualiza apenas os produtos da composição (o split ocorre na criação do pedido).
- No admin, a página do pedido exibe os produtos da composição conforme o split.
- No ERP, o pedido é criado apenas com os SKUs da composição e seus respectivos preços de venda.