Быстрый старт: как перевести CSV в JSON

Чтобы быстро преобразовать выгрузку товаров в чистый структурированный код для сайта, используйте онлайн-конвертер CSV в JSON на русском языке. Достаточно подготовить таблицу с заголовками в первой строке, вставить текст в поле «CSV-данные», выбрать разделитель и структуру (массив объектов или словарь по первой колонке). В результате вы сразу получаете валидный JSON, готовый для передачи разработчикам, импорта в базу данных или обновления карточек товаров на витрине.

Подготовка таблицы перед конвертацией

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

Обратите внимание на ключевые особенности подготовки данных:

  • Заголовки колонок. Первая строка CSV-файла всегда воспринимается как заголовок. Названия из нее станут ключами свойств в итоговом JSON.
  • Типы данных. Все значения из CSV переносятся в JSON в виде строк (в кавычках). Числовые поля, такие как цены или остатки на складе, не преобразуются в числа автоматически.
  • Разделители. В интерфейсе Zyntec можно выбрать варианты: «Авто», «Запятая», «Точка с запятой», «Табуляция» или «Вертикальная черта». Если разделитель известен заранее, лучше указать его вручную.
  • Текст в кавычках. Если внутри ячейки есть запятые или переносы (например, описание товара или список характеристик), такое значение должно быть заключено в кавычки, и они обязательно должны быть парными.

Выбор итоговой структуры зависит от ваших задач:

  1. Массив объектов. Стандартный список, где каждая строка становится отдельным объектом. Подходит для общего вывода каталога, постраничной навигации или ленты товаров.
  2. Словарь по 1-му столбцу. Значения из первой колонки становятся главными ключами верхнего уровня. Это удобно для быстрого поиска карточки по артикулу (SKU) или коду товара. Для этого формата значения в первой колонке обязательно должны быть уникальными.

Пошаговый процесс конвертации

  1. Подготовьте исходный текст. Убедитесь, что первая строка содержит понятные названия полей на латинице или кириллице, а во всех строках ниже находится одинаковое число колонок.
  2. Вставьте данные. Откройте страницу сервиса и скопируйте текст в поле «CSV-данные».
  3. Укажите разделитель. Выберите нужный знак из списка («Авто», «Запятая», «Точка с запятой», «Табуляция» или «Вертикальная черта»).
  4. Выберите формат JSON. Отметьте «Массив объектов» для простого списка или «Словарь по 1-му столбцу» для структуры с ключами.
  5. Заберите результат. Скопируйте полученный JSON и проверьте соответствие ключей и количества записей.

Примеры готовых структур JSON

Рассмотрим наглядный пример каталога с разделением запятыми:

name,price,qty
Чехол,590,12
Коврик,890,5

Если выбрать разделитель «Запятая» и формат «Массив объектов», на выходе получится следующий код:

[
  {
    "name": "Чехол",
    "price": "590",
    "qty": "12"
  },
  {
    "name": "Коврик",
    "price": "890",
    "qty": "5"
  }
]

Три колонки превратились в ключи внутри каждого объекта, а две строки стали элементами массива.

Если же вам нужна структура для поиска по артикулу, разместите SKU в первом столбце:

sku,name,price
a1,Чехол,590
a2,Коврик,890

При выборе формата «Словарь по 1-му столбцу» результат примет такой вид:

{
  "a1": {
    "name": "Чехол",
    "price": "590"
  },
  "a2": {
    "name": "Коврик",
    "price": "890"
  }
}

Когда в тексте присутствуют сложные описания с запятыми, используется экранирование кавычками и точка с запятой:

name;note
Чехол;"красный, синий, белый"

При настройках «Авто» и «Массив объектов» текст внутри кавычек останется единым значением поля note без разрыва структуры.

Ограничения сервиса и форматов

  • Лимит объема. Сервис обрабатывает текст размером до 200000 символов за одну операцию. Для очень крупных баз данных делите выгрузку на части.
  • Строковые типы. Значения сохраняются в текстовом виде. Если вашей внешней системе требуются числовые типы или булевы флаги, преобразование типов выполняется на этапе загрузки в целевую систему.
  • Уникальность ключей. Формат «Словарь по 1-му столбцу» требует строго уникальных идентификаторов в первой колонке. При повторении артикулов данные могут перезаписаться.
  • Поддерживаемые структуры. Инструмент генерирует два классических формата («Массив объектов» и «Словарь по 1-му столбцу»). Вложенные многоуровневые деревья с произвольной иерархией не формируются.

Возможные ошибки и способы их решения

Если исходный CSV сформирован с нарушениями, сервис выведет понятное сообщение с подсказкой:

  • Несовпадение количества полей. Если в какой-то строке столбцов больше или меньше, чем в заголовке, сервис укажет на проблему: Не получилось: Строка 2: ожидалось полей 2, получено 3. Проверьте, нет ли в этой строке лишней запятой без кавычек.
  • Не выбран формат. Если тип структуры не указан, отобразится: Не получилось: Выберите доступный формат JSON. Достаточно просто переключить радиокнопку формата.
  • Незакрытые кавычки. Если в описании товара пропущена закрывающая кавычка, интерфейс покажет: Не получилось: Ошибка парсинга CSV: unexpected end of data. Найдите поврежденную ячейку и закройте кавычку.

После исправления неточностей вставьте обновленный текст в поле «CSV-данные» и выполните конвертацию повторно.

Читайте также