API ViaShopModa documentação

produto/atualizar_textos

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.

Ver como Markdown Baixar coleção Postman 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étodoPOST
URLhttps://api.viashopmoda.com.br/via/produto/atualizar_textos/{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 #

Informe o produto por um destes:

CampoTipoDescrição
cod_produtonúmeroId do produto na loja.
cod_reftextoCó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.

CampoTipoLimiteDescrição
titulotexto255Nome do produto. Não pode ser vazio.
descricaotexto—Descrição completa. Aceita só <br>, <p>, <b> e <strong>; as outras tags são removidas. "" apaga a descrição.
seo_titletexto150Título para buscadores. "" limpa.
seo_descriptiontexto150Descrição para buscadores. "" limpa.
seo_h1texto150Título principal (H1) da página do produto. "" limpa.
video_produtotexto—Link https://vimeo.com/... ou https://youtu.be/.... "" remove.
video_atacadotexto—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 #

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

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

Erros #

MensagemCausa
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.