Что такое Y.CMS

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

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

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

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

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

  1. Скачайте с модулем с GitHub.
  2. Откройте панель управления сайтом. В меню слева нажмите Модули, затем Добавить модуль в правом верхнем углу.
  3. Выберите скачанный файл и нажмите Загрузить этот модуль.

    Загрузить модуль

  4. Когда появится надпись «Модуль был успешно загружен», в Списке модулей (на этой же странице) найдите Y.CMS Prestashop. Если модулей много, вбейте в строку поиска «Яндекс».
  5. Нажмите Установить рядом с названием модуля. Откроется окно с надписью «Вы точно хотите установить модуль, не проверенный в PrestaShop?». Выберите Перейти к установке.
  6. Появится надпись «Модули успешно установлены». Готово — можно переходить к настройке.

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

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

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

  1. Откройте панель управления сайтом. В меню слева нажмите Модули, в списке модулей найдите Y.CMS Prestashop и справа от него нажмите Настроить.

    Модули

  2. Откройте вкладку Яндекс.Касса. Поставьте «Да» в графе Включить прием платежей через Яндекс.Кассу и выберите Рабочий режим.

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

    Включить прием платежей

  3. Из личного кабинета Яндекс.Кассы скопируйте Shop ID, scid, ShopPassword, которые вы получили после подключения.
  4. Выберите удобный сценарий оплаты:
    • Выбор способа оплаты на стороне сервиса Яндекс.Касса
    • Выбор способа оплаты на стороне магазина
    Подробнее о сценариях оплаты

    Выбор сценария оплаты

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

    Первый сценарий оплаты

    Если вы выбрали сценарий оплаты «на стороне магазина», поставьте галочки напротив тех способов оплаты, которые указаны в вашем договоре с Яндекс.Деньгами.

    Второй сценарий оплаты

  6. Если нужно, поменяйте минимальную сумму заказа. Нажмите Сохранить внизу страницы. Готово: можно проверять прием платежей на сайте.

    Минимальная сумма заказа

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

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

  1. Откройте панель управления сайтом. В меню слева нажмите Модули, в списке модулей найдите Y.CMS Prestashop и справа от него нажмите Настроить.

    Настроить

  2. Откройте вкладку Яндекс.Касса: Управление заказами и скачайте там готовый запрос на сертификат (файл в формате .csr).
  3. Скачайте и заполните заявку на сертификат (данные для заполнения вы найдете в таблице на этой же странице), распечатайте, поставьте подпись и печать.

    Заявка на сертификат

  4. Отправьте файл запроса вместе со сканом готовой заявки менеджеру Яндекс.Кассы на merchants@yandex.money.ru.
  5. Когда менеджер пришлет сертификат, загрузите его на этой же странице (кнопка Загрузить). После этого сможете делать возвраты платежей по инструкции из следующего раздела.

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

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

  1. В меню слева нажмите Заказы. Откроется страница со списком заказов: найдите в нем тот, за который хотите вернуть деньги.
  2. Рядом с кнопкой Просмотр откройте выпадающий список и выберите Управление заказом.
  3. Откроется вкладка Возврат: напишите, какую сумму хотите вернуть, и почему. Это сообщение увидит клиент.

    Возврат

  4. Нажмите Сделать возврат. Если всё в порядке, появится сообщение «Платеж успешно возвращен».

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

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

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

  1. В панели управления сайтом кликните Модули, в списке модулей найдите Y.CMS Prestashop и справа от него нажмите Настроить.

    Модуль

  2. Откройте вкладку Яндекс.Деньги. Поставьте «Да» в графе Включить прием платежей в кошелек на Яндексе.

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

    Включить прием платежей

  3. В поле Номер кошелька укажите кошелек на Яндексе, в который будут поступать деньги.
  4. Значения ID приложения и Секретное слово нужно получить на сайте Яндекс.Денег.
    Для этого пройдите по ссылке и заполните поля:
    Название — это название вашего магазина. Его увидит пользователь.
    Адрес сайта — это сайт, на котором вы будете принимать платежи.
    Email для связи — ваша электронная почта.
    Redirect URI — это RedirectURL в настройках модуля (просто скопируйте и вставьте эту ссылку).

    RedirectURL

    Логотип загружать необязательно, но с ним пользователи быстрее узнают ваш сервис.
    Использовать проверку подлинности приложения — обязательно поставьте галочку.
    Когда заполните все поля на странице регистрации, нажмите Подтвердить. Сайт сгенерирует ID и Секретное слово: скопируйте их в настройки модуля.

    Генерация

  5. Если нужно, укажите минимальную сумму заказа. Нажмите Сохранить внизу страницы. Готово, можно проверять прием платежей.

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

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

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

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

    Создание приложения

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

    Список прав

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

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

    Callback URL

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

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

  1. В панели управления сайтом нажмите Модули, в списке модулей найдите Y.CMS Prestashop и справа от него кликните Настроить.

    Модуль

  2. Откройте вкладку Яндекс.Метрика. В графе Активность поставьте Enabled («Включено»).
  3. Укажите данные магазина:
    Номер счетчика вы получили при создании счетчика на сайте Яндекс.Метрики.
    ID приложения и Пароль приложения нужно получить на странице создания приложения. Инструкция
    Токен QAuth заполняется щелчком по ссылке «Получить токен для доступа к Яндекс.Метрике».

    Данные магазина

  4. Отметьте галочками, что вам потребуется от Метрики (графа Настройки), и цели, для которых будет собираться статистика.

    Настройка Метрики

  5. Нажмите Сохранить. Готово — модуль будет собирать статистику для вашего сайта.

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

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

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

  1. В панели управления сайтом нажмите Модули, в списке модулей найдите Y.CMS Prestashop и справа от него кликните Настроить.

    Модуль

  2. Откройте вкладку Яндекс.Маркет. В графе Упрощенный YML поставьте Выключено (настройку нужно будет поменять, если попросят специалисты Яндекс.Маркета).

    Упрощенный YML

  3. Отметьте, по какому принципу выгружать товары на Маркет: либо все сразу, либо выбранные категории. Если вы указали «Выбранные», отметьте товары или категории товаров, которые нужно выгрузить.
  4. Напишите название своего магазина.
  5. Укажите стоимость доставки товара в домашнем регионе:
    • пишите в графе только цифры — ваша «валюта по умолчанию» добавится на Маркете: например, «руб.» или «грн»,
    • если стоимость зависит от района, пишите максимально возможную стоимость доставки,
    • если доставка бесплатная, поставьте 0. Если доставки нет, поставьте любую цифру.
