TL;DR — Resumo Rápido

Resolva erros ao importar ou atualizar listas de preços no CONTPAQi Comercial: formato de arquivo incorreto, chaves duplicadas e atualização massiva.

Erro ao Importar ou Atualizar Listas de Preços no CONTPAQi Comercial

A gestão de listas de preços é uma das operações mais frequentes para empresas com múltiplos clientes, zonas geográficas ou canais de distribuição. O CONTPAQi Comercial permite até 20 listas, mas a importação em massa mediante arquivos externos costuma gerar erros quando o formato não é preciso.

Pré-requisitos

  • CONTPAQi Comercial com acesso de administrador.
  • Catálogo de produtos previamente cadastrado.
  • Arquivo CSV com o layout correto de importação.

Formato do Arquivo para Importação

Coluna Campo Exemplo Obrigatório
A Chave do Produto PROD001 ✅ Sim
B Número da Lista 1 (de 1 a 20) ✅ Sim
C Preço Unitário 549.99 ✅ Sim
D Moeda (opcional) 1 (Peso) / 2 (Dólar) ❌ Não

Importante: O arquivo NÃO deve ter cabeçalhos. A primeira linha deve ser dados.

Erros Comuns e Soluções

1. “Erro na Estrutura do Arquivo”

O layout do CSV não corresponde ao esperado pelo SDK.

Solução:

  1. Verifique se o separador é vírgula (,) e não ponto e vírgula (;).
  2. Abra o arquivo com o Bloco de Notas para confirmar o separador real.
  3. Se usa Excel, salve como CSV (delimitado por vírgulas), não como CSV UTF-8.

2. “Chave de Produto Não Encontrada”

As chaves no arquivo não correspondem ao catálogo do CONTPAQi.

Solução:

  • Exporte primeiro o catálogo de produtos: Catálogos > Produtos > Exportar.
  • Compare as chaves do seu arquivo com o catálogo exportado.
  • Respeite maiúsculas/minúsculas: PROD001 ≠ prod001.
  • Elimine espaços em branco no início ou final das chaves.

3. “Número de Lista Fora do Intervalo”

O número da lista de preços é 0, negativo ou maior que 20.

Solução:

  1. Use valores de 1 a 20 exclusivamente.
  2. Verifique se não há linhas com o campo de lista vazio.
  3. Se precisa de mais de 20 listas, considere esquemas comerciais complementares.

4. Preços Importados como $0,00

O formato numérico do arquivo não é compatível.

Solução:

  • Use ponto (.) como separador decimal: 549.99, não 549,99.
  • Não inclua sinais de moeda ($), separadores de milhares ou espaços no campo de preço.

Tabela de Diagnóstico Rápido

Erro Causa Provável Solução
“Estrutura do arquivo incorreta” Separador incorreto Salvar como CSV delimitado por vírgulas
“Chave não encontrada” Chave inexistente ou com espaços Validar contra catálogo exportado
“Lista fora do intervalo” Número > 20 ou vazio Usar valores 1-20
Preços em $0,00 Formato decimal com vírgula Usar ponto decimal: 549.99
“Acesso negado” Sem permissões de administrador Executar como administrador

Prevenção

Ação Benefício
Criar um modelo CSV padrão Evitar erros de formato recorrentes
Fazer backup das listas antes de importar Poder reverter alterações indesejadas
Usar a exportação como base Garantir compatibilidade de chaves

Artigos Relacionados