К содержимому

Документация

CSV, JSON и XML

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

CSV для Excel и учётных систем

Настройте разделитель колонок, переводы строк и BOM для совместимости с Excel. Если весь файл открылся в одном столбце, проверьте выбранный разделитель при импорте. Артикулы с ведущими нулями лучше импортировать как текст, иначе Excel может их изменить. Заголовок колонки задаётся в дополнительных параметрах поля.

Вложенные структуры и массивы не всегда удобно представлять плоской таблицей. Согласуйте с получателем, нужна ли одна строка на товар или отдельные строки для остатков каждого склада. Для сложных структур рассмотрите JSON.

JSON

JSON сохраняет вложенные объекты, массивы, числа, строки и пустые значения. Можно включить отступы для чтения и задать необязательный корневой контейнер. Например, путь product.sku создаёт поле sku внутри объекта product.

{
  "product": {
    "sku": "A-001",
    "name": "Пример товара",
    "price": 1290.5
  }
}

Тип важен: 1290.5: число, а "1290.5": строка. Проверьте, чего ждёт получатель. Группировка в параметрах формата и произвольная обработка кодом: разные способы: для сложных итогов используйте режим обработки набора.

XML

Настройте корневой тег и тег записи. Имена тегов должны соответствовать допустимому формату; сервер проверяет их при сохранении. Пример структуры:

<items>
  <item><sku>A-001</sku><price>1290.5</price></item>
</items>

Проверьте обработку отсутствующих значений и соответствие схеме принимающей системы. Изменение корневого контейнера или тегов может нарушить существующий импорт.

Параметры находятся в Получение данных → Параметры формата.