PDF или CSV: формат таймшита для клиента

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

Когда нужен PDF?

• Отчёт клиенту вместе со счётом или перед ним. Это документ, а не таблица для работы.
• Приложение к акту или к договорной отчётности.
• Архив у себя: через год важно, чтобы документ выглядел так же, как его видел клиент.
• Любая ситуация, где важно, что содержимое не менялось после отправки.

Когда нужен CSV?

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

Что чаще всего портит выгрузку?

• Кодировка. Русский текст, открытый не в той кодировке, превращается в набор символов. Если клиент жалуется на «иероглифы» — дело в этом, а не в файле.
• Разделитель. В русской локали таблицы часто ожидают точку с запятой, а не запятую, и файл открывается одной колонкой.
• Лишние данные. В CSV попадают технические поля и имена машин, которые клиенту не нужны и вызывают вопросы. Перед отправкой посмотрите, что там вообще есть.
• Неверный период. Самая обидная ошибка: выгрузили не тот месяц и отправили. Проверяйте границы до отправки.

И общее правило для обоих форматов: прочитайте выгрузку глазами клиента, а не глазами того, кто знает контекст. Строка «srv-1c, 40 мин» понятна вам, но не заказчику. Как формулировать описания и что проверять до отправки — в статье о выставлении счёта. Порядок выгрузки — на странице биллинга сессий.