Importar Atualizações de Preços através de um Arquivo CSV

Nota: Esta funcionalidade permite que todos os comerciantes atualizem os atributos gerais de preços (Preço, Comparar com Preço e Custo). No entanto, a criação ou atualização de preços de Listas de Preços e Preços por Volume está disponível apenas para lojas no plano Advanced ou superior.

O arquivo de importação

O arquivo CSV deve estar no formato UTF-8, e todos os caracteres especiais devem ser codificados corretamente. Não é recomendado o uso do Microsoft Office para criar o arquivo; em vez disso, recomendamos usar o Google Sheets ou o LibreOffice.

Para garantir que o seu arquivo tem o formato correto, recomendamos exportar os seus preços a partir da seção Todos os Produtos > Preços. No topo, você verá um botão para exportar um arquivo CSV, que sugerimos usar para ajustar os novos preços dos seus produtos.

Campos

Nome	Descrição e Observações Importantes
Permalink	Identificador único do produto. Obrigatório.
Product Name	Nome do produto. Obrigatório.
Product Option Property	Nome da variante do produto. Obrigatório se o produto tiver variantes.
Price List Name	Nome da Lista de Preços. Deve já existir na loja.
Minimum Quantity	Obrigatório. Deve ser sempre definido como 1 se quiser atualizar o preço normal ou o preço de uma lista de preços específica definida na coluna “Price list name”.
Unit Price	Obrigatório. Representa o preço do produto ou o preço unitário associado a uma determinada quantidade.
Compare at Price	Opcional: Um preço de referência. Mostrará o preço como uma taxa com desconto em comparação com este valor.
Cost per Item	Opcional: Permite estimar o lucro por item.

O processo de importação de novos preços e/ou preços por volume para a sua loja

A importação de novos preços e preços por volume para a sua loja é um processo simples que permite atualizar eficientemente os preços dos produtos. Siga estes passos para garantir uma importação bem-sucedida:

1. Exporte os seus preços atuais

• Vá a Todos os Produtos > Preços no painel de administração da sua loja.

• Clique no botão Exportar para baixar um arquivo com a sua estrutura de preços existente.

• Use este arquivo como modelo para fazer os ajustes de preços necessários.

2. Prepare o seu arquivo CSV

• Certifique-se de que o Permalink corresponde a um produto existente na sua loja.

• Certifique-se de que o Price List Name corresponde a uma lista de preços existente na sua loja.

• Defina a coluna Minimum Quantity como 1 se estiver atualizando o preço normal ou o preço de uma lista de preços específica.

• Insira os novos preços na coluna correspondente, usando valores inteiros ou decimais.

• Para produtos com variantes, inclua a coluna Product Option Property. Se não for encontrada uma variante para o permalink do produto, a validação falhará.

3. Importe o CSV atualizado

• Navegue até a seção Importar no painel de administração da sua loja, em Todos os Produtos > Preços.

• Faça o upload do arquivo CSV modificado.

• O sistema irá validar os dados antes de aplicar as alterações e reportará erros.

• Se o arquivo CSV for válido, você verá um botão para prosseguir com a Importação.

• Você receberá um e-mail assim que o processo tiver terminado.

Algumas notas e validações para garantir uma operação sem problemas

• Recomendamos o uso do nosso arquivo exportado e do Google Sheets para evitar problemas de conversão.

• Uma vez que o nosso sistema realiza uma pré-validação do CSV e do seu conteúdo, arquivos grandes (mais de 1500 linhas) podem demorar algum tempo para validar. Portanto, como já recomendado para importações de produtos, sugerimos que, se o seu arquivo for grande, divida-o em vários arquivos menores com aproximadamente 1000-1500 linhas.

• No final da importação, você receberá um e-mail com o status da operação. Indicará se foi bem-sucedida ou não e, se não foi bem-sucedida, será fornecido o motivo.

• Apenas uma importação pode ser processada por vez. Se tiver uma importação em andamento, não poderá prosseguir com uma segunda importação até que a primeira esteja concluída.

Alguns motivos comuns pelos quais um CSV pode ser inválido

• O Unit Price está ausente, não é um número inteiro ou decimal, ou é negativo.

• O Minimum Quantity está ausente, não é um número inteiro, ou é inferior a 1.

• Se presentes, o Compare at Price e o Cost per Item não são números inteiros ou decimais, ou são negativos.

• Quando o Compare at Price está presente e o Minimum Quantity é 1, deve ser maior que o preço unitário.

• O Price List Name não existe.

• O Permalink não existe.

• O nome do produto associado a um determinado permalink é diferente do valor no campo Product Name no CSV.

• O valor de Product Option Property difere das variantes já disponíveis na loja.

• Em casos com preços por volume (quantidades mínimas > 1), os preços unitários devem diminuir à medida que a quantidade mínima aumenta.

• Os preços unitários para preços por volume devem ser sempre inferiores ao preço normal desse produto (inferiores ao preço da lista de preços quando especificado).

Comportamento de importação de preços e considerações de preços por volume

Por favor, note que o processo de importação apenas cria ou atualiza preços; não é responsável por excluir quaisquer preços existentes, exceto para preços por volume.

Isso significa que, se já existir um preço para um produto, como o produto Tênis Amarelo, e o novo CSV não contiver essa linha, o preço permanecerá inalterado.

Para preços por volume, podem ocorrer exclusões. Por exemplo, se um produto tiver os seguintes preços por volume: 2 -> 10, 3 -> 9, 4 -> 8, e o CSV não incluir entradas para preços por volume, então nada será modificado. No entanto, se o CSV contiver novas entradas para o mesmo produto, como uma quantidade mínima de 5 e um preço unitário de 7, então os valores para as quantidades 2, 3 e 4 serão excluídos, pois não existem no CSV.

Para manter os preços por volume existentes e apenas adicionar a nova entrada para quantidade mínima = 5, as entradas previamente existentes devem permanecer no arquivo CSV importado.

Notas sobre como trabalhar com CSVs no Excel

Por favor, esteja ciente de que o Excel pode ser uma ferramenta útil para trabalhar com arquivos CSV (Comma Separated Value), mas pode não ser a melhor opção para converter arquivos para CSV. Isso se deve ao fato de o Excel nem sempre preservar a formatação e a estrutura do arquivo original ao convertê-lo para CSV.

Por exemplo, o Excel pode usar diferentes delimitadores (como ponto e vírgula ou tabulações) do que é comumente usado em arquivos CSV (que normalmente usam vírgulas). Isso pode causar problemas ao importar o arquivo para outras aplicações que esperam que os arquivos CSV estejam formatados de uma forma específica.

Além disso, o Excel pode adicionar formatação ou caracteres especiais que não são compatíveis com arquivos CSV, o que pode resultar em erros ou perda de dados ao importar o arquivo para outras aplicações.

Portanto, é frequentemente recomendado usar ferramentas especializadas ou scripts desenvolvidos para converter arquivos para CSV, que podem garantir que o arquivo resultante está corretamente formatado e é compatível com outras aplicações. Um truque simples para superar este problema: faça o upload de um arquivo Excel para o Google Sheets e depois baixe o CSV — dessa forma, o seu CSV será compatível com a maioria das plataformas.