Em alguns cenários, pode ser útil adicionar produtos ao carrinho de forma automática. Por exemplo, em campanhas, links de WhatsApp, e-mails ou páginas externas.
Pensando nisso, a VTEX permite adicionar itens ao carrinho diretamente por meio de uma URL específica.
Embora seja uma funcionalidade pouco conhecida, ela pode simplificar bastante alguns fluxos.
Neste post, você vai entender como essa URL funciona e quando faz sentido utilizá-la.
Quando usar a adição por URL?
Antes de tudo, vale entender os principais casos de uso.
Essa abordagem é indicada quando você precisa:
-
Criar links diretos para campanhas promocionais
-
Adicionar produtos ao carrinho a partir de landing pages
-
Facilitar compras rápidas via WhatsApp ou e-mail
-
Simular fluxos de compra em testes e validações
Ou seja, sempre que o objetivo for reduzir etapas, essa solução pode ajudar.
Estrutura da URL para adicionar ao carrinho
A URL utilizada segue o padrão abaixo:
https://{{account}}.myvtex.com/checkout/cart/add?sku={ID_SKU}&qty=1&seller={ID_Seller}&redirect=true&sc={ID_Sales_Channel}
Embora pareça complexa à primeira vista, cada parte tem um papel bem definido.
Entendendo cada variável da URL
A seguir, veja o que cada parâmetro representa:
|
Variável
|
Descrição
|
|---|---|
|
account |
Nome da conta VTEX |
|
sku |
ID do SKU do produto |
|
qty |
Quantidade do item |
|
seller |
ID do seller |
|
redirect |
Define se haverá redirecionamento |
|
sc |
ID do canal de vendas |
Assim, basta substituir os valores conforme o produto desejado.
Exemplo prático de uso
Suponha o seguinte cenário:
-
Conta:
minhaloja -
SKU:
1234 -
Seller:
1 -
Canal de vendas:
1
A URL final ficaria assim:
https://minhaloja.myvtex.com/checkout/cart/add?sku=1234&qty=1&seller=1&redirect=true&sc=1
Ao acessar esse link, o produto será automaticamente adicionado ao carrinho.
Em seguida, o usuário será redirecionado para o checkout.
Pontos de atenção importantes
Apesar da praticidade, alguns cuidados são essenciais:
- O SKU precisa estar ativo
- O seller deve existir no canal informado
- O produto deve estar disponível em estoque
- O canal de vendas deve permitir a compra
- Caso contrário, a adição ao carrinho pode falhar.
Conclusão
Em resumo, adicionar produtos ao carrinho por URL é uma solução simples e poderosa.
Quando bem aplicada, ela reduz etapas e melhora a experiência do usuário.
Por isso, vale considerar esse recurso em campanhas, testes ou fluxos personalizados. Com poucos parâmetros, você consegue criar jornadas mais rápidas e eficientes.
Se você trabalha com VTEX no dia a dia, essa é uma funcionalidade que merece entrar no seu radar 🚀
Quer se aprofundar em Front-end e VTEX IO?
Na DFreedom, trabalhamos com uma formação prática e orientada ao mercado. Por isso, nosso foco está no desenvolvimento web e no ecossistema da VTEX. Assim, atendemos desde quem está começando até profissionais em nível avançado.
