http://wiki2.mag.travel/api.php?action=feedcontributions&feedformat=atom&user=WikiSysWiki - Вклад участника [ru]2026-05-14T17:59:15ZВклад участникаMediaWiki 1.28.0http://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B9&diff=1539Настройки событий2025-10-16T11:13:23Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Вкладка "Настройки событий" раздела Администрирование предназначена для управления напоминаниями, а именно: их включение/отключение, настройка отображения, создание шаблонов для отправки sms и e-mail сообщений туристам.<br />
<br />
==Работа в разделе Настройка событий==<br />
<br />
Вкладка "Настройка событий" имеет следующий внешний вид:<br><br />
<br />
[[Файл:Ak_170.png|border|Настройка событий]]<br><br />
<br />
===Настройка отображения событий===<br />
<br />
Для событий имеется несколько настроек:<br />
* Включение/отключение событий;<br />
* Количество дней, за которое необходимо оповестить о событии;<br />
* Отображать напоминание:<br />
** Всем;<br />
** Только офису;<br />
** Только менеджеру;<br />
* Сообщения туристам:<br />
** SMS:<br />
*** включение/отключение отправки SMS;<br />
*** настройка шаблона для отправки SMS;<br />
** E-mail:<br />
*** включение/отключение отправки E-mail;<br />
*** настройка шаблона для отправки E-mail.<br />
<br />
===Создание шаблонов=== <br />
<br />
Для того, чтобы создать или просмотреть шаблон для sms-сообщений или e-mail или отредактировать имеющийся, необходимо нажать на кнопку ''шаблон''.<br />
<br />
====Создание шаблонов для sms сообщений====<br />
<br />
Окно создания и редактирования шаблона для SMS-сообщений позволяет задать формулировку для рассылки по каждому из событий, а также добавить различные параметры для автоматической подстановки данных ([[Настройки_событий#Параметры для шаблонов|подробнее о возможных параметрах]]):<br><br />
<br />
[[Файл:Ak_171.png]]<br><br />
<br />
====Создание шаблонов для e-mail сообщений====<br />
<br />
Окно создания и редактирования шаблона для E-mail сообщений позволяет задать формулировку для рассылки по каждому из событий, а также добавить различные параметры для автоматической подстановки данных ([[Настройки_событий#Параметры для шаблонов|подробнее о возможных параметрах]]):<br><br />
<br />
[[Файл:Ak_172.png]]<br><br />
<br />
В данном окне имеются расширенные возможности для настройки шаблона. Благодаря верхней панели инструментов, имеется возможность настраивать шрифты, добавлять нумерованные/маркированные списки, таблицы, изображения, прикреплять ссылки и т.д.<br />
<br />
=====Привязка параметров-ссылок к тексту сообщения=====<br />
<br />
Существует возможность прикреплять параметры-ссылки к тексту шаблона при помощи кнопки [[Файл:Ak_394.png|Insert Link]].<br><br />
Например, такой параметр, как ссылка на оплату путёвки через платёжную систему, можно оформить следующим образом:<br><br />
<br />
[[Файл:Ak_395.png]]<br><br />
<br />
К слову "ССЫЛКА" прикреплен параметр {AppexLink}, который автоматически добавляется при формировании письма.<br><br />
<br />
[[Файл:Ak_396.png]]<br><br />
<br />
Таким образом, клиент получит инструкцию по оплате путёвки в удобном формате, без громоздких ссылок:<br><br />
<br />
[[Файл:Ak_397.png|border]]<br><br />
<br />
==Параметры для шаблонов==<br />
<br />
===Общие===<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {agencyname}<br />
| Наименование фирмы-владельца<br />
<br />
|- style="vertical-align:text-top"<br />
| {agencyphones}<br />
| Телефон фирмы-владельца<br />
<br />
|- style="vertical-align:text-top"<br />
| {agencyemail}<br />
| E-mail фирмы-владельца<br />
<br />
|- style="vertical-align:text-top"<br />
| {greeting}<br />
| Выбор слова-обращения в зависимости от пола главного туриста (Уважаемый/Уважаемая)<br />
<br />
|- style="vertical-align:text-top"<br />
| {country}<br />
| Страна по путёвке<br />
<br />
|- style="vertical-align:text-top"<br />
| {city}<br />
| Город по путёвке<br />
|}<br />
<br />
===События по путёвкам===<br />
<br />
Данные параметры доступны и для событий по платежам.<br><br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {code}<br />
| Номер путёвки<br />
<br />
|- style="vertical-align:text-top"<br />
| {datecreate}<br />
| Дата создания путёвки<br />
<br />
|- style="vertical-align:text-top"<br />
| {datebeg}<br />
| Дата заезда по путёвке<br />
<br />
|- style="vertical-align:text-top"<br />
| {dateend}<br />
| Дата завершения тура<br />
<br />
|- style="vertical-align:text-top"<br />
| {paymentdate}<br />
| Крайняя дата оплаты<br />
<br />
|- style="vertical-align:text-top"<br />
| {documentdate}<br />
| Дата сдачи документов<br />
<br />
|- style="vertical-align:text-top"<br />
| {operator}<br />
| Туроператор по путевке/заявке<br />
<br />
|- style="vertical-align:text-top"<br />
| {operatorlegal}<br />
| Юр.лицо туроператора по путевке/заявке<br />
<br />
|- style="vertical-align:text-top"<br />
| {request}<br />
| Номер заявки ТО<br />
<br />
|- style="vertical-align:text-top"<br />
| {days}<br />
| Продолжительность путёвки в днях<br />
<br />
|- style="vertical-align:text-top"<br />
| {nights}<br />
| Продолжительность путёвки в ночах<br />
<br />
|- style="vertical-align:text-top"<br />
| {agreementmanager}<br />
| Ведущий менеджер по путёвке<br />
<br />
|- style="vertical-align:text-top"<br />
| {partner}<br />
| Покупатель юр.лицо<br />
<br />
|- style="vertical-align:text-top"<br />
| {partnerlegal}<br />
| Юр.лицо покупателя<br />
<br />
|- style="vertical-align:text-top"<br />
| {greetingmain}<br />
| Выбор слова-обращения в зависимости от пола главного туриста (Уважаемый/Уважаемая)<br />
<br />
|- style="vertical-align:text-top"<br />
| {maintouristfullname}<br />
| Фамилия Имя Отчество главного туриста<br />
<br />
|- style="vertical-align:text-top"<br />
| {maintouristshortname}<br />
| Имя Отчество главного туриста<br />
<br />
|- style="vertical-align:text-top"<br />
| {tourists}<br />
| Туристы по путёвке<br />
<br />
|- style="vertical-align:text-top"<br />
| {status}<br />
| Статус путёвки<br />
<br />
|- style="vertical-align:text-top"<br />
| {operatorprice}<br />
| Стоимость у ТО<br />
<br />
|- style="vertical-align:text-top"<br />
| {clientprice}<br />
| Стоимость для клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {pricenetto}<br />
| Себестоимость<br />
<br />
|- style="vertical-align:text-top"<br />
| {clientdebt}<br />
| Задолженность клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {operatordebt}<br />
| Задолженность ТО<br />
<br />
|- style="vertical-align:text-top"<br />
| {agreementcourse}<br />
| Курс из путёвки<br />
<br />
|- style="vertical-align:text-top"<br />
| {requestcourse}<br />
| Курс из заявки<br />
<br />
|- style="vertical-align:text-top"<br />
| {agencycourse}<br />
| Внутренний курс агентства<br />
<br />
|- style="vertical-align:text-top"<br />
| {partnercouse}<br />
| Внутренний курс партнёра (туроператора)<br />
<br />
|- style="vertical-align:text-top"<br />
| {datepay}<br />
| Дата последнего платежа по путёвке<br />
<br />
|- style="vertical-align:text-top"<br />
| {departmentname}<br />
| Отдел, к которому привязана путевка<br />
<br />
|- style="vertical-align:text-top"<br />
| {departmentadditional_MAPS} <br />
| Ссылка на яндекс карты, находится в редактировании офиса в разделе дополнительно<br />
<br />
|- style="vertical-align:text-top"<br />
| {departmentadditional_WEB}<br />
| Ссылка на сайт, находится в редактировании офиса в разделе дополнительно<br />
<br />
|- style="vertical-align:text-top"<br />
| {PaymentSystemCodesUrls}<br />
| Ссылки на оплаты через платёжные системы, привязанные к тексту с названием платёжной системы<br />
<br />
|- style="vertical-align:text-top"<br />
| {PaymentSystemUrls}<br />
| Ссылки на оплаты через платёжные системы, привязанные к тексту с экранным названием платёжной системы<br />
<br />
|- style="vertical-align:text-top"<br />
| {AppexName}<br />
| Название платёжной системы Appex<br />
<br />
|- style="vertical-align:text-top"<br />
| {AppexDisplayName}<br />
| Экранное название платёжной системы Appex<br />
<br />
|- style="vertical-align:text-top"<br />
| {AppexLink}<br />
| Ссылка на оплату через Appex<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayOnlineName}<br />
| Название платёжной системы PayOnline<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayOnlineDisplayName}<br />
| Экранное название платёжной системы PayOnline<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayOnlineLink}<br />
| Ссылка на оплату через PayOnline<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayTravelName}<br />
| Название платёжной системы PayTravel<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayTravelDisplayName}<br />
| Экранное название платёжной системы PayTravel<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayTravelLink}<br />
| Ссылка на оплату через PayTravel<br />
<br />
|- style="vertical-align:text-top"<br />
| {PaylerName}<br />
| Название платёжной системы Payler<br />
<br />
|- style="vertical-align:text-top"<br />
| {PaylerDisplayName}<br />
| Экранное название платёжной системы Payler<br />
<br />
|- style="vertical-align:text-top"<br />
| {PaylerLink}<br />
| Ссылка на оплату через Payler<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayKeeperName}<br />
| Название платёжной системы PayKeeper<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayKeeperDisplayName}<br />
| Экранное название платёжной системы PayKeeper<br />
<br />
|- style="vertical-align:text-top"<br />
| {PayKeeperLink}<br />
| Ссылка на оплату через PayKeeper<br />
<br />
|- style="vertical-align:text-top"<br />
| {UnitellerName}<br />
| Название платёжной системы Uniteller<br />
<br />
|- style="vertical-align:text-top"<br />
| {UnitellerDisplayName}<br />
| Экранное название платёжной системы Uniteller<br />
<br />
|- style="vertical-align:text-top"<br />
| {UnitellerLink}<br />
| Ссылка на оплату через Uniteller<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
===События по клиентам===<br />
<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {clientfullname}<br />
| Фамилия Имя Отчество клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {clientshortname}<br />
| Имя Отчество клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {clientname}<br />
| Имя клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {birthdate}<br />
| Дата рождения клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {passportexpiredate}<br />
| Дата окончания паспорта клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {clientmanager}<br />
| Ведущий менеджер по клиенту<br />
<br />
|- style="vertical-align:text-top"<br />
| {visaissuedate}<br />
| Дата выдачи визы клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {visainterviewdate}<br />
| Дата собеседования<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
===События по платежам===<br />
<br />
Данные параметры доступны для событий по платежам.<br><br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {code}<br />
| Номер путёвки<br />
<br />
|- style="vertical-align:text-top"<br />
| {datebeg}<br />
| Дата заезда по путёвке<br />
<br />
|- style="vertical-align:text-top"<br />
| {operator}<br />
| Туроператор по путевке/заявке<br />
<br />
|- style="vertical-align:text-top"<br />
| {operatorlegal}<br />
| Юр.лицо туроператора по путевке/заявке<br />
<br />
|- style="vertical-align:text-top"<br />
| {request}<br />
| Номер заявки ТО<br />
<br />
|- style="vertical-align:text-top"<br />
| {tourist}<br />
| Главный турист<br />
<br />
|- style="vertical-align:text-top"<br />
| {debt}<br />
| Задолженность<br />
<br />
|- style="vertical-align:text-top"<br />
| {contragent}<br />
| Контрагент<br />
<br />
|- style="vertical-align:text-top"<br />
| {contragentlegal}<br />
| Юр.лицо контрагента<br />
<br />
|- style="vertical-align:text-top"<br />
| {datenow}<br />
| Текущая дата<br />
<br />
|- style="vertical-align:text-top"<br />
| {datepay}<br />
| Дата платежа<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
===События по лидам===<br />
<br />
Данные параметры могут использоваться в шаблоне, формируемом на основе предложения из лида:<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadname}<br />
| Наименование лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadstatus}<br />
| Статус лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadmanager}<br />
| Ведущий менеджер по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadoffice}<br />
| Офис по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadadvt}<br />
| Источник рекламы по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadcountry}<br />
| Страна по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadcreatedate}<br />
| Дата создания лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {leaddescr}<br />
| Описание лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadpartner}<br />
| Покупатель юр.лицо - партнёр<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadpartnerlegal}<br />
| Покупатель юр.лицо - юр.лицо<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadmainclient}<br />
| Главный клиент по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadmainclientfullname}<br />
| ФИО главного клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadmainclientshortname}<br />
| Имя и отчество главного клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadclients}<br />
| Клиенты по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
===События по предложению из лида===<br />
<br />
Данные параметры можно использовать только в обращениях, формируемых на основе предложений из лида.<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadoffercountry}<br />
| Страна предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadoffercity}<br />
| Город предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadofferdatebeg}<br />
| Дата заезда<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadofferdateend}<br />
| Дата окончания поездки<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadofferdescr}<br />
| Описание предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadoffercost}<br />
| Цена предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadoffercurr}<br />
| Валюта цены предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadofferurl}<br />
| Ссылка на предложение<br />
<br />
|- style="vertical-align:text-top"<br />
| {leadofferstatus}<br />
| Статус предложения<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
===Интеграция с управляющей компанией===<br />
<br />
Данные параметры вносятся при редактировании шаблона для писем управляющей компании при интеграции МАГ+МАГ (https://2015.mag.travel/tourclient/spa/#/management_company_settings).<br />
<br />
====Общие закладки====<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {Текущая дата в формате "dd.MM.yyyy"}<br />
| Текущая дата в формате "dd.MM.yyyy"<br />
<br />
|- style="vertical-align:text-top"<br />
| {Текущая дата, день (2 цифры)}<br />
| Текущий день месяца (2 цифры)<br />
<br />
|- style="vertical-align:text-top"<br />
| {Текущая дата, месяц в Именительном падеже}<br />
| Текущий месяц в Именительном падеже<br />
<br />
|- style="vertical-align:text-top"<br />
| {Текущая дата, месяц в Родительном падеже}<br />
| Текущий месяц в Родительном падеже<br />
<br />
|- style="vertical-align:text-top"<br />
| {Текущая дата, год (4 цифры)}<br />
| Текущий год (4 цифры)<br />
<br />
|- style="vertical-align:text-top"<br />
| {Текущая дата в полном формате}<br />
| Текущая дата в полном формате<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
====Данные по заявкам====<br />
<br />
Данные параметры могут использоваться в шаблоне, формируемом для отправки сообщений на события по подтверждению, изменению, отклонению заявки управляющей компанией:<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Название УК}<br />
| Наименование управляющей компании<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. ИНН агентства}<br />
| ИНН агентства, отправившего заявку на подключение<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Код агентства}<br />
| Код агентства, отправившего заявку на подключение<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Название агентства}<br />
| Название агентства, отправившего заявку на подключение<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Email агентства}<br />
| E-mail агентства, отправившего заявку на подключение<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Разрешить отправку лидов}<br />
| Разрешена ли отправка лидов от УК агентству<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Статус заявки}<br />
| Статус заявки на подключение<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Ссылка на заявку для ТА}<br />
| Ссылка на заявку подключения для ТА<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Ссылка для менеджера УК}<br />
| Ссылка на заявку подключения для управляющей компании<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Список офисов}<br />
| Список офисов для интеграции, выбранных ТА при создании заявки на подключение<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Список подключенных офисов}<br />
| Список офисов ТА, подключенных управляющей компанией<br />
<br />
|- style="vertical-align:text-top"<br />
| {УК. Список отключенных офисов}<br />
| Список офисов ТА, отключенных управляющей компанией<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
====Данные по лидам====<br />
<br />
Данные параметры могут использоваться в шаблоне, формируемом для отправки сообщений на поступление нового ЛИД-а от УК:<br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| {Страна лида}<br />
| Страна лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {Статус лида}<br />
| Статус лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {Источник рекламы по лиду}<br />
| Источник рекламы по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {Дата создания лида}<br />
| Дата создания лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {Описание лида}<br />
| Описание лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {Id лида}<br />
| Идентификатор (порядковый номер) лида у ТА<br />
<br />
|- style="vertical-align:text-top"<br />
| {Предложения}<br />
| Предложения по лиду<br />
<br />
|- style="vertical-align:text-top"<br />
| {Отели}<br />
| Данные об отеле по предложению лида<br />
<br />
|- style="vertical-align:text-top"<br />
| {Фамилия}<br />
| Фамилия главного клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {Имя}<br />
| Имя главного клиента<br />
<br />
|- style="vertical-align:text-top"<br />
| {Отчество}<br />
| Отчество главного клиента<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
=====Данные по предложениям=====<br />
<br />
Данные параметры могут использоваться в шаблоне, формируемом для отправки сообщений на поступление нового ЛИД-а от УК.<br><br />
Перечисленные ниже закладки являются табличными, то есть могут содержать несколько значений, поэтому их необходимо размещать в виде таблицы, например:<br><br />
<br />
[[Файл:Ak_482.png]]<br><br />
<br />
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"<br />
<br />
|- style="background-color:#F2F2F2"<br />
<br />
! width="20%" | Название параметра<br />
! width="80%" | Описание<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Направление тура, страна}}</nowiki><br />
| Страна по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Направление тура, город}}</nowiki><br />
| Город по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Дата с}}</nowiki><br />
| Дата начала тура по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Дата по}}</nowiki><br />
| Дата окончания тура по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Описание}}</nowiki><br />
| Описание предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Цена}}</nowiki><br />
| Цена предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Валюта путевки}}</nowiki><br />
| Валюта цены предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Ссылка}}</nowiki><br />
| Ссылка на предложение (если она прикреплена к нему)<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Город вылета}}</nowiki><br />
| Город вылета по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Отель}}</nowiki><br />
| Отель из предложения<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Описание отеля}}</nowiki><br />
| Описание отеля <br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Категория отеля}}</nowiki><br />
| Категория отеля по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Фото отеля}}</nowiki><br />
| Фото отеля по предложению (если имеется)<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Отель, рейтинг}}</nowiki><br />
| Рейтинг отеля по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Тип питания}}</nowiki><br />
| Тип питания по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Размещение}}</nowiki><br />
| Тип размещения по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Время пребывания, ночей}}</nowiki><br />
| Длительность в ночах по предложению <br />
<br />
|- style="vertical-align:text-top"<br />
| <nowiki>{{Поставщик}}</nowiki><br />
| Поставщик по предложению<br />
<br />
|- style="vertical-align:text-top"<br />
|}<br />
<br />
[[Category:Администрирование]]<br />
[[Category:MAG.Travel Мастер-Агент 2015]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1538Онлайн кассы2025-02-25T12:28:49Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/vse-drajvera-atol-versii-10/ Драйвер Атол] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет с ошибкой.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку от имени администратора<br><br />
[[Файл:CMD Admin.jpg]]<br><br />
Запустить установку командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
[[Файл:Mag.atol.os11.png]]<br><br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
[[Файл:Mag,atll.os11.png]]<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
Или добавить в ручную в автозагрузку, откройте проводник и вставьте в адресную строку shell:startup,в результате в проводнике будет открыта папка «Автозагрузка». Поместите в папку ярлык приложения magcash , чтобы оно запускалось автоматически при старте системы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1537Онлайн кассы2025-02-25T12:28:22Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/vse-drajvera-atol-versii-10/ Драйвер Атол] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет с ошибкой.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку от имени администратора<br />
[[Файл:CMD Admin.jpg]]<br><br />
Запустить установку командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
[[Файл:Mag.atol.os11.png]]<br><br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
[[Файл:Mag,atll.os11.png]]<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
Или добавить в ручную в автозагрузку, откройте проводник и вставьте в адресную строку shell:startup,в результате в проводнике будет открыта папка «Автозагрузка». Поместите в папку ярлык приложения magcash , чтобы оно запускалось автоматически при старте системы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:CMD_Admin.jpg&diff=1536Файл:CMD Admin.jpg2025-02-25T12:27:47Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_IP-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD%D0%B8%D0%B8&diff=1535Интеграция IP-телефонии2024-10-10T08:56:08Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.<br><br />
На данный момент их 5:<br />
* Asterisk;<br />
* Mango-Office;<br />
* Mobilon;<br />
* Oktell;<br />
* Zadarma;<br />
* UIS<br />
Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:<br />
* Создавать клиентов из карточки звонка;<br />
* Добавлять Лид, а также определять имеющийся лид по клиенту;<br />
* Создавать предварительный заказ;<br />
* Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;<br />
* Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).<br />
<br />
==Asterisk==<br />
<br />
Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:<br><br />
* Адрес сервера Asterisk,<br />
* Порт для подключения к AMI (Asterisk management Interface),<br />
* Логин AMI,<br />
* Пароль AMI.<br />
<br />
Ип с которых должен быть доступен Астериск по AMI<br><br />
<br />
188.187.132.68<br><br />
213.108.172.250<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
<br />
Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf<br />
<br />
Для этого в manager.conf должны быть прописаны логин и пароль ами, а также разрешения на all<br><br />
Пример конфигурации:<br><br />
[magtravel]<br><br />
secret = XXXXXXX<br><br />
deny=0.0.0.0/0.0.0.0<br><br />
permit=188.187.132.68/255.255.255.255<br><br />
permit=213.108.172.250/255.255.255.255<br><br />
permit=148.251.195.241/255.255.255.255<br><br />
permit=188.40.126.229/255.255.255.255<br><br />
permit=148.251.22.175/255.255.255.255<br><br />
read = all,cdr<br><br />
write = all,cdr<br><br />
writetimeout = 500<br><br />
<br />
*Вместо XXXXXXX необходимо указать пароль для подключения, который затем прописать в настройках телефонии в Маге.*<br><br />
<br />
Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html<br><br />
В файле queues.conf должна быть строка: eventwhencalled = yes<br><br />
А также: eventmemberstatus = yes<br><br />
И Астериск должен быть собран с модулем apps/app_queue.c<br><br />
<br><br />
Можно указать контекст Астериск для исходящих звонков.<br><br />
Этот контекст будет использоваться при звонке из Мага.<br><br />
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)<br><br />
<br><br />
Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер<br><br />
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/<br><br />
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP<br><br />
<br><br />
Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.<br><br />
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.<br><br />
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:<br><br />
<br><br />
<br />
Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)<br><br />
<br />
Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)<br><br />
<br />
[magtransfer]<br><br />
exten => s,1,Set(DEFEXT=200)<br><br />
exten => s,n,Set(API_key=API_KEY_TEXT)<br><br />
exten => s,n,Set(RingTime=15)<br><br />
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))<br><br />
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)<br><br />
exten => s,n,NoOp(FROM_DID=${FROM_DID})<br><br />
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})<br><br />
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})<br><br />
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)<br><br />
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
<br><br />
где:<br><br />
* ID_IN_MAG – ID который указываете при входе в систему;<br />
* API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*<br />
* DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение<br />
* FROM_DID - транк, на который поступил звонок<br />
* TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)<br />
<br />
Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer<br />
<br />
==Mango-Office==<br />
<br />
Для интеграции с IP-телефонией '''Mango-Office''' необходимо '''быть действующим клиентом Mango-Office'''.<br><br />
<br />
===Регистрация в Mango-Office===<br />
<br />
Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br><br />
Регистрация в Mango-Office<br />
Шаг 1. Войдите в Личный кабинет Виртуальной АТС (ВАТС).<br />
Шаг 2. Перейдите в раздел «Интеграции»:<br />
<br />
[[Файл:M1.png]]<br><br />
<br />
Шаг 3. Откройте вкладку «API коннектор».<br />
<br />
[[Файл:M2.png|border]]<br><br />
<br />
Шаг 4. Сохраните данные вашей АТС для дальнейшего копирования в виджет CRM-системы или не закрывайте вкладку до окончания настройки интеграции.':<br> <br />
<br />
[[Файл:M3.png|border]]<br><br />
Шаг 5. В поле «адрес внешней системы» впишите адрес СRM-системы или сервера для принятия и обработки уведомлений, которые посылает API.<br />
<br />
Также указать следующие данные:<br />
Адрес внешней системы: https://2015.mag.travel/tourclient/api/Telephony/Mango/999 , где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015;<br />
SSL-сертификат: Не проверять сертификат;<br />
[[Файл:M4.png|border]]<br><br />
<br />
Шаг 6. Установите безопасность посредством IP-адресов. Если вы хотите прослушивать записи разговоров прямо из CRM, то установите флаг «записи разговоров» (при этом необходимо подключить услугу «запись разговоров» в личном кабинете → вкладка «инструменты» → выберите пункт «запись разговоров» и нажмите кнопку «подключить»). Для принятия настроек нажмите кнопку «сохранить».<br />
[[Файл:M5.png|border]]<br><br />
<br />
Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br />
<br />
Шаг 7 Необходимо создать в системе сотрудников и создать им SIP-аккаунт.<br />
[[Файл:M6.png|border]]<br><br />
[[Файл:M7.png|border]]<br><br />
<br />
'''Настройка Mango-Office в MAG.Travel 2015'''<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии".<br />
[[Файл:M8.png|border]]<br><br />
[[Файл:M9.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br />
В Mango-Office:<br />
[[Файл:M10.png|border]]<br><br />
В MAG.Travel 2015:<br />
[[Файл:M11.png|border]]<br><br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015<br />
[[Файл:M12.png|border]]<br><br />
Cервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br />
[[Файл:M13.png|border]]<br><br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
'''Назначение звонков ответственному менеджеру'''<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br />
Таким образом, не отвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br />
[[Файл:M14.png|border]]<br><br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br />
[[Файл:M15.png|border]]<br><br />
[[Файл:M16.png|border]]<br><br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br />
<br />
===Настройка Mango-Office в MAG.Travel 2015===<br />
<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии". <br><br />
<br />
[[Файл:Ak_320.png|border]]<br><br />
<br />
[[Файл:Ak_326.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br><br />
В Mango-Office:<br><br />
<br />
[[Файл:Ak_328.png]]<br><br />
<br />
В MAG.Travel 2015:<br><br />
<br />
[[Файл:Ak_327.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015 [[Файл:Ak_329.png]], сервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br><br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
====Назначение звонков ответственному менеджеру====<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br><br />
Таким образом, неотвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br><br />
<br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br><br />
<br />
[[Файл:Ak_454.png|Пример схемы распределения звонков]]<br><br />
<br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br><br />
<br />
==Mobilon==<br />
<br />
Для интеграции с IP-телефонией '''Mobilon''' необходимо '''быть действующим клиентом Mobilon'''.<br><br />
<br />
===Настройка в Mobilon===<br />
<br />
В личном кабинете Mobilon, в разделе ''Интеграция'', на вкладке ''Настройки'' необходимо прописать данные для интеграции с Mag.Travel 2015:<br><br />
* Тип: '''Webhook''';<br />
* В поле URL для событий размещаем ссылку <code>https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015.<br><br />
<br />
[[Файл:Ak_432.png|border]]<br><br />
<br />
Также, необходимо создать Абонентов в разделе ''Конфигуратор'' подпункт ''Абонент'':<br><br />
<br />
[[Файл:Ak_433.png|border]]<br><br />
<br />
===Настройка Mobilon в MAG.Travel 2015===<br />
<br />
Для настройки в Mag.Travel 2015 необходимо перейти в раздел Администрирования, справочник ''Настройки IP-телефонии'' и в поле ''Тип телефонии'' выбрать Mobilion:<br />
<br />
[[Файл:Ak_435.png]]<br><br />
<br />
Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:<br />
* Внутренний номер;<br />
* Userkey.<br />
<br />
Данные для поля Userkey необходимо взять из данных абонентов в кабинете Mobilon:<br><br />
<br />
[[Файл:Ak_434.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
==Oktell==<br />
Для Интеграции с ip-телефонией Oktell необходимо:<br />
<br />
В поле «Тип телефонии» выбрать Oktell<br />
<br />
В поле «Автоматическое создание клиента» выбрать в каком из предложенных вариантов будет автоматически создан клиент:<br />
- Не создавать – при поступлении входящего звонка новый клиент создан не будет<br />
- При входящем с неизвестного номера – новый клиент создастся, если входящий звонок поступит с номера телефона, которого ещё нет в вашей базе<br />
- При пропущенном входящем с неизвестного номера - новый клиент создастся, если на входящий звонок не было ответа и такого номера телефона нет в вашей базе<br />
<br />
Выбрать один из предложенных вариантов в поле «Автоматическое создание лида», где:<br />
- Не создавать – Лид в базе создан не будет<br />
- При каждом входящем звонке – Лид создается по каждому входящему звонку, не важно от кого и с какого номера телефона поступил звонок<br />
- При входящем с неизвестного номера – Лид создается только в том случае, если звонок поступил с неизвестного номера<br />
При пропущенном входящем с неизвестного номера - Лид создается, если на звонок не было ответа и он поступил с неизвестного номера<br />
<br />
В поле «Изменять статус лида при пропущенном звонке» выбрать на какой статус Лида изменять статус, если звонок был пропущен (статусы подтягиваются из соответствующего справочника)<br />
<br />
В поле «Сервер Oktell» прописать ссылку на ваш сервер Oktell с префиксом «ws://»<br />
<br><br />
[[Файл:Oktell.png]]<br />
<br><br />
'''Внимание!''' Десктопное приложение Oktell не взаимодействует с Mag.Travel.<br />
<br />
==Zadarma==<br />
<br />
В ЛК ZADARMA перейдите в раздел "Настройки" - "API и интеграции".<br />
Здесь вы можете найти API ключ и ключ для создания подписи.<br />
Их нужно прописать в настройках IP телефонии в системе MAG.Travel<br />
<br />
В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида:<br />
https://2015.mag.travel/TourClient/api/Telephony/Zadarma/9999/events при этом заменить 9999 на Ваш ID в MAG<br />
и справа отметьте все события:<br />
[[Файл:2019-10-02_12-03_Zadarma.jpg]]<br />
<br />
Также в системе MAG.Travel, в настройках IP телефонии нужно прописать внутренние номера пользователей для которых будет доступна интеграция.<br />
В ZADARMA можно найти внутренние номера сотрудников в разделе Моя АТС, внутренние номера. Поле с номером - "Внутренний номер АТС"<br />
<br />
Также, для записи разговоров должен быть установлен флаг:<br />
Запись разговоров - в облако<br />
<br />
[[Файл:Zadarmarecording.jpg]]<br />
<br />
Для приема входящих звонков в ЛК ZADARMA должны быть подключены номера в разделе Моя АТС, внешние линии.<br />
<br />
==UIS==<br />
<br />
1. Подключить API<br />
Нужно подключить компонент «Call API Базовый набор» и «Уведомления». Для переадресации на ответственного нужно также подключить «Call API Управление вызовами»\<br />
Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:<br><br />
[[Файл:UIS1.png]]<br />
<br />
2. Доступ к АПИ<br />
Ключи генерируются на уровне пользователя в разделе личного кабинета "Аккаунт" → "Управление пользователями"<br />
Существует два типа ключей:<br />
Постоянный. Постоянный ключ имеет неограниченное время действия.<br />
Временный. Временный ключ имеет конкретную дату окончания действия ключа.<br />
Генерируем постоянный ключ.<br />
При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.<br><br />
[[Файл:UIS2.png]]<br />
<br />
3. Настройка доступа по IP<br />
<br />
По умолчанию доступ к API запрещен всем, чтобы можно было делать запросы необходимо IP-адрес хоста с которого делается запрос добавить в белый список. Это можно сделать через личный кабинет "Администратор -> Аккаунт -> Правила и настройки безопасности" вкладка "API".<br />
Наши IP:<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
[[Файл:UIS3.png]]<br />
<br />
4. Настройка IP телефонии в МАГЕ<br />
<br />
Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”<br><br />
[[Файл:UIS4.png]]<br><br />
Здесь тип телефонии выбирайте UIS.<br />
Ключ доступа к API UIS вставьте, что вы сгенерировали в личном кабинете UIS.<br />
Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.<br><br />
[[Файл:UIS5.png]]<br />
<br />
5. Настройка уведомлений<br />
<br />
Чтобы настроить получение уведомлений, перейдите в раздел Сервисы и статистика, в боковом меню откройте Уведомления и нажмите добавить. В открывшемся окне необходимо заполнить параметры: название уведомления; тип события, о котором нужно вас уведомить; условия, при которых будет приходить уведомление; способ получения уведомлений.<br />
Нужно настроить 8 HTTP уведомлений<br><br />
[[Файл:UIS6.png]]<br />
<br />
При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.<br><br />
<br />
'''Входящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLeg<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id": {{contact_id}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"leg_id": {{leg_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Исходящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/OutgoingLeg<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id": {{contact_id}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"leg_id": {{leg_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Входящий звонок на виртуальный номер'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLine<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}},<br />
<br />
"contact_id": {{contact_id}},<br />
<br />
"contact_full_name": {{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Исходящий звонок'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Outgoing<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id":{{contact_id}},<br />
<br />
"contact_full_name":{{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"employee_info":{<br />
<br />
"employee_full_name":{{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Начало разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/CallStarted<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id":{{contact_id}},<br />
<br />
"contact_full_name":{{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"employee_info":{<br />
<br />
"employee_full_name":{{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Окончание разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndPart<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_info": {<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"talk_time_duration": {{talk_time_duration}}<br />
<br />
},<br />
<br />
"leg_ids": {{leg_ids}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Завершение звонка'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndCall<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_info": {<br />
<br />
"call_source": {{call_source}},<br />
<br />
"direction": {{direction}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"talk_time_duration": {{talk_time_duration}},<br />
<br />
"total_time_duration": {{total_time_duration}},<br />
<br />
"wait_time_duration": {{wait_time_duration}},<br />
<br />
"tag_names": {{tag_names}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Записанный разговор'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Record<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"contact_info": {<br />
<br />
"contact_phone_number": {{contact_phone_number}},<br />
<br />
"communication_number": {{communication_number}},<br />
<br />
"contact_id": {{contact_id}},<br />
<br />
"contact_full_name": {{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id": {{call_session_id}},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_record_file_info": {<br />
<br />
"file_link": {{file_link}},<br />
<br />
"call_record_duration": {{file_duration}}<br />
<br />
},<br />
<br />
"tag_ids": {{tag_ids}},<br />
<br />
"tag_names": {{tag_names}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1534Настройки платежных систем2023-11-09T12:42:20Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код, это MerchantId;<br />
* RemoteApi пароль это PrivateSecurityKey;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
Посмотреть данные MerchantId и PrivateSecurityKey можно в личном кабинете на вкладке "Параметры интеграции".<br />
<br />
Api пользователь и Api пароль оставлять пустыми<br />
<br />
<br />
Далее нужно скопировать данные MerchantId и PrivateSecurityKey в личном кабинете на вкладке "Параметры интеграции". MerchantId нужно вставить в поле Биллинг-код, а PrivateSecurityKey в Api ключ<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Создаем платежную систему в Mag.travel, переходим в администрирование - настройка платежных систем - добавить и прописываем настройки.<br><br />
Далее поставить галочку Использовать страницу договора оферты и указать документ из вашей системы.<br><br />
Необходимо указать в поле "После добавления платежа переходить на страницу" адрес вашего сайта или куда переходить после платежа.<br><br />
Для использования двухстадийных(холд) платежей обратитесь в техническую поддержку альфа банка, чтобы они их вам включили. Если вам не нужно, тогда поставьте галочку "Без предавторизации"<br><br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
Сообщить AlfaBank адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/OnlinePayment/AlfaBank/MAG_AGENCY_CODE/MAG_SETTING_ID?mdOrder={mdOrder}&orderNumber={orderNumber}&checksum={checksum}&operation={operation}&paymentState={paymentState}&status={status}&amount={amount}&approvedAmount={approvedAmount}&paymentDate={paymentDate}&paymentWay={paymentWay}<br><br />
В адресе шлюза нужно подставить нужные значения:<br><br />
Вместо MAG_AGENCY_CODE подставить ID вашего агентства<br><br />
Вместо MAG_SETTING_ID нужно подставить айди настройки платежной системы<br><br />
Пример адреса платежного шлюза, если ID агентства 784 и айди настройки платежной системы 3, то ссылка будет такой:<br><br />
https://2015.mag.travel/tourclient/OnlinePayment/AlfaBank/784/3?mdOrder={mdOrder}&orderNumber={orderNumber}&checksum={checksum}&operation={operation}&paymentState={paymentState}&status={status}&amount={amount}&approvedAmount={approvedAmount}&paymentDate={paymentDate}&paymentWay={paymentWay}<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
<br />
* Прописать в личном кабинете PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/payonline/payonlinepass/100/<br />
<br />
В личном кабинете PayOnline перейдите Сайты -> MerchantId XXXXX -> вкладка "Параметры интеграции" -> изменить и там прописать адрес платежного шлюза в поле для успешных запросов и поставить галочку "Вызывать Callback для подтвержденных транзакций.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1533Онлайн кассы2023-10-17T10:38:18Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/vse-drajvera-atol-versii-10/ Драйвер Атол] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет с ошибкой.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку и запустить установку с доступом администратора командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
[[Файл:Mag.atol.os11.png]]<br><br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
[[Файл:Mag,atll.os11.png]]<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
Или добавить в ручную в автозагрузку, откройте проводник и вставьте в адресную строку shell:startup,в результате в проводнике будет открыта папка «Автозагрузка». Поместите в папку ярлык приложения magcash , чтобы оно запускалось автоматически при старте системы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1532Онлайн кассы2023-10-17T10:37:25Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/vse-drajvera-atol-versii-10/] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет с ошибкой.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку и запустить установку с доступом администратора командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
[[Файл:Mag.atol.os11.png]]<br><br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
[[Файл:Mag,atll.os11.png]]<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
Или добавить в ручную в автозагрузку, откройте проводник и вставьте в адресную строку shell:startup,в результате в проводнике будет открыта папка «Автозагрузка». Поместите в папку ярлык приложения magcash , чтобы оно запускалось автоматически при старте системы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1531Онлайн кассы2023-08-28T09:06:08Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/wp-content/uploads/2019/06/10.5.0.0.zip драйвер АТОЛ] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет с ошибкой.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку и запустить установку с доступом администратора командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
[[Файл:Mag.atol.os11.png]]<br><br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
[[Файл:Mag,atll.os11.png]]<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
Или добавить в ручную в автозагрузку, откройте проводник и вставьте в адресную строку shell:startup,в результате в проводнике будет открыта папка «Автозагрузка». Поместите в папку ярлык приложения magcash , чтобы оно запускалось автоматически при старте системы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Mag,atll.os11.png&diff=1530Файл:Mag,atll.os11.png2023-08-28T09:03:45Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1529Онлайн кассы2023-08-28T09:00:27Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/wp-content/uploads/2019/06/10.5.0.0.zip драйвер АТОЛ] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет с ошибкой.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку и запустить установку с доступом администратора командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
[[Файл:Mag.atol.os11.png]]<br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Mag.atol.os11.png&diff=1528Файл:Mag.atol.os11.png2023-08-28T08:58:27Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1527Онлайн кассы2023-08-28T08:55:11Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/wp-content/uploads/2019/06/10.5.0.0.zip драйвер АТОЛ] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Установка на Windows 11==<br />
На ОС Windows 11 программу MAG Кассы.АТОЛ нужно запускать от имени администратора, иначе установка будет ошибка.<br><br />
Как это сделать, есть множество способов, мы предлагаем следующий, но вы можете сделать по своему.<br><br />
Открыть командную строку и запустить установку с доступом администратора командой: msiexec /a C:\Users\crazy\OneDrive\Documents\MagCashInstaller.msi<br><br />
Вам нужно только указать свой путь к установочному файлу: C:\Users\crazy\OneDrive\Documents\<br><br />
После установки, у приложения magcash в свойствах нужно поставить галочку: всегда запускать от имени администратора. Оно находится по умолчанию в C:\Program Files (x86)\MAG\Mag Кассы.Атол\<br><br />
Теперь перед каждым открытием смены, вам нужно будет запускать magcash в ручную, в Windows 11 к сожалению, пока ярлык сам на рабочем столе не появляется, вы можете туда его скопировать из корня программы.<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1526Настройки интеграции почты2023-07-20T08:58:37Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/Z8-3zlgPaLiF <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений или перейдите по ссылке https://myaccount.google.com/apppasswords?pli=1&rapt=AEjHL4N96Bu3RA2PSW7bGsAUIFeaz7u7Cat7dDPPj1dImnyRSj9f3ou7O-HVgRDlyg-PviESEkLVI8_tNxYzhM2lGpfai-6ruw <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу. <br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy <br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/Z8-3zlgPaLiF <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений или перейдите по ссылке https://myaccount.google.com/apppasswords?pli=1&rapt=AEjHL4N96Bu3RA2PSW7bGsAUIFeaz7u7Cat7dDPPj1dImnyRSj9f3ou7O-HVgRDlyg-PviESEkLVI8_tNxYzhM2lGpfai-6ruw <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу. <br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1525Настройки интеграции почты2023-07-20T08:58:01Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/Z8-3zlgPaLiF <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений или перейдите по ссылке https://myaccount.google.com/apppasswords?pli=1&rapt=AEjHL4N96Bu3RA2PSW7bGsAUIFeaz7u7Cat7dDPPj1dImnyRSj9f3ou7O-HVgRDlyg-PviESEkLVI8_tNxYzhM2lGpfai-6ruw <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу. <br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy <br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1524Настройки интеграции почты2023-07-20T08:57:14Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/Z8-3zlgPaLiF<br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений или перейдите по ссылке https://myaccount.google.com/apppasswords?pli=1&rapt=AEjHL4N96Bu3RA2PSW7bGsAUIFeaz7u7Cat7dDPPj1dImnyRSj9f3ou7O-HVgRDlyg-PviESEkLVI8_tNxYzhM2lGpfai-6ruw<br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy <br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1523Настройки интеграции почты2023-04-24T11:51:07Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy <br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br><br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1522Настройки интеграции почты2023-04-24T11:50:22Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br />
Для использования почты Яндекс нужно создать пароль для внешних приложений. Откройте раздел «Пароли приложений» в разделе Безопасность вашего профиля в Яндекс ID.<br />
Выберите тип приложения, для которого хотите создать пароль.<br />
Введите название пароля и нажмите «Далее».<br />
Скопируйте сгенерированный пароль и введите его при входе в приложение, которое используете для доступа к сервисам Яндекса.<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=MAG.Travel_%D0%9C%D0%B0%D1%81%D1%82%D0%B5%D1%80-%D0%90%D0%B3%D0%B5%D0%BD%D1%82_2015.&diff=1521MAG.Travel Мастер-Агент 2015.2022-12-12T06:43:32Z<p>WikiSys: </p>
<hr />
<div><br />
'''[[Поиск]]'''<br><br />
'''[[Путевки]]'''<br><br />
'''[[Импорт путевок от Туроператоров]]'''<br><br />
'''[[Клиенты]]'''<br><br />
'''[[Лиды]]'''<br><br />
'''Раздел «Финансы»:'''<br />
*'''[[Платежи]]'''<br />
*'''[[Плановые платежи|Требования на оплату]]'''<br />
*'''[[Счета]]'''<br />
*'''[[Подарочные сертификаты]]'''<br />
*'''[[Банковские выписки]]'''<br />
*'''[[Оборотно-сальдовая ведомость]]'''<br />
'''[[Статистика]]'''<br><br />
'''[[Задачи]]'''<br><br />
'''[[События]]'''<br><br />
'''[[Партнеры]]'''<br><br />
'''[[Справочники]]'''<br><br />
'''[[Личный кабинет]]'''<br><br />
'''[[Администрирование]]:'''<br />
*'''[[Справочники для администрирования]]'''<br />
*'''[[Отчеты]]'''<br />
*'''[[Настройки]]'''<br />
**'''[[Бонусная программа 1]]'''<br />
**'''[[Бонусная программа 2]]'''<br />
*'''[[Настройки платежных систем]]'''<br />
*'''[[Настройки полей клиента]]'''<br />
*'''[[Настройки полей путёвки]]'''<br />
*'''[[Настройки событий]]'''<br />
*'''[[Шаблоны услуг]]'''<br />
*'''[[Управление модулями]]:'''<br />
**'''[[Обращение-Лид]]'''<br />
**'''[[Личный кабинет туриста]]'''<br />
**'''[[Поиск туров]]'''<br />
'''[[Интеграция с Мой Агент]]'''<br><br />
'''[[Настройки интеграции почты]]'''<br><br />
'''[[SMS и EMAIL рассылки]]'''<br><br />
'''[[Интеграция IP-телефонии]]'''<br><br />
'''[[Заключение]]'''<br><br />
'''[[F.A.Q. - Часто задаваемые вопросы по системе]]'''</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1520Настройки интеграции почты2022-12-12T06:42:31Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1519Настройки интеграции почты2022-12-12T06:36:13Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка) - Все настройки - слева выбрать Почтовые программы - выставить галочки: С сервера imap.yandex.ru по протоколу IMAP , Пароли приложений и OAuth-токены, Портальный пароль и внизу нажать сохранить изменения.<br />
Как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1518Настройки интеграции почты2022-08-17T09:06:32Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft <br><br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0 <br><br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux <br><br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1517Настройки интеграции почты2022-08-17T09:04:16Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft<br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux<br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
Для использования почты Mail нужно создать пароль для внешних приложений. Зайдите в настройки почты, раздел безопасность, пароли для внешних приложений https://prnt.sc/xg3KOAgAl-ft<br />
Добавляете, даете имя и получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
Для использования почты Gmail нужно создать пароль для внешних приложений. Зайдите в управление аккаунтом, раздел безопасность, пароли для приложений https://prnt.sc/q34yrcjJ7mux<br />
Выберите приложение и устройство, для которых нужно создать пароль приложения, можно выбрать почту и компьютер windows, получаете пароль, который нужно вставить в нашу систему в разделе настройки почты в пароль для доступа к почтовому серверу.<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1516Настройки интеграции почты2022-08-17T08:15:03Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты (У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
У каждого почтового сервиса свои личные настройки, вот пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
=====Mail.ru=====<br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Yandex=====<br />
<br />
Для того, чтобы настроить интеграцию с Яндекс, в самом аккаунте нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Gmail.com=====<br />
<br />
Для того, чтобы настроить интеграцию с Gmail, в самом аккаунте почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Microsoft (Office365)=====<br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
=====Mail.ru=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
Примеры почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Yandex=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у яндекс почты нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
=====Gmail.com=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у гугл почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
<br />
=====Microsoft (Office365)=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1515Настройки интеграции почты2022-08-17T08:09:16Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем данные для подключения к электронной почте.<br><br />
[[Файл:Mail.png]]<br><br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты(У некоторых почтовых сервисов нужно в личном кабинете создавать отдельный пароль для работы почтовых приложений);<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
После заполнения нажимаем Проверить подключение к почтовому аккаунту, если ошибки нет, сохраняемся, если есть ошибка, проверяйте введенные данные.<br />
<br />
<br />
<br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
=====Mail.ru=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
Примеры почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Yandex=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у яндекс почты нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
=====Gmail.com=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у гугл почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
<br />
=====Microsoft (Office365)=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1514Настройки интеграции почты2022-08-17T08:01:57Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем все поля и проверяем с помощью тестового письма. Сохраняем. <br />
[[Файл:Mail.png]]<br><br />
<br />
==Настройки интеграции почты и создание лидов из входящей почты==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]],Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
=====Mail.ru=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
Примеры почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Yandex=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у яндекс почты нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
=====Gmail.com=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у гугл почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
<br />
=====Microsoft (Office365)=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_IP-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD%D0%B8%D0%B8&diff=1513Интеграция IP-телефонии2022-07-05T08:39:56Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.<br><br />
На данный момент их 5:<br />
* Asterisk;<br />
* Mango-Office;<br />
* Mobilon;<br />
* Oktell;<br />
* Zadarma;<br />
* UIS<br />
Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:<br />
* Создавать клиентов из карточки звонка;<br />
* Добавлять Лид, а также определять имеющийся лид по клиенту;<br />
* Создавать предварительный заказ;<br />
* Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;<br />
* Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).<br />
<br />
==Asterisk==<br />
<br />
Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:<br><br />
* Адрес сервера Asterisk,<br />
* Порт для подключения к AMI (Asterisk management Interface),<br />
* Логин AMI,<br />
* Пароль AMI.<br />
<br />
Ип с которых должен быть доступен Астериск по AMI<br><br />
<br />
188.187.132.68<br><br />
213.108.172.250<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
<br />
Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf<br />
<br />
Для этого в manager.conf должны быть прописаны логин и пароль ами, а также разрешения на all<br><br />
Пример конфигурации:<br><br />
[magtravel]<br><br />
secret = XXXXXXX<br><br />
deny=0.0.0.0/0.0.0.0<br><br />
permit=188.187.132.68/255.255.255.255<br><br />
permit=213.108.172.250/255.255.255.255<br><br />
permit=148.251.195.241/255.255.255.255<br><br />
permit=188.40.126.229/255.255.255.255<br><br />
permit=148.251.22.175/255.255.255.255<br><br />
read = all,cdr<br><br />
write = all,cdr<br><br />
writetimeout = 500<br><br />
<br />
*Вместо XXXXXXX необходимо указать пароль для подключения, который затем прописать в настройках телефонии в Маге.*<br><br />
<br />
Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html<br><br />
В файле queues.conf должна быть строка: eventwhencalled = yes<br><br />
А также: eventmemberstatus = yes<br><br />
И Астериск должен быть собран с модулем apps/app_queue.c<br><br />
<br><br />
Можно указать контекст Астериск для исходящих звонков.<br><br />
Этот контекст будет использоваться при звонке из Мага.<br><br />
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)<br><br />
<br><br />
Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер<br><br />
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/<br><br />
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP<br><br />
<br><br />
Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.<br><br />
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.<br><br />
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:<br><br />
<br><br />
<br />
Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)<br><br />
<br />
Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)<br><br />
<br />
[magtransfer]<br><br />
exten => s,1,Set(DEFEXT=200)<br><br />
exten => s,n,Set(API_key=API_KEY_TEXT)<br><br />
exten => s,n,Set(RingTime=15)<br><br />
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))<br><br />
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)<br><br />
exten => s,n,NoOp(FROM_DID=${FROM_DID})<br><br />
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})<br><br />
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})<br><br />
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)<br><br />
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
<br><br />
где:<br><br />
* ID_IN_MAG – ID который указываете при входе в систему;<br />
* API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*<br />
* DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение<br />
* FROM_DID - транк, на который поступил звонок<br />
* TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)<br />
<br />
Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer<br />
<br />
==Mango-Office==<br />
<br />
Для интеграции с IP-телефонией '''Mango-Office''' необходимо '''быть действующим клиентом Mango-Office'''.<br><br />
<br />
===Регистрация в Mango-Office===<br />
<br />
Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br><br />
Регистрация в Mango-Office<br />
Шаг 1. Войдите в Личный кабинет Виртуальной АТС (ВАТС).<br />
Шаг 2. Перейдите в раздел «Интеграции»:<br />
<br />
[[Файл:M1.png]]<br><br />
<br />
Шаг 3. Откройте вкладку «API коннектор».<br />
<br />
[[Файл:M2.png|border]]<br><br />
<br />
Шаг 4. Сохраните данные вашей АТС для дальнейшего копирования в виджет CRM-системы или не закрывайте вкладку до окончания настройки интеграции.':<br> <br />
<br />
[[Файл:M3.png|border]]<br><br />
Шаг 5. В поле «адрес внешней системы» впишите адрес СRM-системы или сервера для принятия и обработки уведомлений, которые посылает API.<br />
<br />
Также указать следующие данные:<br />
Адрес внешней системы: https://2015.mag.travel/tourclient/api/Telephony/Mango/999 , где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015;<br />
SSL-сертификат: Не проверять сертификат;<br />
[[Файл:M4.png|border]]<br><br />
<br />
Шаг 6. Установите безопасность посредством IP-адресов. Если вы хотите прослушивать записи разговоров прямо из CRM, то установите флаг «записи разговоров» (при этом необходимо подключить услугу «запись разговоров» в личном кабинете → вкладка «инструменты» → выберите пункт «запись разговоров» и нажмите кнопку «подключить»). Для принятия настроек нажмите кнопку «сохранить».<br />
[[Файл:M5.png|border]]<br><br />
<br />
Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br />
<br />
Шаг 7 Необходимо создать в системе сотрудников и создать им SIP-аккаунт.<br />
[[Файл:M6.png|border]]<br><br />
[[Файл:M7.png|border]]<br><br />
<br />
'''Настройка Mango-Office в MAG.Travel 2015'''<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии".<br />
[[Файл:M8.png|border]]<br><br />
[[Файл:M9.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br />
В Mango-Office:<br />
[[Файл:M10.png|border]]<br><br />
В MAG.Travel 2015:<br />
[[Файл:M11.png|border]]<br><br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015<br />
[[Файл:M12.png|border]]<br><br />
Cервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br />
[[Файл:M13.png|border]]<br><br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
'''Назначение звонков ответственному менеджеру'''<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br />
Таким образом, не отвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br />
[[Файл:M14.png|border]]<br><br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br />
[[Файл:M15.png|border]]<br><br />
[[Файл:M16.png|border]]<br><br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br />
<br />
===Настройка Mango-Office в MAG.Travel 2015===<br />
<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии". <br><br />
<br />
[[Файл:Ak_320.png|border]]<br><br />
<br />
[[Файл:Ak_326.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br><br />
В Mango-Office:<br><br />
<br />
[[Файл:Ak_328.png]]<br><br />
<br />
В MAG.Travel 2015:<br><br />
<br />
[[Файл:Ak_327.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015 [[Файл:Ak_329.png]], сервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br><br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
====Назначение звонков ответственному менеджеру====<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br><br />
Таким образом, неотвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br><br />
<br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br><br />
<br />
[[Файл:Ak_454.png|Пример схемы распределения звонков]]<br><br />
<br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br><br />
<br />
==Mobilon==<br />
<br />
Для интеграции с IP-телефонией '''Mobilon''' необходимо '''быть действующим клиентом Mobilon'''.<br><br />
<br />
===Настройка в Mobilon===<br />
<br />
В личном кабинете Mobilon, в разделе ''Интеграция'', на вкладке ''Настройки'' необходимо прописать данные для интеграции с Mag.Travel 2015:<br><br />
* Тип: '''Webhook''';<br />
* В поле URL для событий размещаем ссылку <code>https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015.<br><br />
<br />
[[Файл:Ak_432.png|border]]<br><br />
<br />
Также, необходимо создать Абонентов в разделе ''Конфигуратор'' подпункт ''Абонент'':<br><br />
<br />
[[Файл:Ak_433.png|border]]<br><br />
<br />
===Настройка Mobilon в MAG.Travel 2015===<br />
<br />
Для настройки в Mag.Travel 2015 необходимо перейти в раздел Администрирования, справочник ''Настройки IP-телефонии'' и в поле ''Тип телефонии'' выбрать Mobilion:<br />
<br />
[[Файл:Ak_435.png]]<br><br />
<br />
Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:<br />
* Внутренний номер;<br />
* Userkey.<br />
<br />
Данные для поля Userkey необходимо взять из данных абонентов в кабинете Mobilon:<br><br />
<br />
[[Файл:Ak_434.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
==Oktell==<br />
Для Интеграции с ip-телефонией Oktell необходимо:<br />
<br />
В поле «Тип телефонии» выбрать Oktell<br />
<br />
В поле «Автоматическое создание клиента» выбрать в каком из предложенных вариантов будет автоматически создан клиент:<br />
- Не создавать – при поступлении входящего звонка новый клиент создан не будет<br />
- При входящем с неизвестного номера – новый клиент создастся, если входящий звонок поступит с номера телефона, которого ещё нет в вашей базе<br />
- При пропущенном входящем с неизвестного номера - новый клиент создастся, если на входящий звонок не было ответа и такого номера телефона нет в вашей базе<br />
<br />
Выбрать один из предложенных вариантов в поле «Автоматическое создание лида», где:<br />
- Не создавать – Лид в базе создан не будет<br />
- При каждом входящем звонке – Лид создается по каждому входящему звонку, не важно от кого и с какого номера телефона поступил звонок<br />
- При входящем с неизвестного номера – Лид создается только в том случае, если звонок поступил с неизвестного номера<br />
При пропущенном входящем с неизвестного номера - Лид создается, если на звонок не было ответа и он поступил с неизвестного номера<br />
<br />
В поле «Изменять статус лида при пропущенном звонке» выбрать на какой статус Лида изменять статус, если звонок был пропущен (статусы подтягиваются из соответствующего справочника)<br />
<br />
В поле «Сервер Oktell» прописать ссылку на ваш сервер Oktell с префиксом «ws://»<br />
<br><br />
[[Файл:Oktell.png]]<br />
<br><br />
'''Внимание!''' Десктопное приложение Oktell не взаимодействует с Mag.Travel.<br />
<br />
==Zadarma==<br />
<br />
В ЛК ZADARMA перейдите в раздел "Настройки" - "API и интеграции".<br />
Здесь вы можете найти API ключ и ключ для создания подписи.<br />
Их нужно прописать в настройках IP телефонии в системе MAG.Travel<br />
<br />
В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида:<br />
http://2015.mag.travel/TourClient/api/Telephony/Zadarma/999999/events при этом заменить 999999 на Ваш ID в MAG<br />
и справа отметьте все события:<br />
[[Файл:2019-10-02_12-03_Zadarma.jpg]]<br />
<br />
Также в системе MAG.Travel, в настройках IP телефонии нужно прописать внутренние номера пользователей для которых будет доступна интеграция.<br />
В ZADARMA можно найти внутренние номера сотрудников в разделе Моя АТС, внутренние номера. Поле с номером - "Внутренний номер АТС"<br />
<br />
Также, для записи разговоров должен быть установлен флаг:<br />
Запись разговоров - в облако<br />
<br />
[[Файл:Zadarmarecording.jpg]]<br />
<br />
Для приема входящих звонков в ЛК ZADARMA должны быть подключены номера в разделе Моя АТС, внешние линии.<br />
<br />
==UIS==<br />
<br />
1. Подключить API<br />
Нужно подключить компонент «Call API Базовый набор» и «Уведомления». Для переадресации на ответственного нужно также подключить «Call API Управление вызовами»\<br />
Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:<br><br />
[[Файл:UIS1.png]]<br />
<br />
2. Доступ к АПИ<br />
Ключи генерируются на уровне пользователя в разделе личного кабинета "Аккаунт" → "Управление пользователями"<br />
Существует два типа ключей:<br />
Постоянный. Постоянный ключ имеет неограниченное время действия.<br />
Временный. Временный ключ имеет конкретную дату окончания действия ключа.<br />
Генерируем постоянный ключ.<br />
При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.<br><br />
[[Файл:UIS2.png]]<br />
<br />
3. Настройка доступа по IP<br />
<br />
По умолчанию доступ к API запрещен всем, чтобы можно было делать запросы необходимо IP-адрес хоста с которого делается запрос добавить в белый список. Это можно сделать через личный кабинет "Администратор -> Аккаунт -> Правила и настройки безопасности" вкладка "API".<br />
Наши IP:<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
[[Файл:UIS3.png]]<br />
<br />
4. Настройка IP телефонии в МАГЕ<br />
<br />
Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”<br><br />
[[Файл:UIS4.png]]<br><br />
Здесь тип телефонии выбирайте UIS.<br />
Ключ доступа к API UIS вставьте, что вы сгенерировали в личном кабинете UIS.<br />
Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.<br><br />
[[Файл:UIS5.png]]<br />
<br />
5. Настройка уведомлений<br />
<br />
Чтобы настроить получение уведомлений, перейдите в раздел Сервисы и статистика, в боковом меню откройте Уведомления и нажмите добавить. В открывшемся окне необходимо заполнить параметры: название уведомления; тип события, о котором нужно вас уведомить; условия, при которых будет приходить уведомление; способ получения уведомлений.<br />
Нужно настроить 8 HTTP уведомлений<br><br />
[[Файл:UIS6.png]]<br />
<br />
При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.<br><br />
<br />
'''Входящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLeg<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id": {{contact_id}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"leg_id": {{leg_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Исходящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/OutgoingLeg<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id": {{contact_id}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"leg_id": {{leg_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Входящий звонок на виртуальный номер'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLine<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}},<br />
<br />
"contact_id": {{contact_id}},<br />
<br />
"contact_full_name": {{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Исходящий звонок'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Outgoing<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id":{{contact_id}},<br />
<br />
"contact_full_name":{{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"employee_info":{<br />
<br />
"employee_full_name":{{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Начало разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/CallStarted<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id":{{contact_id}},<br />
<br />
"contact_full_name":{{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"employee_info":{<br />
<br />
"employee_full_name":{{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Окончание разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndPart<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_info": {<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"talk_time_duration": {{talk_time_duration}}<br />
<br />
},<br />
<br />
"leg_ids": {{leg_ids}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Завершение звонка'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndCall<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_info": {<br />
<br />
"call_source": {{call_source}},<br />
<br />
"direction": {{direction}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"talk_time_duration": {{talk_time_duration}},<br />
<br />
"total_time_duration": {{total_time_duration}},<br />
<br />
"wait_time_duration": {{wait_time_duration}},<br />
<br />
"tag_names": {{tag_names}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Записанный разговор'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Record<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"contact_info": {<br />
<br />
"contact_phone_number": {{contact_phone_number}},<br />
<br />
"communication_number": {{communication_number}},<br />
<br />
"contact_id": {{contact_id}},<br />
<br />
"contact_full_name": {{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id": {{call_session_id}},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_record_file_info": {<br />
<br />
"file_link": {{file_link}},<br />
<br />
"call_record_duration": {{file_duration}}<br />
<br />
},<br />
<br />
"tag_ids": {{tag_ids}},<br />
<br />
"tag_names": {{tag_names}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_%D0%BF%D0%BE%D1%87%D1%82%D1%8B&diff=1512Настройки интеграции почты2021-11-26T06:30:10Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Справочник используется для настройки интеграции почты с целью автоматического создания [[Лиды|лидов]] в системе MAG.Travel на основе поступающих сообщений на электронную почту в соответствии с определенными правилами.<br><br />
<span style="color:red">'''Внимание!'''</span> Интеграция с почтой будет работать корректно только в том случае, если письма на вашу электронную почту будут приходить в системную папку "Входящие", в противном случае интеграция с почтой осуществится не верно.<br />
<br />
==Первоначальная настройка почты==<br />
<br />
Для настройки рассылок заходим в раздел «Администрирование» - «Настройки» - «Электронная почта». <br />
Заполняем все поля и проверяем с помощью тестового письма. Сохраняем. <br />
[[Файл:Mail.png]]<br><br />
<br />
==Работа в справочнике==<br />
<br />
Данный справочник расположен в разделе [[Администрирование|Администрирование]], вкладка Справочники - Настройки интеграции почты.<br><br />
<br />
[[Файл:Ak_469.png]]<br><br />
<br />
В открывшемся экране отображается список имеющихся настроек интеграции почты, а также управляющие кнопки для редактирования и удаления:<br><br />
<br />
[[Файл:Ak_470.png|border]]<br><br />
<br />
===Создание правил интеграции===<br />
<br />
Для добавления правил интеграции с электронной почтой необходимо нажать на кнопку [[Файл:Ak_471.png|Добавить правило]].<br />
<br />
====Шаг 1. Данные аккаунта====<br />
<br />
На первой вкладке открывшегося окна необходимо заполнить данные для подключения к электронной почте, на которую будут распространяться правила обработки входящих сообщений.<br><br />
<br />
[[Файл:Ak_472.png|border|Данные почтового аккаунта]]<br><br />
<br />
Если почтовый аккаунт уже ранее был сохранён в системе, например, во вкладке [[Настройки#Электронная почта|Настройки]] раздела [[Администрирование]], то после ввода логина можно воспользоваться опцией "''Найти аккаунт по логину''":<br />
<br />
[[Файл:Ak_478.png|border]]<br><br />
<br />
В случае успешного поиска, в остальные поля будут сразу подставлены необходимые данные, в противном случае пользователь увидит следующее сообщение, а заполнить поля нужно будет вручную:<br><br />
<br />
[[Файл:Ak_477.png|border]]<br><br />
<br />
Необходимо заполнить следующие поля:<br />
* Логин - адрес почты, интеграцию с которой нужно произвести;<br />
* Пароль - пароль от электронной почты;<br />
* Адрес IMAP сервера;<br />
* Порт IMAP сервера;<br />
* Тип шифрования при подключении к IMAP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Адрес SMTP сервера;<br />
* Порт SMTP сервера;<br />
* Тип шифрования при подключении к SMTP серверу:<br />
** Нет;<br />
** StartTls;<br />
** SSL;<br />
* Изменять статус лида при получении ответа.<br />
<br />
После заполнения полей необходимо нажать на кнопку [[Файл:Ak_475.png|Кнопка проверки подключения]], если в данных допущена ошибка, то будет выведено следующее сообщение:<br><br />
<br />
[[Файл:Ak_476.png|border]]<br><br />
<br />
В случае внесения корректных настроек, будет произведён автоматический переход на следующую вкладку, а на подключенную почту будет отправлено сообщение.<br />
<br />
=====Mail.ru=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.mail.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.mail.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Rambler=====<br />
<br />
Для того, чтобы настроить интеграцию с Rambler почтой необходимо сначала в настройках почтового ящика разрешить доступ почтовым клиентам:<br><br />
<br />
[[Файл:Ak_481.png|border]]<br><br />
<br />
Примеры почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 143<br><br />
''Тип шифрования при подключении к IMAP серверу:'' StartTls<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
<br />
''Адрес IMAP сервера:'' imap.rambler.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.rambler.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
=====Yandex=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.yandex.ru<br><br />
''Порт IMAP сервера :'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.yandex.ru<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у яндекс почты нужно разрешить доступ к аккаунту от почтовых клиентов:<br />
Настройка(шестеренка)-Прочие-слева выбрать Прочие параметры-выставить галочки как на скриншоте https://prnt.sc/1185lqy<br />
<br />
=====Gmail.com=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' imap.gmail.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.gmail.com<br><br />
''Порт SMTP сервера:'' 465<br><br />
''Тип шифрования при подключении к SMTP серверу:'' SSL<br><br />
<br />
Еще в самом аккаунте у гугл почты нужно разрешить доступ к аккаунту от почтовых клиентов: Настройка(шестеренка)-Все настройки-Пересылка и POP/IMAP и выставить галочки как на скриншоте https://prnt.sc/peobm0<br />
<br />
=====Microsoft (Office365)=====<br />
<br />
Пример почтовых настроек, которые должны быть внесены в данные аккаунта:<br><br />
<br />
''Адрес IMAP сервера:'' outlook.office365.com<br><br />
''Порт IMAP сервера:'' 993<br><br />
''Тип шифрования при подключении к IMAP серверу:'' SSL<br><br />
''Адрес SMTP сервера:'' smtp.office365.com<br><br />
''Порт SMTP сервера:'' 587<br><br />
''Тип шифрования при подключении к SMTP серверу:'' StartTls<br><br />
<br />
====Шаг 2. Фильтры сообщений====<br />
<br />
Далее необходимо определить слова/фразы, которые могут как разрешить обработку письма, так и запретить её.<br><br />
Данная возможность помогает отсеивать письма, лиды по которым создаться не должны, а также определить письма, которые должны быть обработаны в соответствии с правилами.<br><br />
Список фраз необходимо вписать в поле на форме, а каждая новая фраза должна быть расположена на новой строке.<br><br />
Письмо анализируется полностью, включая текст темы письма.<br><br />
<br />
Для удобства также имеется возможность внести только те эл.адреса, сообщения от которых необходимо обрабатывать, или же исключить их из обработки.<br><br />
<br />
[[Файл:Ak_473.png|border|Фильтры для обработки входящих сообщений]]<br><br />
<br />
<span style="color:red">'''Внимание!'''</span> Если необходимо обрабатывать ''все входящие сообщения'', то список разрешенных фраз нужно оставить пустым.<br />
<br />
====Шаг 3. Правила обработки====<br />
<br />
На вкладке ''Обработка'' задаются следующие параметры:<br />
* Формат названия лида - формат на основании которого будет формироваться название лида (может включать параметры). <br />
* Флаг ''Активна'' - данный признак определяет необходимость обработки входящих писем;<br />
* Флаг ''Загружать файлы в лид'' - при установке данного флага, файлы, присланные в письме, будут прикрепляться к лиду при создании;<br />
* Флаг ''Создавать клиента'' - данный признак определяет необходимость создания клиента на основе данных отправителя при создании лида (по умолчанию включен);<br />
* Флаг ''При получении письма всегда создавать новый лид'' - отвечает за создание нового лида при получении '''каждого''' входящего письма, '''без учёта ранее полученных писем''' от отправителя, но в случае получения ответа на обращение или сообщение из путёвки, оно будет обработано и прекреплено к лиду/путёвке, на которую ссылается (по умолчанию отключен);<br />
* Страна по умолчанию;<br />
* Отдел по умолчанию;<br />
* Источник рекламы по умолчанию;<br />
* Менеджер по умолчанию.<br />
<br />
Формат названия лида может включать следующие параметры:<br />
* %DATE% - дата создания лида;<br />
* %TIME% - время создания лида;<br />
* %TITLE% - тема письма;<br />
* %FROM% - данные отправителя письма;<br />
* %FIRSTNAME% - имя клиента; <br />
* %NAME% - фамилия клиента.<br />
<br />
Далее располагается таблица для дополнительных настроек обработки письма и заполнения полей лида значениями:<br />
* Поле - выбор поля лида, которое необходимо заполнить:<br />
** Страна;<br />
** Источник рекламы;<br />
** Офис;<br />
** Менеджер;<br />
** Название лида;<br />
** Поля из [[Доп.описания|справочника доп.описаний]].<br />
<br />
* Наличие текста в письме - текст, при наличии которого данное правило вступит в действие;<br />
* Значение при наличии текста в письме - значение, устанавливаемое в выбранном поле, при наличии определенного текста.<br />
<br />
<span style="color:red">'''Внимание!'''</span> При создании правила добавления лида необходимо заполнить все 3 поля.<br><br />
<br />
[[Файл:Ak_474.png|border|Правила создания лида по входящему сообщению]]<br><br />
<br />
=====Действие правил добавление лида=====<br />
<br />
Если на одно и то же поле действует ''несколько'' правил, то значение устанавливается по первому из правил, подходящих по условию.<br><br />
<br />
Например, имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич", несмотря на то, что в тексте письма он упоминается после фразы "''от менеджера Юлии''", на которую также создано правило.<br><br />
Дело в том, что '''данное правило расположено выше по списку в настройках''', и оно срабатывает первым.<br><br />
<br />
===Редактирование правил интеграции===<br />
<br />
Для редактирования настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_045.png]], а далее в открывшемся окне внести необходимые правки.<br />
<br />
===Удаление правил интеграции===<br />
<br />
Для удаления настройки интеграции почты необходимо в правой части записи нажать на кнопку [[Файл:Ak_046.png]], а затем подтвердить своё действие в окне:<br><br />
<br />
[[Файл:Ak_479.png|border]]<br><br />
<br />
==Обработка правила интеграции==<br />
<br />
При получении входящего письма идёт проверка на наличие клиента в базе по адресу электронной почты.<br><br />
<br />
Обработка правила интеграции начинается с определения подходящего или не подходящего письма по тексту темы и сообщения.<br />
* Если в письме текст темы и сообщения включает разрешенные фразы, то сообщение подлежит дальнейшей обработке;<br />
* Если в письме текст темы и сообщения включает запрещенные фразы, то обработка сообщения не будет производиться;<br />
* Если в письме текст темы и сообщения включает как разрешенные, так и запрещенные фразы, то такие письма так же будут исключены из обработки.<br />
<br />
===Создание лида===<br />
<br />
После того, как система определила, что письмо подлежит обработке, начинают применяться правила, установленные на вкладке ''Обработка''.<br><br />
<br />
* Для названия лида применяется формат, заданный в соответствующем поле.<br><br />
* Затем письмо обрабатывается по заведённым для него правилам: <br />
** заполняются указанные поля, если условия соблюдены и искомые значения найдены в тексте;<br />
** если по правилам лида заполняется поле, для которого ранее выставлено значение по умолчанию (страна, источник рекламы, отдел, менеджер), то правила лида, являясь более приоритетными, будут устанавливать своё значение;<br />
* В полях по умолчанию проставляются значения, выставленные в соответствующих полях, если только ранее значения этих полей не заполнились, согласно правилам. Если значение отсутствует, то будет установлено значение ''не указано''.<br><br />
* Если по адресу электронной почты не будет найдено клиента в базе, то будет создан новый, в ином случае, имеющийся клиент будет прикреплен к лиду.<br />
<br />
'''''Например''''', Менеджером '''по умолчанию''' в лиде установлен "Петров Антон Васильевич", а также имеются 2 правила:<br />
# При наличии текста "от менеджера Ивана", поле ''Менеджер'' должно заполниться значением "Воробьёв Иван Сергеевич";<br />
# При наличии текста "от менеджера Юлии", поле ''Менеджер'' должно заполниться значением "Иванова Юлия Ивановна".<br />
<br />
От клиента приходит письмо следующего содержания:<br><br />
<br />
"Добрый день! Хочу забронировать у вас путешествие на новогодние праздники.<br />
В письме '''''от менеджера Юлии''''' я узнал, что есть интересные акции, а вчера '''''от менеджера Ивана''''' - что у меня есть бонусные баллы, которые скоро сгорят.<br />
Хотелось бы воспользоваться ими при оплате тура. Когда и куда мне лучше подойти по данному вопросу или же может вы мне сразу вышлете варианты предложений?<br />
Заранее спасибо!"<br />
<br />
При обработке данного письма, полю ''Менеджер'' будет установлено значение "Воробьёв Иван Сергеевич".<br><br />
Ранее мы выяснили, что настройка с наличием текста "от менеджера Ивана" располагалось выше, чем "от менеджера Юлии", при этом сработало одно из правил и значение по умолчанию подменяется значением из правил для данного поля.<br><br />
<br />
А в случае, когда будет получено письмо с разрешенной фразой, но без текста "от менеджера Ивана" или "от менеджера Юлии", то менеджером будет выбран "Петров Антон Васильевич".<br />
<br />
===Создание обращения в активный лид===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), то полученное сообщение прикрепляется к нему.<br />
<br />
===Создание сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется к ней.<br />
<br />
===Создание обращения в активном лиде и сообщения в действующей путёвке===<br />
<br />
В случае, если у клиента имеется активный лид (в котором клиент является главным, а лид не в завершающем статусе и не помещенный в архив), а также если у клиента имеется действующая путёвка (в которой клиент является главным и дата окончания тура ещё не наступила), то полученное сообщение прикрепляется и к лиду, и к путёвке.<br />
<br />
[[Category:Справочники]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Mail.png&diff=1511Файл:Mail.png2021-11-26T06:29:49Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1510Настройки платежных систем2021-09-30T06:08:15Z<p>WikiSys: /* AlfaBank. Заявка на подключение */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Создаем платежную систему в Mag.travel, переходим в администрирование - настройка платежных систем - добавить и прописываем настройки.<br><br />
Далее поставить галочку Использовать страницу договора оферты и указать документ из вашей системы.<br><br />
Необходимо указать в поле "После добавления платежа переходить на страницу" адрес вашего сайта или куда переходить после платежа.<br><br />
Для использования двухстадийных(холд) платежей обратитесь в техническую поддержку альфа банка, чтобы они их вам включили. Если вам не нужно, тогда поставьте галочку "Без предавторизации"<br><br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
Сообщить AlfaBank адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/OnlinePayment/AlfaBank/MAG_AGENCY_CODE/MAG_SETTING_ID?mdOrder={mdOrder}&orderNumber={orderNumber}&checksum={checksum}&operation={operation}&paymentState={paymentState}&status={status}&amount={amount}&approvedAmount={approvedAmount}&paymentDate={paymentDate}&paymentWay={paymentWay}<br><br />
В адресе шлюза нужно подставить нужные значения:<br><br />
Вместо MAG_AGENCY_CODE подставить ID вашего агентства<br><br />
Вместо MAG_SETTING_ID нужно подставить айди настройки платежной системы<br><br />
Пример адреса платежного шлюза, если ID агентства 784 и айди настройки платежной системы 3, то ссылка будет такой:<br><br />
https://2015.mag.travel/tourclient/OnlinePayment/AlfaBank/784/3?mdOrder={mdOrder}&orderNumber={orderNumber}&checksum={checksum}&operation={operation}&paymentState={paymentState}&status={status}&amount={amount}&approvedAmount={approvedAmount}&paymentDate={paymentDate}&paymentWay={paymentWay}<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1509Настройки платежных систем2021-09-30T06:07:03Z<p>WikiSys: /* Подключение платежных систем */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Создаем платежную систему в Mag.travel, переходим в администрирование - настройка платежных систем - добавить и прописываем настройки.<br />
Далее поставить галочку Использовать страницу договора оферты и указать документ из вашей системы.<br />
Необходимо указать в поле "После добавления платежа переходить на страницу" адрес вашего сайта или куда переходить после платежа.<br />
Для использования двухстадийных(холд) платежей обратитесь в техническую поддержку альфа банка, чтобы они их вам включили. Если вам не нужно, тогда поставьте галочку "Без предавторизации"<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015.mag.travel/tourclient/OnlinePayment/AlfaBank/MAG_AGENCY_CODE/MAG_SETTING_ID?mdOrder={mdOrder}&orderNumber={orderNumber}&checksum={checksum}&operation={operation}&paymentState={paymentState}&status={status}&amount={amount}&approvedAmount={approvedAmount}&paymentDate={paymentDate}&paymentWay={paymentWay}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо MAG_AGENCY_CODE подставить ID вашего агентства<br />
Вместо MAG_SETTING_ID нужно подставить айди настройки платежной системы<br />
Пример адреса платежного шлюза, если ID агентства 784 и айди настройки платежной системы 3, то ссылка будет такой:<br />
https://2015.mag.travel/tourclient/OnlinePayment/AlfaBank/784/3?mdOrder={mdOrder}&orderNumber={orderNumber}&checksum={checksum}&operation={operation}&paymentState={paymentState}&status={status}&amount={amount}&approvedAmount={approvedAmount}&paymentDate={paymentDate}&paymentWay={paymentWay}<br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1508Настройки платежных систем2021-09-23T14:51:28Z<p>WikiSys: /* AlfaBank. Заявка на подключение */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо {ID_агентства} подставить ID вашего агентства<br />
Вместо {логин_пользователя_для_AlfaBank} нужно подставить логин пользователя, созданного для работы AlfaBank<br />
Вместо {пароль_пользователя_для_AlfaBank} нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
Пример адреса платежного шлюза:<br />
Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1507Настройки платежных систем2021-09-23T12:52:32Z<p>WikiSys: /* AlfaBank. Заявка на подключение */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо {ID_агентства} подставить ID вашего агентства<br />
Вместо {логин_пользователя_для_AlfaBank} нужно подставить логин пользователя, созданного для работы AlfaBank<br />
Вместо {пароль_пользователя_для_AlfaBank} нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
Пример адреса платежного шлюза:<br />
Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa1.png|border]]<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1506Настройки платежных систем2021-09-23T12:52:00Z<p>WikiSys: /* AlfaBank */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо {ID_агентства} подставить ID вашего агентства<br />
Вместо {логин_пользователя_для_AlfaBank} нужно подставить логин пользователя, созданного для работы AlfaBank<br />
Вместо {пароль_пользователя_для_AlfaBank} нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
Пример адреса платежного шлюза:<br />
Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Alfa1.png&diff=1505Файл:Alfa1.png2021-09-23T12:51:41Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1504Настройки платежных систем2021-09-23T10:47:06Z<p>WikiSys: /* AlfaBank. Заявка на подключение */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо {ID_агентства} подставить ID вашего агентства<br />
Вместо {логин_пользователя_для_AlfaBank} нужно подставить логин пользователя, созданного для работы AlfaBank<br />
Вместо {пароль_пользователя_для_AlfaBank} нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
Пример адреса платежного шлюза:<br />
Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br><br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1503Настройки платежных систем2021-09-23T10:46:31Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо {ID_агентства} подставить ID вашего агентства<br />
Вместо {логин_пользователя_для_AlfaBank} нужно подставить логин пользователя, созданного для работы AlfaBank<br />
Вместо {пароль_пользователя_для_AlfaBank} нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
Пример адреса платежного шлюза:<br />
Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
[[Файл:Alfa.png|border]]<br><br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
[[Файл:alfa2.png|border]]<br<br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
[[Файл:alfa3.png|border]]<br<br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1502Настройки платежных систем2021-09-23T10:44:06Z<p>WikiSys: /* AlfaBank. Заявка на подключение */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
AlfaBank. Заявка на подключение<br />
<br />
Для подключения необходимо:<br />
Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
Сообщить AlfaBank адрес платежного шлюза:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
В адресе шлюза нужно подставить нужные значения:<br />
Вместо {ID_агентства} подставить ID вашего агентства<br />
Вместо {логин_пользователя_для_AlfaBank} нужно подставить логин пользователя, созданного для работы AlfaBank<br />
Вместо {пароль_пользователя_для_AlfaBank} нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
Пример адреса платежного шлюза:<br />
Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы.<br />
<br />
<br />
Далее для AlfaBank нужно совершить тестовый платеж, для этого в Url Api платежной системы выбираем: Тестовый шлюз - https://web.rbsuat.com/ab<br />
После окончания теста в Url Api платежной системы надо уже выбрать Рабочий шлюз - https://pay.alfabank.ru/payment<br />
<br />
Ниже нужно указать метод оплаты,по умолчанию стоит для всех, но можно выбрать: "Интернет-эквайринг" или "Система быстрых платежей. Оплата по QR коду" и проставить комиссию<br />
Если для методов оплаты у вас разная комиссия,то нужно нажать добавить и для каждого проставить свою комиссию<br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC&diff=1501Настройки платежных систем2021-09-23T10:42:17Z<p>WikiSys: /* AlfaBank */</p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Данная вкладка раздела ''[[Администрирование|Администрирование]]'' отвечает за настройку платежных систем для проведения оплат.<br />
<br />
==Работа с настройками==<br />
<br />
В данном разделе расположен список настроек для платёжных систем, представленный в виде таблицы.<br><br />
Пользователю отображены следующие данные:<br />
* Название платёжной системы;<br />
* Платёжная система:<br />
** AlfaBank;<br />
** Appex;<br />
** Binbank;<br />
** PayKeeper;<br />
** Payler;<br />
** PayOnline;<br />
** PayTravel;<br />
** Uniteller.<br />
* Юр.лицо - юридическое лицо, для которого данная платёжная система будет доступна;<br />
* Активна - признак доступности;<br />
* Использовать страницу договора-оферты;<br />
* Шаблон договора-оферты (Внимание! Договор-оферта должен быть в формате html).<br />
<br />
[[Файл:Ak_332.png]]<br><br />
<br />
===Добавление записей===<br />
<br />
Для добавления новой настройки для платёжной системы, необходимо воспользоваться кнопкой [[Файл:Ak_335.png|Добавить]], при этом откроется следующая форма:<br />
<br />
[[Файл:Ak_336.png|border]]<br />
<br />
Обязательными полями являются:<br />
* Название;<br />
* Платежная система;<br />
* Юр.лицо;<br />
* Шаблон договора оферты (только при установленном флаге ''Использовать страницу договора оферты'');<br />
<br />
Также обязательны к заполнению поля для настроек проводок платёжных операций:<br />
* Юр.лицо;<br />
* Р/с;<br />
* Операция;<br />
* Вид оплаты;<br />
* Метод оплаты (если имеется).<br />
<br />
Значение поля Юр. лицо в настройках проводок устанавливается автоматически при выборе конкретного юр.лица в основном блоке настроек, или же можно заводить отдельные записи для проводок по каждому юр.лицу, если Юр.лицо в основном блоке имеет значение ''Для всех''.<br><br />
В зависимости от конкретной платёжной системы, выбранной в соответствующем поле, отображаются поля, необходимые для настройки.<br><br />
<br />
Общими полями, помимо обязательных, для всех платёжных систем являются:<br />
* Флаг "Активна" - доступность оплаты через данную платёжную систему;<br />
* Флаг "Скрывать по умолчанию" - скрывать ли данный способ оплаты по умолчанию (отобразить данную платёжную систему можно, установив флаг "Показывать все способы оплаты" [[Путевки#Дополнительно|в карточке путёвки на вкладке "Дополнительно"]]);<br />
* Флаг "Без предавторизации" - принимать ли автоматически платежи, произведенные через платёжные системы (если флаг не установлен, то платежи будут заморожены и для их принятия, необходимо будет подтвердить оплату [[Путевки#Цена и платежи|в карточке путёвки на вкладке "Цена и платежи"]]);<br />
* Использовать холдированные платежи при расчете долга клиента - принимать в расчёт замороженные платежи при расчёте долга клиента (данная настройка отображается только при отсутствии флага "Без предавторизации").<br />
<br />
====AlfaBank====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы AlfaBank:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы (Для начальных тестов платежей: Тестовый шлюз - https://web.rbsuat.com/ab После для основной работы: Рабочий шлюз - https://pay.alfabank.ru/payment);<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа (Например сайт агентства, если такого нету, оставить поле пустым).<br />
<br />
====Appex, Uniteller====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем Appex, Uniteller:<br />
<br />
* Биллинг-код:<br />
** для ПС Uniteller записываются данные id точки продажи;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ (значение для ПС Uniteller совпадает с паролем).<br />
<br />
====PayKeeper, Payler====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжных систем PayKeeper, Payler:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Url Api платежной системы.<br />
<br />
====PayOnline====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayOnline:<br />
<br />
* Биллинг-код;<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* После добавления платежа переходить на страницу - адрес, по которому будет произведен переход после успешного проведения платежа;<br />
* При ошибке оплаты переходить на страницу - адрес, по которому будет произведен переход в случае ошибки при совершении платежа.<br />
<br />
====PayTravel====<br />
<br />
Дополнительные обязательные поля, необходимые для заполнения при настройке платёжной системы PayTravel:<br />
<br />
* RemoteApi пользователь;<br />
* RemoteApi пароль;<br />
* RemoteApi ключ;<br />
* Параметры запроса от платежной системы - имеет формат: /id агентства/логин/пароль (например, /300/user/password);<br />
* Отправлять деньги агентству сразу после оплаты - после получения платежа от клиента, в системе PayTravel создаётся платёж для ТО.<br />
<br />
===Редактирование записей===<br />
<br />
Для редактирования имеющейся записи необходимо нажать на кнопку [[Файл:Ak_340.png|Редактировать]] в соответствующей строке:<br><br />
<br />
[[Файл:Ak_333.png|border]]<br><br />
<br />
===Удаление записей===<br />
<br />
Для удаления имеющейся записи необходимо нажать на кнопку [[Файл:Ak_341.png|Удалить]] в соответствующей строке и подтвердить удаление:<br><br />
<br />
[[Файл:Ak_342.png|border]]<br><br />
<br />
==Подключение платежных систем==<br />
<br />
===AlfaBank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым AlfaBank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить AlfaBank валюты, в которых будут производиться платежи.<br />
* Сообщить AlfaBank адрес платежного шлюза: <br><br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/{agency}/{login}/{password}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br />
* Вместо ''{логин_пользователя_для_AlfaBank}'' нужно подставить логин пользователя, созданного для работы AlfaBank<br />
* Вместо ''{пароль_пользователя_для_AlfaBank}'' нужно подставить пароль пользователя, созданного для работы AlfaBank<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для AlfaBank был создан пользователь с логином AlfaBank и паролем AlfaBankPass, то ссылка будет такой:<br><br />
<br />
https://2015mag.travel/tourclient/PaymentIntegration/AlfaBankProcess/100/AlfaBank/AlfaBankPass<br><br />
<br />
AlfaBank должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы.<br><br />
<br />
===Appex. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Appex необходимо нажать на кнопку [[Файл:Ak_338.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* ИНН;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* Номер мобильного телефона для СМС-авторизации;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* E-mail для реестров о платежах (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Тип компании:<br />
** Турагентство;<br />
** Туроператор;<br />
* Логин к шлюзу; (логин специально созданного пользователя для работы Appex)<br />
* Пароль к шлюзу; (пароль специально созданного пользователя для работы Appex)<br />
* Номер тестовой заявки (номер заявки, по которой будет совершен тестовый платёж).<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
Сообщить Appex адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/{ID_агентства}?LOGIN={логин_пользователя_для_Appex}&PASS={пароль_пользователя_для_Appex}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Appex}'' нужно подставить логин пользователя, созданного для работы Appex<br><br />
* Вместо ''{пароль_пользователя_для_Appex}'' нужно подставить пароль пользователя, созданного для работы Appex<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Appex будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Appex был создан пользователь с логином appex и паролем appexpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/Appex/100?LOGIN=appex&PASS=appexpass&TYPE=1&CODE1={CODE}<br><br />
<br />
[[Файл:Ak_334.png]]<br><br />
<br />
В ответ на заявку, Appex должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Appex.<br />
После вам нужно будет уже добавить платежную систему, для этого перейдите в администрирование-настройка платежных систем нажмите добавить https://prnt.sc/13c4zcf<br />
Здесь заполните все данные кроме api(их пропишите позже) https://prnt.sc/13c55i0<br />
После как получите от Appex биллинг-код, а также данные RemoteApi пропишите их зайдя в редактирование платежной системы https://prnt.sc/13c58b3<br />
<br />
===Binbank. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Binbank будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Binbank логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Binbank адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/{ID_агентства}?LOGIN={логин_пользователя_для_Binbank}&PASS={пароль_пользователя_для_Binbank}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Binbank}'' нужно подставить логин пользователя, созданного для работы Binbank<br><br />
* Вместо ''{пароль_пользователя_для_Binbank}'' нужно подставить пароль пользователя, созданного для работы Binbank<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Binbank будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Binbank был создан пользователь с логином binbank и паролем binbankpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/binbank/100?LOGIN=binbank&PASS=binbankpass&TYPE=1&CODE1={CODE}<br><br />
<br />
===PayKeeper. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* [[Пользователи|Создать пользователя]], под которым PayKeeper будет работать с платежным шлюзом. При [[Пользователи#Добавление пользователя|создании данного пользователя]] необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сформировать '''адрес платежного шлюза''' следующего вида:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/{ID_агентства}/{логин_пользователя_для_PayKeeper}/{пароль_пользователя_для_PayKeeper}<br><br />
В адресе шлюза нужно подставить следующие значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства;<br />
* Вместо ''{логин_пользователя_для_PayKeeper}'' нужно подставить логин пользователя, созданного для работы PayKeeper;<br />
* Вместо ''{пароль_пользователя_для_PayKeeper}'' нужно подставить пароль пользователя, созданного для работы PayKeeper.<br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayKeeper был создан пользователь с логином paykeeper и паролем paykeeperpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PayKeeperProcess/100/paykeeper/paykeeperpass<br><br />
<br />
В личном кабинете PayKeeper необходимо произвести следующие действия:<br />
# Перейти в меню "Настройки",<br />
# Открыть раздел "Получение информации о платежах",<br />
# Указать способ получения уведомления о платежах - "POST-оповещения";<br />
# Внести значение '''адреса платёжного шлюза''' в поле "URL, на который будут отправляться POST-запросы",<br />
# Сгенерировать значение секретного слова, используя кнопку "Сгенерировать",<br />
# Сохранить внесенные изменения.<br><br />
<br />
[[Файл:AK_483.png|border]]<br><br />
<br />
PayKeeper должен прислать Вам данные RemoteApi: <br />
* пользователь, <br />
* пароль, <br />
* Url Api платежной системы (например, http://mag.server.paykeeper.ru).<br />
<br />
Данные, полученные от PayKeeper (пользователь, пароль, Url Api платежной системы), а также секретное слово, сгенерированное ранее в Личном кабинете PayKeeper, необходимо прописать в Mag.Travel, в настройках платежной системы для PayKeeper:<br><br />
* RemoteApi пользователь - пользователь, полученный от PayKeeper;<br />
* RemoteApi пароль - пароль, полученный от PayKeeper;<br />
* RemoteApi ключ - секретное слово, сгенерированное в ЛК PayKeeper;<br />
* Url Api платежной системы - Url Api платежной системы, полученный от PayKeeper.<br />
<br />
[[Файл:AK_484.png|border]]<br><br />
<br />
===Payler. Заявка на подключение===<br />
<br />
Для отправки заявки на подключение платёжной системы Payler необходимо нажать на кнопку [[Файл:Ak_339.png]] и в открывшемся окне заполнить следующие поля:<br />
* Юр. лицо - выбор юр.лица для которого будет производиться подключение ПС;<br />
* Юридическое название вашей компании;<br />
* Контактное лицо;<br />
* Контактный телефон;<br />
* E-mail для контактов (указывается 1 адрес эл.почты);<br />
* Веб-сайт;<br />
* Планируемый оборот.<br />
<br />
Сообщить Payler адрес платежного шлюза:<br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency={ID_агентства}&LOGIN={логин_пользователя_для_Payler}&PASSWORD={пароль_пользователя_для_Payler}<br />
<br />
'''Внимание!''' Учётные данные для подключения к шлюзу (Mag.Travel) необходимо вносить по пользователю, созданному специально для платёжной системы.<br><br />
Такой [[Пользователи|пользователь]] должен иметь [[Роли_пользователей|роль]] ''«Администратор»'' и установленный флаг ''«Запретить вход в систему»''.<br><br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Payler}'' нужно подставить логин пользователя, созданного для работы Payler<br><br />
* Вместо ''{пароль_пользователя_для_Payler}'' нужно подставить пароль пользователя, созданного для работы Payler<br><br />
<br />
''Пример адреса платежного шлюза:''<br><br />
Например, если ID агентства 100 и для Payler был создан пользователь с логином payler и паролем paylerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/PaylerProcess?agency=100&LOGIN=payler&PASSWORD=paylerpass<br><br />
<br />
[[Файл:Ak_337.png]]<br><br />
<br />
Payler должен прислать Вам данные RemoteApi пользователь, пароль, ключ, Url Api, которые необходимо прописать в настройках платёжной системы для Payler.<br />
<br />
===PayOnline. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым PayOnline будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить PayOnline логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить PayOnline адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/PayOnline/{логин_пользователя_для_PayOnline}/{пароль_пользователя_для_PayOnline}/{ID_агентства}/<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_PayOnline}'' нужно подставить логин пользователя, созданного для работы PayOnline<br><br />
* Вместо ''{пароль_пользователя_для_PayOnline}'' нужно подставить пароль пользователя, созданного для работы PayOnline<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр PayOnline будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для PayOnline был создан пользователь с логином payonline и паролем payonlinepass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/ProcessOnline/payonline/payonlinepass/100/<br />
<br />
PayOnline должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для PayOnline.<br />
<br />
===PayTravel. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Pay.Travel будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Pay.Travel логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Pay.Travel, что необходимо передавать суммы в копейках и без точек.<br />
* Сообщить Pay.Travel адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/{ID_агентства}?LOGIN={логин_пользователя_для_Pay.Travel}&PASS={пароль_пользователя_для_Pay.Travel}&TYPE=1&CODE1={CODE}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Pay.Travel}'' нужно подставить логин пользователя, созданного для работы Pay.Travel<br><br />
* Вместо ''{пароль_пользователя_для_Pay.Travel}'' нужно подставить пароль пользователя, созданного для работы Pay.Travel<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Pay.Travel будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Pay.Travel был создан пользователь с логином paytravel и паролем paytravelpass, то ссылка будет такой:<br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/Process/PayTravel/100?LOGIN=paytravel&PASS=paytravelpass&TYPE=1&CODE1={CODE}<br><br />
<br />
Pay.Travel должен прислать Вам биллинг-код, а также данные RemoteApi пользователь, пароль, ключ, которые необходимо прописать в настройках платёжной системы для Pay.Travel.<br />
<br />
===Uniteller. Заявка на подключение===<br />
<br />
Для подключения необходимо:<br />
<br />
* Создать пользователя, под которым Uniteller будет работать с платежным шлюзом. При создании данного пользователя необходимо прописать ему роль ''«Администратор»'' и установить флаг ''«Запретить вход в систему»''.<br />
* Сообщить Uniteller логин и пароль этого пользователя, а также ID вашего агентства.<br />
* Сообщить Uniteller адрес платежного шлюза: <br><br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency={ID агентства в Маг}&login={логин пользователя с правами администратора}&password={пароль пользователя с правами администратора}<br />
<br />
В адресе шлюза нужно подставить нужные значения:<br><br />
* Вместо ''{ID_агентства}'' подставить ID вашего агентства<br><br />
* Вместо ''{логин_пользователя_для_Uniteller}'' нужно подставить логин пользователя, созданного для работы Uniteller<br><br />
* Вместо ''{пароль_пользователя_для_Uniteller}'' нужно подставить пароль пользователя, созданного для работы Uniteller<br><br />
* ''{CODE}'' в ссылке менять не нужно. В этот параметр Uniteller будет передавать номер путевки для оплаты<br><br />
<br />
''Пример адреса платежного шлюза:''<br />
<br>Например, если ID агентства 100 и для Uniteller был создан пользователь с логином uniteller и паролем unitellerpass, то ссылка будет такой: <br><br />
<br />
https://2015.mag.travel/tourclient/PaymentIntegration/UnitellerProcess?agency=100&login=uniteller&password=unitellerpass <br />
<br />
Uniteller должен прислать Вам биллинг-код (id точки продажи), а также данные RemoteApi пользователь, пароль, ключ (совпадает с паролем), которые необходимо прописать в настройках платёжной системы для Uniteller.<br />
<br />
==Платежи==<br />
<br />
===Платежи в списке путевок===<br />
<br />
В списке путёвок как в табличном, так и в плиточном режиме, можно произвести поиск и узнать сумму холдированных платежей, нажав на кнопку [[Файл:Ak_343.png]]:<br><br />
<br />
[[Файл:Ak_167.png|border]]<br><br />
<br />
===Платежи в путевке===<br />
<br />
При подключенных платёжных системах, во вкладке ''[[Путевки#Цена и платежи|Цена и платежи]]'' отображаются ссылки для совершения оплат, а также кнопка для отправки инструкций на оплату для главного клиента (отправка производится на e-mail главного туриста по путёвке):<br><br />
<br />
[[Файл:Ak_260.png|border]]<br><br />
<br />
'''Чтобы отображалась платежная система в путевке, нужно:'''<br />
<br><br />
Во вкладке ([[Путевки#Дополнительно|вкладка Дополнительно]]) необходимо проставить флаг : Доступна для оплаты для отображения ссылки на платежную систему.<br />
<br><br />
[[Файл:154.png]]<br />
<br><br />
'''Либо чтобы она по умолчанию выводилась во всех путевках, необходимо:'''<br />
<br><br />
Администрирование(шестеренка)-настройка-Блок Путевки-Доступна для оплаты<br />
<br><br />
[[Файл:153.png]]<br />
<br><br />
В окне выбора платежных систем для отправки инструкции выводятся также и скрытые по умолчанию.<br><br />
Скрытые по умолчанию платёжные системы не будут отмечены флагами для отправки инструкции, что даёт возможность выбрать только те платёжные системы, инструкции на которые необходимо отправить Главному клиенту:<br><br />
<br />
[[Файл:Ak_360.png|border]]<br><br />
<br />
В данном случае, Appex и PayOnline являются скрытыми по умолчанию платёжными системами.<br><br />
<br />
Если были произведены платежи через платёжные системы, у которых не установлена настройка для платёжной системы ''Без предавторизации'', то также отображается раздел с замороженными платежами в платёжных системах.<br><br />
Данный раздел содержит следующие данные:<br />
* Наименование платёжной системы, через которую осуществляется платёж;<br />
* Дата и время платежа;<br />
* Сумма платежа;<br />
* Статус платёжной операции.<br />
<br />
Платежи, осуществляемые через платёжные системы, подключенные в вкладке ''Настройки платёжных систем'' раздела [[Администрирование]], отображаются в путёвке, по которой производилась оплата, и изначально имеют статус ''Заморожен'':<br> <br />
<br />
[[Файл:Ak_263.png|border]]<br><br />
<br />
Для того, чтобы подтвердить данный платёж, необходимо нажать на кнопку [[Файл:Ak_262.png]] в строке с данным платежом, или отклонить оплату кнопкой [[Файл:Ak_118.png]].<br><br />
При отклонении оплаты, платёж получит статус ''Отменен'', сумма будет возвращена плательщику, а при подтверждении (акцептировании) платежа - платёж будет иметь статус ''Оплачен'':<br />
<br />
[[Файл:Ak_261.png|border]]<br><br />
<br />
В случае установки настройки для платёжной системы ''Без предавторизации'', платежи, совершенные через платёжную систему, будут сразу обработаны и отобразятся в разделе ''[[Путевки#Цена и платежи|Платежи]]''.<br />
<br />
<br />
[[Category:Администрирование]]</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Alfa3.png&diff=1500Файл:Alfa3.png2021-09-23T10:39:13Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Alfa2.png&diff=1499Файл:Alfa2.png2021-09-23T10:39:07Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Alfa.png&diff=1498Файл:Alfa.png2021-09-23T10:39:02Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1497Онлайн кассы2021-08-02T06:10:06Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/wp-content/uploads/2019/06/10.5.0.0.zip драйвер АТОЛ] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
<br><br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_%D0%BA%D0%B0%D1%81%D1%81%D1%8B&diff=1496Онлайн кассы2021-08-02T06:09:32Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
Раздел «Настройки онлайн касс» позволяет управлять информацией о подключенных к системе онлайн-касс и производить настройку интеграции с ними. <br><br />
Интеграцию с кассой можно произвести двумя способами: <br><br />
1. С помощью утилиты MAG Кассы.Атол <br><br />
2. С помощью выделенного ip-адреса <br><br />
<br />
==Интеграция с кассами АТОЛ с помощью выделенного ip-адреса==<br />
В соответствии с Федеральным законом №54-ФЗ юр.лица и индивидуальные предприниматели работают с онлайн-кассами нового образца. Такие кассы подключаются к интернету, печатают чеки и автоматически передают отчеты оператору фискальных данных (ОФД).<br><br />
<br />
====Чтобы перейти на онлайн-кассу, туристическая компания:====<br />
1. Покупает аппарат, который соответствует требованиям ФНС; <br><br />
2. Заключает договор с оператором фискальных данных (ОФД); <br><br />
3. Регистрирует ККТ на сайте налоговой службы или лично в ведомстве; <br><br />
4. Подключает кассу к интернету, чтобы передавать данные о продажах в ФНС <br><br />
----<br />
'''1.''' Туристической компании подойдет любая касса из реестра Федеральной налоговой службы. Она должна быть совместима с фискальным накопителем, подключаться к интернету, печатать чеки с QR-кодами и отправлять их на электронную почту покупателя. Закон не запрещает покупать подержанную ККТ или арендовать у производителя.<br><br />
[https://www.nalog.ru/rn77/related_activities/registries/reestrkkt/ Реестр ККТ ФНС Россиии]<br />
<br><br><br />
'''2.''' ОФД (оператор фискальных данных) — это обязательное звено в системе онлайн-касс для всех торговых компаний. Это относительно новая сущность, с которой приходится сталкиваться всем, кто обязан работать с ККТ и отправлять данные о продажах по новому регламенту в контролирующий орган (в данном случае роль такого органа отведена налоговому ведомству)<br />
В новые кассы встроен фискальный накопитель, ФН — это чип, который сохраняет информацию о покупке, формирует чек и передает его оператору фискальных данных.<br />
ОФД — посредник между магазином и налоговой службой. Он обрабатывает информацию с накопителя и проверяет чек. Если ФНС решит проверить, например, магазин, то запросит данные у ОФД и сравнит их с цифрами из декларации. Если они не совпадают, ФНС приходит с проверкой.<br><br />
<br><br />
Так с помощью онлайн-касс государство отслеживает обороты и контролирует отчисления.<br><br />
<br><br />
При выборе оператора стоит поинтересоваться, ведет ли он деятельность в интересующем вас регионе. Если организация работает в нужном населенном пункте, не лишним будет познакомиться с гарантиями стабильности работы ее оборудования. Ведь от этого напрямую зависит скорость передачи фискальных данных и сам факт их доставки в налоговые органы. В случае если они не окажутся своевременно в налоговой, это вполне предсказуемо грозит штрафом.<br><br />
<br><br />
Что касается расценок за использование услуг ОФД, то в настоящее время они составляют примерно 3000 рублей за каждую кассу в год. Соответственно, вопрос цены при выборе оператора не играет главную роль.<br>[https://www.nalog.ru/rn77/related_activities/registries/fiscaloperators/ Операторы фискальных данных ФНС России] <br><br />
<br><br />
'''3.''' Для того, чтобы зарегистрировать Вашу онлайн кассу в ФНС - проследуйте по [https://www.nalog.ru/rn77/taxation/reference_work/reg_kkt/ ссылке].<br><br />
<br><br />
'''4.'''Система MAG.travel предоставляет туристическим компаниям возможность подключения касс АТОЛ. В будущем планируется подключение и других - Ваши пожелания всегда можно оставить [https://mag.omnidesk.ru/ideas/ здесь].<br><br />
<br><br />
Данная инструкция рассказывает о подключении и настройках касс только в системе MAG. <br><br />
О тонкостях покупки, подключения касс Вы можете узнать на [https://fiscal.atol.ru/kak-podgotovitsya/ сайте АТОЛ]. <br><br />
<br><br />
====Что понадобится для подключения:====<br />
1. Касса Атол ([https://www.atol.ru/catalog/kontrolno-kassovaya-tekhnika/ модели и цены касс]): 1Ф, 11Ф, 15Ф, 20Ф, 22Ф (АТОЛ FPrint- 22ПТК), 25Ф, 27Ф, 30Ф, 42ФС, 50Ф, 52Ф, 55Ф, 60Ф, 77Ф, 90Ф, 91Ф, 92Ф, Sigma 10 (АТОЛ 150Ф), Sigma 7Ф, Sigma 8Ф <br><br />
2. Компьютер, подключенный к интернету со статическим ip (статический ip адрес можно получить через провайдера интернета) <br><br />
3. '''Скачать и установить''' следующие компоненты: программное обеспечение [https://java.com/ru/download/ Java] , [https://atoldriver.ru/wp-content/uploads/2019/06/10.5.0.0.zip драйвер АТОЛ] (обязательно версии не ниже 10) <br><br />
4. Настроить драйвер <br><br />
5. Внести данные в MAG <br><br />
<br><br />
====Установка драйвера АТОЛ:====<br />
* после скачивания и распаковки драйвера, устанавливаем подходящую для ОС версию [[Файл:1.png]] -> [[Файл:2.png]] -> [[Файл:3.png]]<br />
* далее обязательно ставим галочку на пункте Web-сервер <br><br />
[[Файл:4.png]]<br />
* устанавливаем ПО:<br />
[[Файл:5.png]]<br />
<br><br />
<br />
====Настройки АТОЛ:====<br />
<br><br />
В меню пуск, во вкладке АТОЛ находим "Тест драйвера ККТ". В открывшемся окне, при нажатии кнопки "Свойства" будут показаны пункты, которые должны совпадать с настройками произведенными выше<br />
[[Файл:9.png]]<br />
<br><br />
<br><br />
Также, необходимо убедиться, что в драйвере кассы указано верное время:<br />
<br><br />
[[Файл:10.jpg]]<br />
После обязательно закройте программу "Тест драйвера ККТ" и переходите к следующему пункту.<br />
<br><br />
<br />
====Настройки ККТ в MAG:====<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование(шестеренка)» - «Онлайн кассы» .<br />
<br><br />
[[Файл:113.png]]<br />
<br><br />
В открывшемся окне нажать «Добавить онлайн кассу»<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
'''Добавляем онлайн кассу и вносим необходимые настройки:'''<br />
<br><br />
'''Название''' - название вашей кассы<br />
<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию<br />
<br><br />
'''Юр. лицо''' - ваше юр.лицо, в котором находится касса<br />
<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br />
<br><br />
'''Активна''' - обязательный флаг для работы кассы<br />
<br><br />
'''Адрес веб сервиса''' - адрес вашего статического ip. Можно посмотреть в свойствах драйвера ККТ, либо в настройках связей ККТ (см пункты выше)<br />
<br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке<br />
<br><br />
Сохраняем настройки.<br />
<br><br />
[[Файл:114.png]]<br />
<br><br />
<br />
==Интеграция с кассами АТОЛ с помощью утилиты "MAG Кассы.АТОЛ"==<br />
Для настройки кассы Атол через утилиту MAG Кассы.Атол необходимо перейти в раздел «Администрирование» - «Справочники» в настройки онлайн касс.<br />
<br><br />
[[Файл:1-1.png]]<br />
<br><br />
<br><br />
В открывшемся окне нажать '''«Добавить онлайн кассу»'''<br />
<br><br />
[[Файл:2-2.png]]<br />
<br><br />
<br><br />
В диалоговом окне настройки кассы ввести следующие параметры: <br><br />
'''Название''' - название вашей кассы <br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ по умолчанию <br><br />
'''Юр. лицо''' - ваше юр.лицо, на которое зарегистрирована касса. Также необходимо, чтобы у юр. лица, к которому прикреплена касса был email <br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы) <br><br />
'''Активна''' - обязательный флаг для работы кассы <br><br />
'''Место проведения расчетов''' - адрес проведения расчета при печати в чеке <br><br />
<br><br />
Далее необходимо выбрать '''«Интеграция через программу»''', затем скачать и установить программу «MAG Кассы. Атол» на ваш ПК, а сами настройки онлайн кассы сохранить. <br><br />
[[Файл:3-3.png]]<br />
<br><br />
После установки программы на Вашем рабочем столе появится ярлык программы: <br> [[Файл:4-4.png]]. <br><br />
Необходимо запустить её. Если запуск программы не произошел откройте её через панель задач: <br> [[Файл:5-5.png]].<br><br />
Нажмите на данный значок правой кнопкой мыши – подключить кассу <br> [[Файл:6-6.png]]. <br><br />
Появится окно настройки кассы Атол, где необходимо нажать '''«Проверка связи»''' <br> [[Файл:7-7.png]]<br><br />
<br><br />
При удачной проверке в поле '''«Результат»''' появится наименование кассы и её параметры, если все верно, необходимо нажать '''«ОК»'''. <br><br />
[[Файл:8-8.png]]<br><br />
<br><br />
Появится окно для подключения кассы, в который необходимо ввести ключ подключения:<br><br />
[[Файл:9-9.png]]<br><br />
<br><br />
Ключ доступен в настройках онлайн касс в системе MAG.Travel, он генерируется после сохранения настроек:<br><br />
[[Файл:10-10.png]]<br />
<br />
<br><br />
Также, следует настроить систему налогообложения и ставку НДС, т.к. они будут отправляться в ФНС и использоваться при печати фискальных чеков:<br />
<br><br />
[[Файл:666.png]]<br />
<br><br />
Пункт "Агентская схема" используйте в том случае, если зарегистрировали кассу в налоговой с соответствующим признаком агента.<br />
<br><br />
В ином случае оставляете "Не использовать агентскую схему"<br />
<br><br />
[[Файл:667.png]]<br />
<br><br />
<br />
==Атол Онлайн==<br />
'''Общая схема оплаты при подключении АТОЛ онлайн:'''<br />
* платёж поступает в платежную систему<br />
* платежная система отправляет холд в MAG<br />
* MAG отправляет чек в АТОЛ онлайн<br />
* АТОЛ онлайн отправляет чек в ОФД<br />
* ОФД отправляет чек на email клиента (и в налоговую)<br />
<br><br />
Инструкция по подключению и основным настройкам АТОЛ онлайн подробно представлена на сайте [https://online.atol.ru/ online.atol.ru]<br><br />
<br><br />
'''Для того, чтобы завершить процесс настройки и интегрировать вашу онлайн кассу с MAG, необходимо сделать следующее:'''<br><br />
1. В системе MAG.travel зайти в раздел Администрирование -> Онлайн кассы -> Добавить онлайн кассу<br />
2. Добавляем онлайн кассу и вносим необходимые настройки:<br><br />
'''Название''' - название вашей кассы<br><br />
'''Тип онлайн кассы''' - выбираем АТОЛ онлайн.<br><br />
'''Юр. лицо''' - выбор необходимого юр.лица. Также необходимо, что бы у юр. лица, к которому прикреплена касса (или у юр. лица по умолчанию, если касса прикреплена в Маге ко всем юр. лицам) был email<br><br />
'''Отдел''' - это офис для которого возможно использование данной кассы (если офис не указан - кассу могут использовать все офисы)<br><br />
'''Активна''' - обязательный флаг для работы кассы<br><br />
'''Идентификатор группы ККТ и логин/пароль:'''<br><br />
После успешной фискализации первой ККТ в разделе «Мои компании» в личном кабинете АТОЛ, отобразится кнопка "Настройки интегратора".<br><br />
[[Файл:1AO.png]]<br><br />
По клику на кнопку выгрузится файл в формате *.xml, содержащий данные для взаимодействия с сервисом.<br><br />
<?xml version="1.0" encoding="UTF-8"?><br><br />
<cms_params Company="Trishin" INN="999999999999" KPP=""><br><br />
<shop hostname="www.shopmy.ru"><br><br />
<access login=" shopmy-ru" password="6#jYZjУЕ" group_code="shopmy-ru _0"/><br><br />
</shop><br><br />
</cms_params><br><br />
<br><br />
Скопируйте данные из этого файла и перенесите в соответствующие поля в "Настройках онлайн касс" системы MAG.<br><br />
<br><br />
'''Параметры''':<br><br />
<shop hostname="www.shopmy.ru">- сайт который указывается при регистрации, именно его нужно прописать в '''Место проведения расчетов''' - через него будет происходить оплата. В случае если сайтов несколько - указываете только один;<br><br />
login – логин для отправки данных("Логин");<br><br />
password – пароль для отправки данных("Пароль");<br><br />
group_code – код группы ("Идентификатор группы ККТ");<br><br />
<br><br />
Сохраняем настройки.<br><br />
[[Файл:2AO.png]]<br><br />
3. Если у Вас уже есть подключение к платежным системам, необходимо проследовать в меню Администрирование -> Настройка платежных систем и выбрать вашу онлайн кассу<br><br />
[[Файл:3AO.png]]<br><br />
''Если Вы еще не подключены к какой-либо платежной системе - на сайте MAG.travel в разделе "Интеграции" представлена информация о партнерах [https://www.mag.travel/partners/ https://www.mag.travel/partners/]''<br><br />
<br />
----<br />
'''Вопрос- ответ:'''<br><br />
1. Q: Работает это так, поступает платёж в Пэйлер, Пэйлер отправляет холд в MAG: данный функционал реализован на стороне Пэйлера?<br><br />
A: Отправка холда в Маг реализована на стороне Пейлера, Маг такой холд сохраняет и отображает в путевке и в списке путевок.<br><br />
2. Q: MAG отправляет чек в Атол онлайн, Атол онлайн отправляет чек в ОФД, ОФД отправляет чек на email клиента (и в налоговую). На какой email отправляется чек, на тот который указан в карточке туриста в MAG или на тот, который указывается в Пэйлере при заведении платежа, когда переходишь по ссылке?<br><br />
A: Основной email в карточке туриста в MAG.<br><br />
3. Q: Можно ли отправлять чек клиенту, когда деньги еще не списаны и возможен возврат?<br><br />
A: Чек отправляется непосредственно в тот момент, когда клиент платит деньги. В случае возврата будет уже новый чек - возврат по заказу.<br><br />
<br />
==Если возникли проблемы==<br />
Если кассу Атол не удается подключить, необходимо проверить доступен ли порт кассы для подключения. Для этого:<br><br />
*отключите программу интеграции кассы с Mag.Travel<br><br />
*откройте Тест драйвера ККТ и нажмите "Проверить связь"<br><br />
[[Файл:1E.png]]<br><br />
Если при проверке сведений в поле "Результат" появилась информация:<br><br />
*нет связи - касса выключена\не подключена<br><br />
*порт занят - другая программа подключена к кассе в данный момент<br><br />
[[Файл:2E.png]]<br><br />
В таком случае необходимо произвести проверку подключенных программ, например, через Process Exploer, пример - [https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm https://www.intech.co.nz/downloads/help/mscanv5/faq_84.htm]<br><br />
В некоторых случаях проблема может быть из-за службы EoU. Она описана здесь - [https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php https://kkmspb.ru/kontrolno-kassovaya-tekhnika/kassovye-apparaty/knowledge-base/Atol/the-port-is-busy.php]<br><br />
После проверок порта и перед запуском программы "Mag Кассы.Атол" нужно закрыть тест драйвера ККТ.</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_IP-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD%D0%B8%D0%B8&diff=1495Интеграция IP-телефонии2021-07-05T06:56:16Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.<br><br />
На данный момент их 5:<br />
* Asterisk;<br />
* Mango-Office;<br />
* Mobilon;<br />
* Oktell;<br />
* Zadarma;<br />
* UIS<br />
Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:<br />
* Создавать клиентов из карточки звонка;<br />
* Добавлять Лид, а также определять имеющийся лид по клиенту;<br />
* Создавать предварительный заказ;<br />
* Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;<br />
* Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).<br />
<br />
==Asterisk==<br />
<br />
Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:<br><br />
* Адрес сервера Asterisk,<br />
* Порт для подключения к AMI (Asterisk management Interface),<br />
* Логин AMI,<br />
* Пароль AMI.<br />
<br />
Ип с которых должен быть доступен Астериск по AMI<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
<br />
Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf<br />
<br />
Для этого в manager.conf должны быть прописаны логин и пароль ами, а также разрешения на all<br><br />
Пример конфигурации:<br><br />
[magtravel]<br><br />
secret = XXXXXXX<br><br />
deny=0.0.0.0/0.0.0.0<br><br />
permit=148.251.195.241/255.255.255.255<br><br />
permit=188.40.126.229/255.255.255.255<br><br />
permit=148.251.22.175/255.255.255.255<br><br />
permit=185.26.169.104/255.255.255.255<br><br />
read = all,cdr<br><br />
write = all,cdr<br><br />
writetimeout = 500<br><br />
<br />
*Вместо XXXXXXX необходимо указать пароль для подключения, который затем прописать в настройках телефонии в Маге.*<br><br />
<br />
Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html<br><br />
В файле queues.conf должна быть строка: eventwhencalled = yes<br><br />
А также: eventmemberstatus = yes<br><br />
И Астериск должен быть собран с модулем apps/app_queue.c<br><br />
<br><br />
Можно указать контекст Астериск для исходящих звонков.<br><br />
Этот контекст будет использоваться при звонке из Мага.<br><br />
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)<br><br />
<br><br />
Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер<br><br />
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/<br><br />
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP<br><br />
<br><br />
Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.<br><br />
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.<br><br />
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:<br><br />
<br><br />
<br />
Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)<br><br />
<br />
Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)<br><br />
<br />
[magtransfer]<br><br />
exten => s,1,Set(DEFEXT=200)<br><br />
exten => s,n,Set(API_key=API_KEY_TEXT)<br><br />
exten => s,n,Set(RingTime=15)<br><br />
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))<br><br />
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)<br><br />
exten => s,n,NoOp(FROM_DID=${FROM_DID})<br><br />
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})<br><br />
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})<br><br />
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)<br><br />
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
<br><br />
где:<br><br />
* ID_IN_MAG – ID который указываете при входе в систему;<br />
* API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*<br />
* DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение<br />
* FROM_DID - транк, на который поступил звонок<br />
* TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)<br />
<br />
Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer<br />
<br />
==Mango-Office==<br />
<br />
Для интеграции с IP-телефонией '''Mango-Office''' необходимо '''быть действующим клиентом Mango-Office'''.<br><br />
<br />
===Регистрация в Mango-Office===<br />
<br />
Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br><br />
Регистрация в Mango-Office<br />
Шаг 1. Войдите в Личный кабинет Виртуальной АТС (ВАТС).<br />
Шаг 2. Перейдите в раздел «Интеграции»:<br />
<br />
[[Файл:M1.png]]<br><br />
<br />
Шаг 3. Откройте вкладку «API коннектор».<br />
<br />
[[Файл:M2.png|border]]<br><br />
<br />
Шаг 4. Сохраните данные вашей АТС для дальнейшего копирования в виджет CRM-системы или не закрывайте вкладку до окончания настройки интеграции.':<br> <br />
<br />
[[Файл:M3.png|border]]<br><br />
Шаг 5. В поле «адрес внешней системы» впишите адрес СRM-системы или сервера для принятия и обработки уведомлений, которые посылает API.<br />
<br />
Также указать следующие данные:<br />
Адрес внешней системы: https://2015.mag.travel/tourclient/api/Telephony/Mango/999 , где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015;<br />
SSL-сертификат: Не проверять сертификат;<br />
[[Файл:M4.png|border]]<br><br />
<br />
Шаг 6. Установите безопасность посредством IP-адресов. Если вы хотите прослушивать записи разговоров прямо из CRM, то установите флаг «записи разговоров» (при этом необходимо подключить услугу «запись разговоров» в личном кабинете → вкладка «инструменты» → выберите пункт «запись разговоров» и нажмите кнопку «подключить»). Для принятия настроек нажмите кнопку «сохранить».<br />
[[Файл:M5.png|border]]<br><br />
<br />
Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br />
<br />
Шаг 7 Необходимо создать в системе сотрудников и создать им SIP-аккаунт.<br />
[[Файл:M6.png|border]]<br><br />
[[Файл:M7.png|border]]<br><br />
<br />
'''Настройка Mango-Office в MAG.Travel 2015'''<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии".<br />
[[Файл:M8.png|border]]<br><br />
[[Файл:M9.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br />
В Mango-Office:<br />
[[Файл:M10.png|border]]<br><br />
В MAG.Travel 2015:<br />
[[Файл:M11.png|border]]<br><br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015<br />
[[Файл:M12.png|border]]<br><br />
Cервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br />
[[Файл:M13.png|border]]<br><br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
'''Назначение звонков ответственному менеджеру'''<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br />
Таким образом, не отвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br />
[[Файл:M14.png|border]]<br><br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br />
[[Файл:M15.png|border]]<br><br />
[[Файл:M16.png|border]]<br><br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br />
<br />
===Настройка Mango-Office в MAG.Travel 2015===<br />
<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии". <br><br />
<br />
[[Файл:Ak_320.png|border]]<br><br />
<br />
[[Файл:Ak_326.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br><br />
В Mango-Office:<br><br />
<br />
[[Файл:Ak_328.png]]<br><br />
<br />
В MAG.Travel 2015:<br><br />
<br />
[[Файл:Ak_327.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015 [[Файл:Ak_329.png]], сервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br><br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
====Назначение звонков ответственному менеджеру====<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br><br />
Таким образом, неотвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br><br />
<br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br><br />
<br />
[[Файл:Ak_454.png|Пример схемы распределения звонков]]<br><br />
<br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br><br />
<br />
==Mobilon==<br />
<br />
Для интеграции с IP-телефонией '''Mobilon''' необходимо '''быть действующим клиентом Mobilon'''.<br><br />
<br />
===Настройка в Mobilon===<br />
<br />
В личном кабинете Mobilon, в разделе ''Интеграция'', на вкладке ''Настройки'' необходимо прописать данные для интеграции с Mag.Travel 2015:<br><br />
* Тип: '''Webhook''';<br />
* В поле URL для событий размещаем ссылку <code>https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015.<br><br />
<br />
[[Файл:Ak_432.png|border]]<br><br />
<br />
Также, необходимо создать Абонентов в разделе ''Конфигуратор'' подпункт ''Абонент'':<br><br />
<br />
[[Файл:Ak_433.png|border]]<br><br />
<br />
===Настройка Mobilon в MAG.Travel 2015===<br />
<br />
Для настройки в Mag.Travel 2015 необходимо перейти в раздел Администрирования, справочник ''Настройки IP-телефонии'' и в поле ''Тип телефонии'' выбрать Mobilion:<br />
<br />
[[Файл:Ak_435.png]]<br><br />
<br />
Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:<br />
* Внутренний номер;<br />
* Userkey.<br />
<br />
Данные для поля Userkey необходимо взять из данных абонентов в кабинете Mobilon:<br><br />
<br />
[[Файл:Ak_434.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
==Oktell==<br />
Для Интеграции с ip-телефонией Oktell необходимо:<br />
<br />
В поле «Тип телефонии» выбрать Oktell<br />
<br />
В поле «Автоматическое создание клиента» выбрать в каком из предложенных вариантов будет автоматически создан клиент:<br />
- Не создавать – при поступлении входящего звонка новый клиент создан не будет<br />
- При входящем с неизвестного номера – новый клиент создастся, если входящий звонок поступит с номера телефона, которого ещё нет в вашей базе<br />
- При пропущенном входящем с неизвестного номера - новый клиент создастся, если на входящий звонок не было ответа и такого номера телефона нет в вашей базе<br />
<br />
Выбрать один из предложенных вариантов в поле «Автоматическое создание лида», где:<br />
- Не создавать – Лид в базе создан не будет<br />
- При каждом входящем звонке – Лид создается по каждому входящему звонку, не важно от кого и с какого номера телефона поступил звонок<br />
- При входящем с неизвестного номера – Лид создается только в том случае, если звонок поступил с неизвестного номера<br />
При пропущенном входящем с неизвестного номера - Лид создается, если на звонок не было ответа и он поступил с неизвестного номера<br />
<br />
В поле «Изменять статус лида при пропущенном звонке» выбрать на какой статус Лида изменять статус, если звонок был пропущен (статусы подтягиваются из соответствующего справочника)<br />
<br />
В поле «Сервер Oktell» прописать ссылку на ваш сервер Oktell с префиксом «ws://»<br />
<br><br />
[[Файл:Oktell.png]]<br />
<br><br />
'''Внимание!''' Десктопное приложение Oktell не взаимодействует с Mag.Travel.<br />
<br />
==Zadarma==<br />
<br />
В ЛК ZADARMA перейдите в раздел "Настройки" - "API и интеграции".<br />
Здесь вы можете найти API ключ и ключ для создания подписи.<br />
Их нужно прописать в настройках IP телефонии в системе MAG.Travel<br />
<br />
В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида:<br />
http://2015.mag.travel/TourClient/api/Telephony/Zadarma/999999/events при этом заменить 999999 на Ваш ID в MAG<br />
и справа отметьте все события:<br />
[[Файл:2019-10-02_12-03_Zadarma.jpg]]<br />
<br />
Также в системе MAG.Travel, в настройках IP телефонии нужно прописать внутренние номера пользователей для которых будет доступна интеграция.<br />
В ZADARMA можно найти внутренние номера сотрудников в разделе Моя АТС, внутренние номера. Поле с номером - "Внутренний номер АТС"<br />
<br />
Также, для записи разговоров должен быть установлен флаг:<br />
Запись разговоров - в облако<br />
<br />
[[Файл:Zadarmarecording.jpg]]<br />
<br />
Для приема входящих звонков в ЛК ZADARMA должны быть подключены номера в разделе Моя АТС, внешние линии.<br />
<br />
==UIS==<br />
<br />
1. Подключить API<br />
Нужно подключить компонент «Call API Базовый набор» и «Уведомления». Для переадресации на ответственного нужно также подключить «Call API Управление вызовами»\<br />
Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:<br><br />
[[Файл:UIS1.png]]<br />
<br />
2. Доступ к АПИ<br />
Ключи генерируются на уровне пользователя в разделе личного кабинета "Аккаунт" → "Управление пользователями"<br />
Существует два типа ключей:<br />
Постоянный. Постоянный ключ имеет неограниченное время действия.<br />
Временный. Временный ключ имеет конкретную дату окончания действия ключа.<br />
Генерируем постоянный ключ.<br />
При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.<br><br />
[[Файл:UIS2.png]]<br />
<br />
3. Настройка доступа по IP<br />
<br />
По умолчанию доступ к API запрещен всем, чтобы можно было делать запросы необходимо IP-адрес хоста с которого делается запрос добавить в белый список. Это можно сделать через личный кабинет "Администратор -> Аккаунт -> Правила и настройки безопасности" вкладка "API".<br />
Наши IP:<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
[[Файл:UIS3.png]]<br />
<br />
4. Настройка IP телефонии в МАГЕ<br />
<br />
Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”<br><br />
[[Файл:UIS4.png]]<br><br />
Здесь тип телефонии выбирайте UIS.<br />
Ключ доступа к API UIS вставьте, что вы сгенерировали в личном кабинете UIS.<br />
Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.<br><br />
[[Файл:UIS5.png]]<br />
<br />
5. Настройка уведомлений<br />
<br />
Чтобы настроить получение уведомлений, перейдите в раздел Сервисы и статистика, в боковом меню откройте Уведомления и нажмите добавить. В открывшемся окне необходимо заполнить параметры: название уведомления; тип события, о котором нужно вас уведомить; условия, при которых будет приходить уведомление; способ получения уведомлений.<br />
Нужно настроить 8 HTTP уведомлений<br><br />
[[Файл:UIS6.png]]<br />
<br />
При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.<br><br />
<br />
'''Входящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLeg<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id": {{contact_id}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"leg_id": {{leg_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Исходящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/OutgoingLeg<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id": {{contact_id}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"leg_id": {{leg_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Входящий звонок на виртуальный номер'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLine<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}},<br />
<br />
"contact_id": {{contact_id}},<br />
<br />
"contact_full_name": {{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Исходящий звонок'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Outgoing<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id":{{contact_id}},<br />
<br />
"contact_full_name":{{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"employee_info":{<br />
<br />
"employee_full_name":{{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Начало разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/CallStarted<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"contact_id":{{contact_id}},<br />
<br />
"contact_full_name":{{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"employee_info":{<br />
<br />
"employee_full_name":{{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Окончание разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndPart<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_info": {<br />
<br />
"call_source": {{call_source}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"direction": {{direction}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"talk_time_duration": {{talk_time_duration}}<br />
<br />
},<br />
<br />
"leg_ids": {{leg_ids}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Завершение звонка'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndCall<br />
<br />
{<br />
<br />
"notification_name":{{notification_name}},<br />
<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
<br />
"notification_time":{{notification_time}},<br />
<br />
"external_id": {{external_id}},<br />
<br />
"contact_info":{<br />
<br />
"contact_phone_number":{{contact_phone_number}},<br />
<br />
"communication_number":{{communication_number}}<br />
<br />
},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_info": {<br />
<br />
"call_source": {{call_source}},<br />
<br />
"direction": {{direction}},<br />
<br />
"call_session_id":{{call_session_id}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"talk_time_duration": {{talk_time_duration}},<br />
<br />
"total_time_duration": {{total_time_duration}},<br />
<br />
"wait_time_duration": {{wait_time_duration}},<br />
<br />
"tag_names": {{tag_names}}<br />
<br />
},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}<br />
<br />
'''Записанный разговор'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Record<br />
<br />
{<br />
<br />
"notification_name": {{notification_name}},<br />
<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
<br />
"notification_time": {{notification_time}},<br />
<br />
"scenario_name": {{scenario_name}},<br />
<br />
"contact_info": {<br />
<br />
"contact_phone_number": {{contact_phone_number}},<br />
<br />
"communication_number": {{communication_number}},<br />
<br />
"contact_id": {{contact_id}},<br />
<br />
"contact_full_name": {{contact_full_name}}<br />
<br />
},<br />
<br />
"call_session_id": {{call_session_id}},<br />
<br />
"employee_info": {<br />
<br />
"employee_full_name": {{employee_full_name}},<br />
<br />
"extension_phone_number": {{extension_phone_number}}<br />
<br />
},<br />
<br />
"call_record_file_info": {<br />
<br />
"file_link": {{file_link}},<br />
<br />
"call_record_duration": {{file_duration}}<br />
<br />
},<br />
<br />
"tag_ids": {{tag_ids}},<br />
<br />
"tag_names": {{tag_names}},<br />
<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
<br />
}</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_IP-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD%D0%B8%D0%B8&diff=1494Интеграция IP-телефонии2021-07-05T06:52:49Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.<br><br />
На данный момент их 5:<br />
* Asterisk;<br />
* Mango-Office;<br />
* Mobilon;<br />
* Oktell;<br />
* Zadarma;<br />
* UIS<br />
Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:<br />
* Создавать клиентов из карточки звонка;<br />
* Добавлять Лид, а также определять имеющийся лид по клиенту;<br />
* Создавать предварительный заказ;<br />
* Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;<br />
* Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).<br />
<br />
==Asterisk==<br />
<br />
Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:<br><br />
* Адрес сервера Asterisk,<br />
* Порт для подключения к AMI (Asterisk management Interface),<br />
* Логин AMI,<br />
* Пароль AMI.<br />
<br />
Ип с которых должен быть доступен Астериск по AMI<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
<br />
Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf<br />
<br />
Для этого в manager.conf должны быть прописаны логин и пароль ами, а также разрешения на all<br><br />
Пример конфигурации:<br><br />
[magtravel]<br><br />
secret = XXXXXXX<br><br />
deny=0.0.0.0/0.0.0.0<br><br />
permit=148.251.195.241/255.255.255.255<br><br />
permit=188.40.126.229/255.255.255.255<br><br />
permit=148.251.22.175/255.255.255.255<br><br />
permit=185.26.169.104/255.255.255.255<br><br />
read = all,cdr<br><br />
write = all,cdr<br><br />
writetimeout = 500<br><br />
<br />
*Вместо XXXXXXX необходимо указать пароль для подключения, который затем прописать в настройках телефонии в Маге.*<br><br />
<br />
Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html<br><br />
В файле queues.conf должна быть строка: eventwhencalled = yes<br><br />
А также: eventmemberstatus = yes<br><br />
И Астериск должен быть собран с модулем apps/app_queue.c<br><br />
<br><br />
Можно указать контекст Астериск для исходящих звонков.<br><br />
Этот контекст будет использоваться при звонке из Мага.<br><br />
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)<br><br />
<br><br />
Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер<br><br />
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/<br><br />
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP<br><br />
<br><br />
Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.<br><br />
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.<br><br />
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:<br><br />
<br><br />
<br />
Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)<br><br />
<br />
Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)<br><br />
<br />
[magtransfer]<br><br />
exten => s,1,Set(DEFEXT=200)<br><br />
exten => s,n,Set(API_key=API_KEY_TEXT)<br><br />
exten => s,n,Set(RingTime=15)<br><br />
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))<br><br />
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)<br><br />
exten => s,n,NoOp(FROM_DID=${FROM_DID})<br><br />
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})<br><br />
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})<br><br />
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)<br><br />
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
<br><br />
где:<br><br />
* ID_IN_MAG – ID который указываете при входе в систему;<br />
* API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*<br />
* DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение<br />
* FROM_DID - транк, на который поступил звонок<br />
* TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)<br />
<br />
Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer<br />
<br />
==Mango-Office==<br />
<br />
Для интеграции с IP-телефонией '''Mango-Office''' необходимо '''быть действующим клиентом Mango-Office'''.<br><br />
<br />
===Регистрация в Mango-Office===<br />
<br />
Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br><br />
Регистрация в Mango-Office<br />
Шаг 1. Войдите в Личный кабинет Виртуальной АТС (ВАТС).<br />
Шаг 2. Перейдите в раздел «Интеграции»:<br />
<br />
[[Файл:M1.png]]<br><br />
<br />
Шаг 3. Откройте вкладку «API коннектор».<br />
<br />
[[Файл:M2.png|border]]<br><br />
<br />
Шаг 4. Сохраните данные вашей АТС для дальнейшего копирования в виджет CRM-системы или не закрывайте вкладку до окончания настройки интеграции.':<br> <br />
<br />
[[Файл:M3.png|border]]<br><br />
Шаг 5. В поле «адрес внешней системы» впишите адрес СRM-системы или сервера для принятия и обработки уведомлений, которые посылает API.<br />
<br />
Также указать следующие данные:<br />
Адрес внешней системы: https://2015.mag.travel/tourclient/api/Telephony/Mango/999 , где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015;<br />
SSL-сертификат: Не проверять сертификат;<br />
[[Файл:M4.png|border]]<br><br />
<br />
Шаг 6. Установите безопасность посредством IP-адресов. Если вы хотите прослушивать записи разговоров прямо из CRM, то установите флаг «записи разговоров» (при этом необходимо подключить услугу «запись разговоров» в личном кабинете → вкладка «инструменты» → выберите пункт «запись разговоров» и нажмите кнопку «подключить»). Для принятия настроек нажмите кнопку «сохранить».<br />
[[Файл:M5.png|border]]<br><br />
<br />
Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br />
<br />
Шаг 7 Необходимо создать в системе сотрудников и создать им SIP-аккаунт.<br />
[[Файл:M6.png|border]]<br><br />
[[Файл:M7.png|border]]<br><br />
<br />
'''Настройка Mango-Office в MAG.Travel 2015'''<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии".<br />
[[Файл:M8.png|border]]<br><br />
[[Файл:M9.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br />
В Mango-Office:<br />
[[Файл:M10.png|border]]<br><br />
В MAG.Travel 2015:<br />
[[Файл:M11.png|border]]<br><br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015<br />
[[Файл:M12.png|border]]<br><br />
Cервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br />
[[Файл:M13.png|border]]<br><br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
'''Назначение звонков ответственному менеджеру'''<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br />
Таким образом, не отвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br />
[[Файл:M14.png|border]]<br><br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br />
[[Файл:M15.png|border]]<br><br />
[[Файл:M16.png|border]]<br><br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br />
<br />
===Настройка Mango-Office в MAG.Travel 2015===<br />
<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии". <br><br />
<br />
[[Файл:Ak_320.png|border]]<br><br />
<br />
[[Файл:Ak_326.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br><br />
В Mango-Office:<br><br />
<br />
[[Файл:Ak_328.png]]<br><br />
<br />
В MAG.Travel 2015:<br><br />
<br />
[[Файл:Ak_327.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015 [[Файл:Ak_329.png]], сервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br><br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
====Назначение звонков ответственному менеджеру====<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br><br />
Таким образом, неотвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br><br />
<br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br><br />
<br />
[[Файл:Ak_454.png|Пример схемы распределения звонков]]<br><br />
<br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br><br />
<br />
==Mobilon==<br />
<br />
Для интеграции с IP-телефонией '''Mobilon''' необходимо '''быть действующим клиентом Mobilon'''.<br><br />
<br />
===Настройка в Mobilon===<br />
<br />
В личном кабинете Mobilon, в разделе ''Интеграция'', на вкладке ''Настройки'' необходимо прописать данные для интеграции с Mag.Travel 2015:<br><br />
* Тип: '''Webhook''';<br />
* В поле URL для событий размещаем ссылку <code>https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015.<br><br />
<br />
[[Файл:Ak_432.png|border]]<br><br />
<br />
Также, необходимо создать Абонентов в разделе ''Конфигуратор'' подпункт ''Абонент'':<br><br />
<br />
[[Файл:Ak_433.png|border]]<br><br />
<br />
===Настройка Mobilon в MAG.Travel 2015===<br />
<br />
Для настройки в Mag.Travel 2015 необходимо перейти в раздел Администрирования, справочник ''Настройки IP-телефонии'' и в поле ''Тип телефонии'' выбрать Mobilion:<br />
<br />
[[Файл:Ak_435.png]]<br><br />
<br />
Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:<br />
* Внутренний номер;<br />
* Userkey.<br />
<br />
Данные для поля Userkey необходимо взять из данных абонентов в кабинете Mobilon:<br><br />
<br />
[[Файл:Ak_434.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
==Oktell==<br />
Для Интеграции с ip-телефонией Oktell необходимо:<br />
<br />
В поле «Тип телефонии» выбрать Oktell<br />
<br />
В поле «Автоматическое создание клиента» выбрать в каком из предложенных вариантов будет автоматически создан клиент:<br />
- Не создавать – при поступлении входящего звонка новый клиент создан не будет<br />
- При входящем с неизвестного номера – новый клиент создастся, если входящий звонок поступит с номера телефона, которого ещё нет в вашей базе<br />
- При пропущенном входящем с неизвестного номера - новый клиент создастся, если на входящий звонок не было ответа и такого номера телефона нет в вашей базе<br />
<br />
Выбрать один из предложенных вариантов в поле «Автоматическое создание лида», где:<br />
- Не создавать – Лид в базе создан не будет<br />
- При каждом входящем звонке – Лид создается по каждому входящему звонку, не важно от кого и с какого номера телефона поступил звонок<br />
- При входящем с неизвестного номера – Лид создается только в том случае, если звонок поступил с неизвестного номера<br />
При пропущенном входящем с неизвестного номера - Лид создается, если на звонок не было ответа и он поступил с неизвестного номера<br />
<br />
В поле «Изменять статус лида при пропущенном звонке» выбрать на какой статус Лида изменять статус, если звонок был пропущен (статусы подтягиваются из соответствующего справочника)<br />
<br />
В поле «Сервер Oktell» прописать ссылку на ваш сервер Oktell с префиксом «ws://»<br />
<br><br />
[[Файл:Oktell.png]]<br />
<br><br />
'''Внимание!''' Десктопное приложение Oktell не взаимодействует с Mag.Travel.<br />
<br />
==Zadarma==<br />
<br />
В ЛК ZADARMA перейдите в раздел "Настройки" - "API и интеграции".<br />
Здесь вы можете найти API ключ и ключ для создания подписи.<br />
Их нужно прописать в настройках IP телефонии в системе MAG.Travel<br />
<br />
В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида:<br />
http://2015.mag.travel/TourClient/api/Telephony/Zadarma/999999/events при этом заменить 999999 на Ваш ID в MAG<br />
и справа отметьте все события:<br />
[[Файл:2019-10-02_12-03_Zadarma.jpg]]<br />
<br />
Также в системе MAG.Travel, в настройках IP телефонии нужно прописать внутренние номера пользователей для которых будет доступна интеграция.<br />
В ZADARMA можно найти внутренние номера сотрудников в разделе Моя АТС, внутренние номера. Поле с номером - "Внутренний номер АТС"<br />
<br />
Также, для записи разговоров должен быть установлен флаг:<br />
Запись разговоров - в облако<br />
<br />
[[Файл:Zadarmarecording.jpg]]<br />
<br />
Для приема входящих звонков в ЛК ZADARMA должны быть подключены номера в разделе Моя АТС, внешние линии.<br />
<br />
==UIS==<br />
<br />
1. Подключить API<br />
Нужно подключить компонент «Call API Базовый набор» и «Уведомления». Для переадресации на ответственного нужно также подключить «Call API Управление вызовами»\<br />
Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:<br><br />
[[Файл:UIS1.png]]<br />
<br />
2. Доступ к АПИ<br />
Ключи генерируются на уровне пользователя в разделе личного кабинета "Аккаунт" → "Управление пользователями"<br />
Существует два типа ключей:<br />
Постоянный. Постоянный ключ имеет неограниченное время действия.<br />
Временный. Временный ключ имеет конкретную дату окончания действия ключа.<br />
Генерируем постоянный ключ.<br />
При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.<br><br />
[[Файл:UIS2.png]]<br />
<br />
3. Настройка доступа по IP<br />
<br />
По умолчанию доступ к API запрещен всем, чтобы можно было делать запросы необходимо IP-адрес хоста с которого делается запрос добавить в белый список. Это можно сделать через личный кабинет "Администратор -> Аккаунт -> Правила и настройки безопасности" вкладка "API".<br />
Наши IP:<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
[[Файл:UIS3.png]]<br />
<br />
4. Настройка IP телефонии в МАГЕ<br />
<br />
Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”<br><br />
[[Файл:UIS4.png]]<br><br />
Здесь тип телефонии выбирайте UIS.<br />
Ключ доступа к API UIS вставьте, что вы сгенерировали в личном кабинете UIS.<br />
Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.<br><br />
[[Файл:UIS5.png]]<br />
<br />
5. Настройка уведомлений<br />
<br />
Чтобы настроить получение уведомлений, перейдите в раздел Сервисы и статистика, в боковом меню откройте Уведомления и нажмите добавить. В открывшемся окне необходимо заполнить параметры: название уведомления; тип события, о котором нужно вас уведомить; условия, при которых будет приходить уведомление; способ получения уведомлений.<br />
Нужно настроить 8 HTTP уведомлений<br><br />
[[Файл:UIS6.png]]<br />
<br />
При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.<br><br />
<br />
'''Входящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLeg<br />
<br />
{<br><br />
"notification_name":{{notification_name}},<br><br />
"notification_time":{{notification_time}},<br><br />
"external_id": {{external_id}},<br><br />
"contact_info":{<br><br />
"contact_phone_number":{{contact_phone_number}},<br><br />
"contact_id": {{contact_id}}<br><br />
},<br><br />
"employee_info": {<br><br />
"employee_full_name": {{employee_full_name}},<br><br />
"extension_phone_number": {{extension_phone_number}}<br><br />
},<br><br />
"call_source": {{call_source}},<br><br />
"call_session_id":{{call_session_id}},<br><br />
"direction": {{direction}},<br><br />
"leg_id": {{leg_id}},<br><br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br><br />
}<br><br />
<br />
'''Исходящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/OutgoingLeg<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id": {{contact_id}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_source": {{call_source}},<br />
"call_session_id":{{call_session_id}},<br />
"direction": {{direction}},<br />
"leg_id": {{leg_id}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Входящий звонок на виртуальный номер'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLine<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
"notification_time":{{notification_time}},<br />
"scenario_name": {{scenario_name}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"communication_number":{{communication_number}},<br />
"contact_id": {{contact_id}},<br />
"contact_full_name": {{contact_full_name}}<br />
},<br />
"call_session_id":{{call_session_id}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Исходящий звонок'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Outgoing<br />
<br />
{<br />
"notification_name": {{notification_name}},<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
"notification_time": {{notification_time}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id":{{contact_id}},<br />
"contact_full_name":{{contact_full_name}}<br />
},<br />
"call_session_id":{{call_session_id}},<br />
"employee_info":{<br />
"employee_full_name":{{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Начало разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/CallStarted<br />
<br />
{<br />
"notification_name": {{notification_name}},<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
"notification_time": {{notification_time}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id":{{contact_id}},<br />
"contact_full_name":{{contact_full_name}}<br />
},<br />
"call_session_id":{{call_session_id}},<br />
"employee_info":{<br />
"employee_full_name":{{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Окончание разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndPart<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"communication_number":{{communication_number}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_info": {<br />
"call_source": {{call_source}},<br />
"call_session_id":{{call_session_id}},<br />
"direction": {{direction}},<br />
"scenario_name": {{scenario_name}},<br />
"talk_time_duration": {{talk_time_duration}}<br />
},<br />
"leg_ids": {{leg_ids}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Завершение звонка'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndCall<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"communication_number":{{communication_number}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_info": {<br />
"call_source": {{call_source}},<br />
"direction": {{direction}},<br />
"call_session_id":{{call_session_id}},<br />
"scenario_name": {{scenario_name}},<br />
"talk_time_duration": {{talk_time_duration}},<br />
"total_time_duration": {{total_time_duration}},<br />
"wait_time_duration": {{wait_time_duration}},<br />
"tag_names": {{tag_names}}<br />
},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Записанный разговор'''<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Record<br />
<br />
{<br />
"notification_name": {{notification_name}},<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
"notification_time": {{notification_time}},<br />
"scenario_name": {{scenario_name}},<br />
"contact_info": {<br />
"contact_phone_number": {{contact_phone_number}},<br />
"communication_number": {{communication_number}},<br />
"contact_id": {{contact_id}},<br />
"contact_full_name": {{contact_full_name}}<br />
},<br />
"call_session_id": {{call_session_id}},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_record_file_info": {<br />
"file_link": {{file_link}},<br />
"call_record_duration": {{file_duration}}<br />
},<br />
"tag_ids": {{tag_ids}},<br />
"tag_names": {{tag_names}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_IP-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD%D0%B8%D0%B8&diff=1493Интеграция IP-телефонии2021-07-05T06:44:42Z<p>WikiSys: </p>
<hr />
<div>Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <br />
<br />
==Введение==<br />
<br />
Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.<br><br />
На данный момент их 5:<br />
* Asterisk;<br />
* Mango-Office;<br />
* Mobilon;<br />
* Oktell;<br />
* Zadarma;<br />
* UIS<br />
Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:<br />
* Создавать клиентов из карточки звонка;<br />
* Добавлять Лид, а также определять имеющийся лид по клиенту;<br />
* Создавать предварительный заказ;<br />
* Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;<br />
* Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).<br />
<br />
==Asterisk==<br />
<br />
Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:<br><br />
* Адрес сервера Asterisk,<br />
* Порт для подключения к AMI (Asterisk management Interface),<br />
* Логин AMI,<br />
* Пароль AMI.<br />
<br />
Ип с которых должен быть доступен Астериск по AMI<br><br />
148.251.195.241<br><br />
188.40.126.229<br><br />
148.251.22.175<br><br />
185.26.169.104<br><br />
<br />
Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf<br />
<br />
Для этого в manager.conf должны быть прописаны логин и пароль ами, а также разрешения на all<br><br />
Пример конфигурации:<br><br />
[magtravel]<br><br />
secret = XXXXXXX<br><br />
deny=0.0.0.0/0.0.0.0<br><br />
permit=148.251.195.241/255.255.255.255<br><br />
permit=188.40.126.229/255.255.255.255<br><br />
permit=148.251.22.175/255.255.255.255<br><br />
permit=185.26.169.104/255.255.255.255<br><br />
read = all,cdr<br><br />
write = all,cdr<br><br />
writetimeout = 500<br><br />
<br />
*Вместо XXXXXXX необходимо указать пароль для подключения, который затем прописать в настройках телефонии в Маге.*<br><br />
<br />
Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html<br><br />
В файле queues.conf должна быть строка: eventwhencalled = yes<br><br />
А также: eventmemberstatus = yes<br><br />
И Астериск должен быть собран с модулем apps/app_queue.c<br><br />
<br><br />
Можно указать контекст Астериск для исходящих звонков.<br><br />
Этот контекст будет использоваться при звонке из Мага.<br><br />
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)<br><br />
<br><br />
Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер<br><br />
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/<br><br />
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP<br><br />
<br><br />
Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.<br><br />
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.<br><br />
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:<br><br />
<br><br />
<br />
Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)<br><br />
<br />
Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)<br><br />
<br />
[magtransfer]<br><br />
exten => s,1,Set(DEFEXT=200)<br><br />
exten => s,n,Set(API_key=API_KEY_TEXT)<br><br />
exten => s,n,Set(RingTime=15)<br><br />
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))<br><br />
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)<br><br />
exten => s,n,NoOp(FROM_DID=${FROM_DID})<br><br />
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})<br><br />
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})<br><br />
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)<br><br />
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})<br><br />
exten => s,n,Return()<br><br />
<br><br />
где:<br><br />
* ID_IN_MAG – ID который указываете при входе в систему;<br />
* API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*<br />
* DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение<br />
* FROM_DID - транк, на который поступил звонок<br />
* TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)<br />
<br />
Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer<br />
<br />
==Mango-Office==<br />
<br />
Для интеграции с IP-телефонией '''Mango-Office''' необходимо '''быть действующим клиентом Mango-Office'''.<br><br />
<br />
===Регистрация в Mango-Office===<br />
<br />
Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br><br />
Регистрация в Mango-Office<br />
Шаг 1. Войдите в Личный кабинет Виртуальной АТС (ВАТС).<br />
Шаг 2. Перейдите в раздел «Интеграции»:<br />
<br />
[[Файл:M1.png]]<br><br />
<br />
Шаг 3. Откройте вкладку «API коннектор».<br />
<br />
[[Файл:M2.png|border]]<br><br />
<br />
Шаг 4. Сохраните данные вашей АТС для дальнейшего копирования в виджет CRM-системы или не закрывайте вкладку до окончания настройки интеграции.':<br> <br />
<br />
[[Файл:M3.png|border]]<br><br />
Шаг 5. В поле «адрес внешней системы» впишите адрес СRM-системы или сервера для принятия и обработки уведомлений, которые посылает API.<br />
<br />
Также указать следующие данные:<br />
Адрес внешней системы: https://2015.mag.travel/tourclient/api/Telephony/Mango/999 , где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015;<br />
SSL-сертификат: Не проверять сертификат;<br />
[[Файл:M4.png|border]]<br><br />
<br />
Шаг 6. Установите безопасность посредством IP-адресов. Если вы хотите прослушивать записи разговоров прямо из CRM, то установите флаг «записи разговоров» (при этом необходимо подключить услугу «запись разговоров» в личном кабинете → вкладка «инструменты» → выберите пункт «запись разговоров» и нажмите кнопку «подключить»). Для принятия настроек нажмите кнопку «сохранить».<br />
[[Файл:M5.png|border]]<br><br />
<br />
Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br />
<br />
Шаг 7 Необходимо создать в системе сотрудников и создать им SIP-аккаунт.<br />
[[Файл:M6.png|border]]<br><br />
[[Файл:M7.png|border]]<br><br />
<br />
'''Настройка Mango-Office в MAG.Travel 2015'''<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии".<br />
[[Файл:M8.png|border]]<br><br />
[[Файл:M9.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br />
В Mango-Office:<br />
[[Файл:M10.png|border]]<br><br />
В MAG.Travel 2015:<br />
[[Файл:M11.png|border]]<br><br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015<br />
[[Файл:M12.png|border]]<br><br />
Cервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br />
[[Файл:M13.png|border]]<br><br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
'''Назначение звонков ответственному менеджеру'''<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br />
Таким образом, не отвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br />
[[Файл:M14.png|border]]<br><br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br />
[[Файл:M15.png|border]]<br><br />
[[Файл:M16.png|border]]<br><br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br />
<br />
===Настройка Mango-Office в MAG.Travel 2015===<br />
<br />
Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии". <br><br />
<br />
[[Файл:Ak_320.png|border]]<br><br />
<br />
[[Файл:Ak_326.png|border]]<br><br />
<br />
Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br><br />
В Mango-Office:<br><br />
<br />
[[Файл:Ak_328.png]]<br><br />
<br />
В MAG.Travel 2015:<br><br />
<br />
[[Файл:Ak_327.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015 [[Файл:Ak_329.png]], сервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br><br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
====Назначение звонков ответственному менеджеру====<br />
<br />
В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br><br />
Таким образом, неотвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br><br />
<br />
Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br><br />
<br />
[[Файл:Ak_454.png|Пример схемы распределения звонков]]<br><br />
<br />
Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br><br />
<br />
==Mobilon==<br />
<br />
Для интеграции с IP-телефонией '''Mobilon''' необходимо '''быть действующим клиентом Mobilon'''.<br><br />
<br />
===Настройка в Mobilon===<br />
<br />
В личном кабинете Mobilon, в разделе ''Интеграция'', на вкладке ''Настройки'' необходимо прописать данные для интеграции с Mag.Travel 2015:<br><br />
* Тип: '''Webhook''';<br />
* В поле URL для событий размещаем ссылку <code>https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015.<br><br />
<br />
[[Файл:Ak_432.png|border]]<br><br />
<br />
Также, необходимо создать Абонентов в разделе ''Конфигуратор'' подпункт ''Абонент'':<br><br />
<br />
[[Файл:Ak_433.png|border]]<br><br />
<br />
===Настройка Mobilon в MAG.Travel 2015===<br />
<br />
Для настройки в Mag.Travel 2015 необходимо перейти в раздел Администрирования, справочник ''Настройки IP-телефонии'' и в поле ''Тип телефонии'' выбрать Mobilion:<br />
<br />
[[Файл:Ak_435.png]]<br><br />
<br />
Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:<br />
* Внутренний номер;<br />
* Userkey.<br />
<br />
Данные для поля Userkey необходимо взять из данных абонентов в кабинете Mobilon:<br><br />
<br />
[[Файл:Ak_434.png|border]]<br><br />
<br />
После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br><br />
<br />
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br><br />
<br />
[[Файл:Ak_330.png]]<br><br />
<br />
'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).<br />
<br />
==Oktell==<br />
Для Интеграции с ip-телефонией Oktell необходимо:<br />
<br />
В поле «Тип телефонии» выбрать Oktell<br />
<br />
В поле «Автоматическое создание клиента» выбрать в каком из предложенных вариантов будет автоматически создан клиент:<br />
- Не создавать – при поступлении входящего звонка новый клиент создан не будет<br />
- При входящем с неизвестного номера – новый клиент создастся, если входящий звонок поступит с номера телефона, которого ещё нет в вашей базе<br />
- При пропущенном входящем с неизвестного номера - новый клиент создастся, если на входящий звонок не было ответа и такого номера телефона нет в вашей базе<br />
<br />
Выбрать один из предложенных вариантов в поле «Автоматическое создание лида», где:<br />
- Не создавать – Лид в базе создан не будет<br />
- При каждом входящем звонке – Лид создается по каждому входящему звонку, не важно от кого и с какого номера телефона поступил звонок<br />
- При входящем с неизвестного номера – Лид создается только в том случае, если звонок поступил с неизвестного номера<br />
При пропущенном входящем с неизвестного номера - Лид создается, если на звонок не было ответа и он поступил с неизвестного номера<br />
<br />
В поле «Изменять статус лида при пропущенном звонке» выбрать на какой статус Лида изменять статус, если звонок был пропущен (статусы подтягиваются из соответствующего справочника)<br />
<br />
В поле «Сервер Oktell» прописать ссылку на ваш сервер Oktell с префиксом «ws://»<br />
<br><br />
[[Файл:Oktell.png]]<br />
<br><br />
'''Внимание!''' Десктопное приложение Oktell не взаимодействует с Mag.Travel.<br />
<br />
==Zadarma==<br />
<br />
В ЛК ZADARMA перейдите в раздел "Настройки" - "API и интеграции".<br />
Здесь вы можете найти API ключ и ключ для создания подписи.<br />
Их нужно прописать в настройках IP телефонии в системе MAG.Travel<br />
<br />
В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида:<br />
http://2015.mag.travel/TourClient/api/Telephony/Zadarma/999999/events при этом заменить 999999 на Ваш ID в MAG<br />
и справа отметьте все события:<br />
[[Файл:2019-10-02_12-03_Zadarma.jpg]]<br />
<br />
Также в системе MAG.Travel, в настройках IP телефонии нужно прописать внутренние номера пользователей для которых будет доступна интеграция.<br />
В ZADARMA можно найти внутренние номера сотрудников в разделе Моя АТС, внутренние номера. Поле с номером - "Внутренний номер АТС"<br />
<br />
Также, для записи разговоров должен быть установлен флаг:<br />
Запись разговоров - в облако<br />
<br />
[[Файл:Zadarmarecording.jpg]]<br />
<br />
Для приема входящих звонков в ЛК ZADARMA должны быть подключены номера в разделе Моя АТС, внешние линии.<br />
<br />
==UIS==<br />
<br />
1. Подключить API<br />
Нужно подключить компонент «Call API Базовый набор» и «Уведомления». Для переадресации на ответственного нужно также подключить «Call API Управление вызовами»\<br />
Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:<br />
[[Файл:UIS1.png]]<br />
<br />
2. Доступ к АПИ<br />
Ключи генерируются на уровне пользователя в разделе личного кабинета "Аккаунт" → "Управление пользователями"<br />
Существует два типа ключей:<br />
Постоянный. Постоянный ключ имеет неограниченное время действия.<br />
Временный. Временный ключ имеет конкретную дату окончания действия ключа.<br />
Генерируем постоянный ключ.<br />
При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.<br />
[[Файл:UIS2.png]]<br />
<br />
3. Настройка доступа по IP<br />
<br />
По умолчанию доступ к API запрещен всем, чтобы можно было делать запросы необходимо IP-адрес хоста с которого делается запрос добавить в белый список. Это можно сделать через личный кабинет "Администратор -> Аккаунт -> Правила и настройки безопасности" вкладка "API".<br />
Наши IP:<br />
148.251.195.241<br />
188.40.126.229<br />
148.251.22.175<br />
185.26.169.104<br />
[[Файл:UIS3.png]]<br />
<br />
4. Настройка IP телефонии в МАГЕ<br />
<br />
Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”<br />
[[Файл:UIS4.png]]<br />
Здесь тип телефонии выбирайте UIS.<br />
Ключ доступа к API UIS вставьте, что вы сгенерировали в личном кабинете UIS.<br />
Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.<br />
[[Файл:UIS5.png]]<br />
<br />
5. Настройка уведомлений<br />
<br />
Чтобы настроить получение уведомлений, перейдите в раздел Сервисы и статистика, в боковом меню откройте Уведомления и нажмите добавить. В открывшемся окне необходимо заполнить параметры: название уведомления; тип события, о котором нужно вас уведомить; условия, при которых будет приходить уведомление; способ получения уведомлений.<br />
Нужно настроить 8 HTTP уведомлений<br />
[[Файл:UIS6.png]]<br />
<br />
При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.<br />
<br />
'''Входящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLeg<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id": {{contact_id}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_source": {{call_source}},<br />
"call_session_id":{{call_session_id}},<br />
"direction": {{direction}},<br />
"leg_id": {{leg_id}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Исходящее плечо'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/OutgoingLeg<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id": {{contact_id}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_source": {{call_source}},<br />
"call_session_id":{{call_session_id}},<br />
"direction": {{direction}},<br />
"leg_id": {{leg_id}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Входящий звонок на виртуальный номер'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLine<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
"notification_time":{{notification_time}},<br />
"scenario_name": {{scenario_name}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"communication_number":{{communication_number}},<br />
"contact_id": {{contact_id}},<br />
"contact_full_name": {{contact_full_name}}<br />
},<br />
"call_session_id":{{call_session_id}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Исходящий звонок'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Outgoing<br />
<br />
{<br />
"notification_name": {{notification_name}},<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
"notification_time": {{notification_time}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id":{{contact_id}},<br />
"contact_full_name":{{contact_full_name}}<br />
},<br />
"call_session_id":{{call_session_id}},<br />
"employee_info":{<br />
"employee_full_name":{{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Начало разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/CallStarted<br />
<br />
{<br />
"notification_name": {{notification_name}},<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
"notification_time": {{notification_time}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"contact_id":{{contact_id}},<br />
"contact_full_name":{{contact_full_name}}<br />
},<br />
"call_session_id":{{call_session_id}},<br />
"employee_info":{<br />
"employee_full_name":{{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Окончание разговора'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndPart<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"communication_number":{{communication_number}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_info": {<br />
"call_source": {{call_source}},<br />
"call_session_id":{{call_session_id}},<br />
"direction": {{direction}},<br />
"scenario_name": {{scenario_name}},<br />
"talk_time_duration": {{talk_time_duration}}<br />
},<br />
"leg_ids": {{leg_ids}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Завершение звонка'''<br />
<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/EndCall<br />
<br />
{<br />
"notification_name":{{notification_name}},<br />
"virtual_phone_number":{{virtual_phone_number}},<br />
"notification_time":{{notification_time}},<br />
"external_id": {{external_id}},<br />
"contact_info":{<br />
"contact_phone_number":{{contact_phone_number}},<br />
"communication_number":{{communication_number}}<br />
},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_info": {<br />
"call_source": {{call_source}},<br />
"direction": {{direction}},<br />
"call_session_id":{{call_session_id}},<br />
"scenario_name": {{scenario_name}},<br />
"talk_time_duration": {{talk_time_duration}},<br />
"total_time_duration": {{total_time_duration}},<br />
"wait_time_duration": {{wait_time_duration}},<br />
"tag_names": {{tag_names}}<br />
},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}<br />
<br />
'''Записанный разговор'''<br />
POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/Record<br />
<br />
{<br />
"notification_name": {{notification_name}},<br />
"virtual_phone_number": {{virtual_phone_number}},<br />
"notification_time": {{notification_time}},<br />
"scenario_name": {{scenario_name}},<br />
"contact_info": {<br />
"contact_phone_number": {{contact_phone_number}},<br />
"communication_number": {{communication_number}},<br />
"contact_id": {{contact_id}},<br />
"contact_full_name": {{contact_full_name}}<br />
},<br />
"call_session_id": {{call_session_id}},<br />
"employee_info": {<br />
"employee_full_name": {{employee_full_name}},<br />
"extension_phone_number": {{extension_phone_number}}<br />
},<br />
"call_record_file_info": {<br />
"file_link": {{file_link}},<br />
"call_record_duration": {{file_duration}}<br />
},<br />
"tag_ids": {{tag_ids}},<br />
"tag_names": {{tag_names}},<br />
"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br />
}</div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:UIS6.png&diff=1492Файл:UIS6.png2021-07-05T06:36:39Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:UIS5.png&diff=1491Файл:UIS5.png2021-07-05T06:36:28Z<p>WikiSys: </p>
<hr />
<div></div>WikiSyshttp://wiki2.mag.travel/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:UIS4.png&diff=1490Файл:UIS4.png2021-07-05T06:36:22Z<p>WikiSys: </p>
<hr />
<div></div>WikiSys