Arquivos de dados CSV

O formato de arquivo CSV (valores separados por vírgula) é usado como a base das operações de transferência de dados e é compatível com todos os aplicativos de planilha e banco de dados. Os seguintes tipos de arquivos são suportados para importação e exportação:

Os arquivos CSV têm uma estrutura específica que deve corresponder ao banco de dados. Cada cabeçalho de coluna corresponde ao Código de atributo do campo representado pela coluna. Para garantir que os títulos das colunas possam ser lidos pelo Commerce, primeiro exporte os dados do seu armazenamento como um arquivo CSV. Em seguida, você pode editar os dados e importá-los novamente para o Commerce.

Se você abrir um arquivo CSV exportado em um editor de texto, verá que os valores são separados por vírgulas e vários valores são colocados entre aspas duplas. Durante a importação, é possível especificar um caractere separador personalizado, embora o padrão seja uma vírgula.

Estrutura do CSV de produtos

Uma exportação completa do banco de dados de produtos contém informações sobre cada produto no catálogo e os relacionamentos entre eles. Cada registro tem uma seleção fixa de colunas que correspondem aos atributos no catálogo, embora a ordem dos atributos seja ignorada durante o processo de importação.

A primeira linha da tabela contém os nomes de cada atributo, que são usados como cabeçalhos de coluna. As linhas restantes descrevem os registros de produtos individuais. Qualquer linha que comece com um valor na coluna SKU é o início de um novo registro de produto. Um único produto pode incluir várias linhas que contêm informações sobre várias imagens ou opções de produto. A próxima linha que tiver um valor na coluna SKU inicia um novo produto.

A coluna de categoria contém um caminho para cada categoria à qual o produto está atribuído. O caminho inclui a categoria raiz, seguida por uma barra (/) entre cada nível. Por padrão, a vírgula , caractere é usada para separar caminhos de categorias diferentes. (Você pode especificar um caractere separador diferente com a opção Multiple value separator.) Por exemplo:

Default Category/Gear,Default Category/Gear/Bags

Para importar dados, você precisa incluir apenas o SKU e quaisquer colunas com alterações. Quaisquer colunas em branco são ignoradas durante o processo de importação. Não é possível adicionar atributos durante o processo de importação. É possível incluir apenas atributos existentes.

Para obter uma descrição detalhada de cada atributo de produto, consulte Estrutura do arquivo CSV de produtos.

Estrutura CSV do cliente

O arquivo CSV de clientes contém informações do cliente do banco de dados e tem a seguinte estrutura:

A primeira linha da tabela contém os nomes das colunas de atributo (que são iguais aos códigos de atributo). Há dois tipos de nomes de coluna, conforme mostrado na tabela a seguir. Outras linhas contêm valores de atributo, dados de serviço e dados complexos. Cada linha com valores não vazios nas colunas email e _website inicia a descrição do cliente subsequente. Cada linha pode representar dados do cliente com ou sem dados de endereço ou somente os dados de endereço. Se uma linha contiver apenas os dados de endereço, os valores nas colunas, relacionados ao perfil do cliente, serão ignorados e poderão estar vazios.

Para adicionar ou substituir mais de um endereço para um cliente, adicione uma linha para cada novo endereço com dados vazios do cliente e os dados novos ou atualizados do endereço abaixo da linha de dados do cliente.

Para obter uma descrição detalhada de cada atributo do cliente, consulte Estrutura do arquivo CSV do cliente.