workflows

Exportar CSV para planilha: quando um campo vira fórmula

Antes de entregar um CSV ao Excel ou Google Sheets, diferencie texto externo de fórmula e use uma ficha de liberação adequada ao destino.

Um campo de nome, comentário ou referência pode sair de um sistema como texto e ser interpretado como fórmula quando alguém abre o CSV numa planilha. Isso depende do conteúdo, do aplicativo e do modo de importação. Antes de automatizar o envio, descubra quem controla cada campo e qual programa abrirá o arquivo.

Resposta curta

Se um campo vindo de usuário ou parceiro começar com =, +, -, @ ou caracteres de controle, trate-o como potencial fórmula, não como instrução legítima. A OWASP documenta a injeção de fórmula em CSV e alerta que aspas ou apóstrofo podem perder a proteção após salvar e reabrir no Excel. Para escrita programática no Google Sheets, a API distingue RAW de USER_ENTERED: RAW conserva =1+1 como texto, enquanto USER_ENTERED o interpreta como fórmula. Essa escolha da API não protege automaticamente um arquivo CSV aberto por uma pessoa.

Ficha de liberação por destino

Destino Decisão antes de liberar Evidência que falta se bloquear
Excel ou outra planilha aberta por pessoa Inspecione cada célula externa depois do parse real, neutralize conforme o aplicativo e teste abrir, salvar e reabrir em ambiente isolado Não se sabe se o texto reaparece como fórmula após reabrir
Google Sheets via API Escreva campos externos como texto com RAW; se houver fórmula legítima, separe-a de dados externos e controle quem a cria O fluxo usa USER_ENTERED para dados de origem não confiável
CSV para outro sistema Preserve dados de acordo com o contrato do consumidor; não acrescente tabulação ou apóstrofo sem verificar o efeito na importação O destino pode receber caracteres extras ou transformar identificadores

Ativo original da Pulse: registre campo e origem → destino real → prefixo observado → tratamento escolhido → resultado após reabrir/importar → responsável → liberar ou bloquear. Esta ficha é um modelo de decisão, não resultado de teste da Pulse. Uma célula de demonstração =1+1 basta para verificar a interpretação sem usar uma fórmula de rede nem dados sensíveis.

O que verificar no arquivo brasileiro

Num exemplo hipotético, um pequeno negócio exporta comentários de pedidos para uma equipe que revisa o arquivo no Excel. O CSV pode usar ponto e vírgula como separador, mas não presuma isso: confirme o contrato e faça o parse antes de procurar prefixos no início de cada célula. Um separador ou aspas inseridos dentro de um comentário podem criar outra célula; checar apenas o primeiro caractere do campo bruto não basta. Não use o arquivo de clientes como teste. Use valores fictícios em uma cópia isolada, com o mesmo aplicativo e fluxo de salvar/reabrir da equipe.

Se o negócio puder entregar XLSX com células explicitamente tipadas como texto, avalie essa saída e teste no leitor real. Se só houver CSV para pessoas, escolha uma neutralização apropriada e valide seus efeitos. A OWASP descreve a tabulação dentro de célula entre aspas como mitigação observada no Excel, mas ela permanece no dado e pode prejudicar uma importação automatizada. Não há um escape universal para todos os leitores.

Se o destino confirmado é Excel e o CSV é para leitura humana: após separar as células com o parser do formato real, coloque cada campo entre aspas duplas e duplique aspas internas. Nos campos externos cujo valor começa por =, +, - ou @, coloque um caractere de tabulação antes do valor, dentro das aspas do campo, conforme a mitigação específica descrita pela OWASP. Não aplique apenas ao começo da linha bruta: faça isso célula por célula. Gere uma amostra fictícia, abra no Excel usado pela equipe, confirme que =1+1 aparece como texto, salve, feche e reabra para confirmar de novo. Verifique ainda se a tabulação passa a fazer parte do dado; se o arquivo também alimenta software, faça uma saída separada conforme o contrato desse consumidor. Se não conseguir validar essas condições, não envie o CSV.

Pare a publicação do arquivo se não conhecer o leitor, se não conseguir reproduzir a abertura/reabertura, se o tratamento mudar o dado de negócio ou se uma célula externa ainda for executada como fórmula. Para conferir separador, datas e valores, use o guia de localidade de CSV. Para isolar efeitos antes da ativação, veja teste de automação.

Fontes