Яндекс Чекаут (YCP) для Shop-Script

Как подключить Яндекс Чекаут к Shop-Script

В этой инструкции последовательно разберём подключение магазина, сопоставление товарного фида, оплату, доставку и проверку результата. Названия и расположение отдельных полей могут отличаться в зависимости от версии плагина.

1. Установите плагин и выберите витрину

1. Откройте административную часть Webasyst, перейдите в «Инсталлер», найдите «YCP Яндекс Чекаут» и установите плагин.
2. Откройте приложение Shop-Script, затем раздел «Плагины» и в списке слева выберите «YCP Яндекс Чекаут».
3. В поле «Витрина» выберите адрес магазина, который подключаете к Яндекс Чекауту. Для базовой версии выбирается одна витрина.
4. Если на странице показано название профиля, оставьте понятное имя, например «Основной профиль». В Premium при работе с несколькими витринами используются отдельные профили; перед изменениями проверяйте, какой профиль открыт.
5. Пока не переходите к проверке подключения: сначала нужно заполнить адрес и общий токен и сохранить настройки.

2. Настройте адрес и токен подключения

1. Откройте вкладку «Подключение». Убедитесь, что выше выбрана нужная витрина: после выбора появится «Адрес для кабинета Яндекс Чекаута».
2. Скопируйте этот адрес и укажите его в кабинете Яндекс Чекаута в поле адреса API магазина. Копируйте адрес целиком, включая завершающую часть пути.
3. Поле «Префикс адреса» обычно менять не нужно. Если вы всё же изменили его, заново скопируйте получившийся адрес и обновите его в кабинете Яндекса.
4. Рядом с полем «Токен доступа» нажмите «Сгенерировать». Скопируйте полученный токен и укажите точно такое же значение в настройках подключения в кабинете Яндекс Чекаута.
5. Включите «Плагин принимает запросы от Яндекса» и нажмите «Сохранить настройки». Сохраните изменения и в кабинете Яндекса.
6. После сохранения вернитесь в плагин и нажмите «Проверить подключение». Прочитайте результат рядом с кнопкой. Проверка обращается к сохранённому адресу с сохранённым токеном, поэтому после изменения этих данных их нужно сначала сохранить.

3. Сопоставьте товарный фид

Яндекс передаёт идентификатор товара из фида. Плагину нужно понимать, как по этому значению найти товар или артикул в Shop-Script.

1. Откройте вкладку «Товарные фиды» и нажмите «Выбрать фид».
2. Выберите профиль фида, который фактически загружен в Яндекс Товары. Если нужного источника в списке нет, выберите «Другой источник» и укажите полный URL фида вручную.
3. В поле «Сопоставление offer id» выберите формат идентификатора, который используется именно в этом фиде: ID товара, ID артикула, код артикула либо смешанный формат market.
4. Если вы добавляете несколько фидов, проверьте правило для каждого отдельно. Поле «Сопоставление по умолчанию» используется там, где индивидуальное правило не выбрано.
5. Нажмите «Сохранить настройки», затем «Проверить и обновить индекс». Дождитесь результата и убедитесь, что плагин показывает количество найденных предложений.
6. Если идентификаторы в фиде состоят только из цифр, не определяйте формат на глаз: проверьте настройки экспорта или обратитесь к специалисту, который создавал фид.
7. После изменения или обновления фида повторно обновите индекс. Недоступные предложения и предложения с отключённым оформлением через Чекаут в индекс не включаются.

4. Выберите способы оплаты

1. Откройте вкладку «Оплата». В некоторых версиях она называется «Товары и оплата».
2. В поле «Способ оплаты при онлайн-оплате» выберите способ Shop-Script, которым должны отмечаться заказы, оплаченные онлайн в Яндекс Чекауте.
3. В поле «Способ оплаты при оплате при получении» выберите подходящий способ магазина для оплаты при получении, если вы её используете.
4. Если нужного варианта нет в списке, сначала создайте или включите способ оплаты в настройках Shop-Script, затем вернитесь в плагин и выберите его.
5. Сохраните настройки. При проверке заказа убедитесь, что выбранный способ отображается в карточке заказа корректно.

5. Укажите склад и схему доставки

1. Откройте «Логистика». В блоке «Схема доставки» выберите, кто рассчитывает доставку: магазин или Яндекс. При делегировании расчёта Яндексу магазин не передаёт собственные варианты тарифов.
2. Если доставку рассчитывает магазин, включите «Доставка по YCP протоколу», а затем необходимые варианты: «Курьерская доставка» и/или «Доставка до ПВЗ». Эти же способы должны быть включены в кабинете Яндекс Чекаута.
3. В блоке «Склад» заполните название, телефон, часовой пояс и адрес склада. Яндекс получает эти данные через подключение к магазину.
4. Проверьте «Внешний код склада в Яндекс Чекауте». Не меняйте его без необходимости после подключения: изменение может привести к появлению нового склада вместо прежнего.
5. В блоке «Остатки и склад» проверьте источник остатков. В базовой версии используется общий режим остатков; выбор конкретных физических складов относится к Premium.
6. Если покупатели могут забирать заказ непосредственно со склада, включите «Самовывоз со склада доступен» и заполните часы работы. Это отдельная настройка от доставки до ПВЗ.

