Integração das imagens dos produtos

Histórico de Alterações

Data	Quem	Comentários
09/07/2025	Renato Lima	Criação do documento

Necessidade

A empresa dispõe de um amplo portfólio de produtos e necessita garantir a disponibilidade das respectivas imagens para exibição durante o processo de venda, tanto no Portal quanto no aplicativo Evo. Considerando o elevado volume de itens, torna-se essencial a implementação de uma funcionalidade que permita a integração das imagens em lote, por meio da leitura de arquivos disponibilizados em um diretório acessível ao sistema.

Solução

Para viabilizar a exibição das imagens de produtos tanto no Portal quanto no App Evo, é necessário garantir a sincronização entre as estruturas de "imagem" e "produto imagem". As imagens devem estar armazenadas em um diretório do servidor do cliente, acessível por meio de um caminho público via HTTPS. A associação entre imagem e produto será feita com base no código de referência do produto.

A exibição das imagens seguirá os parâmetros de venda configurados individualmente para cada produto. Somente serão consideradas as imagens dos produtos habilitados para venda.

Para que o sistema consiga apresentar corretamente as imagens nas aplicações Portal e App GeoSales, é necessário que:

• As imagens estejam disponíveis em um diretório acessível via HTTPS.

• Os arquivos de imagem sigam o padrão de nomenclatura baseado no código de referência do produto.

• As imagens estejam no formato .jpg.

• Para produtos com múltiplas imagens (máximo de 3), os arquivos devem seguir a seguinte convenção:

• https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA.jpg

• https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA_1.jpg

• https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA_2.jpg

Todas as imagens disponíveis no diretório que seguirem esse padrão serão automaticamente associadas aos produtos e exibidas nas aplicações. A GeoSales não realizará validação do conteúdo ou qualidade das imagens disponibilizadas, cabendo ao cliente garantir o correto preenchimento e organização do diretório.

A exibição das imagens seguirá os parâmetros de venda configurados individualmente para cada produto. Somente serão consideradas as imagens dos produtos habilitados para venda.

Para que o sistema consiga apresentar corretamente as imagens nas aplicações Portal e App GeoSales, é necessário que:

As imagens estejam disponíveis em um diretório acessível via HTTPS.

Os arquivos de imagem sigam o padrão de nomenclatura baseado no código de referência do produto.

As imagens estejam no formato .jpg.

Para produtos com múltiplas imagens (máximo de 3), os arquivos devem seguir a seguinte convenção:

https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA.jpg

https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA_1.jpg

https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA_2.jpg

Todas as imagens disponíveis no diretório que seguirem esse padrão serão automaticamente associadas aos produtos e exibidas nas aplicações. A GeoSales não realizará validação do conteúdo ou qualidade das imagens disponibilizadas, cabendo ao cliente garantir o correto preenchimento e organização do diretório.

Regras de Negócios

[RN-1]- As imagens podem ser inseridas via portal também em caso de necessidade;

[RN-2]- As imagens a serem integradas para o uso no Portal/App, deve ser disponibilizadas no diretório em que seja possível acessa-las.

[RN-3]- O caminho a ser usado para acesso as imagens deve ser https;

[RN-4]- Os arquivos dentro do diretório deve ter como nome seu código de produto(referencia);

[RN-5]- O formato do arquivo deve ser jpg;

[RN-6]- Os produtos que deve ter suas informações inseridas nas estruturas para exibição de imagens, devem está disponíveis para venda;

[RN-7]- O endereço da imagens deve ser o seguinte: https://assets.paulus.com.br/imagens-capa/CD_REFERENCIA_X, onde o pode chegar até 3, assim representará as imagens amarradas ao produto;

[RN-8]- AS imagens que respeitarem os critérios estabelecidos serão disponibilizados sem previa avalição das imagens.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Desenvolvimento - GeoSales	Pessoa que aprovou	00/00/0000
Integração - GeoSales	Pessoa que aprovou	00/00/0000
Configurações - GeoSales	Pessoa que aprovou	00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data	Assinatura
Gerente TI - Cliente	Pessoa que aprovou	00/00/0000
Gerente de Projeto - Cliente	Pessoa que aprovou	00/00/0000
Gerente Comercial - Cliente	Pessoa que aprovou	00/00/0000