Solução de problemas na importação CSV do Clara
Resolva os problemas mais comuns ao importar recibos de quilometragem no formato CSV para o Clara.
Por que importações falham (e por que é raro ser culpa da Clara)
Quando a importação de um CSV de quilometragem falha no painel da Clara, a primeira reação costuma ser questionar a ferramenta.[^rfb-sped] Em quase todos os casos, no entanto, a falha vem de um detalhe no arquivo: codificação alterada, separadores trocados, colunas reordenadas ou centros de custo desatualizados. Este guia resolve os problemas mais comuns e mostra como prevenir cada um. Reservar 15 minutos para entender essas categorias evita horas de retrabalho ao longo do ano e elimina a maior parte dos chamados de suporte abertos pelo financeiro.
Erros de codificação UTF-8
O sintoma típico é a Clara aceitar o arquivo, mas mostrar acentos quebrados (caracteres como "ã" no lugar de "ã"). A causa quase sempre é a abertura do CSV no Excel para "dar uma olhada" antes de subir, porque o Excel reabre como Windows-1252 ou ANSI e perde a marcação UTF-8. A solução é simples: nunca abra o CSV exportado pelo Quilometragem antes de subir na Clara. Se precisar inspecionar o conteúdo, use editor de texto puro (VS Code, Notepad++, Sublime) que preserva a codificação. Se o arquivo já foi alterado, gere um novo no Quilometragem.
Separadores trocados (vírgula vs ponto-e-vírgula)
A Clara aceita CSV com separador de vírgula ou ponto-e-vírgula, mas precisa de consistência: o arquivo inteiro deve usar o mesmo separador. Quando alguém edita uma linha no Excel e salva como CSV em ambiente Windows pt-BR, o separador pode virar ponto-e-vírgula, enquanto o restante do arquivo segue com vírgula. A Clara vai parar a importação na primeira linha inconsistente. A regra é a mesma do erro anterior: não edite o arquivo gerado. Se precisar adicionar manualmente uma despesa, faça pelo painel da Clara, não no CSV.
Colunas faltantes ou em ordem errada
A Clara espera uma sequência específica de colunas, e mudar a ordem ou remover qualquer uma quebra a importação. O Quilometragem sempre exporta com a sequência correta, mas planilhas baixadas de templates antigos da Clara podem ter ordem diferente da versão atual. Quando a mensagem de erro mencionar "campo obrigatório ausente" ou "coluna não reconhecida", reexporte do Quilometragem em vez de tentar reordenar manualmente. A versão do template é mantida automaticamente sincronizada.
Separador decimal e formato de data
Valores monetários no Brasil tradicionalmente usam vírgula decimal, mas o padrão de CSV internacional pede ponto. O Quilometragem sempre gera com ponto decimal porque é o que a Clara espera. Quando alguém abre o arquivo no Excel pt-BR, o programa converte para vírgula automaticamente, e o CSV salvo passa a ser inválido. O mesmo vale para datas: o padrão é ISO (AAAA-MM-DD), e o Excel pode reformatar para DD/MM/AAAA, quebrando o reconhecimento. Editor de texto puro evita esses dois problemas de uma vez.
**Detecção de duplicatas e centros de custo desconhecidos**
A Clara identifica duplicatas pelo identificador externo do recibo. Se você reexportar o mesmo lote sem alterações, a Clara avisa que tudo já existe. Se reexportar com alguns recibos novos no meio, ela importa só os novos. Esse comportamento é desejável, mas confunde quando o usuário esperava reimportar tudo. Para forçar reimportação, exclua os lançamentos antigos no painel da Clara antes de subir o novo arquivo. Já o erro de centro de custo desconhecido aparece quando o projeto foi renomeado ou desativado entre a geração do CSV e a importação.
Fluxo preventivo recomendado pelo Quilometragem
A maneira mais segura de evitar problemas é seguir um fluxo padrão: gerar o CSV, conferir totais no painel do Quilometragem, baixar, subir direto na Clara sem abrir, validar pré-visualização e confirmar. Esse fluxo elimina mais de 90% dos chamados de suporte. Para empresas com volume alto, recomendamos um responsável único pelo upload mensal, treinado nesse fluxo, em vez de distribuir a tarefa entre vários colaboradores. Documentar o procedimento em um runbook curto também ajuda na continuidade.
Próximos passos quando o problema persistir
Se mesmo seguindo o fluxo o erro persistir, três ações resolvem quase todos os casos restantes. Primeira: gere o CSV em um lote menor (um colaborador por vez) para isolar o lançamento problemático. Segunda: compare o CSV exportado com o template de referência atual da Clara para confirmar versões. Terceira: abra um chamado simultâneo com suporte do Quilometragem (que vê o gerador) e da Clara (que vê o importador). A combinação dessas três ações fecha qualquer caso edge em poucas horas.