Что такое Y.CMS

Y.CMS — это универсальный модуль для интеграции интернет-магазина с сервисами Яндекса.

Установите Y.CMS на вашем сайте и получите сразу четыре модуля. С их помощью можно:

  • принимать платежи и делать возвраты через Яндекс.Кассу (по договору — для юрлиц и ИП),
  • принимать платежи на кошелек в Яндекс.Деньгах (без заключения договора),
  • настраивать сбор данных через Яндекс.Метрику,
  • размещать товары в Яндекс.Маркете и участвовать в программе «Заказ на Маркете».

За техническую поддержку и обновление модуля отвечает компания «Яндекс.Деньги».

Установка модуля

  1. Скачайте архив (ss.zip, 75,1 КБ)
  2. Содержимое архива скопируйте в корневую папку сайта на вашем сервере.
Скопируйте в корневую папку
  1. В файл /wa-config/apps/shop/plugins.php добавьте строку 'yamodule' => true,
Добавить строку в файл
  1. Убедитесь, что модуль установлен: для этого откройте панель управления сайтом и в разделе Магазин выберите вкладку Плагины. В левой колонке должна быть строчка Y.CMS Shop-Script.
Убедитесь, что модуль установлен

Если всё верно, можно переходить к настройке модуля.

Яндекс.Касса

Как настроить прием платежей

Чтобы принимать платежи через этот модуль, нужно подать заявку на подключение Яндекс.Кассы, а после — заключить договор с компанией «Яндекс.Деньги».

  1. В панели управления сайтом нажмите Магазин, выберите вкладку Плагины (наверху справа) и нажмите Y.CMS Shop-Script в левом меню.
  2. Откройте вкладку «Яндекс.Касса». Поставьте галочку «Включить прием платежей через Яндекс.Кассу» и выберите «Рабочий режим».
    Обратите внимание: принимать платежи можно либо через Яндекс.Кассу, либо через Яндекс.Деньги. Когда вы включите модуль Кассы, прием платежей через Яндекс.Деньги выключится автоматически (и наоборот).
  3. Из личного кабинета Яндекс.Кассы скопируйте Shop ID, scid, ShopPassword, которые вы получили после подключения.
Укажите данные из личного кабинета
  1. Выберите удобный сценарий оплаты:
    • Выбор способа оплаты на стороне сервиса Яндекс.Касса
    • Выбор способа оплаты на стороне магазина
    Подробнее о сценариях оплаты
  2. Если вы выбрали первый сценарий, кнопку оплаты можно назвать «Заплатить через Яндекс»: для этого просто поставьте галочку.
    Если вы выбрали сценарий оплаты «на стороне магазина», поставьте галочки напротив тех способов оплаты, которые указаны в вашем договоре с Яндекс.Деньгами.
  3. Если нужно, включите отправку данных для чеков. Это настройка для тех, кто работает с решением Кассы для 54-ФЗ.
    Для чека потребуется ставка НДС: если вы включили отправку данных для чеков, модуль предложит сопоставить ставки в вашем магазине и ставки в Кассе.
Отправка данных для чеков
  1. Нажмите Save внизу страницы. Затем откройте вкладку Настройки и выберите раздел Оплата.
Save
  1. Нажмите Добавить способ оплаты и в открывшемся списке выберите Яндекс.Деньги (Y.CMS).
  2. В поле Название способа оплаты напишите Яндекс.Касса, в поле Описание перечислите доступные способы оплаты (например, как на скриншоте ниже). Этот текст увидят ваши клиенты.
Перечислите доступные способы оплаты
  1. Нажмите Сохранить внизу страницы. Готово: можно проверять прием платежей на сайте.

Как настроить возвраты

Когда настроен прием платежей через Яндекс.Кассу, в модуле можно настроить возвраты платежей.

  1. В панели управления сайтом нажмите Магазин, выберите вкладку Плагины (справа наверху) и нажмите Y.CMS Shop-Script в левом меню.
  2. Откройте вкладку «Яндекс.Касса: Управление заказами» и скачайте там готовый запрос на сертификат (файл в формате .csr).
  3. Скачайте и заполните заявку на сертификат (данные для заполнения вы найдете в таблице на этой же странице), распечатайте, поставьте подпись и печать.
  4. Отправьте файл запроса вместе со сканом готовой заявки менеджеру Яндекс.Кассы на merchants@yamoney.ru.
Настройка возвратов
  1. Когда менеджер пришлет сертификат, загрузите его на этой же странице (кнопка «Загрузить») — и сможете делать возвраты платежей по инструкции из следующего раздела.

Как делать возвраты

Когда модуль «Яндекс.Касса: управление заказами» настроен, можно делать возвраты через панель управления сайтом. Для этого:

  1. Перейдите в раздел со списком заказов и выберите нужный.
Заказы
  1. Рядом с номером заказа нажмите Возврат — и всё готово, деньги отправлены клиенту. Информация об этом заказе перемещена в раздел Возврат (меню слева).

Яндекс.Деньги

Как настроить прием платежей в кошелек на Яндексе

