Конвертация JSON в CSV

Правила уплощения одинаковы на любой глубине. Ключ вложенного объекта склеивается с ключом родителя: поле city внутри address внутри customer даёт колонку customer.address.city. Элементы массива получают порядковый индекс — tags.0, items.1.price. Набор колонок собирается объединением ключей всех записей: столбец появляется, если поле встретилось хотя бы однажды, у остальных строк ячейка остаётся пустой, а порядок столбцов определяется первым появлением ключа.

Точность чисел — то, что стоит проверить до импорта. JSON не различает целые и дробные значения, а разбор идёт в двоичной плавающей точке двойной точности, где целые представимы без искажений до 9 007 199 254 740 991. Девятнадцатизначный идентификатор заказа, записанный числом, потеряет младшие разряды ещё на этапе разбора — в исходном JSON такие поля должны быть строками. Даты остаются строками в том виде, в каком они записаны, чаще всего по ISO 8601.

Оформление результата подчиняется стандарту CSV: значение, внутри которого встречается разделитель, кавычка или перенос строки, заключается в двойные кавычки, а кавычка внутри такого значения удваивается. Файл записывается в UTF-8 с меткой порядка байтов из трёх байтов — она нужна табличным редакторам, чтобы опознать кодировку без диалога импорта. Разделитель задаётся параметром: запятая, точка с запятой или табуляция. На обработку отводится 120 секунд.