300 руб., на заказ
Самовывоз
Показать телефон
  1. Выберите, какое описание товара выгружать: полное или короткое.
  2. Графа Доступность отвечает за сроки поставки товаров в пункт самовывоза. Отметьте нужный пункт.
    Все доступны Любой товар может быть доставлен в пункт самовывоза в течение двух дней.
    Доступны если > 0, остальные на заказ Товары, которые есть в наличии, будут доставлены в пункт самовывоза в течение двух дней. Для остальных срок поставки будет «на заказ».
    Если = 0, не выгружать Самовывоза нет.
    Всё на заказ Для всех товаров срок поставки будет «на заказ».

    Доступность

  3. В выпадающем списке выберите параметр, который на вашем сайте соответствует параметру Vendor («Производитель»).
  4. В разделе Настройки отметьте галочками нужные опции.
    Экспортировать только товары в наличии Будут выгружаться только те товары, которые есть в наличии (наличие проверяется по статусам на вашем сайте).
    Исключить неактивные категории Если товара нет в наличии, он не будет выгружаться.
    Экспорт комбинаций товара Товар будет выгружаться во всех цветах и размерах, которые есть в вашем магазине.
    Например, если вы продаете красные и зеленые ботинки одной модели, в Маркете будут созданы страницы и для красной, и для зеленой пары.
    Отображать размеры товара (dimensions) В карточке товара на Маркете будут указаны ширина, длина и высота товара в упаковке (если они указаны у вас на сайте).
    Экспорт свойств товара В карточке вашего товара на Маркете будут те же самые параметры, что и в карточке товара на вашем сайте.
    Выгружать все валюты? (Если нет, выгрузится только по умолчанию) Поставьте галочку, если хотите, чтобы Маркет использовал ваши цены в других валютах. Если галочки не будет, конвертация будет проходить автоматически: по курсу Центробанка страны, которая указана в настройках вашего магазина.
    Подробнее о валюте и конвертации — на странице currencies (помощь Маркета).
    Gzip сжатие Поставьте галочку, если у вас больше 10 000 товаров — так Маркет быстрее обработает список.
    Возможность купить в розничном магазине Поставьте галочку, если у вас есть офлайн-магазины с таким же ассортиментом.
    Возможность доставки соответствующего товара Поставьте галочку, если у вас есть доставка в домашнем регионе.
    Возможность зарезервировать и забрать самостоятельно Поставьте галочку, если у вас есть самовывоз.

    Выберите нужные настройки

  5. Нажмите Сохранить. Когда сверху появится надпись «Все настройки верно заполнены!», прокрутите страницу вниз и скопируйте ссылку из поля Файл yml.
  6. В настройках своего магазина на partner.market.yandex.ru нажмите Ассортимент, затем Прайс-лист и Указать ссылку. Появится поле: вставьте в него скопированную ссылку Файл yml и нажмите Импортировать.

    Импорт

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

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

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

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

    Создание приложения

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

    Настройка прав

    Callback URL — скопируйте URL из поля Ссылка для приложения во вкладке Заказы в Маркете (настройки Y.CMS PrestaShop).

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

    Callback URL

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

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

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

Затем:

  1. В панели управления сайтом нажмите Модули, в списке модулей найдите Y.CMS Prestashop и справа от него кликните Настроить.

    Модуль

  2. Авторизационный токен Яндекс.Маркет скопируйте в настройках вашего магазина в Яндекс.Маркете (Заказ на Маркете, затем Настройки API заказа).

    Авторизационный токен

  3. Отметьте галочками способы, которыми можно расплатиться в вашем магазине.
  4. Скопируйте URL партнёрского API Яндекс.Маркет. Перейдите на partner.market.yandex.ru, нажмите Заказ на Маркете, затем — Настройки API заказа. Скопированную ссылку вставьте в поле URL API и справа нажмите Сохранить.

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

  5. Вернитесь к настройкам модуля. Поставьте галочку Включить смену доставок: когда вы (по просьбе клиента) измените способ доставки в панели управления, он автоматически поменяется на Маркете.

    Настройки модуля

  6. Номер кампании скопируйте в настройках Яндекс.Маркета (под названием магазина) — без «11 —» в начале.
  7. Напишите логин на Яндексе, под которым вы регистрировали магазин в Маркете.
  8. ID приложения и Пароль приложения нужно получить на странице создания приложения. Инструкция
  9. Идентификатор пункта самовывоза — это номер пункта самовывоза в списке ваших точек продаж на Маркете. Если пункта самовывоза нет, оставьте поле пустым.

    Настройки

  10. В выпадающих списках Тип доставки установите соответствие между вашими способами доставки и способами, которые есть на Маркете.
  11. Нажмите Сохранить. Готово, можно проверять работу «Заказа на Маркете».

    Сохранение