Importar seu catálogo

Como enviar seus produtos, quais colunas o Bruxel reconhece e o que acontece com o que já estava carregado.

Este tutorial tem vídeo em outros idiomas: em espanhol · em inglês

Formatos e tamanho

São aceitos dois formatos, e o arquivo é validado pelo conteúdo, não só pela extensão:

CSV em UTF-8.
Excel (.xlsx).
CSV até 256 MB e XLSX até 10 MB, com até 50.000 linhas e 512 colunas.

Colunas

Você não precisa renomear nada: o Bruxel reconhece vários nomes para cada coluna principal.

Coluna	Nomes que reconhece	Obrigatória?
SKU	sku, upc, ean, gtin, codigo, id, product_id, id_producto	Sim
Nome	name, nombre, title, titulo, product_name, name_mejorado, nombre_mejorado, nombre_original	Sim
Marca	brand, marca	Não
Categoria	category, categoria, categories, categoria_especifica, subcategoria, departamento	Não

As demais colunas do seu arquivo não se perdem. Antes de escrever qualquer coisa, a simulação lista uma por uma e você marca quais guardar: as marcadas viram dados de origem e alimentam a geração; as outras ficam no seu arquivo.

E se o seu arquivo trouxer duas colunas que servem

Um catálogo enriquecido costuma trazer o dado duas vezes: o nome cru do ERP e um já redigido, ou o departamento e a categoria fina. A Bruxel escolhe uma só, e sempre a mesma:

Nome: ganha o enriquecido. Se o arquivo tiver name_mejorado e nombre_original, usa-se o primeiro — costuma ser mais limpo, porque o cru costuma enfiar a descrição dentro do nome.
Categoria: ganha a mais específica. Entre categoria_especifica (“martelete”) e departamento (“Ferramentas e Ferragens”), usa-se a específica: descreve o produto, não o corredor.

A coluna que não ganha NÃO se perde: fica como dado de origem e pode virar um atributo filtrável. E você não precisa adivinhar: a simulação mostra qual coluna alimentou cada campo antes de escrever nada.

Como entram os seus atributos

Os atributos filtráveis — cor, tamanho, material — entram com o próprio import, não por outra tela. O lugar onde isso se decide é «Revisar antes de importar»: ali, em «Quais colunas guardar», a Bruxel lista cada coluna do seu arquivo e diz o que faria com ela. Podem acontecer três coisas:

A coluna coincide com um atributo que você já tem: ela se preenche sozinha e de graça. Não gasta créditos nem usa IA — é o seu próprio dado, já vinha no arquivo.
A coluna ainda não existe como atributo: se você deixar marcada, ela é criada com os seus valores durante este mesmo import e já dá para filtrar. E se as células trazem vários valores de uma vez (“Livre de Crueldade,Vegano”), ele é criado como seleção múltipla: cada produto fica com seus valores separados, não com a combinação colada.
A coluna não serve como atributo, e ele diz por quê: «texto longo», «um valor diferente por produto», «um único valor», «vazia» ou «quase vazia». Uma coluna com um valor diferente por produto não vira atributo mesmo que você marque — como filtro não serviria de nada.

Preencher um atributo a partir do seu arquivo NUNCA sobrescreve o que já estava. Se alguém da sua equipe corrigiu um valor à mão, um import posterior respeita e só preenche as lacunas. Por isso você pode reimportar o mesmo arquivo quantas vezes precisar.

Um atributo é criado com no máximo 500 valores, os mais frequentes do seu arquivo. Se uma coluna tiver mais, os produtos com valor incomum ficam sem esse atributo. A simulação avisa antes: diz quantos valores a coluna tem e quantos serão criados.

O que você não marcar não se perde: fica guardado como dado de origem e continua alimentando a geração das descrições. Só não dá para filtrar por ele na sua loja.

O que acontece com o que já existia

O SKU é a chave. Importar o mesmo arquivo duas vezes não duplica nada:

SKU novo: o produto é criado.
SKU que já existe: nome, marca, categoria e dados de origem são atualizados.
SKU que você havia excluído: o produto volta a aparecer.

A atualização SUBSTITUI os dados de origem do produto pelos do arquivo novo. Se o seu segundo arquivo tiver menos colunas, as que faltam são perdidas.

O percurso de uma carga

No histórico de importações, “Ver o percurso” mostra as etapas de cada carga: Importado, Ficha gerada, Controle de qualidade, Publicado, Entregue e Na loja. Cada etapa traz a data, “Em andamento” (alguns produtos já chegaram), “Pendente” ou “Sem dado”, com o motivo.

Contam os produtos que a carga mudou e o que aconteceu depois dela: uma ficha que já existia antes não conta como gerada por esta carga. Com vários idiomas configurados, um produto conta quando está em todos.

Se você enviar o mesmo arquivo duas vezes, a segunda carga diz que nenhum produto mudou: não há fichas para acompanhar. As cargas anteriores a 12 de setembro de 2026 dizem “Sem dado”: o Bruxel ainda não guardava o histórico de alterações.

“Entregue” só se sabe se um sistema ouve os avisos de fichas (webhooks), e durante 30 dias. “Na loja” sempre diz “Sem dado”: a Bruxel não sabe quando a sua loja publica cada produto.

Variantes no mesmo arquivo

Se você vende tamanhos ou cores, acrescente uma coluna parent_sku com o SKU do produto pai. O Bruxel monta o vínculo na importação, e você pode trazer pais e filhas no mesmo arquivo.