Como ligar Stockbase ao Shopware?

O que a Stockbase fornece e não fornece

Nos Países Baixos, a Stockbase é sobretudo conhecida como plataforma de dados de stock e produto entre fornecedores e retalhistas. Para imagens, o funcionamento é simples: por EAN (o código de barras, também chamado GTIN) estão disponíveis uma ou mais imagens de produto, cada uma com o seu próprio número de imagem. Normalmente são packshots do fornecedor, por vezes também imagens de detalhe ou imagens com modelo.

A ligação de imagens não fornece títulos de produto, descrições ou propriedades já prontos, como material e instruções de lavagem. Esses dados vêm do teu próprio ficheiro de artigos, do sistema de ponto de venda ou ERP, ou são criados com base na imagem e na etiqueta de lavagem. Por isso, não contes que a Stockbase, por si só, complete um produto no Shopware.

O Shopware 6 não tem uma integração padrão com imagens Stockbase. É possível descarregar imagens e carregá-las através de uma importação ou do administrador do Shopware, mas, com centenas de artigos por época, isso torna-se trabalho manual. Uma integração que faça a correspondência, edite e publique é o que mais poupa tempo.

O que é necessário antes de começar

Do lado da Stockbase, só precisas do nome de utilizador e da palavra-passe da tua própria conta Stockbase. Com esses dados, o Photopilot pede os tokens de acesso e renova-os a tempo, para que a ligação não pare quando um token expirar.

Do lado da Shopware, em Definições, Sistema, Integrações, crias uma integração com permissões de escrita em produtos. Depois, forneces ao Photopilot a access key e a secret key. Um acesso de administrador pode servir como alternativa, mas deixa de funcionar quando a palavra-passe é alterada ou quando há 2FA.

O essencial está nos teus próprios dados: o ficheiro de artigos deve conter o EAN por variante de tamanho, e os números de produto devem corresponder aos que estão no Shopware. Sem estas duas chaves, não é possível criar uma ligação fiável.

• Nome de utilizador e palavra-passe da Stockbase
• Integração Shopware com access key, secret key e permissões de escrita em produtos
• Ficheiro de artigos com EAN por variante de tamanho, normalmente do teu sistema de caixa ou ERP
• Números de produto existentes no Shopware

Etapa 1: recolher imagens e fazer a correspondência por EAN

O Photopilot consulta a Stockbase a cada hora para saber que imagens estão disponíveis. Cada imagem é pesquisada pelo EAN no teu ficheiro de artigos, até ao código de barras da variante de tamanho. Assim, fica logo claro a que artigo e a que cor a imagem pertence, mesmo que os teus números de artigo tenham uma estrutura diferente da do fornecedor.

O Photopilot reconhece as imagens que já foram recebidas pela EAN e pelo endereço da imagem, e ignora-as. Se vários tamanhos do mesmo artigo tiverem a mesma imagem, esta é associada ao artigo apenas uma vez, em vez de uma vez por tamanho.

Se um EAN ainda não estiver no teu sortido, ou se o artigo não estiver ativo, a imagem ainda não é importada. Assim que o artigo existir, a ronda horária seguinte recolhe a imagem. Assim, ninguém tem de mudar nomes de ficheiros nem ordená-los.

Passo 2: identidade visual e slots de imagem

As imagens da Stockbase variam muito por fornecedor: uns entregam em branco, outros em cinzento, com margens pequenas ou, pelo contrário, grandes. O Photopilot converte-as para as tuas próprias regras de imagem: fundo, modelo de enquadramento por grupo de artigos, sombra, correção de cor e proporção. Estas edições padrão estão incluídas no plano mensal, a partir de 500 € por mês.

Cada imagem recebe um slot de imagem, como vista frontal, vista traseira ou detalhe. O slot de imagem 1 torna-se depois a imagem principal no Shopware. Se o mesmo artigo também vier da Fashion Cloud ou do teu próprio estúdio, as tuas regras por slot determinam que versão prevalece; as outras continuam visíveis como alternativas.

Se existir apenas um packshot plano, é possível transformá-lo numa imagem com manequim invisível ou numa foto com modelo IA. As fotos de IA custam 0,05 € – 0,21 € por foto na fila e ficam muitas vezes prontas no prazo de uma hora. Por marca ou grupo de artigos, escolhes se as imagens seguem automaticamente ou se vão primeiro para revisão.

Passo 3: imagens na galeria de produto do Shopware

Após a aprovação, o Photopilot coloca a imagem como media do produto através da Admin-API. O produto é encontrado pelo número de artigo; se, num produto com variantes, as imagens estiverem associadas ao produto principal, o Photopilot recorre ao EAN. O slot de imagem 1 passa para a posição 1 e torna-se a imagem principal; os restantes slots seguem a tua ordem.

O Photopilot marca os media que coloca. Por isso, uma nova versão do mesmo slot substitui a imagem anterior do Photopilot, e as imagens que colocaste manualmente no Shopware mantêm-se. Se preferires trabalhar com a tua própria importação de imagens, o Photopilot entrega os ficheiros com nomes fixos via FTP ou Azure.

Se o produto ainda não estiver no Shopware, por exemplo porque a importação do ERP chega mais tarde, o Photopilot tenta novamente mais tarde. Assim que o produto aparecer, o push avança.

Passo 4: acrescentar textos e propriedades

Uma imagem, por si só, não cria uma boa página de produto (PDP). Com base na imagem e nos dados do artigo, o Photopilot escreve, por idioma, uma descrição, um título SEO (metaTitle) e uma metadescrição (metaDescription) e, após aprovação, coloca-os nas traduções do produto em poucos minutos. O Photopilot só substitui o título do produto se essa opção for escolhida.

O Photopilot obtém o material e as instruções de lavagem a partir da etiqueta de lavagem (care label) ou dos teus próprios dados mestre e coloca-os no produto como propriedades Shopware Material e Instruções de lavagem, também como filtro se quiseres. A cor e o tamanho não são alterados.

O Photopilot lê automaticamente os idiomas e canais de venda a partir do Shopware e atualiza-os a cada seis horas. Assim, é possível ver por idioma que artigos já têm texto e quais ainda não têm.

Revisão e publicação

Por vezes, o Shopware responde sem mensagem de erro, mesmo quando um campo não foi guardado. Por isso, o Photopilot verifica de duas em duas horas o que está realmente na loja. Os registos de push por artigo mostram o que foi enviado, o que já estava correto e o que foi ignorado, com um botão para tentar novamente.

A publicação na tua loja online ativa-se nas definições de conteúdo, apenas quando estiveres satisfeito com os primeiros resultados. Até lá, o Photopilot só lê dados e podes ver com calma o que está pronto.

Dica: começa com um fornecedor em revisão, acompanha os logs de push durante uma semana e depois passa os fornecedores, um a um, para piloto automático.

Quando esta ligação não é o caminho mais inteligente

Se só usares imagens do Stockbase para alguns artigos por estação e a apresentação do fornecedor for suficiente, fica mais barato descarregar e carregar manualmente no Shopware. Perdes o recorte próprio, o controlo por fornecedor e os textos, mas, para volumes pequenos, isso pode compensar.

Mesmo que a tua base de artigos não tenha um EAN fiável por tamanho, compensa organizar primeiro os dados principais. Qualquer associação de imagens, seja com Stockbase ou com Fashion Cloud, depende desse código de barras.