# Limpe um CSV desorganizado sem perder linhas

Um checklist prático para limpar CSVs, cobrindo datas, identificadores, duplicatas, valores ausentes e conferência linha por linha.

Canonical page: https://beeuni.ai/blog/pt/clean-messy-csv-without-losing-rows

Um CSV limpo pode parecer melhor e ainda assim estar errado. Zeros à esquerda desaparecem, datas ambíguas viram o mês errado e a remoção de duplicatas pode apagar transações legítimas. Preserve o arquivo original e mantenha cada transformação vinculada à linha de origem.

Suponha que seu relatório de pedidos esteja em uma planilha conectada, em uma unidade compartilhada ou em um painel da Web. Indique o relatório ao Beeuni e especifique o intervalo de datas. Com a conexão necessária ou o acesso ao navegador, o agente pode buscar os dados e salvar uma cópia de origem antes de limpá-los.

Peça ao agente que inspecione primeiro a cópia salva. Antes de alterar os valores, ele deve informar o delimitador, a codificação, os cabeçalhos, a quantidade de linhas analisadas e os registros malformados. Contar linhas por si só não basta, pois um campo CSV entre aspas pode conter uma quebra de linha. Mantenha o link do relatório, o horário da extração e os filtros junto com a cópia para poder explicar quais registros foram incluídos.

## Defina regras para as colunas importantes

| Coluna | Regra de limpeza | Deixar para revisão |
| --- | --- | --- |
| ID do pedido | Ler como texto; preservar os zeros à esquerda | Identificadores ausentes ou registros conflitantes |
| Data | Usar datas ISO quando o formato da fonte for conhecido | Valores ambíguos, como 03/04/2026 |
| Valor | Analisar de acordo com a convenção decimal indicada | Separadores mistos ou valores ilegíveis |
| Moeda | Manter uma moeda explícita em cada linha | Valores sem moeda conhecida |
| Status | Aplicar um mapeamento de rótulos aprovado | Rótulos cujo significado não está claro |

Defina o que conta como duplicata antes de remover qualquer registro. Um ID de pedido pode aparecer em vários itens de linha. Dois valores iguais podem corresponder a compras diferentes. Comece identificando as possíveis duplicatas e explicando os critérios de correspondência. Exclua linhas somente quando houver uma regra que diferencie cópias acidentais de registros válidos.

## Solicite três resultados

```
Retrieve the report from the connection or page I specify, using the agreed date range.
Save an unchanged source copy and record its origin and filters.
Write and run a cleanup script using the agreed column rules.
Add source_row_number before sorting or filtering.
Keep all successfully parsed source rows in cleaned.csv.
Flag uncertain values instead of guessing.
Put malformed records and issues in review.csv, with reasons.
Write checks.txt with row counts, changed fields, and totals by currency.
Do not overwrite the source or update the live report.
```

Mantenha em branco os valores ausentes, a menos que saiba que representam zero. Registre separadamente uma conversão de data malsucedida e uma data ausente na fonte. Caso contrário, você perderá as informações necessárias para corrigir a linha depois.

## Faça a conferência antes de importar

- **Linhas:** cada registro da fonte deve aparecer no resultado limpo ou no relatório de registros malformados. Explique as exclusões à parte.
- **Identificadores:** confira valores com zeros à esquerda e sequências longas de dígitos em um visualizador de texto simples.
- **Totais:** compare os valores por moeda antes e depois da limpeza. Não some moedas diferentes.
- **Alterações:** confira uma amostra de registros de cada transformação, incluindo espaços removidos, status mapeados e datas convertidas.
- **Destino:** importe uma amostra pequena para o aplicativo de destino e verifique como ele interpreta datas e campos de texto.

Alguns aplicativos de planilha removem zeros à esquerda ao abrir um CSV. Se isso acontecer, confira o arquivo bruto e importe a coluna de IDs como texto. Depois de revisar o resultado, você pode pedir ao agente que o grave em uma nova planilha ou em outro destino por meio de uma ferramenta conectada compatível com essa ação. Confirme o destino e confira os registros importados; mantenha o relatório original intacto.