! Обратите внимание, для новых пользователей ПланФикса, которые устанавливают коннектор после изменений и внедрения в ПланФикс сущности Объект, Инструкция доступна по ссылке.
Для подключения
коннектора необходимо подключить Аккаунт ПланФикс. Как это сделать смотрим по ссылке.
Видео инструкция подключения и настройки коннектора
доступна по ссылке.
Далее необходимо подключить сервис ЮКасса на сайте getupd.io вкладка Аккаунты.
Нажимаем Добавить и переходим в настройки.
Где:
Название — произвольное название подключения.
ID магазина — ID вашего магазина на сайте
yookassa.ru
API ключ — API ключ на сайте yookassa.ru
Подключив аккаунт Юкасса, переходим во вкладку Коннекторы, Создать коннектор.
Переходим в ПланФикс.
Для работы с ЮКасса,
нам нужно создать новый шаблон документа, с полями: URL Возврата,
Сумма платежа, Статус платежа, Платежная
ссылка.
Обратите
внимание - при создании нового поля в шаблоне есть параметр "Тип
поля". Для полей Платежная ссылка и Статус оплаты - тип поля можно не
менять, по умолчанию будет Строка.
Для поля Сумма
платежа тип поля - число.
! При создании поля Платежная ссылка, советую перевести триггер Отображать как гиперссылку в состояние Включен и выбрать https протокол.
Теперь будем создавать
кнопку.
В ПланФикс переходим в Настройки — Управление аккаунтом — Процессы задач — Стандартный — Кнопки — Новая кнопка.
! Обратите внимание, для новых пользователей ПланФикса, которые устанавливают коннектор после изменений и внедрения в ПланФикс сущности Объект, настройка кнопки производиться в Настройки / Управление аккаунтом / Объекты / Стандартный (или ваш Объект) / Кнопки / Нажимаем создать Новую кнопку. Инструкция доступна по ссылке.
Указываем название
кнопки.
В п. 3 выбираем кто видит кнопку и может на нее нажимать.
В п. 5 выбираем послать HTTP запрос.
Далее интересно, будем
копировать данные из настроек коннектора.
Возвращаемся на сайт getupd.io. Будем копировать вот эти данные.
Копируем URL и вставляем его в поле URL в ПланФикс.
Теперь будем заполнять поле Содержимое запроса. Это значит, что нужно скопировать Параметр запроса и затем найти его значение. Все по порядку. Заполненное поле у нас должно выглядеть так:
У нас есть 6 параметров.
task_id, customerPhone, customerEmail, vatCode, currency, paymentDescription. Каждый параметр у нас должен быть в отдельной
строке, его вы можете просто скопировать.
Для трех параметров
переменную нужно указать согласно ваших настроек, это task_id, customerPhone, customerEmail.
vatCode — это цифровой
параметр.
currency — это валюта
RUB
paymentDescription — это Описание платежа.
Итак, первый параметр
это task_id - это id задачи,
В этом же блоке нажимаем Различные поля.
у нас откроется список доступных переменных. Выбираем Задача и затем идентификатор.
Копируем переменную
{{Задача.Идентификатор}} или нажимаем Вставить переменную. Только курсор должен
стоять в поле для переменной т.е. в поле Значение.
Далее, нажимаем Добавить, и ищем переменную для параметров customerPhone, customerEmail.
и
Далее как на скриншоте.
Ваш vatCode. Если не знаете, переходите в настройки коннектора и кликаете по слову НДС.
Вас перебросит на страницу ставок НДС.
У нас остается одна
переменная указанная в настройках. Это itemDescription - Товар в чеке.
Может использоваться вместо аналитики Товар.
Эту переменную нужно будет указать если у вас всего 1 товар. И
значение ее может быть примерно таким: {{Задача.Название}}.
Если товаров несколько, то ее не указываем.
Отлично. Еще немного настроек и все будет работать 🙂
Нам осталось подставить Заголовки. Content-Type у нас указан, нажимаем Добавить. С настроек коннектора копируем и вставляем сам Заголовок Webhook-Token, затем его значение.
Для корректной работы ставим галочки.
Сохраняем. Кнопка создана.
Возвращаемся в настройки коннектора, будем выбирать параметры.
Первым делом выбираем тот шаблон, в котором мы создали новые
поля. У меня шаблон так и называется ЮКасса. Как только я его выбрала, можно
настроить Поля шаблона. Название Поля слева, должно соответствовать выбранному
значению.
Вот так:
Сохраняем.
Итак, если у вас 1 товар, услуга, разовые платежи, то можно не подключать Аналитики, и должна быть прописана переменная itemDescription при создании кнопки. В этом случае коннектор уже готов к работе.
В случае, если у вас есть потребность давайте подключим
Аналитики.
Переходим в ПланФикс, Настройки
— Управление аккаунтом — Аналитики.
Создаем новую группу.
У меня это группа ЮКасса. И теперь в этой группе я создаю
Аналитики по, например, по своим услугам.
В этой аналитике мне нужно создать поля, которые мы
впоследствии, выберем в настройках коннектора. Это поля: название товара,
количество и цена.
У вас должно получиться вот так:
Обратите внимание, обязательно укажите корректный тип поля, и
советую перевести триггер в положение Обязательный для заполнения.
Отлично. Мы создали Аналитику!
Переходим к настройкам коннектора и заполним поля аналитик
товара.
Для начала нужно выбрать Аналитику товара, и затем выбрать значения полей аналитик, выбранное значение соответствует названию поля слева.
При необходимости настраиваем время запуска коннектора.
Сохраняем.
Готово, мы подключили и настроили коннектор!
Как это работает.
Проверим. Я создала задачу Платеж. Указала сумму, нажала на созданную кнопку. У меня отобразилась гиперссылка, и статус Ожидании оплаты.
Перехожу по ссылке.
Отлично! Оплата прошла успешно.
Давайте проверим статус в ПланФикс.
А теперь мы воспользуемся Аналитиками.
Указываем сумму, нажимаем созданную кнопку.
Готово.
Коннектор «ЮКасса»
готов к работе.
С дополнительными
вопросами по работе сервиса обращайтесь на почту mailbox@getupd.io или нажмите в личном кабинете на кнопку
«Обратиться за помощью». Служба поддержки поможет разобраться с первичной
настройкой коннекторов.