6. Настройте тарифы, пункты выдачи и сопоставление

1. В разделе «Тарифы и ПВЗ» найдите «Источник тарифов». В фиксированном режиме укажите название варианта, стоимость и сроки вручную.
2. Для динамического расчёта выберите соответствующий режим и отметьте включённые способы доставки Shop-Script. Если ничего не отмечено, плагин проверяет все включённые способы.
3. Если ваши способы доставки поддерживают пункты выдачи и вы хотите передавать их Яндексу, включите «Подтягивать ПВЗ из выбранных способов доставки».
4. Откройте «Инструменты ПВЗ» и нажмите «Пересобрать каталог ПВЗ сейчас». Дождитесь завершения и проверьте количество и состояние по службам. Наличие пункта в каталоге само по себе не гарантирует доступность тарифа для конкретной корзины.
5. Для регулярного обновления настройте cron-команду, показанную в этом же разделе плагина. Рекомендуемый интервал — раз в шесть часов. Если вы не настраивали cron раньше, передайте команду администратору хостинга.
6. Если пункты не импортируются из службы, при необходимости заполните «Ручной пункт выдачи»: код, название, адрес, координаты, стоимость и сроки. Проверьте введённые значения.
7. В блоке «Сопоставление служб доставки» выберите способы Shop-Script, которые должны указываться в заказах для соответствующих вариантов получения.
8. Нажмите «Сохранить настройки» и проверьте итоговые варианты доставки в кабинете и тестовом сценарии оформления.

7. Сопоставьте статусы заказов

1. Откройте вкладку «Статусы».
2. В разделе «Яндекс → Shop-Script» выберите действия, которые магазин должен выполнить после онлайн-оплаты, отмены и отметки о доставке в Яндекс Чекауте.
3. В разделе «Shop-Script → Яндекс» напротив каждого статуса магазина выберите соответствующее состояние YCP. Сверяйте смысл статусов с вашим рабочим процессом: названия в кабинете Яндекса могут отличаться.
4. Сохраните настройки. При проверке заказа убедитесь, что каждое используемое событие приводит к ожидаемому изменению статуса.

8. При необходимости включите кнопку на сайте

Вывод кнопки «Купить в Яндексе» на витрине доступен в Premium-версии. Для базового подключения YCP настраивать этот раздел не обязательно.

1. Откройте вкладку «Кнопка купить в Яндексе» и выберите, на каких витринах показывать кнопку.
2. В блоке «Кнопка в карточке товара» включите показ, задайте текст и выберите режим вывода. Аналогично настройте блок «Кнопка в корзине», если она нужна в корзине.
3. При автоматическом режиме плагин использует поддерживаемый темой хук. Если кнопка не появилась в нужном месте, проверьте поддержку хука темой или используйте ручной режим и хелпер из настроек плагина.
4. При необходимости настройте цвета и скругление. Сохраните настройки и проверьте кнопку на карточке товара и в корзине.
5. Проверьте состав и сумму корзины при переходе. Если покупатель меняет товары или количество уже в Чекауте, ранее переданные скидки не пересчитываются; для нового расчёта нужно вернуться в корзину магазина.

9. Проверьте подключение и обработку заказа

1. В разделе «Прочее» укажите резервные вес и габариты, если они нужны для товаров без заполненных размеров. Проверьте единицы измерения рядом с полями.
2. На вкладке «Отладка» запустите «Полная самодиагностика YCP». Она проверяет настройки и локальный контракт без создания реального заказа. Исправьте найденные ошибки и повторите проверку.
3. Проверьте товар: он должен присутствовать в выбранном фиде, иметь корректную цену и быть доступным к покупке.
4. Пройдите предусмотренный Яндексом тестовый сценарий оформления и убедитесь, что заказ появляется в Shop-Script с ожидаемыми товарами, оплатой и доставкой. Если сценарий создаёт настоящий заказ или платёж, выполняйте его только при готовности обработать и затем отменить такой заказ.
5. Для диагностики при необходимости временно включите «Режим отладки» и проверьте журнал последних запросов. После устранения проблемы выключите отладку.

Если что-то не получилось

Не проходит подключение. Проверьте выбранную витрину, полный адрес API и совпадение токена в плагине и кабинете Яндекса. Сохраните оба набора настроек и повторите проверку.

Товар не найден. Сверьте, что в плагине выбран тот же фид, который использует Яндекс, а формат offer id соответствует экспорту. Обновите индекс и проверьте доступность предложения.

Нет доставки или ПВЗ. Проверьте выбранную схему расчёта, включение нужного вида доставки в плагине и кабинете, работу служб Shop-Script и состояние каталога ПВЗ.

Кнопка не появилась. Убедитесь, что доступна Premium-версия, включён вывод для нужной витрины и тема поддерживает выбранный способ вывода.