С помощью этого модуля можно принимать платежи без договора, в кошелек на Яндексе.

  1. В панели управления сайтом нажмите Магазин, выберите вкладку Плагины и нажмите Y.CMS Shop-Script в левом меню.
  2. Откройте вкладку «Яндекс.Деньги». Поставьте галочку «Включить прием платежей в кошелек на Яндексе».

    Важно: если вы включите прием платежей в кошелек на Яндексе, то прием платежей через Яндекс.Кассу автоматически выключится.

  3. В поле «Номер кошелька» укажите номер кошелька на Яндексе, в который будут поступать деньги.
Укажите номер кошелька
  1. Значения «ID приложения» и «Секретное слово» нужно получить на сайте Яндекс.Денег.

    Для этого пройдите по ссылке и заполните поля:

    «Название» — это название вашего магазина. Его увидит пользователь.

    «Адрес сайта» — это сайт, на котором вы будете принимать платежи.

    «Email для связи» — ваша электронная почта.

    «Redirect URI» — это RedirectURL в настройках модуля (просто скопируйте эту ссылку).

    «Логотип» загружать необязательно, но с ним пользователи быстрее узнают ваш сервис.

    «Использовать проверку подлинности приложения» — обязательно поставьте галочку.

  2. Когда заполните все поля на странице регистрации, нажмите «Подтвердить». Сайт сгенерирует ID и «Секретное слово»: скопируйте их в настройки модуля.
  3. Нажмите Save внизу страницы. Затем откройте вкладку Настройки и выберите раздел Оплата.
  4. Нажмите Добавить способ оплаты и в открывшемся списке выберите Яндекс.Деньги (Y.CMS).
Яндекс.Деньги (Y.CMS)
  1. В поле Название способа оплаты напишите «Яндекс.Деньги», в поле Описание перечислите доступные способы оплаты (например, как на скриншоте ниже). Этот текст увидят ваши клиенты.
Перечислите доступные способы оплаты
  1. Нажмите Сохранить внизу страницы. Готово: можно проверять прием платежей.

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

Как получить параметры для настройки Метрики

Чтобы настроить модуль для сбора статистики, нужно создать приложение для доступа к Метрике и получить его ID и пароль. Новое приложение нужно создать, даже если вы уже делали это для работы с любым другим сервисом Яндекса.

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

Callback URL — скопируйте URL из поля «Ссылка для приложения» во вкладке «Яндекс.Метрика» (настройки Y.CMS Shop-Script).

Не нажимайте «Подставить URL для разработки» — с ним модуль работать не будет.

Подставить URL для разработки
  1. Нажмите «Сохранить». Яндекс выдаст ID и пароль приложения: с ними можно настраивать модуль для работы Яндекс.Метрикой.

Как настроить модуль для работы с Метрикой

  1. В панели управления сайтом нажмите Магазин, выберите вкладку Плагины (справа наверху) и нажмите Y.CMS Shop-Script в левом меню.
  2. Откройте вкладку «Яндекс.Метрика». В графе «Активность» поставьте «Включено».
  3. Укажите данные магазина:
    «Номер счетчика» вы получили при создании счетчика на сайте Яндекс.Метрики.
    «ID приложения» и «Пароль приложения» нужно получить на странице создания приложения (раздел инструкции «Как получить параметры для настройки Метрики»).
    «Токен QAuth» заполняется щелчком по ссылке «Получить токен для доступа к Яндекс.Метрика».
Укажите данные магазина
  1. Отметьте галочками, что вам потребуется от Метрики (графа Настройки), и цели, для которых будет собираться статистика.
  2. Нажмите Save. Готово — модуль будет собирать статистику для вашего сайта.

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

Как выгрузить товары на Маркет

Важно: перед тем, как настраивать модуль, нужно зарегистрировать магазин на Яндекс.Маркете.

Когда магазин зарегистрирован:

  1. В панели управления сайтом нажмите Магазин, выберите вкладку Плагины (справа наверху) и нажмите Y.CMS Shop-Script в левом меню.
Редактировать
  1. Откройте вкладку «Яндекс.Маркет». В графе Упрощенный YML поставьте Выключено (настройку нужно будет поменять, если попросят специалисты Яндекс.Маркета).
  2. Отметьте, по какому принципу выгружать товары на Маркет: либо все сразу, либо выбранные категории. Если вы указали «Выбранные», отметьте товары или категории товаров, которые нужно выгрузить.
Выгружать
  1. Графа Доступность отвечает за сроки поставки товаров в пункт самовывоза. Отметьте нужный пункт.
Все доступны Любой товар может быть доставлен в пункт самовывоза в течение двух дней.
Доступны если > 0, остальные на заказ Товары, которые есть в наличии, будут доставлены в пункт самовывоза в течение двух дней. Для остальных срок поставки будет «на заказ».
Если = 0, не выгружать Самовывоза нет.
Всё на заказ Для всех товаров срок поставки будет «на заказ».
  1. Напишите название своего магазина.
  2. Укажите стоимость доставки товара в домашнем регионе:
    • пишите в графе только цифры — ваша «валюта по умолчанию» добавится на Маркете: например, «руб.» или «грн»,
    • если стоимость зависит от района, пишите максимально возможную стоимость доставки,
    • если доставка бесплатная, поставьте 0. Если доставки нет, поставьте любую цифру.
