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