Импорт и обновление товаров с помощью таблицы#

Скачайте шаблон категории, заполните данные товаров и загрузите файл в Каталог. Для этого не нужно писать код или использовать учетные данные API.

Перед началом#

Выберите нужный магазин в панели управления. У вас должно быть разрешение на редактирование его каталога. Если кнопка Загрузить таблицу товаров отсутствует, проверьте выбранный магазин, разрешение на запись в каталог и не ограничен ли ваш аккаунт доступом только для чтения.

Скачивание шаблона категории#

Откройте Панель управления → Каталог.
Нажмите Загрузить таблицу товаров, чтобы открыть диалог Импорт товаров.
В разделе Выберите категорию продукта укажите нужную категорию. Доступные варианты зависят от настроек магазина.
Нажмите Загрузить шаблон Excel. Для каждой категории используйте отдельный шаблон и загружайте файл отдельно.

При подготовке нового импорта скачивайте свежий шаблон, чтобы его столбцы соответствовали текущим требованиям категории. Скачанная книга — это шаблон, а не экспорт существующего каталога.

Заполнение книги#

Используйте листы книги следующим образом:

Лист	Назначение
`Products`	Введите реальные данные товаров начиная со строки 2. Не изменяйте первую строку с названиями полей.
`Instructions`	Ознакомьтесь с обязательными полями, размерами и правилами категории.
`Enums`	Найдите допустимые значения полей, таких как `status` и `dimension_unit`.
`Examples`	Посмотрите корректные и некорректные примеры. Вводите реальные товары в `Products`, а не здесь.

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

Сохраняйте текстовый формат ячеек SKU, чтобы программа для работы с таблицами не удаляла начальные нули и не изменяла длинные идентификаторы. Используйте одну строку на SKU; повторяющиеся значения в одном файле отклоняются, в том числе различающиеся только регистром букв.
Укажите в image_url прямой общедоступный HTTP- или HTTPS-адрес изображения; он должен работать без входа в аккаунт, файлов cookie и специальных заголовков запроса. В product_url укажите адрес страницы товара.
Указывайте размеры и единицы измерения по инструкциям шаблона. Если единица не задана ни в значении размера, ни в dimension_unit, по умолчанию используется in.
Выберите status из допустимых значений на листе Enums. Если оставить поле пустым, по умолчанию будет active; при обновлении товаров указывайте значение явно.

Сохраните файл в формате .xlsx (рекомендуется). Формат .csv также принимается, если файл содержит только строку заголовков товаров и данные. Устаревшие файлы .xls не поддерживаются. Каждый файл может содержать до 50,000 непустых строк товаров, а его размер не должен превышать 50 MB.

Загрузка и проверка результата#

Вернитесь в диалог импорта и выберите ту же категорию, что и для шаблона.
В разделе Завершите и загрузите выберите сохраненный файл и нажмите Начать импорт.
Проверьте имя файла, статус обработки и количество успешных и неуспешных строк в разделе Недавний импорт. Отправка подтверждает прием файла; обработка продолжается в фоновом режиме.
Дождитесь завершения обработки и проверьте неуспешные строки, даже если статус задания — Завершено. Вернитесь в Каталог, чтобы проверить данные импортированных товаров и их готовность.

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

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

Обновление существующих товаров#

Чтобы обновить товары, используйте тот же шаблон категории и сохраните существующий SKU каждого товара. Заполните все обязательные поля в каждой включенной строке, измените нужные значения и снова загрузите файл.

Тот же SKU в том же магазине обновляет существующий товар. Если SKU еще не существует, создается новый товар. Изменение SKU в таблице не переименовывает исходный товар.
Можно загрузить только строки товаров, которые нужно обновить. Товары, отсутствующие в файле, не удаляются, не отключаются и не снимаются с публикации.
Это не частичное обновление полей: обязательные поля по-прежнему должны содержать значения. Не предполагайте, что пустая необязательная ячейка сохраняет предыдущее значение. В частности, пустое поле status получает значение active, а при отсутствии единиц измерения размеров используется in.
Сохраняйте заполненную книгу для будущих обновлений. Скачанный шаблон не содержит текущих данных ваших товаров.

После завершения задания проверьте затронутые товары в Каталоге. Сам по себе успешный импорт не подтверждает видимость товаров на витрине; проверьте их готовность и чеклист запуска SDK.

Автоматизация импорта#

Для регулярной синхронизации на сервере используйте Product Import API. Поля запросов, ограничения и поведение частичного обновления описаны отдельно от этого процесса импорта с помощью таблицы.