API ViaShopModa documentação

preco/atualizar

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.

Ver como Markdown Baixar coleção Postman 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.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/preco/atualizar/{TOKEN}
CorpoLista JSON [ {...}, {...} ], até 20 itens por requisição, cabeçalho Content-Type: application/json
TokenSubstitua {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.

CampoTipoObrigatórioLimitesDescrição
cod_produtointegernãoCódigo do produto na loja virtual
cod_gradeintegernãoConsultar códigos da grade em grade/consultar
cod_estampaintegernãoConsultar códigos da estampa em estampa/consultar
cod_barrasstringnãoCódigo de barras cadastrado na loja virtual de acordo com o padrão do seu sistema
preco_atacadodoublesimaceita nullPreç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_varejodoublesimaceita nullPreç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 #

[
  { "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.

{
  "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.