Инструкция по настройке модуля Y.CMS для WebAsyst

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


Яндекс.Касса: позволяет принимать платежи на расчетный счет и делать возвраты (по договору, для юрлиц и ИП).

Яндекс.Деньги: позволяет принимать платежи на кошелек в Яндекс.Деньгах (без заключения договора, для всех).

Яндекс.Платежка: позволяет принимать платежи на счет компании (без договора, для юрлиц и ИП).

Яндекс.Метрика: позволяет собирать данные о кликах и поведении пользователей.

Яндекс.Маркет: модуль поможет разместить товары в Яндекс.Маркете и подключиться к программе «Заказ на Маркете».


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

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

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

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

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

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

Чтобы настроить прием платежей по этой инструкции, нужно подключиться к Яндекс.Кассе и получить shopId и Секретный ключ.

  • shopId появится в личном кабинете Кассы сам, когда вы подключитесь к сервису,
  • секретный ключ нужно самостоятельно выпустить и активировать в личном кабинете Кассы. Подробнее в Помощи Кассы

Когда у вас будут оба этих параметра, можно переходить к настройке.

  1. В панели управления сайтом выберите Магазин — Плагины — Y.CMS Shop-Script (2.0).
  1. Откройте вкладку Яндекс.Касса. Поставьте галочку Включить прием платежей через Яндекс.Кассу.
  1. Заполните поля shopId и Секретный ключ: оба параметра можно взять в личном кабинете Яндекс.Кассы.
  2. Отметьте удобный сценарий выбора способа оплаты:
    • На стороне Яндекс.Кассы (пример можно посмотреть в демо-магазине),
    • На стороне магазина.
      Пример выбора способа оплаты на стороне магазина
  1. Если вы выбрали первый сценарий, кнопку оплаты можно назвать «Заплатить через Яндекс»: поставьте для этого галочку.

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

  1. Если нужно, включите отправку данных для чеков. Это настройка для тех, кто работает с решением Кассы для 54-ФЗ.

Для чека потребуется ставка НДС: если вы включили отправку данных для чеков, модуль предложит сопоставить ставки в вашем магазине и ставки в Кассе.

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

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

Вы можете вернуть деньги покупателю, если заказ оплатили через Яндекс.Кассу одним из этих способов: банковские карты, Яндекс.Деньги, WebMoney, Альфа-Клик, MasterPass, QIWI Wallet, КупиВкредит.

Чтобы вернуть деньги полностью:

  1. В панели управления сайтом нажмите Заказы и выберите нужный заказ.
  1. На странице заказа будет вкладка Возврат: укажите причину (это сообщение отправится покупателю) и нажмите Сделать возврат.

Вернуть деньги частично можно только из личного кабинета Яндекс.Кассы. Инструкция на сайте Яндекс.Кассы

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

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

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

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

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

    • «Название» — это название вашего магазина. Его увидит пользователь.
    • «Адрес сайта» — это сайт, на котором вы будете принимать платежи.
    • «Email для связи» — ваша электронная почта.
    • «Redirect URI» — это RedirectURL в настройках модуля (просто скопируйте эту ссылку).
    • «Логотип» загружать необязательно, но с ним пользователи быстрее узнают ваш сервис.
    • «Использовать проверку подлинности приложения» — обязательно поставьте галочку.

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

Яндекс.Платежка

Настройка приема платежей через Платежку состоит из трех этапов:

  1. На сайте Платежки получите настройки платежной формы.
  2. Пропишите эти настройки в панели управления сайтом.
  3. Заплатите за работу формы.

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

  1. На сайте Платежки заполните шаблон формы: в поле Название товара или услуги напишите «Оплата заказа». Поле Сумма заполнять не нужно, добавлять другие товары или  дополнительные поля тоже не нужно — все уже учтено в вашей CMS.

    Как выглядит шаблон формы
  1. Нажмите Продолжить и на открывшейся странице заполните анкету компании. Нужно указать:
    • юридическое название и ИНН вашей компании,
    • реквизиты счета,
    • электронную почту: на нее будут приходить сообщения о платежах,
    • сайт, на котором вы планируете принимать платежи через Платежку.

    Как выглядит анкета компании
  1. Нажмите Создать форму. Реквизиты, сайт и другие данные, которые вы указали, отправятся на проверку. Она займет пару минут.
  2. Если всё в порядке, вам придет электронное письмо с параметрами формы и реквизитами для лицензионного платежа.
  3. Как выглядит письмо

Как прописать настройки в панели управления

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

Как оплатить работу формы

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

Готово, можно принимать платежи.

Важно: один лицензионный платеж действует на все формы, которые вы соберете для своей компании (проверяем по ИНН, который вы указываете при создании формы). Ограничения по количеству и размеру платежей тоже действуют на все формы сразу.

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

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

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

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

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

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

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

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

    Права — выберите «Яндекс.Метрика» и отметьте пункты:
    • «Получение статистики, чтение параметров своих и доверенных счётчиков»,
    • «Создание счётчиков, изменение параметров своих и доверенных счётчиков».

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

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

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

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

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


  4. Номер счетчика вы получили при создании счетчика на сайте Яндекс.Метрики.

    ID приложения и Пароль приложения нужно получить на странице создания приложения. Инструкция

    Токен QAuth заполняется щелчком по ссылке «Получить токен».
  1. Отметьте галочками, что вам потребуется от Метрики (графа Настройки), и цели, для которых будет собираться статистика.
  2. Нажмите Save. Готово — модуль будет собирать статистику для вашего сайта.

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

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

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

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

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

Подробнее о валюте и конвертации — на странице currencies (помощь Маркета).
Возможность купить в розничном магазине Поставьте галочку, если у вас есть офлайн-магазины с таким же ассортиментом.
Возможность доставки соответствующего товара Поставьте галочку, если у вас есть доставка в домашнем регионе.
Возможность зарезервировать и забрать самостоятельно Поставьте галочку, если у вас есть самовывоз.
  1. Нажмите Save. Когда сверху появится надпись «Все настройки верно заполнены!», прокрутите страницу вниз и скопируйте Ссылку на динамический yml.
  2. li В настройках своего магазина на partner.market.yandex.ru нажмите «Ассортимент», затем «Прайс-лист» и «Указать ссылку». Появится поле: вставьте в него скопированную «Ссылку для выгрузки товаров на Маркет» и нажмите «Импортировать».

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

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

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

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

    Название — это название компании, его увидит пользователь.

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

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

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

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

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

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

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

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

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

Затем:

  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. Готово — можно проверять работу «Заказа на Маркете».