- Criado por Jaciara Pereira Da Silva em out 03, 2025
Millen-58860_31130 - Integração Vtex - Enviar Campo "Label" e "Texto" da Imagem
Release - 108
Versão - 5
Autor - Jaciara Silva
Caminho:
Produtos e Serviços > Vitrines > Vitrine
Objetivo
Na integração entre e-Millennium e a plataforma VTEX, no front da plataforma existe um tratamento para ler as informações contidas no campo “Label” das imagens, usado para definir o padrão de exibição. Porém, atualmente, o e-Millennium não envia o campo Label, ao enviar as imagens para a plataforma.
Para atender esta demanda, foi necessário:
- Desenvolver uma rotina que realizasse o envio do campo “Label” e as expressões de imagem para a plataforma;
- Criar tabela para configuração de relação entre “Label” e “Expressão da Imagem” nas configurações adicionas;
- Criar validação para cada campo, antes de ser enviado para a Vtex.
O envio de imagens passa a ser feito em dois níveis:
- No nível do produto – quando os dados são enviados por SKU
- No nível da vitrine – quando os dados são enviados por produto
A ordem do envio de imagens será sempre a seguinte:
- Primeiro o sistema irá checar no cadastro do produto se existem urls configuradas por SKU;
- Se não houver url por SKU, o sistema irá buscar no cadastro da vitrine e fará o envio por produto.
ATENÇÃO
Este recurso não acompanha a versão do sistema. Para utilizá-lo, solicite aos nossos consultores que forneçam o módulo para instalação. Caso você não consiga fazer a instalação, entre em contato com nosso departamento comercial e solicite a visita de um consultor.
Pré-requisitos
Instalar os módulos:
- millenium!mEnvio_Avancado_Imagem.minst
- millenium_eco_active_vtex!mEnvio_Avancado_Imagem.minst
Parâmetros
Atenção! Para que a customização funcione corretamente, é necessário que no banco de dados a tabela "VITRINE_DADOS_VTEX" esteja com campo "USA_NOVA_API_PRODUTO" preenchido com o valor de 'T'.

Entradas
Em Produtos e Serviços\Vitrines\Vitrine de Produtos, incluir os produtos na vitrine a ser integrada com a Vtex.

Envio de Imagens no Nível do Produto
Nesse caso, a empresa poderá enviar uma imagem para cada SKU do produto, independente do tamanho da grade, ideal para apresentação de roupas, calçados, artigos para pets etc.
Em Produtos e Serviços > Produtos, na guia Fotos, localizar e preencher:
- Tabela de Envio Avançado de Imagens;
- Clicar no sinal de adição (+);
- Expressão de Imagens – preencher com a url da foto;
- Label e Text – preenchimento livre;
- Selecionar cor, estampa e tamanho – definindo o SKU a ser vinculado na url da foto;
- Salvar.
Atenção! Ao selecionar cor, estampa ou tamanho a imagem será vinculada somente à opção selecionada.
No exemplo a seguir temos:
url teste 1 é específica para a cor Champagne, na estampa Floral e no tamanho P;
url teste 2 é específica para a cor Champagne, na estampa Por do Sol e no tamanho M;
url teste 3 é para a cor Coral, na estampa Floral e para todos os tamanhos;
url teste 4 é para a cor Amêndoa, para todas as estampas e para todos os tamanhos.

ATENÇÃO
Atenção! Não será possível cadastrar duas urls para a mesma chave de SKU. O sistema fará uma validação e emitirá uma mensagem de alerta, solicitando a correção do preenchimento da tabela.

Envio de Imagens no Nível da Vitrine
Nesse caso, a empresa opta por enviar uma imagem genérica para o produto, mais indicado para produtos que não dependam de grade para a venda, por exemplo: celulares, eletrodomésticos, medicamentos etc.
Sendo assim, não é necessário preencher no cadastro do produto cada SKU, basta preencher na própria vitrine e o sistema enviará a mesma imagem para toda a grade do produto, mesmo que não seja uma grade única.
Em Produtos e Serviços > Vitrines:
- Faça uma busca e selecione a vitrine a ser integrada com a Vtex;
- No link Ações, selecione Configurações Adicionais;
- Na guia Geral, localize e preencha os campos:
Expressões de Imagens - informe o caminho para o local onde está armazenada a imagem a ser exibida, geralmente é um FTP, um repositório contratado.
Label - informe um nome para a imagem
Text - informe uma descrição para a imagem
Obs.: O nome e a descrição da imagem devem ser preenchidos de acordo com a necessidade da empresa e serão usados pela Vtex e/ou pela agência responsável pelo site.
Validações e Saídas
1.O campo Expressões de Imagens também está disponível na guia Configurações de Produto. Porém, ele deverá permanecer vazio, sempre que o usuário informar as expressões de imagens na tela de Configurações Adicionais. Isso é necessário porque o e-Millennium fará uma verificação antes de integrar com a Vtex, evitando um conflito de informações. Se o sistema detectar que o campo foi preenchido nas duas telas, será emitida uma mensagem de alerta e o usuário deverá providenciar a correção dos preenchimentos.

2.Os campos Label e Text somente serão enviados na integração com a Vtex quando preenchidos junto com o campo Expressões de Imagens disponível na tela de Configurações Adicionais.
Índice
- Sem rótulos