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 #
{
"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 #
| 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.