# Cadastrar estampas (cores/variações)

> Cria estampas em lote pelo nome; as que já existem são devolvidas sem alteração.

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


## O que faz

Cria estampas (a "cor" da variação). Nomes que já existem entre as estampas ativas vêm em `nao_cadastrados`, com o id existente.

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

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/estampa/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** | mín. 3, máx. 50 | Nome da estampa |


## Regras

- Nome de 3 a 50 caracteres.
- A estampa nasce **sem imagem**. Para dar uma imagem, use [`imagens/upload`](https://api.viashopmoda.com.br/docs-api/?p=recursos/imagens/upload&formato=md) com o objeto `estampa`; para uma cor sólida, [`estampa/atualizar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/estampa/atualizar&formato=md) com `hex`.

## Exemplo

```json
[ { "nome": "VERMELHO CEREJA" }, { "nome": "NUDE" } ]
```

```json
{
  "retorno": true,
  "total": 2,
  "cadastrados": [ { "id": "500", "nome": "VERMELHO CEREJA" } ],
  "nao_cadastrados": [ { "id": "10", "nome": "NUDE" } ]
}
```

Erros: `POST enviado não é um 'array'`, `'nome' da estampa enviado é inválido ou vazio.`, `Estampa não cadastrada`.

## Pode reenviar?

Sim; as existentes vêm em `nao_cadastrados`.
