Integrar o Brandfolder com o SAP Commerce Cloud é ligar o DAM, onde as equipas aprovam imagens, vídeos e documentos, ao catálogo que o SAP Commerce publica nos sites. Não encontrámos um conector oficial da Brandfolder para esta plataforma, pelo que a ligação se constrói com a API da Brandfolder, os mecanismos de importação e as interfaces REST do SAP Commerce, normalmente com um serviço intermédio.
Em projetos empresariais, o problema raramente é técnico em si. É organizacional: quem aprova, quem associa o ficheiro ao produto, quem responde quando a imagem errada aparece num site de um país. Na Avafa tratamos este tema na nossa área de integração de DAM com ecommerce, e este guia reúne o que convém decidir antes de contratar ou desenvolver.
Encontra aqui o que as fontes oficiais permitem confirmar, uma matriz de responsabilidades, os passos de um projeto, os riscos mais frequentes e uma lista de verificação final.
Existe um conector da Brandfolder para o SAP Commerce Cloud?
Não consta da página de integrações da Brandfolder, consultada em outubro de 2026. O único conector de comércio ali listado é o do Shopify, e a empresa aponta para a sua API pública e para plataformas como o Zapier e o Tray.ai para ligações próprias.
Num ambiente SAP, a opção do Zapier raramente chega, porque há volumes, vários sites e regras de catálogo. O mais comum é um serviço dedicado ou uma plataforma de integração empresarial, com monitorização e ambientes de teste.
Como a Brandfolder organiza e expõe os ativos
A API v4 da Brandfolder usa autenticação por token e uma hierarquia clara: organização, Brandfolder, secção e coleção, ativo e anexo. Segundo a documentação oficial, a secção determina que tipos de ativos digitais podem ser carregados, e a coleção agrupa ativos para organização, partilha e restrição de acesso.
Para um grupo com várias marcas ou países, isto sugere um desenho: um Brandfolder por marca ou unidade, secções por tipo de ativo e coleções por mercado. A listagem de ativos aceita filtrar por Brandfolder, secção, coleção ou etiqueta, e pode incluir os anexos na mesma chamada.
Os campos personalizados são pares chave-valor de texto ligados a um ativo. Servem para guardar o código de produto, o catálogo de destino, a validade e o mercado. Segundo a mesma documentação, apagar uma chave apaga todos os valores associados, o que justifica restringir quem pode alterar o modelo de campos.
O lado do SAP Commerce Cloud
No SAP Commerce, as imagens são objetos de media associados ao produto, e a organização por contentores e formatos define o que a loja apresenta em cada contexto. A importação em massa faz-se habitualmente com ImpEx, e a exposição a aplicações externas pode passar pelas interfaces REST do Omni Commerce Connect.
Estes pormenores dependem da versão, da implementação e dos acordos do projeto. Antes de desenhar a integração, a equipa técnica deve confirmar na ajuda do SAP Commerce Cloud como estão configurados os formatos de media, as versões de catálogo e os utilizadores de integração no seu ambiente.
Uma decisão estrutural é se a loja guarda cópia do ficheiro ou apenas o referencia. Copiar dá controlo e desempenho previsíveis, mas duplica armazenamento e exige limpeza. Referenciar poupa espaço, mas liga a loja à disponibilidade do DAM.
Quando compensa investir numa integração destas
Compensa quando o número de produtos, sites e equipas torna o carregamento manual um custo recorrente e uma fonte de erros. Nesse cenário, cada hora poupada em cópias e correções repete-se todas as semanas, e o controlo de versões deixa de depender da memória de quem trabalha no catálogo.
Não compensa, por agora, se o DAM ainda não tem regras: sem códigos de produto, estados de aprovação e responsáveis definidos, automatizar apenas acelera a propagação dos erros. Nesse caso, o primeiro projeto é organizar o Brandfolder.
Matriz de responsabilidades
Num grupo grande, escrever quem faz o quê vale tanto como o desenho técnico.
| Tarefa | Responsável | Sistema |
|---|---|---|
| Carregar e aprovar ativo | Marca ou produto | Brandfolder |
| Preencher código de produto | Gestão de catálogo | Brandfolder |
| Definir formatos de imagem | Equipa técnica | SAP Commerce |
| Gerir o serviço de ligação | TI ou parceiro | Intermédio |
| Resolver erros de carga | Operações | Todos |
Cada linha deve ter uma pessoa e uma suplente. Quando a responsabilidade é de um departamento inteiro, os erros ficam sem dono.
Fluxo recomendado
O fluxo mais robusto separa o aviso da carga. O webhook avisa, o serviço consulta e só depois a loja é atualizada.
- A equipa aprova o ativo no Brandfolder e preenche os campos obrigatórios.
- A Brandfolder envia um aviso de criação ou atualização para o serviço.
- O serviço consulta o ativo e os seus anexos pela API.
- O serviço valida o código de produto, o mercado e o estado de aprovação.
- O serviço envia o ficheiro e os dados para o SAP Commerce, pela via acordada.
- O resultado é registado, com o identificador do ativo e do produto.
Segundo a documentação, o aviso da Brandfolder é leve: traz o identificador do ativo e o tipo de evento, não os dados. Cada subscrição é específica de um Brandfolder, o que obriga a criar uma por marca ou unidade.
Riscos mais frequentes
Os riscos de projeto empresarial repetem-se e convém tratá-los desde o início.
- Avisos perdidos ou repetidos: a Brandfolder tenta de novo até 15 vezes se o endereço não responder com 2xx, e as mensagens podem chegar fora de ordem.
- Subscrição desativada: acontece em cerca de 30 minutos se a chave perder acesso ao recurso.
- Campos mal preenchidos: um código de produto errado coloca a imagem no artigo errado.
- Vários sites: a mesma imagem pode ser válida num país e não noutro.
- Ambientes: testar só em produção é o erro mais caro de todos.
O endereço de retorno tem de ser público, segundo a documentação, e não pode ficar atrás de autenticação. Planeie a segurança com o apoio da equipa de infraestrutura.
Passos de um projeto bem conduzido
- Fazer um inventário dos ativos, dos Brandfolders e dos catálogos do SAP envolvidos.
- Definir o modelo de campos personalizados e quem o mantém.
- Escolher a via técnica de carga e documentá-la.
- Criar utilizadores técnicos nos dois sistemas com permissões mínimas.
- Montar um ambiente de teste com um conjunto reduzido de produtos.
- Medir erros e tempos, e só depois alargar por marca ou país.
- Entregar documentação e formar quem vai operar a ligação.
Lista de verificação antes de ir para produção
- Existe uma matriz de responsabilidades com nome e suplente.
- O modelo de campos está fechado e protegido contra alterações.
- Há uma subscrição de webhook por Brandfolder, e está documentada.
- O serviço responde de imediato e processa por fila.
- A mesma mensagem recebida duas vezes não duplica media.
- A regra para ativos retirados ou expirados está escrita.
- Os formatos de imagem foram validados na versão do SAP em uso.
- O piloto correu em ambiente de teste com variantes e vários mercados.
- Há monitorização, alertas e um plano de reposição.
Como trabalhamos na Avafa
Começamos por mapear ativos, campos e responsáveis, e só depois escolhemos a via técnica. Revemos o desenho com a equipa que vai operar a ligação, para que o projeto não dependa de uma única pessoa. Se quiser ver como abordamos estes casos, comece pela página de integração de DAM com ecommerce.
Guias relacionados do mesmo cluster
Estes guias analisam outros DAM com o mesmo tipo de plataforma:
- Widen com SAP Commerce Cloud
- OpenText DAM com SAP Commerce Cloud
- Canto com SAP Commerce Cloud
- Brandfolder com Salesforce Commerce Cloud
- Brandfolder com BigCommerce
Perguntas frequentes
A Brandfolder tem conector oficial para o SAP Commerce Cloud?
Não consta da página oficial de integrações da Brandfolder, que lista apenas o Shopify como conector de comércio. A ligação faz-se por API e desenvolvimento.
Como se associa cada imagem ao produto certo?
Através de um campo personalizado do ativo com o código de produto. A documentação indica que são pares chave-valor de texto ligados a um único ativo.
Um webhook por marca ou um único para todas?
A documentação diz que cada subscrição é específica de um Brandfolder. Se tem vários, terá várias subscrições, que podem apontar para o mesmo serviço.
O que acontece se o serviço estiver em baixo?
A Brandfolder repete o envio até 15 vezes, com esperas crescentes. Se a falha persistir, a subscrição pode ser desativada, por isso é preciso monitorizar.
Devo copiar os ficheiros para o SAP Commerce?
Depende de desempenho, armazenamento e dependência do DAM. Decida com a equipa técnica e registe a decisão.