PhotopilotPhotopilot
Associar

Como ligar Fashion Cloud ao Shopware?

A Fashion Cloud e a Shopware não comunicam diretamente entre si: é necessária uma camada que associe produtos da Fashion Cloud aos teus artigos por EAN, coloque as imagens na ordem certa e no estilo visual correto, e as publique no produto com textos e propriedades através da Shopware Admin-API. Com o Photopilot, isto é feito com um token da Fashion Cloud API e uma chave de integração da Shopware; as novas imagens são recolhidas a cada meia hora.

Atualizado:

Fotografia de estúdio de um modelo com camisola e jeans, pronta para uma página de produto
  • a cada meia hora novas imagens do Fashion Cloud e direitos da marca
  • alguns minutos até os textos aprovados estarem no Shopware
  • a cada 2 horas controlo do que está realmente live

O que é necessário

A Fashion Cloud é uma plataforma onde as marcas disponibilizam imagens e dados de produto aos seus retalhistas. A Shopware é a tua loja online. Não existe um botão padrão que ligue as duas, por isso a integração passa por uma camada intermédia que faz a correspondência, edita e publica.

Do lado da Fashion Cloud, é necessária uma conta de retalhista com um API-token. As próprias marcas decidem se participam, dando-te permissões na Fashion Cloud. Do lado do Shopware, em Definições, Sistema, Integrações, crias uma integração com access key, secret key e permissões de escrita nos produtos.

Além disso, o teu ficheiro de artigos deve conter códigos EAN por variante, normalmente provenientes do sistema de caixa ou do ERP. Sem EAN, há pouca correspondência fiável possível.

  • Conta de retalhista Fashion Cloud com token de API
  • Direitos das marcas que queres utilizar
  • Integração Shopware com access key, secret key e permissões de escrita em produtos
  • Artigos com EAN por variante e números de produto existentes no Shopware

Passo 1: recolher e fazer a correspondência por EAN

O Photopilot verifica a cada meia hora que marcas podes usar e recolhe os produtos dessas marcas com as respetivas imagens. Uma primeira importação grande é feita por partes e, após uma interrupção, continua a partir do ponto onde ficou.

Cada produto do Fashion Cloud é associado, através do EAN (GTIN), a uma variante no teu ficheiro de artigos. A cor desse produto determina a que artigo de cor pertencem as imagens. Se um código de barras passar mais tarde para outro artigo, as imagens acompanham-no.

Se uma marca substituir um shoot na Fashion Cloud, as imagens antigas também desaparecem no teu lado, exceto as imagens que carregaste ou que bloqueaste intencionalmente. Se um produto voltar temporariamente meio vazio da API, isso não é tratado como eliminação.

Pipeline da Fashion Cloud no Photopilot com uma origem ligada, imagens com modelo e imagens de produto
Fashion Cloud como origem, dividida em imagens com modelo e imagens de produto.

Passo 2: posições de imagem, ordem e identidade visual

A Fashion Cloud indica, para cada imagem, como foi criada: num modelo, num modelo sem rosto, num ghost mannequin (hollow), em flat lay ou dobrada, e a partir de que lado. Com essa informação, o Photopilot separa imagens com modelo e imagens de produto, e coloca cada imagem numa posição: vista frontal, vista traseira, detalhe, modelo ou conjunto.

Depois são aplicadas as tuas próprias regras de imagem: modelo de enquadramento por grupo de artigos, fundo, sombra, correção de cor e recorte. Assim, as imagens de marca da Fashion Cloud ficam alinhadas com a tua própria fotografia de produto, em vez de parecerem uma mistura de cinquenta fornecedores.

Por marca ou grupo de artigos, escolhes se as imagens avançam automaticamente ou se aparecem primeiro para revisão. Normalmente, as novas marcas começam em revisão e passam mais tarde para automático.

Imagens de produto de camisas com linhas do modelo de enquadramento para manter as mesmas margens
Cada marca com o mesmo recorte, com a posição de imagem 1 como imagem principal.

Passo 3: imagens no Shopware, pela ordem certa

O Photopilot coloca as imagens no produto como media de produto através da Admin API, ou entrega-as por FTP ao teu processo de importação de imagens existente. O slot de imagem 1 passa a ser a posição 1 na galeria Shopware e, por isso, a imagem principal; os restantes slots seguem a tua ordem.

O Photopilot marca os media que coloca. Assim, uma nova versão do mesmo slot substitui a imagem anterior do Photopilot em vez de acrescentar uma segunda ao lado, e as imagens que colocaste manualmente no Shopware permanecem intactas. Um ficheiro de media partilhado de um produto duplicado não é substituído.

Se um produto ainda não estiver no Shopware, por exemplo porque a importação a partir do teu ERP chega mais tarde, o Photopilot volta a tentar mais tarde. Assim que o produto aparecer, o envio avança.

Passo 4: textos, propriedades e idiomas

