Импорт прайсов, остатков и каталога

Импорт нужен, когда товары и цены ведутся в учётной системе, а на площадку их надо переносить регулярно. Кабинет → Импорт.

Источник

• Что импортируем: «Каталог» (товары целиком: названия, описания, категории, свойства, фото) или «Цены и остатки» (быстрый прайс по артикулам).
• Формат: csv, xlsx, xml или json. Файл по ссылке, из S3 или с FTP — до 200 МБ; json — до 50 МБ (он читается целиком, остальные форматы — потоком, поэтому для большого прайса берите csv, xlsx или xml).
• Откуда: ссылка https://…, FTP, бакет S3 или ручная загрузка файла. Для доступа с паролем заведите доступ и выберите его в источнике (Доступы к внешним системам).
• Интервал проверки — как часто смотреть, не изменился ли файл. Минимум — 60 секунд. Импорт запускается, только если файл действительно изменился: сначала сверяется дата изменения и ETag, а затем содержимое файла целиком. Перевыложили тот же прайс — в журнале появится запись «Файл не изменился», каталог не перезаписывается. Кнопка «Запустить» импортирует в любом случае.
• Пока импорт идёт, второй не начнётся. Если прогон не уложился в интервал проверки (большой каталог импортируется долго), следующая проверка его просто пропустит, а кнопки «Запустить» и «Загрузить файл» будут недоступны до окончания. Статус источника при этом — «Идёт».

Сопоставление колонок

Если колонки названы привычно (Артикул, Название, Цена, Остаток, Категория, Бренд, Вес, г), сопоставление не требуется — они распознаются автоматически, регистр не важен. Колонка Цена без кода типа цен — это розничная цена, Остаток без кода склада — остаток на основном складе. Иначе задайте соответствие вручную:

• sku — артикул (ключ, по которому ищется товар; можно использовать external_id — код из вашей системы);
• name.ru, name.en — название по языкам (или колонки name_ru, name_en);
• price:rrc, price:opt — цена по коду типа цены (Типы цен);
• stock:msk — остаток по коду склада (Склады, график работы и срок отгрузки);
• prop:power_w — значение свойства по коду (Свойства и характеристики);
• category, tags, images — категория, теги, ссылки на фото;
• published_at (или колонка «Дата публикации») — дата, по которой товар попадает в сортировку «Сначала новые» (Добавление товаров); формат 2026-02-03, будущая дата не принимается;
• vat_rate (или колонка «НДС») — ставка НДС товара: 0, 5, 7, 10 или 22, можно со знаком процента. Другая ставка (например, прежние 18 или 20) и текст не записываются: у товара остаётся его ставка, новый товар получает 22 %, а в журнале появляется замечание с артикулом.

Категория — раздел вашего каталога (Категории каталога); вложенность пишется через / (Свет/Люстры/Хрустальные), несколько категорий разделяются | или ;, первая становится основной. Отсутствующие категории, теги, бренды и свойства создаются автоматически.

Если категории с таким именем нет на месте, указанном в файле, но она есть в другом месте вашего дерева (вы её переложили, а в файле остался старый путь), товар уйдёт в существующую категорию, а не в новую с тем же именем — в журнале появится строка с фактическим путём. Когда одноимённых категорий в дереве несколько, выбрать за вас нельзя: категория создаётся по пути из файла, и об этом тоже пишется в журнал.

Списковые свойства — исключение: новые варианты списка импорт не придумывает. Значение, которого нет среди вариантов (Свойства и характеристики), в товар не попадёт, а уйдёт строкой в журнал — добавьте вариант в свойство и запустите импорт снова.

Цены и остатки: что записывается

Строка прайса считается загруженной, если товар найден по артикулу. Неподходящее значение в ней не отменяет остальные: цена не записалась — остаток той же строки запишется, и наоборот.

• Цена 0 записывается как есть: по этому типу цен у товара цены больше нет, покупатель увидит «Цена по запросу» и кнопку запроса цены (Запросы цены (RFQ)) — если ему не подошла цена другого типа или правило (Правила цен для контрагентов). В журнале будет замечание. Так же работает файл, загруженный в разделе «Обмен данными», и REST API (REST API и токены).
• Отрицательная цена, текст вместо числа и заведомо невозможная сумма не записываются — прежняя цена остаётся, в журнале замечание.
• Отрицательный остаток («пересорт» в учётной системе) записывается как 0 — продавать нечего. В журнале замечание с исходным значением.
• Неизвестный код типа цен или склада в названии колонки (price:opt2, stock:spb) — колонка не загружается, остальные колонки строки загружаются. Замечание одно на весь файл.

Обмен с 1С с нулевой ценой поступает иначе — действующую цену нулём не затирает (Обмен с 1С).

Результат

Каждый запуск попадает в журнал: сколько строк создано, обновлено и пропущено — в сумме это всегда число строк файла — и замечания с номерами строк. Пропущена — значит, строка не загружена совсем (товар не найден, нет артикула, недопустимое название): такие записи в журнале красные. Строка, загруженная не целиком, в «пропущено» не попадает: она считается созданной или обновлённой, а в журнале стоит замечание о том, что именно не записалось (жёлтым). Число в колонке замечаний — полное; в журнале показаны первые 200, одинаковые сложены в одно с пометкой «ещё строк: N». Там же видно, что импорт завёл сам — категории (полным путём), теги, бренды, свойства и артикулы новых товаров, по 50 названий на вид, дальше числом. Это способ поймать опечатку в файле: лишняя категория или тег обычно означают, что в колонке ошибка. Если источник недоступен или файл битый, статус станет «Ошибка», а текст ошибки будет виден в списке. Такой источник проверяется снова не раньше чем через 15 минут, а не каждую минуту — исправьте файл или адрес и нажмите «Запустить». Источник, файл которого ещё не загружен, просто ждёт загрузки. Если прогон оборвался (например, перезапуск сервера), источник освобождается сам, и следующая проверка запустит импорт заново.

Разовую загрузку файла удобнее делать через раздел «Обмен данными» (Экспорт и загрузка файла); для 1С есть отдельный обмен (Обмен с 1С).