Интеграция с Яндекс Маркетом через 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 минут. После каждого заказа на сайте остатки купленных вариантов уходят в Маркет сразу. Если две выгрузки совпали по времени, вторая пропускается с записью «идёт другая выгрузка остатков, эта пропущена» — следующая плановая выгрузка всё догонит.
Если вы поменяли артикулы, остатки или цены и не хотите ждать, нажмите «Обновить остатки» или «Обновить цены».
Как проверить
- Сохраните настройки и нажмите «Обновить остатки». В итоге «Отправлено» должно быть больше нуля, а «принято Маркетом» — равно ему.
- Откройте в кабинете Маркета товар с известным артикулом и сравните остаток с карточкой товара на сайте.
- Если включены цены — нажмите «Обновить цены» и сравните цену в Маркете с ценой со скидкой на сайте.
- Когда на Маркете появится заказ, нажмите «Загрузить заказы» и проверьте раздел Заказы: у нового заказа источник «Яндекс Маркет».
- Оформите тестовый заказ на сайте и убедитесь, что остаток на Маркете уменьшился.
Частые проблемы и решения
«Сначала укажите API-ключ и номер кампании и сохраните настройки»
Вы нажали кнопку запуска до сохранения настроек. Заполните ключ и номер кампании и нажмите «Сохранить».
«Номер кампании и номер кабинета — только цифры, как в кабинете Маркета»
В поле попали буквы, пробелы или лишние символы. Скопируйте номер ещё раз, только цифры.
«API-ключ указан неверно: скопируйте его из кабинета Маркета целиком, без пробелов»
Ключ скопирован не полностью или с пробелами. Скопируйте его заново. Если ключ потерян — создайте новый в кабинете Маркета.
«Для передачи цен укажите номер кабинета (businessId)»
Вы включили передачу цен, но не заполнили номер кабинета. Заполните его или снимите флажок цен.
«Отправлено» больше нуля, а «принято Маркетом» — ноль, или «Маркет не подтвердил запрос»
Маркет отклонил запрос. Чаще всего у ключа нет нужного доступа, указан чужой номер кампании или SKU на сайте не совпадают с SKU в Маркете. Проверьте права ключа и номер кампании. Если в тексте ошибки есть «Маркет недоступен» — это временная проблема связи, повторите позже.
Много пропусков «без ограничения»
У вариантов включено «без ограничения», и количество неизвестно. Снимите отметку и введите остатки в товарах.
«заказ Маркета … не загружен: SKU … не найден среди артикулов сайта»
В заказе есть товар, артикула которого нет на сайте. Такой заказ не загружается целиком, чтобы не получить неполный заказ. Исправьте артикул на сайте или SKU в Маркете — при следующей проверке заказ загрузится сам.
«загрузка прервалась, заказ на сайте мог не создаться — проверьте его вручную»
Загрузка конкретного заказа оборвалась на середине. Повторно он загружаться не будет, чтобы не создать дубль и не списать остаток дважды. Найдите номер Маркета в разделе «Заказы» и при необходимости внесите заказ вручную.
Вопросы и ответы
Нужно ли отключать YML-выгрузку, если я подключил API?
Нет. YML по-прежнему передаёт в Маркет каталог, а API добавляет остатки, цены и заказы. Следите только за совпадением SKU и артикулов.
Можно ли включить только загрузку заказов?
Да, каждый из трёх флажков работает независимо. Для любого обмена обязательны API-ключ и номер кампании.
Почему цена на Маркете отличается от цены на сайте?
Addshop отправляет цену со скидкой товара. Маркет может показывать покупателю свою цену с учётом собственных акций и скидок — этим управляет Маркет.
Заказ отменили на Маркете, а на сайте он остался. Это ошибка?
Нет, так задумано: отмены и смена статусов Маркета на сайт не переносятся. Отмените заказ на сайте и при необходимости верните остаток.
Безопасно ли хранить ключ в Addshop?
Ключ хранится в настройках магазина и на странице после сохранения не показывается. В журналы ошибок он не попадает — вместо него пишутся звёздочки.