# Cadastrar grades (tamanhos)

> Cria tamanhos em lote pelo nome; tamanhos já existentes têm a descrição atualizada.

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


## O que faz

Para cada item: se não existe grade com o nome, cria; se existe, **atualiza** a descrição (aparece em `alterados`).

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

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/grade/cadastrar/{TOKEN}` |
| **Corpo** | Lista JSON `[ {...}, {...} ]`, até 20 itens por requisição, 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

O corpo é uma **lista** `[ {...}, {...} ]` com no máximo 20 itens. Cada item tem os campos abaixo.

| Campo | Tipo | Obrigatório | Limites | Descrição |
|---|---|---|---|---|
| `nome` | string | **sim** |  | Nome da grade. Ex.: 'XG' |
| `descricao` | string | não | aceita null | Informação adicional para a grade. Ex.: 'Extra G' |


## Exemplo

```json
[ { "nome": "P" }, { "nome": "EXG", "descricao": "Extra GG" } ]
```

```json
{
  "retorno": true,
  "total": 2,
  "cadastrados": [ { "id": "20", "nome": "EXG", "descricao": "Extra GG" } ],
  "alterados": [ { "id": "14", "nome": "P", "descricao": "" } ]
}
```

Erros: `POST enviado não é um 'array'`, `Grade não cadastrada`.

## Pode reenviar?

Sim. Atenção: para uma grade que já existe, os dados enviados são regravados — envie sempre a `descricao` desejada junto com o nome.
