96

Интеграция с Яндекс Маркетом через API: остатки, цены и заказы

Если вы продаёте на Яндекс Маркете со своего склада (схема FBS — вы сами храните и собираете заказы), Addshop может обмениваться с Маркетом напрямую через его Партнёрский API. Обмен решает три задачи: остатки с сайта уходят в Маркет, цены сайта уходят в Маркет, а новые заказы Маркета появляются в разделе «Заказы» вашего магазина. Так у вас один учёт остатков на два канала продаж, и товар, проданный на сайте, не будет продан ещё раз на Маркете.

Вы можете создать интернет магазин за 1 вечер. Просто выберите готовый шаблон интернет магазина и установите его. Останется только наполнить его своими товарами.

Важно понимать разницу с YML-выгрузкой. YML — это файл-каталог по ссылке, из которого Маркет создаёт и обновляет карточки товаров. API каталог не передаёт, он только синхронизирует остатки, цены и заказы уже существующих в Маркете товаров. Обычно используют оба способа вместе. Про YML читайте в статье YML-выгрузка товаров для Яндекс Маркета и ВКонтакте.

Что понадобится

  • Магазин на Яндекс Маркете, работающий по модели FBS (продажа со своего склада).
  • Доступ к кабинету продавца Маркета с правом создавать API-ключи.
  • Номер кампании (campaignId) — это номер вашего магазина в Маркете.
  • Номер кабинета (businessId) — нужен только если вы хотите передавать цены.
  • Артикулы у вариантов товаров на сайте, совпадающие с SKU товаров в Маркете. Это главное условие, без него обмен не найдёт товары.
  • Валюта магазина — рубль, если вы хотите передавать цены.

Шаг 1. Подготовка в кабинете Яндекс Маркета

API-ключ

В кабинете продавца Маркета откройте раздел настроек API (в подсказке поля в Addshop он обозначен как «Настройки → API и модули», в кабинете название может немного отличаться). Создайте API-ключ и дайте ему доступ к остаткам, ценам и заказам. Скопируйте ключ целиком, без пробелов в начале и в конце — позже Маркет может больше не показать его полностью.

Номер кампании и номер кабинета

Номер кампании (campaignId) и номер кабинета (businessId) — это числа. Их можно найти в кабинете продавца, обычно в настройках магазина или рядом с API-ключами. В Addshop оба поля принимают только цифры.

SKU товаров

Проверьте, какие SKU (ваши артикулы) указаны у товаров в кабинете Маркета. Addshop ищет товар так: SKU в Маркете должен совпадать с артикулом варианта на сайте, а если у варианта артикула нет — с артикулом самого товара.

Обратите внимание. Если товары попали в Маркет из YML-выгрузки Addshop, их SKU в Маркете — это внутренний номер варианта сайта, а не артикул. В этом случае приведите SKU в кабинете Маркета к артикулам сайта или заполните артикулы на сайте так, чтобы они совпали с SKU.

Шаг 2. Настройка в Addshop

Откройте Настройки → Интеграции и нажмите плитку «Яндекс Маркет (API)» в блоке торговых площадок. Откроется страница Яндекс Маркет (API). Туда же ведёт ссылка внизу страницы YML-выгрузки.

Поля формы

  • API-ключ — вставьте ключ из кабинета Маркета. Поле скрыто, как пароль. После сохранения ключ на странице не показывается, а в поле появляется подсказка «сохранён — оставьте пустым, чтобы не менять». Чтобы заменить ключ, просто введите новый.
  • Номер кампании (магазина, campaignId) — только цифры.
  • Номер кабинета (businessId) — нужен для цен — только цифры. Без него остатки и заказы работают, а цены нет.

Флажки обмена

  • Передавать остатки — после каждого заказа на сайте и по расписанию. После заказа на сайте в Маркет уходят остатки только купленных вариантов. Раз в час все остатки отправляются заново.
  • Передавать цены по расписанию (цена со скидкой товара, как в YML). Цены отправляются по расписанию, тем же заданием, что и остатки.
  • Загружать новые заказы Маркета в заказы магазина. Новые заказы проверяются примерно раз в 10 минут.

Нажмите Сохранить. Должно появиться сообщение «Настройки сохранены». После этого на плитке на странице интеграций появится отметка, а на странице Маркета — кнопки ручного запуска.

Кнопки ручного запуска

  • Обновить остатки — сразу отправляет все остатки.
  • Обновить цены — сразу отправляет все цены (нужен номер кабинета).
  • Загрузить заказы — сразу проверяет новые заказы Маркета.

Под кнопками выводятся итоги последних запусков — «Остатки», «Цены», «Заказы» с датой и временем. Для остатков и цен: «Отправлено», «принято Маркетом» и для остатков ещё «пропущено «без ограничения»». Для заказов: «Ждут сборки в Маркете», «загружено новых», «уже были загружены», «не загружено». Ошибки показываются красным списком ниже.

Что переносится и что нет

Остатки

  • Передаётся остаток каждого варианта товара, найденного по артикулу.
  • Варианты с отметкой «без ограничения» остаток не передают — они попадают в счётчик «пропущено». Чтобы Маркет видел количество, снимите в товаре «без ограничения» и укажите остаток.
  • Выключенный или удалённый товар передаётся с остатком 0 — на Маркете он перестанет продаваться.
  • Артикул, который повторяется у нескольких вариантов сайта, не передаётся вовсе, а в итогах появится ошибка «артикул есть у нескольких вариантов сайта, не отправлен».

