Você pode criar muitos Modelos de Produto (SKUs) de uma vez fazendo upload de um arquivo CSV (valores separados por vírgula), em vez de adicioná-los um a um. Um Modelo de Produto é a definição de catálogo de um produto. O upload em massa valida o arquivo inteiro primeiro e depois cria todos os modelos de uma só vez.
Para informações sobre o tipo de produto em si, consulte O que é um Modelo de Produto?
Baixar o CSV de exemplo
A maneira mais fácil de preparar seu arquivo é começar com o CSV de exemplo de Modelo de Produto. Ele tem exatamente os cabeçalhos de coluna que o upload espera, junto com uma linha de exemplo mínima e uma linha de exemplo totalmente preenchida. Mantenha a linha de cabeçalho, substitua as linhas de exemplo pelas suas próprias e salve o arquivo como .csv.
Iniciar um upload em massa
Para fazer upload em massa de Modelos de Produto com um arquivo CSV:
Acesse Ecosystem Registries > Product Templates.
Abra o menu de três pontos no topo da lista e escolha Bulk Upload via CSV.
Selecione seu arquivo .csv preparado e inicie o upload.
Requisitos do arquivo
Seu arquivo deve atender a estes requisitos antes de ser aceito:
Requisito | Detalhe |
Tipo de arquivo | Um arquivo .csv. |
Tamanho do arquivo | Menor que 20 MB. |
Separador decimal | Números usam "." (ponto), por exemplo 12.5. |
Datas do produto | Use o formato dd/MM/yyyy, por exemplo 31/12/2026. Uma data de término não pode ser anterior à data de início. |
O que as colunas cobrem
O CSV tem um conjunto amplo de colunas. Elas se dividem nos seguintes grupos (o CSV de exemplo acima mostra os nomes exatos dos cabeçalhos):
Grupo de colunas | O que contém |
Identity and description | ID, Name, Brand, Brand Owner, Manufacturer, Visibility, Country of Origin e descrições. |
Classification | GPC (a Classificação Global de Produtos GS1) e Uniclass, cada um com um código e um título, para segmento, família, classe e tijolo. |
Dimensions, weights and volume | Atributos físicos, cada um associado à sua própria unidade. |
Packaging and storage | Temperaturas de armazenamento e tipo de embalagem. |
Warranty and product dates | Detalhes de garantia e intervalos de datas. |
Metadata | Colunas de formato livre chamadas Metadata.<Type>.<Field> para seus próprios dados adicionais. |
Campos obrigatórios
Cada linha deve incluir os seguintes campos, caso contrário o upload é rejeitado:
Campo obrigatório | Notas |
ID | Deve ser único e não pode já existir no seu Product Template Registry. |
Name | O nome do Modelo de Produto. |
Brand Owner | Tanto o ID quanto o tipo. |
Visibility | Público ou privado. |
Country of Origin | Um país válido. |
GS1 segment and family titles | O segmento e a família GS1 de nível superior. |
Regras de validação
O sistema verifica cada linha em relação a estas regras antes de criar qualquer coisa:
ID único: o ID não pode coincidir com um modelo já existente.
Emparelhamento de medida e unidade: se você fornecer uma medida, deve fornecer a unidade correspondente, e vice-versa. A unidade deve ser válida para esse tipo de medida, e os valores numéricos devem ser positivos.
Dados de referência: países, classificações GS1 e Uniclass, tipos de embalagem, e as Organizações de Brand Owner e Manufacturer são verificados em relação aos dados de referência existentes.
Datas: as datas do produto usam dd/MM/yyyy, e uma data de término não pode ser anterior à data de início.
O que acontece após o upload
O upload é tudo ou nada na etapa de validação: cada linha é validada primeiro e, se qualquer linha falhar, o upload inteiro é rejeitado e você recebe uma lista de erros por linha. Nada é criado até que o arquivo seja válido. Quando o arquivo passa na validação, os Modelos de Produto são criados imediatamente. Eles não ficam na fila em segundo plano nem são criados como rascunhos; eles aparecem na sua lista de Product Templates imediatamente.
Nota: Se um ID duplicado passar pela verificação, ele é silenciosamente ignorado em vez de criar um segundo modelo, embora na prática a verificação de "ID já existe" normalmente o detecte primeiro.