Importe produtos

Como funciona

A importação lê um arquivo de texto com uma linha de cabeçalho seguida de uma linha por produto. Para cada linha, o Accuracy procura um produto com o mesmo código de barras na organização:

• se não existir, o produto é criado
• se existir e algum valor mudou, o produto é atualizado
• se existir e nada mudou, a linha é ignorada

Linhas com erro não interrompem a importação: as demais continuam sendo processadas e os erros aparecem com o número da linha.

Formato do arquivo

• Extensão .csv ou .txt. As duas são lidas da mesma forma — a extensão não muda nada no conteúdo esperado.
• Codificação UTF-8 (acentos funcionam normalmente).
• A primeira linha não vazia é o cabeçalho, com os nomes das colunas.
• O separador é detectado automaticamente pelo cabeçalho: vírgula ,, ponto e vírgula ;, barra vertical | ou tabulação. Use o mesmo separador em todas as linhas.
• Se um valor contém o separador, coloque-o entre aspas duplas: "Café Torrado e Moído, 500g".
• A ordem das colunas é livre, maiúsculas e minúsculas são ignoradas e colunas desconhecidas são descartadas.
• Linhas em branco são ignoradas.

Colunas

Preços aceitam até 4 casas decimais, sem separador de milhar e sem símbolo de moeda: 5.49 ou 5,49. Em arquivos separados por vírgula, use ponto como decimal (ou coloque o valor entre aspas).

Exemplos

Simples: só as colunas obrigatórias

Cadastra ou atualiza a descrição dos produtos, sem tocar nos demais dados.

barcode,description
7891000100103,Leite Integral 1L
7891910000197,Arroz Branco Tipo 1 5kg
7896005800010,Café Torrado e Moído 500g

Baixar: products-simple.csv · products-simple.txt

Completo: todas as colunas

Cadastra os produtos com código externo, unidade e preço, e vincula cada um às empresas com valores próprios.

barcode,description,external_system_id,unit,price,company_id,company_code,company_external_system_id,company_price
7891000100103,Leite Integral 1L,ERP-1001,UN,5.49,,LOJA01,L01-1001,5.79
7891000100103,Leite Integral 1L,ERP-1001,UN,5.49,,LOJA02,,5.99
7891910000197,Arroz Branco Tipo 1 5kg,ERP-2002,PCT,27.90,,,,
7896005800010,"Café Torrado e Moído, 500g",ERP-3003,UN,18.75,,LOJA01,,

Baixar: products-full.csv · products-full.txt

O que cada linha do exemplo completo faz:

1. Leite vinculado à empresa LOJA01, com código externo L01-1001 e preço 5.79 só nessa empresa.
2. O mesmo leite vinculado também à LOJA02, com preço 5.99. Como company_external_system_id está vazio, a empresa usa o código externo do produto (ERP-1001).
3. Arroz sem empresa: só os dados do produto são gravados.
4. Café vinculado à LOJA01 sem valores próprios — a empresa usa o código externo e o preço do produto.

Vincular produtos a empresas

• Informe company_code ou company_id para vincular o produto a uma empresa. Se informar os dois, eles precisam apontar para a mesma empresa.
• Você só pode vincular empresas às quais tem acesso.
• company_external_system_id e company_price só valem com uma empresa na mesma linha.
• Para vincular o mesmo produto a várias empresas, repita a linha mudando a empresa, como no exemplo completo.

Atualizar produtos existentes

barcode e description são sempre gravados, pois são obrigatórios.

Execute a importação

1. Abra Importar produtos em Produtos.
2. Selecione o arquivo .csv ou .txt.
3. Clique em Iniciar importação.

A página também mostra a tabela de colunas aceitas e os botões para baixar os arquivos de exemplo.

O que significam os resultados

Depois da execução, o Accuracy mostra:

• Linhas: total de linhas de dados lidas
• Criado: produtos novos ou novos vínculos com empresa
• Atualizado: produtos ou vínculos que tiveram algum valor alterado
• Ignorado: linhas sem nenhuma alteração
• Erros: linhas que não foram importadas

Se algumas linhas falharem, use a seção Erros de linha: o número da linha é o mesmo que aparece no seu editor de texto (o cabeçalho costuma ser a linha 1). Corrija o arquivo e importe de novo — linhas já importadas aparecem como ignoradas.

Erros comuns