# Cadastrar gênero (categoria)

> Cria um gênero pelo nome; se já existir, devolve o id do existente.

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


## O que faz

Cria um gênero (campo `genero` do produto). Se o nome já existir, **não** cria outro e devolve o id do existente.

Normalmente não é preciso chamar esta rota: [`produto/cadastrar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/cadastrar&formato=md) cria o gênero pelo nome.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/categoria/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 | Limites | Descrição |
|---|---|---|---|---|
| `nome` | string | **sim** | mín. 2, máx. 30, gravado em MAIÚSCULAS |  |


## Regras

- Nome de 2 a 30 caracteres, gravado em MAIÚSCULAS.

## Exemplo

```json
{ "nome": "Plus size" }
```

Criado:

```json
{ "retorno": true, "cadastro": true, "nome": "PLUS SIZE", "id": 10 }
```

Já existia (não é erro — use o `id`):

```json
{ "retorno": true, "cadastro": false, "msg_erro": "Categoria não cadastrada. Nome enviado já existe.", "nome": "PLUS SIZE", "id": "10" }
```

Erros: `Parâmetro 'nome' em 'categoria/cadastrar' não encontrado`, `Categoria não cadastrado`.

## Pode reenviar?

Sim. O reenvio devolve o id existente com `cadastro: false`.