Бесплатно, до 4 дней
Самовывоз
Показать телефон
  1. Укажите валюту, в которой указываете стоимость товаров. Если нужной валюты в выпадающем списке нет, откройте «Настройки», в меню слева выберите Валюта и добавьте нужную. Затем вернитесь к настройкам Маркета.
  2. В выпадающем списке выберите параметр, который на вашем сайте соответствует параметру Vendor («Производитель»).
  3. В разделе Настройки отметьте галочками нужные опции.
Выгружать
Экспортировать только товары в наличии Будут выгружаться только те товары, которые есть в наличии (наличие проверяется по статусам на вашем сайте).
Экспорт комбинаций товара Товар будет выгружаться во всех цветах и размерах, которые есть в вашем магазине.
Например, если вы продаете красные и зеленые ботинки одной модели, в Маркете будут созданы страницы и для красной, и для зеленой пары.
Экспорт свойств товара В карточке вашего товара на Маркете будут те же самые параметры, что и в карточке товара на вашем сайте.
Выгружать все валюты? (Если нет, выгрузится только по умолчанию) Поставьте галочку, если хотите, чтобы Маркет использовал ваши цены в других валютах. Если галочки не будет, конвертация будет проходить автоматически: по курсу Центробанка страны, которая указана в настройках вашего магазина.
Подробнее о валюте и конвертации — на странице currencies (помощь Маркета).
Возможность купить в розничном магазине Поставьте галочку, если у вас есть офлайн-магазины с таким же ассортиментом.
Возможность доставки соответствующего товара Поставьте галочку, если у вас есть доставка в домашнем регионе.
Возможность зарезервировать и забрать самостоятельно Поставьте галочку, если у вас есть самовывоз.
  1. Нажмите Save. Когда сверху появится надпись «Все настройки верно заполнены!», прокрутите страницу вниз и скопируйте Ссылку на динамический yml.
  2. В настройках своего магазина на partner.market.yandex.ru нажмите Ассортимент, затем Прайс-лист и Указать ссылку. Появится поле: вставьте в него скопированную «Ссылку для выгрузки товаров на Маркет» и нажмите Импортировать.
Импортировать

Если настройки Y.CMS заполнены верно, прайс-лист отправится на проверку к специалистам Яндекс.Маркета. Если есть ошибки, Маркет подскажет, как их исправить.

Как получить параметры для настройки «Заказа на Маркете»

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

  1. Зайдите на страницу создания приложения.
Страница создания приложения
  1. Заполните поля:

    «Название» — это название увидит пользователь.

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

    «Ссылка на иконку» — ссылка на логотип вашего сайта. Добавляйте по желанию.

    «Ссылка на сайт приложения» — ссылка на ваш сайт.

    «Права» — отметьте пункт «Яндекс.Маркет», затем «API Яндекс.Маркета для партнеров».

Заполлнение полей

Callback URL — скопируйте URL из поля «Callback URL» во вкладке «Яндекс.Маркет» (настройки Y.CMS).

Не нажимайте «Подставить URL для разработки» — с ним модуль работать не будет.

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

Как настроить модуль для программы «Заказ на Маркете»

Перед тем, как настраивать модуль, проверьте «Настройки API заказа» на Маркете: чтобы всё заработало, в графе «Тип авторизации» должно быть отмечено «URL», в графе «Формат данных»«JSON».

Настройки API заказа

Затем:

  1. В панели управления сайтом нажмите Магазин, выберите вкладку Плагины и нажмите Y.CMS Shop-Script в левом меню. Откройте вкладку Заказы в Маркете.
Редактировать
  1. «Авторизационный токен Яндекс.Маркет» и «Номер кампании» скопируйте в настройках вашего магазина в Яндекс.Маркете («Заказ на Маркете», затем «Настройки API заказа»). Номер кампании нужно скопировать без «11» в начале.
Заказы на Маркете
  1. ID приложения и Пароль приложения нужно получить на странице создания приложения. Инструкция
  2. Идентификатор пункта самовывоза — это номер пункта самовывоза в списке ваших точек продаж на Маркете. Если пункта самовывоза нет, оставьте поле пустым.
  3. Скопируйте URL партнёрского API Яндекс.Маркет. Перейдите на partner.market.yandex.ru, нажмите Заказ на Маркете, затем — Настройки API заказа. Скопированную ссылку вставьте в поле URL API и справа нажмите Сохранить.
Идентификатор пункта самовывоза
  1. Вернитесь к настройкам модуля (вкладка Заказы в Маркете). Отметьте галочками способы, которыми можно расплатиться в вашем магазине.
  2. В выпадающем списке выберите тип доставки, который на вашем сайте означает доставку курьером.
Тип доставки
  1. Нажмите Save. Когда сверху появится надпись «Все настройки верно заполнены!», найдите графу Авторизационный токен и щелкните по ссылке Получить токен для доступа к программе «Заказ на Маркете». Графа заполнится автоматически — после этого нажмите Save еще раз.
  2. Готово — можно проверять работу «Заказа на Маркете».