Как выбрать формат выгрузки: CSV, XLSX или JSON
Формат выбирается не по вкусу, а по приёмнику. Разбираем, что каждый из трёх хранит, что теряет и кому он нужен.
На этой странице нет сравнительной таблицы с конкурентами: их цены и возможности меняются, а писать о чужих продуктах по памяти — значит вводить вас в заблуждение. Вместо этого — критерии и вопросы, которые стоит задать всем, включая нас.
По чему сравнивать
01Кто открывает файл — человек или программа
Человеку нужен XLSX с типами колонок, программе — предсказуемый CSV или JSON без форматирования.
Как проверить: Спросите себя, что произойдёт с файлом дальше: его откроют глазами или загрузят импортом.
02Хранит ли формат типы данных
CSV не хранит типы, поэтому артикул 007-12 при открытии в Excel превращается в дату, а ИНН теряет ведущий ноль.
Как проверить: Откройте пробную выгрузку двойным кликом и посмотрите на колонку артикулов.
03Сколько уровней данных нужно
У документа два уровня: шапка и позиции. CSV удерживает один, XLSX — два листами, JSON — вложенностью.
Как проверить: Решите, нужны ли вам позиции отдельно или достаточно шапки для платёжного календаря.
04Кто чинит, если импорт упал
Разделитель, кодировка и экранирование — три источника ошибок импорта, и у каждого приёмника свои требования.
Как проверить: Попросите тестовый файл и прогоните импорт на копии базы до того, как платить.
Вопросы поставщику
- 1В каком виде вы отдаёте позиции документа — отдельным листом или в той же строке?
- 2Какой разделитель и кодировка в CSV?
- 3Сохраняются ли ведущие нули в артикулах и ИНН?
- 4Есть ли в выгрузке пометка о полях, прочитанных неуверенно?
- 5Можно ли получить один и тот же документ сразу в двух форматах?
Наши ответы на эти же вопросы
- По умолчанию отдаём XLSX: в нём тип колонки записан внутри файла, поэтому артикулы и ИНН доживают до вашей таблицы.
- CSV отдаём под конкретный приёмник: для русского Excel — точка с запятой и BOM, для скрипта — запятая и UTF-8 без BOM.
- JSON содержит те же поля плюс блок проверок и отметки об уверенности разбора.
- Публичного API нет: JSON отдаётся файлом, и мы пишем это прямо, а не мелким шрифтом.
Вопросы
Почему нельзя один универсальный CSV на все случаи?
Потому что «универсальный» CSV одинаково плохо подходит и Excel, и скрипту: первому нужна точка с запятой и BOM, второму — запятая без BOM. Файл под приёмник настраивается за минуту, а разбирательство с кракозябрами занимает полдня.
Что выбрать, если данные идут и человеку, и в систему?
XLSX для человека и CSV или JSON для системы, из одного разбора. Это дешевле, чем один компромиссный формат, который неудобен обоим.
Проверьте нас по этим же критериям
Пилот на 30 дней — это и есть тест на ваших документах, только с результатом на руках.
Первый счёт разбираем вручную под ваш формат. Списание разовое, автопродления нет. Источник перехода: seo/vybor/format-vygruzki.
Другие материалы о выборе