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.