Na VTEX, a forma de acessar uma coleção depende diretamente da tecnologia utilizada no front-end: VTEX CMS ou VTEX IO.
Embora o conceito de coleção (Product Cluster) seja o mesmo, a estrutura de URL muda completamente entre as duas tecnologias.
Por isso, é comum surgir dúvida sobre qual URL usar — principalmente quando alguém tenta acessar uma coleção no IO usando o padrão do CMS.
Neste post, você vai entender como funciona o acesso a coleções em cada cenário, de forma simples e objetiva.
Como acessar coleções no VTEX CMS
No VTEX CMS, as coleções são acessadas por meio da rota de busca, utilizando filtros (fq).
Estrutura da URL no CMS:
/busca?fq=H:{id_da_colecao}
Exemplo:
https://dfreedom.com.br/busca?fq=H:180
Onde:
-
H:180representa o ID da coleção -
A rota
/buscaé responsável por listar os produtos filtrados
Esse padrão é exclusivo do VTEX CMS.
Como acessar coleções no VTEX IO
No VTEX IO, o acesso às coleções não utiliza a rota /busca. As coleções são acessadas diretamente por uma rota baseada no ID da coleção, combinada com o parâmetro map.
Estrutura da URL no IO:
/{id_da_colecao}?map=productClusterIds
Exemplo:
https://dfreedom.com.br/180?map=productClusterIds
Onde:
-
180é o ID da coleção -
map=productClusterIdsinforma ao IO que o filtro aplicado é uma coleção
Essa é a forma correta e padrão de acessar páginas de coleção no VTEX IO.
Importante: CMS e IO usam padrões diferentes
É importante reforçar:
- A URL do CMS não funciona no IO
- A URL do IO não existe no CMS
- Não se trata de mudança temporária ou de migração
- É uma diferença estrutural entre as tecnologias
Conclusão
Na VTEX, acessar coleções depende diretamente da tecnologia utilizada no front-end.
-
VTEX CMS:
/busca?fq=H:{id} -
VTEX IO:
/{id}?map=productClusterIds
Entender essa diferença evita erros de acesso, dúvidas desnecessárias e retrabalho no suporte técnico.
Com isso, sempre que surgir a pergunta sobre URL de coleção, a resposta fica simples, clara e documentada.
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.
