# Mover produtos de coleção

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

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/alterar_colecao · 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étodo** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/produto/alterar_colecao/{TOKEN}` |
| **Corpo** | Objeto JSON `{ ... }`, cabeçalho `Content-Type: application/json` (JSON cru; form-data é recusado) |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Campos

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `colecao_para` | texto | **sim** | Nome de uma coleção **ativa** existente. |
| `cods_produtos` | lista | um dos dois | Ids dos produtos (`cod_produto`). |
| `colecao_de` | texto | um dos dois | Nome da coleção de origem (ativa). Se vierem os dois, vale `colecao_de`. |

## Exemplo

```json
{ "colecao_de": "VERÃO 2026", "colecao_para": "OUTLET" }
```

```json
{ "cods_produtos": [325, 326, 327], "colecao_para": "OUTLET" }
```

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

## Erros

| Mensagem | Causa |
|---|---|
| `colecao_para é obrigatório` | Falta o destino. |
| `cods_produtos ou colecao_de é obrigatório` | Falta a origem. |
| `colecao_para duplicada ou não encontrada` | Coleção de destino inexistente, inativa ou com nome repetido. |
| `cods_produtos não é um array` | Envie uma lista. |
| `colecao_de duplicada ou não encontrada` / `colecao_de não possui produtos ativos` | Problema na coleção de origem. |
| `produtos não encontrados` | Nenhum 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](https://api.viashopmoda.com.br/docs-api/?p=guias/catalogo-carga-inicial&formato=md#organizar-a-vitrine).