Além das imagens, a Fashion Cloud também fornece material e instruções de lavagem. O Photopilot usa estes dados no texto de produto e coloca-os na Shopware como propriedades Material e Instruções de lavagem, na página de produto e, se quiseres, também como filtro. O material é enviado sem percentagem, para que o filtro Algodão encontre todos os artigos com algodão; a cor e o tamanho ficam inalterados.

Por idioma da tua loja, são enviados para o produto a descrição, o título SEO (metaTitle), a metadescrição (metaDescription) e, se aplicável, palavras-chave e campos próprios. O Photopilot só substitui o título do produto se optares por isso, porque muitas vezes esse título já vem do ERP.

O Photopilot lê automaticamente os idiomas e canais de venda a partir do Shopware e atualiza-os a cada seis horas. Ao adicionares um idioma, este aparece automaticamente como opção.

O que passa do Fashion Cloud para o Shopware via Photopilot
Do Fashion CloudNo PhotopilotNo ShopwareTempo
Imagens de produtoCorrespondido por EAN, por slot de imagem, editadoMedia de produto, slot 1 como imagem principalapós aprovação
MaterialComposição por artigoPropriedade Material, filtro opcionala cada quarto de hora
Instruções de lavagemSímbolos de lavagem por artigoPropriedade Instruções de lavagem, filtro opcionala cada quarto de hora
Dados de marca e artigoFonte para texto de produto com IAdescription, metaTitle, metaDescription por idiomaem poucos minutos
Direitos da marcaQue marcas vêsnão aplicávela cada meia hora

Controlo: o que está realmente online?

Por vezes, o Shopware responde sem mensagem de erro, mesmo quando um campo não foi guardado, por exemplo se o nome do campo não existir. Por isso, o Photopilot verifica a cada duas horas o que está realmente na loja e assinala os campos que o Shopware não reconhece.

Os pushlogs por artigo mostram o que foi enviado, o que já existia e o que foi ignorado. A publicação pode ser imediata ou por lote, com nova tentativa manual. O envio de conteúdo para uma loja live está desativado por predefinição: é ativado manualmente nas definições de conteúdo, nunca automaticamente.

Dica: começa com uma marca em modo de controlo, acompanha os pushlogs durante uma semana e depois passa as marcas para automático, uma a uma.

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

Se usas apenas algumas marcas da Fashion Cloud e não adaptas as imagens, descarregar da Fashion Cloud e fazer uma importação simples de imagens para a Shopware pode ser suficiente. Mas perdes o recorte próprio, o controlo por marca e a ligação a textos e filtros.

Mesmo que o teu ficheiro de artigos não tenha códigos EAN fiáveis, vale a pena começar por organizar os dados mestre. Qualquer integração depende dessa chave.

FAQ

Perguntas frequentes

A Fashion Cloud tem uma ligação ao Shopware?

Não existe uma integração padrão que associe, edite e publique imagens juntamente com textos e propriedades. O Photopilot preenche essa lacuna: lê a Fashion Cloud, faz a correspondência por EAN e escreve nos teus produtos através da Shopware Admin-API.

Que chaves são necessárias para ligar Fashion Cloud ao Shopware?

Um API-token da conta de retalhista Fashion Cloud e uma integração Shopware com access key, secret key e permissões de escrita em produtos. Um início de sessão de administrador pode servir como alternativa, mas deixa de funcionar após uma alteração de palavra-passe ou 2FA.

Com que frequência são atualizadas as imagens da Fashion Cloud no Shopware?

O Photopilot recolhe novas imagens e direitos de marca a cada meia hora. Depois da edição e de uma eventual revisão, seguem para Shopware; as propriedades são atualizadas a cada quinze minutos.

Posso definir a ordem das imagens no Shopware?

Sim, através de slots de imagem. O slot 1 passa a ser a imagem principal e os restantes slots seguem a ordem definida por grupo de artigos.

O Photopilot substitui as minhas fotografias de produto existentes no Shopware?

Não. O Photopilot substitui apenas os media que colocou e mantém as imagens que adicionaste manualmente no Shopware.

É possível usar o material da Fashion Cloud como filtro no Shopware?

Sim. O material e a instrução de lavagem tornam-se uma propriedade e, se quiseres, um filtro. O material é enviado sem percentagem, para que o filtro Algodão encontre todos os artigos com algodão.

A integração funciona com vários idiomas no Shopware?

Sim. O Photopilot lê os idiomas e canais de venda do Shopware e escreve a descrição, o título SEO e a meta-descrição por idioma. As propriedades também recebem o respetivo nome por idioma.

E se o produto ainda não estiver no Shopware?

Nesse caso, o Photopilot tenta novamente mais tarde. Assim que o produto aparecer na loja, as imagens e os textos seguem na mesma.

O que acontece se uma marca substituir as suas imagens no Fashion Cloud?

As novas imagens entram e as imagens expiradas são removidas, também na tua loja online. As imagens que carregaste ou que bloqueaste de propósito mantêm-se.