# 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. **Autor:** Felipe Andrade — Líder de Produto e Integrações **Publicado:** 2025-08-18 **Atualizado:** 2026-04-28 **URL:** https://quilometragem.com.br/blog/solucao-problemas-importacao-clara **TL;DR:** Resolva os problemas mais comuns ao importar recibos de quilometragem no formato CSV para o Clara. - Quando a importação de um CSV de quilometragem falha no painel da Clara, a primeira reação costuma ser questionar a ferramenta. - O sintoma típico é a Clara aceitar o arquivo, mas mostrar acentos quebrados (caracteres como "ã" no lugar de "ã"). - 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. - A Clara espera uma sequência específica de colunas, e mudar a ordem ou remover qualquer uma quebra a importação. - Valores monetários no Brasil tradicionalmente usam vírgula decimal, mas o padrão de CSV internacional pede ponto. ## 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. ## Perguntas frequentes ### Por que a Clara está rejeitando meu CSV? As causas mais comuns são separador errado (vírgula vs ponto-e-vírgula), encoding diferente de UTF-8 e nomes de colunas que não batem com o template oficial. ### Como corrigir erros de codificação? Reabra o arquivo em um editor de texto e salve explicitamente como UTF-8 sem BOM; o Excel pode ser configurado em 'Salvar Como > CSV UTF-8'. ### E se viagens duplicadas forem importadas? A Clara identifica duplicatas pela combinação de data, colaborador e valor; remova as cópias diretamente no painel ou reimporte com a flag de deduplicação ativa. ## Fontes - [Receita Federal — Layouts oficiais SPED](https://www.gov.br/receitafederal/pt-br/assuntos/orientacao-tributaria/declaracoes-e-demonstrativos/sped-sistema-publico-de-escrituracao-digital) — Receita Federal do Brasil (2026-04-28)