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 de preços passo a passo.
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:
- Verifique se o separador é vírgula (
,) e não ponto e vírgula (;). - Abra o arquivo com o Bloco de Notas para confirmar o separador real.
- 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:
- Use valores de 1 a 20 exclusivamente.
- Verifique se não há linhas com o campo de lista vazio.
- 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ão549,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 |