Cadastrar o kit no admin
Abra seu admin:
Clique em Produtos > Kits;
Adicionar kits;
Preencha as informações: nome do kit, SKU dos itens, referência do kit, descrição, tags e dimensões do pacote.
Com isso é possível selecionar os itens que devem compor esse kit.
Além disso, é possível cadastrar um valor promocional para cada item dentro do kit.
Outro ponto importante é que o cliente poderá selecionar a variação do item como cor, tamanho e etc.
Como gerir o kit?
Após o cadastro do Kit, com os itens já selecionados você visualiza o preço atual e promocional de cada um, além do estoque disponível. Lembrando que a disponibilidade do kit depende do menor estoque entre os itens que compõem o kit.
Por exemplo: se tenho um kit com uma camiseta A + uma camiseta B.
Se a camiseta A tem 20 unidades e a camiseta B tem 30, o sistema apresenta a opção de 20 kits. Considera sempre o menor estoque dos itens que compõem o kit.
Um kit pode receber um cupom de desconto?
Sim. Os kits podem receber um cupom de desconto e permitir a integração deste pedido seja no ERP, Hub ou outras integrações.
Limitações do kit
Produtos com personalização não retornam na seção de kits.
O kit não possui compra rápida no bloco de produtos (quando visto nas listagens, home e buscas).
Front-end
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:
Lojas geradas a partir de 15/09/25:
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.jse 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 oproductPurchase.jsantes, o que pode demandar mais tempo.Como validar se a loja já utiliza o
productPurchase.js:Acesse uma PDP.
Abra o console do navegador.
Digite
window.productVariants.Se retornar uma lista de produtos organizada por IDs, significa que o script está em uso.
Se a variável não existir, a loja ainda não utiliza o
productPurchase.js.
Fluxo para pautar os Cards
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.
Documentação: kit-nativo · Vnda / Code Examples no GitLab
Fluxo do pedido
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.
Sincronização com ERP
A nova solução de kits não abrange o envio de kits do ERP para o e-commerce. Portanto, nesses casos, seguimos usando a solução antiga.
1. Criar o kit no Tiny seguindo esse tutorial: Como cadastrar produtos do tipo Kit no Sistema ERP da Olist
2. Feito isso, vão sincronizar o kit com o e-commerce e ele entrará como um produto simples aqui no nosso admin (a separação dos itens do kit ocorre toda no ERP).
Caso o seller queira utilizar a nova solução de kits, é necessário que criem os kits diretamente no admin.