Цены

  • Передаётся цена со скидкой товара — та же, что в YML-выгрузке.
  • Если у товара есть скидка, передаётся и зачёркнутая старая цена, но только если она в целых рублях и скидка от 5 до 99 процентов. Иначе цена уходит без зачёркнутой — так Маркет не отклонит всю пачку.
  • Отправляются только включённые товары с ценой больше нуля.
  • Если валюта магазина не рубль, цены не отправляются: в итогах будет «цены не отправлены: Маркет принимает цены в рублях, а валюта магазина другая».

Заказы

  • Загружаются заказы Маркета, которые ждут сборки. Каждый заказ Маркета создаёт ровно один заказ на сайте, повторно он не загрузится.
  • Источник заказа — «Яндекс Маркет» (создаётся сам при первом заказе), в комментарии стоит «Заказ Яндекс Маркета №» и номер Маркета.
  • Покупатель — имя и адрес, которые передал Маркет, иначе «Покупатель Яндекс Маркета».
  • Статус, способ доставки и способ оплаты в таком заказе пустые, заказ отмечен как неоплаченный: оплата и доставка идут через Маркет. Чеки через онлайн-кассу по таким заказам не пробиваются.
  • Остаток купленных вариантов на сайте уменьшается (не ниже нуля), а новые остатки сразу уходят на Ozon и Wildberries, если они подключены.
  • Отмены и смена статусов в Маркете в заказ сайта не переносятся — отменённый на Маркете заказ отмените на сайте сами.

Что не переносится вовсе

  • Карточки товаров, описания, фото и категории — это делает YML-выгрузка.
  • Заказы со склада Маркета (FBO) и любые финансовые данные.

Повторная синхронизация и расписание

Ничего запускать вручную не нужно. Остатки и цены отправляются раз в час, первыми — магазины, которые дольше всех не обновлялись. Заказы проверяются примерно раз в 10 минут. После каждого заказа на сайте остатки купленных вариантов уходят в Маркет сразу. Если две выгрузки совпали по времени, вторая пропускается с записью «идёт другая выгрузка остатков, эта пропущена» — следующая плановая выгрузка всё догонит.

Если вы поменяли артикулы, остатки или цены и не хотите ждать, нажмите «Обновить остатки» или «Обновить цены».

Как проверить

  1. Сохраните настройки и нажмите «Обновить остатки». В итоге «Отправлено» должно быть больше нуля, а «принято Маркетом» — равно ему.
  2. Откройте в кабинете Маркета товар с известным артикулом и сравните остаток с карточкой товара на сайте.
  3. Если включены цены — нажмите «Обновить цены» и сравните цену в Маркете с ценой со скидкой на сайте.
  4. Когда на Маркете появится заказ, нажмите «Загрузить заказы» и проверьте раздел Заказы: у нового заказа источник «Яндекс Маркет».
  5. Оформите тестовый заказ на сайте и убедитесь, что остаток на Маркете уменьшился.

Частые проблемы и решения

«Сначала укажите API-ключ и номер кампании и сохраните настройки»

Вы нажали кнопку запуска до сохранения настроек. Заполните ключ и номер кампании и нажмите «Сохранить».

«Номер кампании и номер кабинета — только цифры, как в кабинете Маркета»

В поле попали буквы, пробелы или лишние символы. Скопируйте номер ещё раз, только цифры.

«API-ключ указан неверно: скопируйте его из кабинета Маркета целиком, без пробелов»

Ключ скопирован не полностью или с пробелами. Скопируйте его заново. Если ключ потерян — создайте новый в кабинете Маркета.

«Для передачи цен укажите номер кабинета (businessId)»

Вы включили передачу цен, но не заполнили номер кабинета. Заполните его или снимите флажок цен.

«Отправлено» больше нуля, а «принято Маркетом» — ноль, или «Маркет не подтвердил запрос»

Маркет отклонил запрос. Чаще всего у ключа нет нужного доступа, указан чужой номер кампании или SKU на сайте не совпадают с SKU в Маркете. Проверьте права ключа и номер кампании. Если в тексте ошибки есть «Маркет недоступен» — это временная проблема связи, повторите позже.

Много пропусков «без ограничения»

У вариантов включено «без ограничения», и количество неизвестно. Снимите отметку и введите остатки в товарах.

«заказ Маркета … не загружен: SKU … не найден среди артикулов сайта»

В заказе есть товар, артикула которого нет на сайте. Такой заказ не загружается целиком, чтобы не получить неполный заказ. Исправьте артикул на сайте или SKU в Маркете — при следующей проверке заказ загрузится сам.

«загрузка прервалась, заказ на сайте мог не создаться — проверьте его вручную»

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

Вопросы и ответы

Нужно ли отключать YML-выгрузку, если я подключил API?

Нет. YML по-прежнему передаёт в Маркет каталог, а API добавляет остатки, цены и заказы. Следите только за совпадением SKU и артикулов.

Можно ли включить только загрузку заказов?

Да, каждый из трёх флажков работает независимо. Для любого обмена обязательны API-ключ и номер кампании.

Почему цена на Маркете отличается от цены на сайте?

Addshop отправляет цену со скидкой товара. Маркет может показывать покупателю свою цену с учётом собственных акций и скидок — этим управляет Маркет.

Заказ отменили на Маркете, а на сайте он остался. Это ошибка?

Нет, так задумано: отмены и смена статусов Маркета на сайт не переносятся. Отмените заказ на сайте и при необходимости верните остаток.

Безопасно ли хранить ключ в Addshop?

Ключ хранится в настройках магазина и на странице после сохранения не показывается. В журналы ошибок он не попадает — вместо него пишутся звёздочки.

Создайте интернет-магазин на Addshop за один вечер: готовые шаблоны, приём оплаты и выгрузка на маркетплейсы.
Создать магазин бесплатно Тарифы

Читайте также