Feeds de produto: como enviar seu catálogo para cada canal sem refazê-lo

O que é um feed

Um feed é a forma como o seu catálogo chega a outro sistema. Pode ser um arquivo CSV que você sobe em um marketplace, um arquivo que um canal lê de tempos em tempos ou uma conexão por API que envia as alterações assim que elas acontecem. Em todos os casos, o destino define as regras:

• quais colunas ele quer e com que nome;
• em que ordem e com qual separador;
• quais valores aceita em cada coluna, por exemplo categorias da própria árvore ou unidades específicas;
• o que é obrigatório para publicar um produto.

O Google Merchant Center, por exemplo, publica uma especificação dos dados do produto com os atributos que exige, os que recomenda e os que só se aplicam a certos produtos ou países.

Um feed por canal, uma única ficha

O erro clássico é manter uma planilha por canal. No começo parece prático; poucos meses depois, cada planilha diz uma coisa diferente e ninguém sabe qual é a certa.

A alternativa é ter uma única ficha por produto e montar um feed por canal a partir dela. O feed decide quais colunas saem, com que nome e em que formato, mas os dados são os mesmos. Se você muda a descrição, ela muda em todos os feeds.

O que costuma falhar

1. Células vazias que apagam. Em alguns destinos, uma coluna vazia não significa «sem alterações», e sim «apagar o valor». Enviar um feed incompleto pode apagar dados que o canal já tinha.
2. Separadores de valores múltiplos. Se um atributo tem vários valores e o destino espera um separador diferente do que você usa, o canal lê um único valor estranho.
3. Codificação. Um CSV que não está em UTF-8 transforma os acentos e o «ç» em símbolos.
4. Categorias que não existem no destino. Cada canal tem a sua árvore; enviar a sua do jeito que está costuma terminar em rejeição.
5. Identificadores inconsistentes. O SKU ou o GTIN mudam entre uma carga e outra e o canal cria produtos duplicados.

Antes de enviar: quantos sairão completos

Antes de gerar um feed, vale a pena saber quantos produtos sairão completos com as colunas que esse canal pede e quantos têm alguma lacuna. Com essa contagem você decide se envia tudo, se deixa de fora o que está incompleto ou se primeiro completa o que falta.

Arquivo ou conexão

Um arquivo é simples e funciona com quase qualquer destino, mas depende de alguém gerá-lo e subi-lo. Uma conexão — um módulo na loja ou uma API — envia as alterações sem intervenção, mas precisa ser configurada uma vez. Muitos catálogos usam as duas: conexão com a loja própria e arquivos para os marketplaces.

Atualizar sem quebrar

O primeiro feed é fácil; o difícil é mantê-lo em dia. Algumas regras ajudam:

• Altere na ficha, nunca no arquivo. Se você corrige um dado no arquivo, a próxima exportação o coloca errado de novo.
• Não mude os identificadores. O SKU e o identificador de grupo das variantes devem ser os mesmos em cada carga.
• Revise o relatório de erros de cada carga. É a lista mais precisa do que o canal não aceitou.
• Avise quando as colunas mudarem. Se um canal acrescenta um campo obrigatório, ajuste o feed dele antes da próxima carga.

Como o Bruxel resolve isso

No Bruxel, cada canal define as suas colunas, a sua ordem, o separador de valores múltiplos e o idioma, e você pode começar a partir de um modelo. Antes de baixar, você vê quantos produtos sairão completos e pode omitir as linhas incompletas para não apagar nada no destino. Exportar não custa créditos. Para a loja própria, o Bruxel se conecta de forma nativa ao Adobe Commerce e tem uma API pública com avisos (webhooks) para qualquer outro sistema. O guia para exportar mostra isso passo a passo, e o de conectar o Adobe Commerce explica o módulo.

Por onde começar

Escolha o canal que mais vende e baixe a especificação de dados dele. Compare-a com o seu catálogo: quais colunas você já tem, quais faltam e quais estão em um formato diferente. Essa comparação é a sua primeira lista de trabalho, e o primeiro feed que vale a pena automatizar.