# Atualizar textos e SEO do produto

> Altera título, descrição, SEO e vídeos de um produto existente sem enviar preço nem estoque.

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


## O que faz

Atualiza **só os textos** de um produto que já existe na loja. Preço, estoque, variações, fotos, coleção, tipo, gênero e status **não são alterados**.

Use esta rota quando o preço e o estoque vêm do ERP e você só cuida da vitrine. Reenviar `produto/cadastrar` para isso recria as variações e regrava os preços.

## Requisição

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

Informe o produto por **um** destes:

| Campo | Tipo | Descrição |
|---|---|---|
| `cod_produto` | número | Id do produto na loja. |
| `cod_ref` | texto | Código de referência. Se houver mais de um produto com a mesma referência, vale o ativo. |

E envie ao menos um dos campos abaixo. **Campo não enviado não é alterado.**

| Campo | Tipo | Limite | Descrição |
|---|---|---|---|
| `titulo` | texto | 255 | Nome do produto. Não pode ser vazio. |
| `descricao` | texto | — | Descrição completa. Aceita só `<br>`, `<p>`, `<b>` e `<strong>`; as outras tags são removidas. `""` apaga a descrição. |
| `seo_title` | texto | 150 | Título para buscadores. `""` limpa. |
| `seo_description` | texto | 150 | Descrição para buscadores. `""` limpa. |
| `seo_h1` | texto | 150 | Título principal (H1) da página do produto. `""` limpa. |
| `video_produto` | texto | — | Link `https://vimeo.com/...` ou `https://youtu.be/...`. `""` remove. |
| `video_atacado` | texto | — | Mesmo formato, vídeo do atacado. `""` remove. |

O endereço (URL) do produto **não muda** quando o título é alterado, para não quebrar links e a indexação.

## Exemplo

```json
{
  "cod_ref": "0000618",
  "titulo": "Vestido Midi Azul Marinho",
  "seo_title": "Vestido Midi Azul Marinho | Coleção Verão",
  "seo_description": "Vestido midi em viscose, alças finas, do P ao GG."
}
```

Sucesso:

```json
{
  "retorno": true,
  "msg": "Textos do produto Ref. 0000618 atualizados.",
  "cod_produto": 325,
  "cod_ref": "0000618",
  "campos_atualizados": ["titulo", "seo_title", "seo_description"]
}
```

## Erros

| Mensagem | Causa |
|---|---|
| `Informe 'cod_produto' ou 'cod_ref'.` | Falta identificar o produto. |
| `Produto não encontrado.` | Id ou referência inexistente. |
| `Nenhum campo para atualizar...` | Nenhum dos campos de texto foi enviado. |
| `'titulo' não pode ser vazio.` | Título enviado como `""`. |
| `'<campo>' tem mais de N caracteres.` | Passou do limite da tabela acima. |
| `'<campo>' deve ser texto.` | Valor enviado como número, lista ou objeto. |
| `'video_produto' no formato errado...` | Link que não é do Vimeo nem do youtu.be. |

## Pode reenviar?

Sim. Reenviar o mesmo conteúdo deixa o produto igual.

## Onde entra no processo

Ajustes de vitrine depois da carga do catálogo. Dispara o webhook `produto.atualizado` — guia [Catálogo](https://api.viashopmoda.com.br/docs-api/?p=guias/catalogo-carga-inicial&formato=md#reenviar-um-produto-atualizacao).
