# Atualizar preço de variações

> Dá um preço diferente do produto para até 20 variações (ex.: tamanho GG mais caro), ou volta a herdar o preço do produto.

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


## O que faz

Grava o preço próprio de cada variação. `null` faz a variação voltar a usar o preço do produto.

Para mudar o preço do **produto** (todas as variações), use [`produto/alterar_precos`](https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/alterar_precos&formato=md).

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/preco/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

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

| Campo | Tipo | Obrigatório | Limites | Descrição |
|---|---|---|---|---|
| `cod_produto` | integer | não |  | Código do produto na loja virtual |
| `cod_grade` | integer | não |  | Consultar códigos da grade em [grade/consultar](https://api.viashopmoda.com.br/docs-api/?p=recursos/grade/consultar&formato=md) |
| `cod_estampa` | integer | não |  | Consultar códigos da estampa em [estampa/consultar](https://api.viashopmoda.com.br/docs-api/?p=recursos/estampa/consultar&formato=md) |
| `cod_barras` | string | não |  | Código de barras cadastrado na loja virtual de acordo com o padrão do seu sistema |
| `preco_atacado` | double | **sim** | aceita null | Preço especial do SKU no atacado, diferenciando do preço produto. Se não enviado, não será atualizado. Se enviado como NULL, o preço de atacado desse SKU passará a ser o valor do produto. |
| `preco_varejo` | double | **sim** | aceita null | Preço especial do SKU no varejo, diferenciando do preço produto. Se não enviado, não será atualizado. Se enviado como NULL, o preço de atacado desse SKU passará a ser o valor do produto. |


## Regras

- Identifique a variação por `cod_barras` **ou** por `cod_produto` + `cod_grade` + `cod_estampa`.
- Depois de gravar, a loja tenta recalcular o preço do produto como o **menor** preço entre as variações. Para não fazer isso, acrescente `?atualizar_produtos=N` na URL.
- Máximo de 20 itens.

## Exemplo

```json
[
  { "cod_barras": "7890000000103", "preco_atacado": 64.90, "preco_varejo": 129.90 },
  { "cod_barras": "7890000000101", "preco_atacado": null, "preco_varejo": null }
]
```

O primeiro item fica com preço próprio; o segundo volta a herdar o preço do produto.

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

Erros da requisição: `POST de 'produtos' deve ser um array (...)`, `POST de 'produtos' está zerado.`, `Permitido enviar no máximo 20 registros por requisição...`, `Se não enviar 'cod_barras' deverá informar 'cod_produto, cod_grade e cod_estampa' no index [N] do array enviado`.

## Pode reenviar?

Sim.

## Onde entra no processo

Guia [Estoque e preço](https://api.viashopmoda.com.br/docs-api/?p=guias/estoque-e-preco&formato=md).
