SC 33 Importacao de Imagens de Produtos

Importacoes_Dados

Smart Component de Execução que busca automaticamente fotos de produtos na internet e vincula às Informações Adicionais do Produto.

Para que serve

Muitos produtos são cadastrados sem foto, o que prejudica catálogos, e-commerce, força de vendas e etiquetas. Este recurso percorre os produtos ativos e sem nenhuma imagem cadastrada e tenta localizar fotos automaticamente na internet, usando o código de barras do produto e, como último recurso, o nome do produto.

Você não precisa informar nada produto a produto: basta configurar os filtros, ligar as fontes de pesquisa desejadas e executar.

Antes de começar

Pré-requisito	Detalhe
Empresa configurada	O componente usa o proxy de navegação HTTP cadastrado na empresa. Se a sua rede exige proxy, ele precisa estar configurado em Empresa → Proxy → Navegação HTTP, senão os downloads falham.
Acesso à internet	O servidor de aplicação precisa acessar as URLs das fontes (Cosmos, EAN Pictures e Google).
Códigos de barras	Produtos sem código de barras ativo só podem ser pesquisados pelo Google (por nome). Cosmos e EAN Pictures são ignorados para eles.
Chaves do Google	Necessárias apenas se você for usar a fonte Google (veja Como obter a chave e o ID de pesquisa do Google).

Quais produtos são processados

O componente seleciona apenas produtos que atendem todas as condições abaixo:

Produto ativo;
Nenhuma imagem já cadastrada nas Informações Adicionais — produtos que já têm foto são ignorados, ou seja, o recurso nunca sobrescreve imagens existentes;
Atendem aos filtros opcionais que você marcar (espécie, subespécie, produto, tabela de preço).

Os produtos são processados em blocos de 100 registros, até acabar a lista ou até atingir o limite de requisições configurado. Produtos que já possuem imagem são descartados sem consumir requisição, ou seja, não gastam a sua cota do Google.

Como as fontes são usadas (ordem de tentativa)

As fontes são testadas em cascata: assim que uma delas devolve imagens, as demais não são consultadas para aquele produto.

1º  Cosmos (Bluesoft)      → pesquisa pelo código de barras
2º  EAN Pictures           → pesquisa pelo código de barras   (só se o Cosmos não achou nada)
3º  Google Custom Search   → pesquisa "imagens produto <código de barras>"
                             (só se as fontes anteriores não acharam nada)
                           → se ainda assim não achar, repete a pesquisa pelo NOME do produto

Quando o produto tem mais de um código de barras ativo, o sistema tenta um a um e para no primeiro que retornar imagens.

Parâmetros

Obrigatórios

Parâmetro	O que informar
Empresa	Empresa usada para obter a configuração de proxy de navegação.
Usar Cosmos Soft	Sim / Não — habilita a fonte Cosmos (Bluesoft).
Usar EAN Pictures	Sim / Não — habilita a fonte EAN Pictures.
Usar Google	Sim / Não — habilita a fonte Google Custom Search.
Somente produtos com tabela de preço	Sim / Não. Marcando Sim, apenas produtos com tabela de preço base ativa são processados. Útil para não gastar requisições com itens que não são vendidos.
Filtrar Espécie / Subespécie / Produto	Sim / Não. Quando Sim, a lista correspondente passa a ser obrigatória.

Exclusivos da fonte Google

Obrigatórios quando Usar Google = Sim.

Parâmetro	O que informar
Chave da API do Google	Chave da API do Custom Search.
ID da pesquisa do Google	Identificador do mecanismo de pesquisa personalizado (`cx`).
Número de imagens	Quantidade máxima de imagens gravadas por produto. Se ficar em branco, o sistema assume 3.
Número máximo de requisições	Limite de produtos processados na execução. 0 = sem limite. Use este parâmetro para respeitar a cota diária da sua chave Google.

Listas de filtro

Parâmetro	Quando é usado
Espécies	Somente quando Filtrar Espécie = Sim.
Subespécies	Somente quando Filtrar Subespécie = Sim.
Produtos	Somente quando Filtrar Produto = Sim. Ideal para testes: rode primeiro com 2 ou 3 produtos.

Resolução das imagens

O parâmetro Resolução da imagem define o tamanho máximo das fotos gravadas. A proporção (aspecto) da imagem original é sempre preservada, e a imagem só é reduzida — nunca ampliada.

Opção	Resolução
0	Miniatura média (thumbnail)
1	WVGA
2	Padrão (assumido quando o parâmetro não é informado)
3	HD
4	Full HD
5	4K

