Pular para o conteúdo principal

VM Builder – Coleções e Subconjuntos (Slices)

O VM Builder permite criar e organizar coleções de produtos utilizando IA, planilhas ou seleção manual. Cada coleção pode conter subconjuntos chamados slices, que organizam os produtos de acordo com critérios definidos.

1. Criando uma Coleção​

  1. Clique em New Collection.
  2. Insira:
    • Nome da coleção (ex.: Coleção de Inverno 2025).
    • Descrição da coleção (ex.: Produtos de inverno).
  3. Salve a coleção.

A coleção será listada na tela inicial, mostrando:

  • Nome
  • Descrição
  • Data de criação
  • Número de slices existentes

2. Criando um Subconjunto (Slice)​

  1. Dentro da coleção, clique em New Slice.
  2. Preencha:
    • Nome do slice (ex.: Casacos de Lã).
    • Tipo (MANUAL, ou outros tipos se disponíveis).
    • Data de início (quando ficará ativo).
    • Data de fim (quando expira).

Para um slice sem expiração, utilize uma data de fim distante.

Status de um slice (com base nas datas)​

  • 🟩 Verde – Ativo (entre data de início e fim).
  • 🟨 Amarelo – Agendado (ainda não começou).
  • 🟥 Vermelho – Expirado (data de fim já passou).

3. Gerenciamento de Produtos no Slice​

Dentro de cada slice você pode:

  • ➕ Adicionar produtos
  • ➖ Remover produtos
  • 🔀 Reposicionar produtos (definir a ordem/position)

Limite: cada slice pode conter até 500 produtos.

O campo active retornado por produto na API respeita os filtros aplicados ao slice.

4. Consultando Produtos da Coleção via API​

Na página da coleção, há um endpoint para consultar os produtos do slice ativo.

Endpoint​

GET https://catalog.api.fashionaiale.com/api/v1/merchandising-collections/protected/{id}

Headers​

X-FashionAI-APP-Token: <app-token>

Regras da API​

  • A API retorna apenas 1 slice ativo.
  • Se existirem vários ativos, retorna o que possuir a maior data de início.
  • Se não houver slice ativo, retorna HTTP 404.

5. Exemplo de Resposta (payload)​

{
  "collectionId": 1,
  "collectionName": "Coleção de Inverno 2025",
  "collectionDescription": "Produtos de inverno",
  "sliceId": 10,
  "sliceName": "Casacos de Lã",
  "startsAt": "2025-09-23T00:00:00.000Z",
  "endsAt": "2025-12-31T23:59:59.000Z",
  "products": [
    {
      "productId": "12345",
      "position": 1,
      "active": true
    },
    {
      "productId": "12346",
      "position": 2,
      "active": false
    }
  ]
}

Campos Importantes​

  • position: ordem do produto no slice.
  • active: indica se o produto está ativo conforme os filtros do slice.

6. Restrições​

  • ✅ Máximo de 500 produtos por slice.
  • ✅ Um slice pode ser criado sem expiração (definindo data de fim distante).
  • ❌ Sem slice ativo → a API não retorna produtos (HTTP 404).

7. Notas de Boas Práticas​

  • Nomeie coleções e slices de forma clara para facilitar a manutenção.
  • Evite manter mais de um slice ativo ao mesmo tempo, para reduzir ambiguidades.