API ViaShopModa documentação

produto/alterar_colecao

Mover produtos de coleção

Transfere para outra coleção uma lista de produtos ou todos os produtos ativos de uma coleção.

Ver como Markdown Baixar coleção Postman Atualizado em 18/11/2026

O que faz #

Move produtos para a coleção colecao_para. Escolha um modo:

  • cods_produtos: os produtos da lista;
  • colecao_de: todos os produtos ativos dessa coleção.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/produto/alterar_colecao/{TOKEN}
CorpoObjeto JSON { ... }, cabeçalho Content-Type: application/json (JSON cru; form-data é recusado)
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.

Campos #

CampoTipoObrigatórioDescrição
colecao_paratextosimNome de uma coleção ativa existente.
cods_produtoslistaum dos doisIds dos produtos (cod_produto).
colecao_detextoum dos doisNome da coleção de origem (ativa). Se vierem os dois, vale colecao_de.

Exemplo #

{ "colecao_de": "VERÃO 2026", "colecao_para": "OUTLET" }
{ "cods_produtos": [325, 326, 327], "colecao_para": "OUTLET" }

Sucesso: {"retorno": true, "mensagem": "3 produtos foram transferidos para coleção OUTLET."}

Erros #

MensagemCausa
colecao_para é obrigatórioFalta o destino.
cods_produtos ou colecao_de é obrigatórioFalta a origem.
colecao_para duplicada ou não encontradaColeção de destino inexistente, inativa ou com nome repetido.
cods_produtos não é um arrayEnvie uma lista.
colecao_de duplicada ou não encontrada / colecao_de não possui produtos ativosProblema na coleção de origem.
produtos não encontradosNenhum dos ids existe.

Pode reenviar? #

Sim; os produtos ficam na coleção de destino.

Onde entra no processo #

Organização da vitrine — guia Catálogo.