Каталог Market --- загрузка / выгрузка CSV

Обновлено: Aug 31, 2026Раздел: Интеграции

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

  1. Экспортируйте текущий каталог в CSV
  2. Отредактируйте строки офлайн
  3. Загрузите CSV обратно
  4. Просмотрите обнаруженные изменения
  5. Примените изменения

Эта страница описывает процесс панели управления владельца (авторизация Bearer). Для внешнего API каталога только для чтения с X-API-Key см. market-catalog-external-api{.interpreted-text role="doc"}.

Обзор

В интеграции MARKET есть отдельная вкладка:

  • Загрузка / Выгрузка в деталях интеграции
  • Экспорт CSV скачивает round-trip CSV со стабильными заголовками
  • Импорт CSV сначала анализирует содержимое файла (предпросмотр), затем применяет операции создания/обновления

Текущий охват:

  • Только товары и варианты
  • Отсутствующие строки игнорируются (не архивируются)
  • Прайс-листы пока не входят в этот CSV-процесс

Контракт CSV

Заголовки CSV фиксированные и упорядоченные:

row_type,product_id,variant_id,status,type_keys,tag_slugs,product_name,product_attributes_json,product_locales_json,variant_sort_order,variant_sku,variant_attributes_json,variant_locales_json

Важные правила:

  • row_type: product или variant
  • product_id:
  • необязателен для строк новых товаров
  • обязателен для строк вариантов
  • variant_id:
  • необязателен для строк новых вариантов
  • обязателен для обновления существующего варианта
  • type_keys использует | как разделитель (для строк товаров)
  • tag_slugs использует | как разделитель (для строк товаров)
  • Столбцы *_attributes_json и *_locales_json должны содержать валидные JSON-объекты при заполнении

Предпросмотр и применение

Панель управления всегда сначала выполняет предпросмотр:

  • валидирует структуру строк и доменные ограничения
  • определяет действие строки: created, updated, unchanged или invalid
  • выделяет изменённые поля в таблице предпросмотра
  • показывает итоговые счётчики

Фильтр предпросмотра по умолчанию --- только изменённые строки. Можно переключить на отображение всех строк.

Этап применения:

  • требует токен предпросмотра из последнего ответа предпросмотра
  • завершается конфликтом, если данные изменились и токен устарел
  • применяет только операции создания/обновления

Поведение при отсутствующих строках

Строки, существующие в каталоге, но отсутствующие в загруженном CSV, подсчитываются как missing in file и игнорируются:

  • автоматическое изменение статуса на ARCHIVED не производится
  • удаление не выполняется

Лучшие практики

  • Начинайте с актуального экспорта перед редактированием
  • Сохраняйте ID при обновлении существующих строк
  • Не меняйте порядок или имена столбцов
  • Используйте файлы CSV в кодировке UTF-8
  • Поддерживайте единственный источник истины для значений SKU (строки вариантов)

Дополнительные материалы

  • Внешний API чтения и области действия API-ключей: market-catalog-external-api{.interpreted-text role="doc"}
  • API-ключи и разрешения: OpenAPI https://api.mailoo.app/docs/v1
📚