API ViaShopModa documentação

cod_barras/atualizar

Trocar código de barras

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

Ver como Markdown Baixar coleção Postman 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étodoPOST
URLhttps://api.viashopmoda.com.br/via/cod_barras/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 (de cada item) #

CampoTipoObrigatórioDescrição
cod_barrastextosimO código novo.
cod_barras_antigotextoum dos modosCódigo atual da variação.
cod_produto, cod_grade, cod_estampanúmeroum dos modosIds 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 #

[
  { "cod_barras_antigo": "VES001-P-AZ", "cod_barras": "7890000000101" },
  { "cod_produto": 153, "cod_grade": 18, "cod_estampa": 138, "cod_barras": "7890000000999" }
]
{
  "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.