Когда после выгрузки «сбились формулы», сначала откройте файл как архив данных, а не как привычную книгу. CSV вообще не хранит листы, стили и формульную модель книги: это строки значений с разделителями. Если на входе был XLSX, а на выходе CSV, исчезновение формул ожидаемо. Исправлять формулу в этом случае бессмысленно — выбран не тот формат результата.

Вторая частая ситуация выглядит похоже, но причина иная: API прочитал рассчитанное значение, а затем записал его в новую таблицу. На экране число совпадает, пока исходные данные не меняются. После изменения пользователь обнаруживает, что пересчёта больше нет. Найдите одну контрольную ячейку и проследите не только её отображение, но и буквальный текст формулы.

Три результата нельзя называть одной выгрузкой

Нужный результатПодходящий форматЧто не сохранится
обмен строкамиCSV или TSVформулы, несколько листов, стили, проверки
готовая книгаXLSX или ODSзависит от поддержки функций библиотекой
живая совместная модельGoogle Sheetsчасть функций может зависеть от локали и API
неизменяемый отчётPDFредактирование и пересчёт
машинный наборJSON или APIоформление и формульный интерфейс

Microsoft прямо предупреждает: при сохранении книги в текстовый или CSV-формат часть данных и возможностей теряется, а форматирование удаляется. В CSV сохраняются отображаемые текст и значения активного листа. Поэтому безопасная схема часто состоит из двух файлов: CSV как переносимый набор данных и XLSX как отчётный шаблон с формулами.

Контрольная карточка ячейки ловит подмену значения

cell: Report!G18
formula_before: =SUM(G2:G17)
value_before: 148320.50
export_format: xlsx
read_mode: FORMULA
write_mode: USER_ENTERED
locale: ru_RU
formula_after: =SUM(G2:G17)
value_after: 148320.50

Для Google Sheets API параметр ValueRenderOption определяет, что вернётся при чтении: FORMATTED_VALUE — рассчитанное и оформленное значение, UNFORMATTED_VALUE — рассчитанное значение без оформления, FORMULA — сама формула. Если задача переносит модель, чтение в режиме FORMATTED_VALUE уже уничтожает нужную информацию на границе API.

При записи ValueInputOption RAW оставляет строки неразобранными, а USER_ENTERED применяет правила интерфейса Sheets: строки могут стать числами, датами или формулами. Выбор должен быть явным. Для пользовательских данных безопаснее RAW, а для доверенного шаблона формул — контролируемый USER_ENTERED. Не смешивайте их в одном неразмеченном массиве.

Локаль меняет не только внешний вид числа

  • десятичный разделитель может быть запятой или точкой;
  • разделитель аргументов формулы зависит от среды;
  • названия функций могут отображаться или импортироваться иначе;
  • строка 01.02.2026 способна стать разной датой;
  • имя листа с пробелом требует корректного quoting в ссылке;
  • внешняя ссылка может не поддерживаться библиотекой генерации XLSX.

Не лечите локаль глобальной заменой запятых и точек: она испортит текстовые поля и часть формул. Храните числовые значения числами, даты — однозначными датами, а целевую локаль задавайте на уровне книги. После генерации открывайте файл тем же движком или совместимой библиотекой и проверяйте формулу и вычисленное значение отдельно.

Шаблон и данные обновляются в разных областях

Устойчивый отчёт содержит лист Data, куда процесс записывает только значения, и лист Report с проверенными формулами, диаграммами и форматами. Обновление очищает заданный диапазон Data, а не пересоздаёт книгу целиком. Формулы ссылаются на таблицу или именованные диапазоны, которые расширяются предсказуемо.

  1. Сделать версию шаблона и хранить её вместе с отчётом.
  2. Проверить обязательные листы, заголовки и именованные диапазоны.
  3. Записать данные только в предназначенный диапазон.
  4. Открыть контрольные ячейки и сравнить текст формулы с эталоном.
  5. Проверить вычисленные значения и ошибки #REF!, #NAME? и #VALUE!.
  6. Сохранить журнал версии шаблона, локали и библиотеки экспорта.

Ошибка диапазона видна на маленьком тесте

Соберите тест из трёх строк: обычное число, пустое значение и строка с запятой. Добавьте сумму, ссылку на другой лист и формулу с датой. Такой файл быстрее покажет, где происходит потеря: при чтении исходника, сериализации, записи, открытии или пересчёте. Большой отчёт только маскирует границу сбоя.

Для диагностики приложите исходный и полученный файл без персональных данных, формат, локаль, одну контрольную формулу, режимы API и версию библиотеки. Не пересылайте рабочую книгу с финансовыми данными, если проблему можно воспроизвести на пяти ячейках. Решение считается готовым, когда повторная выгрузка сохраняет формулу и даёт ожидаемый пересчёт после изменения входной строки.

Проверенные источники