Todas as imagens são convertidas para PNG antes de serem gravadas.

Além das imagens adicionais, a primeira imagem encontrada é gravada também como imagem principal do produto (em formato miniatura), que é a foto usada nas listagens e aplicativos. Se o produto já tiver uma imagem principal cadastrada, ela é preservada.

Como obter a chave e o ID de pesquisa do Google

Acesse o Google Cloud Console e crie (ou selecione) um projeto.
Ative a API Custom Search API.
Em Credenciais, gere uma Chave de API → este é o valor do parâmetro Chave da API do Google.
Acesse o Programmable Search Engine e crie um mecanismo de pesquisa com a opção Pesquisar em toda a web e Pesquisa de imagens habilitada.
Copie o ID do mecanismo de pesquisa (cx) → este é o valor do parâmetro ID da pesquisa do Google.

Atenção à cota: a Custom Search API tem um limite diário gratuito baixo (tipicamente 100 consultas por dia). Cada produto pesquisado consome de 1 a 2 consultas. Por isso, sempre preencha o parâmetro Número máximo de requisições de acordo com a sua cota.

Passo a passo de uso

Abra a tela de Smart Components e localize Importação de Imagens de Produtos.
Informe a Empresa.
Escolha as fontes que deseja usar (Cosmos, EAN Pictures, Google).
Se usar Google, informe chave, ID de pesquisa, número de imagens e número máximo de requisições.
Defina os filtros (espécie / subespécie / produto / somente com tabela de preço).
Escolha a resolução.
Recomendado na primeira vez: marque Filtrar Produto = Sim e selecione poucos produtos, para conferir o resultado antes de rodar em massa.
Execute e acompanhe o retorno (Sucesso ou Erro com a mensagem correspondente).
Confira o resultado em Produto → Informações Adicionais → Imagens.

Resultado da execução

Retorno	Significado
Sucesso	O processamento terminou. Isso não garante que todos os produtos receberam foto — apenas que não houve erro. Produtos sem resultado nas fontes simplesmente ficam sem imagem.
Erro	A mensagem indica a causa: falha de rede ou proxy, chave do Google inválida ou cota excedida, parâmetro obrigatório não informado, etc.

Downloads individuais que falham (link quebrado, formato de imagem não suportado) são ignorados e não interrompem a execução.

Perguntas frequentes

O recurso substitui as fotos que já tenho?: Não. Produtos que já possuem qualquer imagem cadastrada são excluídos da seleção.

Posso rodar mais de uma vez?: Sim. Como os produtos que já receberam imagem deixam de ser selecionados, as execuções seguintes avançam sobre os produtos restantes. É a forma recomendada de trabalhar quando há cota do Google: rode um pouco por dia usando o Número máximo de requisições.

Por que alguns produtos não receberam foto?: As causas mais comuns são: produto sem código de barras ativo, código de barras não catalogado nas bases consultadas, nome de produto muito genérico ou abreviado, ou cota do Google esgotada.

As imagens vêm sempre corretas?: Não necessariamente. A pesquisa é automática, por semelhança de termos — especialmente na fonte Google, que pesquisa na web aberta. Sempre revise as imagens importadas antes de publicá-las em catálogo ou e-commerce. Lembre-se também de que imagens obtidas na web podem ter direitos autorais de terceiros; a responsabilidade pelo uso é de quem publica.

Preciso ligar as três fontes?: Não. Cosmos e EAN Pictures são gratuitas e mais precisas, pois pesquisam por código de barras. Uma boa configuração inicial é ligar essas duas e deixar o Google desligado; ligue o Google apenas para cobrir os produtos que sobrarem.

Solução de problemas

Sintoma	O que verificar
Erro de conexão ou timeout em todos os produtos	Proxy de navegação HTTP da empresa e liberação de saída do servidor para as URLs das fontes.
Nenhuma imagem vinda do Google	Chave de API e ID de pesquisa; se a pesquisa de imagens está habilitada no mecanismo; se a cota diária foi excedida.
"Campo obrigatório não informado"	Ao marcar Sim em um filtro, a lista correspondente passa a ser obrigatória; o mesmo vale para os parâmetros do Google quando Usar Google = Sim.
A execução parece parar antes do fim	Provavelmente o Número máximo de requisições foi atingido. Aumente o valor ou execute novamente para continuar de onde parou.

Recurso técnico correspondente: SCExecImportacaoImagensGoogle (Smart Component de Execução).