⚠️ Antes de começar — leia com atenção

O arquivo CSV gerado pelo sistema possui as seguintes características:

• Delimitador: ponto e vírgula (;)
• Codificação: UTF-8 com BOM — o encoding é detectado automaticamente pelo Excel e pela maioria das ferramentas

Atenção ao delimitador: se o arquivo for aberto sem configurar o separador como ponto e vírgula, todos os dados aparecerão em uma única coluna. Siga o passo a passo da sua ferramenta antes de abrir o arquivo.

📊 Excel no Windows

Recomendado para a maioria dos usuários Windows com Microsoft Office instalado.

Passo a passo:

1. Abra o Excel com uma planilha em branco.
2. Clique na aba Dados na barra de menus.
3. Clique em Obter Dados > De Arquivo > De Texto/CSV.
4. Localize e selecione o arquivo .csv recebido.
5. Na janela de pré-visualização, verifique:
   • Codificação do arquivo: o Excel detecta automaticamente o UTF-8 com BOM — verifique se já aparece selecionado corretamente.
   • Delimitador: selecione Ponto e vírgula. Confirme que as colunas aparecem separadas na pré-visualização.
6. Clique em Carregar para importar os dados.

⚡ Power Query — Para arquivos extensos

Recomendado quando a abertura direta travar ou demorar. Carrega os dados em partes, sem travar o Excel. Disponível no Excel 2016 ou superior.

Passo a passo:

1. Abra o Excel e clique em Dados > Obter Dados > De Arquivo > De Texto/CSV.
2. Selecione o arquivo CSV.
3. Na janela de pré-visualização, não clique em Carregar. Clique em Transformar Dados.
4. O Editor do Power Query será aberto. Verifique se as colunas estão separadas corretamente.
5. Se as colunas não estiverem separadas, clique em Página Inicial > Dividir Coluna > Por Delimitador e escolha Ponto e vírgula.
6. Quando os dados estiverem corretos, clique em Fechar e Carregar.

🍎 Excel no Mac

O fluxo é similar ao Windows, com pequenas diferenças na interface.

Passo a passo:

1. Abra o Excel com uma planilha em branco.
2. No menu superior, clique em Dados > Do arquivo de texto.
3. Selecione o arquivo CSV.
4. No assistente de importação:
   • Passo 1: selecione Delimitado. A codificação UTF-8 já deve aparecer pré-selecionada — confirme antes de avançar.
   • Passo 2: marque Ponto-e-vírgula como delimitador (desmarque Tabulação).
   • Passo 3: mantenha o formato Geral e clique em Concluir.
5. Defina onde os dados serão inseridos e clique em OK.

🌐 Google Sheets

Boa opção para quem não tem o Excel instalado. Funciona pelo navegador, sem instalação.

Passo a passo:

1. Acesse sheets.google.com e crie uma planilha em branco.
2. No menu, clique em Arquivo > Importar.
3. Na aba Fazer upload, arraste o arquivo CSV ou clique em Selecionar arquivo do seu dispositivo.
4. Na janela de configuração, defina:
   • Local de importação: Substituir planilha atual
   • Tipo de separador: Personalizado → digite ;
5. Clique em Importar dados.

🔓 LibreOffice Calc

Alternativa gratuita ao Excel, disponível para Windows, Mac e Linux.

Passo a passo:

1. Abra o LibreOffice Calc.
2. Clique em Arquivo > Abrir e selecione o arquivo CSV.
3. Na janela Importação de Texto:
   • Conjunto de caracteres: o LibreOffice detecta o UTF-8 com BOM automaticamente — confirme que está selecionado.
   • Opções de separador: marque Separado por e marque a caixa Ponto e vírgula.
4. Confira a pré-visualização na parte inferior — as colunas devem aparecer separadas.
5. Clique em OK.

Todos os dados aparecem em uma única coluna

Causa: o delimitador não foi configurado como ponto e vírgula — a ferramenta usou vírgula ou tabulação por padrão.
Solução: feche o arquivo, reimporte usando o fluxo indicado neste artigo e defina o delimitador como Ponto e vírgula.

Acentos e caracteres especiais aparecem com símbolos estranhos (ex: ção)

Causa: a ferramenta não reconheceu o encoding UTF-8 com BOM corretamente ou foi sobrescrito durante a importação.
Solução: reimporte o arquivo e confirme que a codificação está definida como UTF-8 na etapa de importação. Não altere o encoding padrão sugerido pela ferramenta ao abrir o arquivo.

O Excel trava ou fica muito lento ao abrir o arquivo

Causa: o arquivo possui muitas linhas e o Excel tentou carregar tudo na memória de uma vez.
Solução: use o Power Query (veja o card acima). Ele carrega os dados em partes e permite aplicar filtros antes de trazer os dados para a planilha.

O Excel não exibe todas as linhas do arquivo

Causa: o Excel tem um limite de aproximadamente 1 milhão de linhas por aba (1.048.576). Arquivos que ultrapassam esse limite são truncados silenciosamente.
Solução: use o Power Query para filtrar os dados antes de carregá-los (ex: filtrar por período, CNPJ ou status), trazendo para a planilha apenas o subconjunto necessário.

Por que o sistema gera CSV em vez de Excel?

Para relatórios com grande volume de dados, a geração de um arquivo XLSX diretamente no servidor exigiria manter todos os registros na memória de uma vez, o que pode causar lentidão e erros. O CSV é um formato mais leve que permite exportar qualquer volume com segurança.

Posso abrir o CSV com dois cliques?

No Windows, o duplo clique abre o arquivo no Excel sem perguntar sobre o delimitador — e os dados aparecem todos em uma única coluna. O encoding é reconhecido corretamente pelo BOM, mas o delimitador não. Sempre use o fluxo de importação descrito neste artigo para garantir que as colunas sejam separadas corretamente.

O que é UTF-8 com BOM?

BOM (Byte Order Mark) é uma marcação invisível no início do arquivo que indica ao Excel e a outras ferramentas qual é o encoding do arquivo, sem que o usuário precise configurar manualmente. Por isso, ao importar o CSV, a codificação UTF-8 já costuma aparecer pré-selecionada corretamente.

O arquivo CSV é diferente de um Excel (.xlsx)?

Sim. O CSV é um arquivo de texto simples, sem formatação, fórmulas ou múltiplas abas. Ele contém os dados brutos separados por ponto e vírgula. Após importar no Excel, você pode salvar como .xlsx normalmente para aplicar formatação e fórmulas.

Posso importar o CSV diretamente em um ERP ou BI?

Sim. A maioria dos sistemas de ERP e BI (SAP, Power BI, Tableau, etc.) importa CSV nativamente. Na configuração de importação, informe o delimitador ; e a codificação UTF-8. Sistemas que fazem leitura via código podem precisar tratar o BOM como caractere extra no início do arquivo — oriente o time técnico responsável pela integração.

Ainda preciso de ajuda. Com quem falo?

Entre em contato com o suporte Invent pelo chat ou abra um chamado informando o nome do relatório e qual ferramenta está utilizando.