# Trocar código de barras

> Troca o código de barras de até 20 variações já existentes.

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


## O que faz

Grava um novo `cod_barras` numa variação existente. A variação é localizada pelo código antigo ou pelos ids.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/cod_barras/atualizar/{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 (de cada item)

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `cod_barras` | texto | **sim** | O código **novo**. |
| `cod_barras_antigo` | texto | um dos modos | Código atual da variação. |
| `cod_produto`, `cod_grade`, `cod_estampa` | número | um dos modos | Ids da variação. |

## Regras

- A variação precisa existir; se não existir, o item vem em `nao_atualizados`.
- Todos os itens são validados antes de gravar: um item mal formado recusa a requisição inteira.
- Máximo de 20 itens.

## Exemplo

```json
[
  { "cod_barras_antigo": "VES001-P-AZ", "cod_barras": "7890000000101" },
  { "cod_produto": 153, "cod_grade": 18, "cod_estampa": 138, "cod_barras": "7890000000999" }
]
```

```json
{
  "retorno": true,
  "qtd_atualizar": 2,
  "qtd_atualizados": 2,
  "qtd_nao_atualizados": 0,
  "qtd_erros": 0,
  "atualizados": [ ... ],
  "nao_atualizados": [],
  "erros": []
}
```

Erro de validação: `Objeto index[N] inválido, é preciso enviar o 'cod_barras_antigo' ou 'cod_produto', 'cod_estampa' e 'cod_grade'`.

## Pode reenviar?

Com `cod_barras_antigo`, não: depois da troca o código antigo não existe mais e o item vem em `nao_atualizados`. Com os ids, sim.
