# Cadastrar coleção

> Cria uma coleção pelo nome; se já existir uma ativa com esse nome, devolve o id dela.

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


## O que faz

Cria uma coleção ativa. Se já existir uma coleção **ativa** com o mesmo nome, devolve o id dela sem criar outra.

Normalmente não é preciso: [`produto/cadastrar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/cadastrar&formato=md) cria a coleção pelo nome.

## Requisição

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


## Campos

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `nome` | texto | **sim** | 3 a 40 caracteres, gravado em MAIÚSCULAS. |

## Regras

- A busca por nome considera só coleções **ativas**: se existir uma inativa com o mesmo nome, uma nova é criada.

## Exemplo

```json
{ "nome": "Inverno 2026" }
```

```json
{ "retorno": true, "cadastro": true, "msg": "Coleção cadastrada com sucesso.", "id": 34, "nome": "INVERNO 2026" }
```

Já existia: `retorno: true`, `cadastro: false`, com `msg_erro` explicando e o `id` existente. Erros: `Parâmetro 'nome' não encontrado`, `Coleção não cadastrada`.

## Pode reenviar?

Sim; devolve o id da coleção ativa existente.
