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: