# Agrupar produtos na SuperVitrine

> Liga produtos que são o mesmo modelo em cores diferentes, cadastrados como produtos separados.

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/associar_supervitrine · Atualizado em 18/11/2026


## O que faz

Algumas lojas cadastram um produto **por cor** (ex.: `001 - Preto`, `001 - Verde`). A SuperVitrine liga esses produtos para que a página de cada um mostre as outras cores.

Cada produto da lista passa a apontar para **todos** os produtos da lista (o grupo inteiro é substituído).

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/produto/associar_supervitrine/{TOKEN}` |
| **Corpo** | Objeto JSON `{ ... }`, cabeçalho `Content-Type: application/json` (JSON cru; form-data é recusado) |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Campos

Envie **uma** das listas:

| Campo | Tipo | Descrição |
|---|---|---|
| `ids` | lista | Ids dos produtos (`cod_produto`). |
| `cods_ref` | lista | Códigos de referência. |

Só produtos **ativos** são associados.

## Exemplo

```json
{ "cods_ref": ["001 - PRETO", "001 - VERDE", "001 - VERMELHO"] }
```

```json
{ "retorno": true, "associados": "2032, 2033", "nao_associados": "2034" }
```

Erro: `ids ou cods_ref precisa ser array`.

## Pode reenviar?

Sim. Para mudar o grupo, envie a lista completa nova.

## Onde entra no processo

Guia [Catálogo](https://api.viashopmoda.com.br/docs-api/?p=guias/catalogo-carga-inicial&formato=md#organizar-a-vitrine).
