Подключение площадок

Поля вкладки «Подключение» настройки обмена для каждого маркетплейса: какие доступы нужны, где их взять в кабинете продавца и что означают остальные параметры подключения.

Общие правила

Вкладка «Подключение» — первая вкладка настройки обмена. Её состав зависит от выбранного маркетплейса, но логика у всех одна: доступы к API, схема работы, глубина запроса заказов и параметры, специфичные для площадки. Доступы выдаёт личный кабинет продавца; передавать их нам не нужно — они вводятся в вашей базе 1С и наружу не уходят.

• Проверить соединение — есть у каждой площадки. Нажимайте после ввода ключей: модуль делает пробный запрос и сообщает, приняла ли площадка доступы. Пока проверка не проходит, дальше настраивать бессмысленно.
• Схема работы — FBO, FBS, realFBS, DBS и другие варианты, которые поддерживает площадка. Схема должна совпадать с той, по которой вы работаете в кабинете; на каждую схему и на каждый кабинет создаётся своя настройка обмена. После успешного обмена схему лучше не менять — заказы и остатки уже привязаны к ней.
• Глубина заказов и Глубина возвратов — за сколько дней запрашивать данные: 0 — только сегодня, 1 — сегодня и вчера, и так далее. Максимум задаёт площадка (у Wildberries — 29 дней). Когда обмен идёт по расписанию, держите 0: заказы всё равно подтягиваются по мере поступления, а большая глубина только замедляет каждый запрос.
• Warehouse ID — общий идентификатор склада площадки. Если заполнен, он подставляется вместо идентификаторов складов из таблицы на вкладке «Склады и остатки». Обычно удобнее оставить его пустым и заполнить таблицу складов.
• Размер стикера и Ориентация страницы — формат, в котором площадка отдаёт этикетки; выбирайте под бумагу вашего принтера.
• Обновлять категории при загрузке товаров — вместе с карточками загружать названия категорий, чтобы в каталоге были понятные наименования, а не идентификаторы.
• Использовать тестовую среду API — переключение на песочницу площадки. Нужна только разработчикам: в тестовом контуре нет ваших товаров и заказов, а проверка на нём ничего не подтверждает. В рабочей настройке флажок должен быть снят.
• Формирование ссылок на изображения — при создании карточек из 1С площадке нужны публичные ссылки на картинки. Модуль умеет выкладывать их на ваш FTP/SFTP-сервер (строка вида ftp://логин:пароль@сервер:порт/путь и шаблон внешней ссылки) или на Яндекс Диск (Client ID приложения, OAuth-токен и путь к папке). Кнопка «Проверить» кладёт тестовый файл и удаляет его.

Пошаговые инструкции «с нуля» по площадкам, где подключение разобрано вместе со всеми остальными шагами: Ozon, Wildberries, Яндекс Маркет, Lamoda, Лемана ПРО, Спортмастер, Сантехника-Онлайн. Краткая шпаргалка, где в кабинетах лежат ключи, — в разделе «Где взять доступы маркетплейса».

Ozon

• API key и Client ID — выдаются в кабинете продавца: «Настройки» → «Seller API». Client ID — число, показанное в этом разделе; API-ключ генерируется кнопкой «Сгенерировать ключ»: задайте ему название, уровень доступа с правами на все нужные операции и цель «для внешнего сервиса». Ключ показывается один раз — сохраните его сразу. У ключей ограничен срок жизни, следите за датой истечения в кабинете: с истёкшим ключом обмен останавливается с ошибкой авторизации.
• Warehouse ID — общий идентификатор склада (см. общие правила).
• Схема работы — FBO (продажи со склада площадки), FBS (со своего склада с передачей в доставку Ozon) или realFBS (со своего склада с доставкой сторонним перевозчиком). Состав интерфейса зависит от схемы: на FBO нет остатков, сборки и печати, зато есть заявки на поставку и таймслоты.
• Настройка FBO — поле в настройке со схемой FBS: укажите здесь настройку обмена того же кабинета со схемой FBO, чтобы остатки на складах площадки корректно отображались и учитывались при работе по FBS.
• Глубина заказов, Глубина возвратов — см. общие правила.
• Обновлять категории при загрузке товаров, Размер стикера, Ориентация страницы — см. общие правила.
• Контролировать зоны размещения — при обновлении карточек дополнительно загружать зоны размещения товара на складах; обновление становится дольше.
• Есть Premium-подписка — отметьте, если у кабинета оформлена платная подписка площадки. От флажка зависит, какие методы модуль будет вызывать; без подписки площадка отвечает на такие запросы ошибкой.
• Доверительная приёмка — включите, если кабинет работает по доверительной приёмке на складах площадки.
• Формирование ссылок на изображения — FTP или Яндекс Диск, см. общие правила.

Подробнее: «Ozon: настройка интеграции с нуля». Типичная ошибка при передаче цен «product not found» — здесь.

Wildberries

• Использовать новую систему авторизации OAuth 2.0 — переключает способ авторизации. Без флажка используется обычный токен API; с флажком — авторизация приложения в два шага.
• Токен API (без OAuth) — выпускается в кабинете WB Partners под владельцем профиля: меню профиля → «Интеграции по API» → «Создать токен». Выпускайте персональный токен отдельно под интеграцию с 1С и отмечайте все категории данных, которые нужны для ваших операций (заказы, поставки, остатки, цены, контент, возвраты), с правом записи. Токен показывается один раз, живёт 180 дней — по истечении обмен останавливается, нужен новый. Какие права нужны и что бывает при их нехватке — в статье «Какие права нужны токену Wildberries».
• Авторизоваться из 1С (шаг 1) и Подключиться (шаг 2) (с OAuth) — первая кнопка открывает авторизацию на стороне площадки; после подтверждения доступа в форму приходят код верификации и код авторизации, второй кнопкой они закрепляются за настройкой. Коды можно получить и вручную в кабинете, подключив приложение, и вставить в поля. «Отменить авторизацию» сбрасывает связку.
• Warehouse ID (Склад ID) — см. общие правила.
• Схема работы — FBO, FBS, DBS, DBW, Click&Collect, «Цифровой». Должна совпадать с кабинетом.
• Город — обязательное поле: без него не формируются стикеры поставки.
• Глубина заказов (не больше 29 дней), Глубина возвратов, Глубина поставок — за сколько дней запрашивать заказы, возвраты и поставки.
• Отгрузить через (ч) — через сколько часов после поступления заказ должен быть отгружен; этим значением заполняется поле «Отгрузить до» в заказах.
• Обновлять категории при загрузке товаров — см. общие правила.
• Использовать короба — включает работу с коробами при формировании поставок и печать стикеров коробов.
• Есть подписка Джем — платная подписка площадки; см. «Есть Premium-подписка» у Ozon.
• Конвертировать изображения при загрузке из WEBP в PNG — картинки карточек с площадки приходят в формате WEBP, который 1С не отображает; флажок конвертирует их при сохранении в номенклатуру.
• Размер стикера, Ориентация страницы, Формирование ссылок на изображения — см. общие правила.
• Использовать тестовую среду API — требует отдельного токена вида «Тестовый контур»; в рабочей настройке не включайте.

Подробнее: «Wildberries: настройка интеграции с нуля». При ошибке 429 «Too Many Requests» — здесь.

Яндекс Маркет

У Яндекса на одно подключение приходится несколько идентификаторов разного уровня, и большинство ошибок подключения — от того, что в поле подставили не тот номер.

• Номер компании — это номер кампании, то есть конкретного магазина. В кабинете: иконка аккаунта → «Настройки» → «API и модули» → поле «ID кампании» (в старом интерфейсе — название бизнеса в левом нижнем углу → «Модули и API»). Это не ИНН, не номер договора и не идентификатор кабинета.
• Использовать новую систему авторизации по токену — рекомендуемый способ: один авторизационный токен из кабинета. Создаётся там же, в блоке «Токен для авторизации» («Выбрать доступы» для первого токена или «Создать новый токен»), с ролью, дающей полные права; показывается один раз. Вставьте его в поле «Токен».
• Client ID и Токен (старая авторизация) — если флажок новой авторизации снят: Client ID приложения Яндекса, затем кнопка открытия токена в поле «Токен» и авторизация на Яндекс Маркете.
• Business ID — идентификатор бизнес-аккаунта (кабинета целиком). Получается кнопкой «Получить Business ID» прямо из 1С — но только после того, как заполнены токен и номер кампании. По кабинету работают каталог, карточки, карантин цен, чаты, отзывы и акции; по магазину — заказы и остатки.
• Есть подписка Медиум — платная подписка площадки; см. «Есть Premium-подписка» у Ozon.
• Склад ID — см. общие правила.
• Схема работы — FBY (со склада Яндекса), FBS, Экспресс или DBS.
• Глубина заказов, Глубина возвратов — см. общие правила.
• Загружать только тестовые (фейковые) заказы — для проверки обмена на тестовых заказах, которые создаются в кабинете; в рабочей настройке выключено.
• Валюта — валюта, в которой передаются цены.
• Размер стикера, Ориентация страницы — см. общие правила.
• Логин пользователя в Яндекс ID — логин без «@yandex.ru», от имени которого подписывается электронный акт приёма-передачи. Находится в кабинете в разделе «Настройки» → «Сотрудники и доступы».
• Формирование ссылок на изображения — FTP или Яндекс Диск, см. общие правила.

Подробнее: «Яндекс.Маркет: настройка интеграции с нуля».

МегаМаркет

• ID личного кабинета и Авторизационный токен — оба берутся в кабинете продавца в разделе настроек интеграции по API.
• Схема работы — по договору с площадкой; поддерживается схема rDBS — см. «МегаМаркет требует протестировать схему rDBS».
• Глубина заказов — см. общие правила.
• Максимальное количество заказов в запросе — сколько заказов запрашивать за одно обращение к API; если не заполнено, модуль берёт 200.
• ФИД — адрес FTP/SFTP, куда выкладывать фид для автозагрузки площадкой (sftp://логин:пароль@сервер/путь/fid.xml); используется, если площадка принимает ассортимент фидом.
• Использовать тестовую среду API — см. общие правила.

Lamoda

• CLIENT_ID и CLIENT_SECRET — выдаёт менеджер площадки при подключении API, в кабинете они не генерируются.
• Схема работы, Глубина заказов — см. общие правила.
• Группа Партнёр: Partner ID (Seller ID), Код партнёра (короткий код из трёх-четырёх символов) и Партнёр (наименование) — идентификаторы вашей компании в системе площадки; кнопка «Получить параметры» запрашивает их по API после ввода ключей. Бренд записывается в карточки товаров как производитель/бренд.
• Размер стикера на товар, Размер стикера пакет, Размер стикера паллета, Ориентация страницы — у площадки три вида этикеток, размер каждой задаётся отдельно.
• Использовать короба — включает работу с коробами при сборке и отгрузке.
• Использовать тестовую среду API — оставьте снятым: полноценной тестовой среды у площадки нет, демо-контур не повторяет ваш кабинет.

Подробнее: «Lamoda: настройка интеграции с нуля»; если загружается только часть заказов — здесь.

Лемана ПРО

• Client ID и Client SECRET — единственные доступы; отдельного номера магазина нет. В интерфейсе кабинета они не выдаются автоматически — запрашиваются у технической поддержки площадки.
• Схема работы — FBS или DBS. Глубина заказов — см. общие правила.
• Использовать тестовую среду API — в рабочей настройке снять.

Подробнее: «Лемана ПРО: настройка интеграции с нуля».

Магнит Маркет

• API ключ (api_key) — генерируется в кабинете продавца в разделе интеграций по API: создайте ключ с полным доступом и сразу скопируйте его.
• Схема работы, Глубина заказов — см. общие правила.
• Использовать тестовую среду API — в рабочей настройке снять.

Детский мир

• Client ID и Токен — ключи доступа к API из кабинета продавца.
• Схема работы, Глубина заказов, Warehouse ID — см. общие правила.
• Номер контракта — номер вашего договора с площадкой; передаётся в запросах.

Спортмастер

• Client ID и Токен — из кабинета продавца после регистрации.
• Схема работы, Глубина заказов — см. общие правила.
• Warehouse ID — идентификатор вашего склада на площадке; здесь он нужен обязательно.

Подробнее: «СпортМастер: настройка интеграции с нуля».

AliExpress

• Токен — ключ доступа к API из кабинета продавца.
• Схема работы — FBS в реализации площадки (отправка через её логистических партнёров). Глубина заказов — см. общие правила.

М.Видео

• API-ключ — создаётся в кабинете продавца в разделе «Доступ к API»: там же виден список действующих ключей и их назначение. Прежний способ — токен авторизации — площадкой отключён; если в поле стоит старый токен, замените его ключом.
• Схема работы, Глубина заказов — см. общие правила.
• Размер стикера, Ориентация страницы — формат этикеток.

Авито

• Client ID и Client SECRET — ключи приложения. API у Авито доступен только на платных тарифах для профессионалов: в профиле откройте раздел для профессионалов → «API», зарегистрируйте приложение и получите пару ключей.
• Глубина заказов — см. общие правила.
• ФИД — адрес FTP/SFTP, куда модуль выкладывает фид объявлений для автозагрузки площадкой (sftp://логин:пароль@сервер/путь/fid.xml); кнопка «Проверить» проверяет доступ к серверу.
• В настройке обмена на вкладке «Прочие» для Авито дополнительно выбирается Услуга продвижения, которая указывается при создании объявлений.

Сантехника-Онлайн

• Логин и Пароль — учётные данные кабинета продавца.
• Сертификат — файл сертификата, который выдаёт техническая поддержка площадки. Пароля у файла нет, он загружается в настройку как есть; пока сертификат не загружен, проверка связи не пройдёт.

У площадки свой порядок работы с ценами и ограниченный набор операций — см. «Сантехника-Онлайн: настройка интеграции с нуля».

Hoff

• Код поставщика в системе Hoff и Номер склада поставщика в системе Hoff — оба значения выдаёт ваш менеджер площадки.

Петрович

• E-mail и Пароль — учётные данные для входа в кабинет продавца; отдельного ключа API у площадки нет.

Kaspi

• Company ID, Company name и Токен — идентификатор и название компании в системе площадки и ключ API из кабинета продавца.
• Глубина заказов — см. общие правила.
• Период рассрочки — период рассрочки, который передаётся в предложениях, если вы продаёте в рассрочку.
• ФИД и Формирование ссылок на изображения — FTP/SFTP для фида и картинок, см. общие правила.

Halyk Market

• Client ID и Client secret — ключи API из кабинета продавца.
• Seller Company Name и Seller Brand — название компании и бренда, как они заведены на площадке.
• Точка продаж ID — идентификатор вашей точки продаж (склада) на площадке.
• Использовать тестовую среду API — в рабочей настройке снять.

Стройландия

• Логин и Пароль — учётные данные кабинета поставщика.
• Warehouse ID (Склад ID) — идентификатор склада на площадке.
• Вариант сопоставления — по какому признаку связывать позиции площадки с номенклатурой при загрузке заказов.

Авирона

• Токен — ключ API из кабинета.
• Город — город, в котором публикуются объявления.

АКСОН

• API ключ — генерируется в кабинете: номер договора (справа вверху) → раздел «API» → «Сгенерировать ключ».

VIPAVENUE и ВИМОС

• Токен — ключ API, который выдаёт площадка при подключении.