Como importar/exportar produtos no carrinho de compras

Melhores Práticas > Passo 1 - Configurações > A aba Avançado > O carrinho de compras da loja virtual >

Como importar/exportar produtos no carrinho de compras

Previous pageReturn to chapter overviewNext page

Depois de criar um carrinho de compras para sua loja virtual, pode ser útil exportar o catálogo de produtos para usar em outro projeto, ou outro software, como por exemplo seu programa de contabilidade. Também é igualmente importante poder importar um catálogo de produtos para não ter que recriar tudo desde o início.

No WebSite X5 você pode importar/exportar catálogos de produtos usando a barra de ferramentas na janela Carrinho de compras | Lista Produtos. Quando exportar um catálogo de produtos, um arquivo no formato .TXT ou .CSV é gerado, que pode ser facilmente aberto e editado por qualquer editor de textos (por exemplo o Bloco de notas do Windows) ou pelo Microsoft Excel.

Siga as indicações abaixo se for editar manualmente o arquivo do catálogo de produtos exportado, ou se for criar um novo para importar:

A primeira linha deverá conter os títulos dos campos (colunas) com os seguintes termos:

ID;Category;Name/Code;Description;Price;Enable VAT;VAT Value;Weight;Options;Enable Discounts;Discounts

que em português equivalem a "Identidade, Categoria, Nome/Código, Descrição, Preço, Habilitar ICMS, Valor do ICMS, Peso, Opções, Habilitar Descontos,  Descontos".

Se você remover um campo entre os títulos, você removerá os dados correspondentes para todos os produtos. Os campos obrigatórios (Category, Name/Code, Description e Price) não podem ser removidos.
Cada linha depois do título corresponderá a um produto.
Todos os parâmetros deverão ser separados pelo caractere ";".
As seguintes informações deverão ser fornecidas para cada produto: Nome da categoria, Nome do produto (ou código), Descrição do produto, Preço do produto. Todos os outros campos são opcionais e podem ser omitidos (basta não escrever nada entre os caracteres ";" que separam os campos em questão).
A Identidade (ID) do produto é um número gerado pelo Programa: se você inserir um novo produto, deixe o campo do ID vazio.
Qualquer espaço no arquivo será removido durante a importação.

Os parâmetros em um arquivo .TXT ou .CSV são:

Parâmetro: ID

Obrigatório

Não

Descrição

O identificador único para cada produto.

Valor

É gerado e associado a um único produto automaticamente pelo Programa.

Se você atualizar o arquivo .TXT ou .CSV de uma exportação anterior, não edite os IDs já existentes, e deixe o campo vazio para os novos produtos. Quando um catálogo é importado, o Programa verifica se há duplicidade de IDs e gera os que forem necessários.

Parâmetro: Category

Obrigatório

Sim

Descrição

A categoria do produto.

Valor

Use o caractere ">" para indicar o caminho relativo das categorias e sub-categorias.

Por exemplo, uma camiseta na sub-categoria "Casual" da categoria "Vestuário Masculino" seria indicada no arquivo .TXT ou .CSV como:

... ; Vestuário Masculino > Casual ; ...

Você pode adicionar todas as sub-categorias necessárias desta forma.

Parâmetro: Name/Code

Obrigatório

Sim

Descrição

O nome ou o código do produto.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Nome/Código na janela Configurações do Produto | Geral.

Parâmetro: Description

Obrigatório

Sim

Descrição

A descrição do produto.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Descrição na janela Configurações do Produto | Geral.

Parâmetro: Price

Obrigatório

Sim

Descrição

O preço do produto.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Preço na janela Configurações do Produto | Geral.

Parâmetro: Enable VAT

Obrigatório

Não

Descrição

Indica um valor específico de imposto para este produto.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir da opção ICMS (%) na janela Configurações do Produto | Geral. Esta opção só fica disponível se o Tipo "ICMS incluído" tiver sido selecionado em Configurações do ICMS em Carrinho de compras | Disponibilidade. É usado associado a um valor específico de ICMS para um produto, que seja diferente do valor do imposto para os outros produtos no catálogo. Nestes casos os preços são fornecidos sem o ICMS.

Este parâmetro pode ter um valor de 0, se a opção ICMS (%) não tiver sido selecionada, ou 1 se tiver sido.

Parâmetro: VAT Value

Obrigatório

Não

Descrição

A taxa a ser aplicada ao preço de um produto com um imposto específico

Valor

Quando o catálogo é exportado em um arquivo .TXT ou .CSV, este parâmetro é obtido a partir da opção ICMS (%) na janela Configurações do Produto | Geral que só fica disponível se, na Carrinho de compras | Disponibilidade o Tipo "ICMS incluído" tiver sido selecionada para as Configurações do ICMS.

Se a opção ICMS (%) na janela Configurações do Produto | Geral estiver selecionada mas nenhum valor for fornecido, o Valor padrão (%) indicado em Configurações do Produto | Disponibilidade é que será usado.

Parâmetro: Weight

Obrigatório

Não

Descrição

O peso do produto.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Peso na janela Configurações do Produto | Geral.

Parâmetro: Options

Obrigatório

Não

Descrição

Uma lista de variações possíveis do produto.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Lista de Opções Principais na janela Configurações do Produto | Opções.

Se você estiver criando um arquivo .TXT ou .CSV para importar, as variações do produto na lista podem ser separados pelo caractere "|", desta forma:

... ; Variação1 |Variação2 | Variação3 ; ....

Todas as variações necessárias podem ser adicionadas desta forma.

Parâmetro: Enable Discounts

Obrigatório

Não

Descrição

Indicador de desconto para quantidades.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Habilitar desconto por quantidade na janela Configurações do Produto | Desconto.

Este parâmetro pode ter um valor de 1 ou 0, dependendo se a opção Habilitar desconto por quantidade tiver sido selecionada ou não.

Parâmetro: Discounts

Obrigatório

Não

Descrição

A lista de descontos possíveis para compra em quantidade.

Valor

Quando o catálogo é exportado para um arquivo .TXT ou .CSV, este parâmetro é obtido a partir do campo Habilitar desconto por quantidade na janela Configurações do Produto | Desconto.

Se você estiver criando um arquivo .TXT ou .CSV para importar, a lista dos descontos para compras em quantidade deverão ser inseridas da seguinte forma:

... ; quantidade : desconto | quantidade : desconto ; ...

Portanto, se um desconto de 10% for aplicado a compras de mais de 20 artigos, e um desconto de 15% for aplicado a compras de mais de 50 artiogs, você deverá inserir assim:

... ; 20 : 10 | 50 : 15 ; ...

Use o caractere "|" para adicionar todos os descontos por quantidade necessários.

Quando importar um arquivo .TXT ou .CSV gerado por uma operação de exportação anterior ou que você mesmo tenha escrito, ele provavelmente será atualizado pelo Programa, para adicionar as IDs que faltarem, por exemplo. Se quiser uma cópia atualizada do arquivo .TXT ou .CSV, você terá que re-exportar o catálogo de produtos.

 


Melhores práticas:

-

Como redigir emails de notificação