Платежные web-сервисы: EntryPoint — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(Uniteller)
(Sberbank)
 
(не показано 69 промежуточных версий 4 участников)
Строка 4: Строка 4:
 
Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br />
 
Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br />
 
В данный момент доступны следующие способы оплаты:
 
В данный момент доступны следующие способы оплаты:
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете)|Alfabank]]
+
* Alfabank
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Sberbank (оплата картой в личном кабинете)|Sberbank]]
+
* Sberbank
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Tinkoff (оплата картой в личном кабинете)|Tinkoff]]
+
* Tinkoff (Т-Банк)
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)|Uniteller]]
+
* Uniteller
 +
* YandexPay
 +
* Assist
 +
* WebPay
 +
* PayOnline
  
 
==Установка==  
 
==Установка==  
Строка 27: Строка 31:
 
[[Файл: am_748.png|x500px|Добавить приложение]]<br />
 
[[Файл: am_748.png|x500px|Добавить приложение]]<br />
 
<br />
 
<br />
 +
==Настройка==
 
===Подключение к базе данных ПК «Мастер-Тур»===
 
===Подключение к базе данных ПК «Мастер-Тур»===
 
В файле <code>web.config</code>, расположенном в папке '''EntryPoint''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
 
В файле <code>web.config</code>, расположенном в папке '''EntryPoint''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
Строка 133: Строка 138:
 
|}
 
|}
  
 +
===Настройки логирования===
 +
Настройки секции <code><loggerSection></code> файла <code>web.config</code> модуля EntryPoint.
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 +
|- style="background-color:#F2F2F2"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 +
|- style="vertical-align:text-top"
  
===Формат настроек в файле web.config модуля '''EntryPoint'''===  
+
| 1
 +
|Логирование <br>
 +
|
 +
Путь к лог-файлам задается в секции ''Loggers path''.
 +
* ExceptionLogger – информация об ошибках
 +
* MasterWeb – общая информация при работе с системой
 +
* DetailEPLoger – пошаговое отслеживание работы платежной системы (работаем через EP). Сейчас реализован только для Юнителлера, при необходимости можно расширять и на другие платежные системы. Удобно использовать для тестирования и проверки платежной системы на стороне клиента.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<Loggers path="Logs\">
 +
<Logger level="ALL" name="ExceptionLogger" />
 +
<Logger level="ALL" name="MasterWeb" />
 +
<Logger level="OFF" name="DetailEPLoger" />
 +
</Loggers>
 +
</syntaxhighlight>
 +
|}
 +
 
 +
===Настройки в секции appSettings модуля EntryPoint===  
 
Настройки секции <code><appSettings></code> файла <code>web.config</code> модуля EntryPoint.
 
Настройки секции <code><appSettings></code> файла <code>web.config</code> модуля EntryPoint.
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
Строка 165: Строка 198:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 3
 +
| Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. '''Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web"'''.
 +
|'''false''' - хэширование пароля в файлах cookie выключено;
 +
'''true''' или '''отсутствие настройки''' - хэширование пароля в файлах cookie включено.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="HashPasswordForCookie" value="true" />
 +
</syntaxhighlight>
  
| 3
+
|- style="vertical-align:text-top"
 +
 
 +
| 4
 
|Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. <br>
 
|Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. <br>
 
|
 
|
Строка 177: Строка 219:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
| 4
+
| 5
 
| Настройка задержки проверки статуса платежа на платежной системе.
 
| Настройка задержки проверки статуса платежа на платежной системе.
 
|
 
|
Строка 188: Строка 230:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|}
+
| 6
 +
|Текст правил оплаты <br>
 +
|
 +
Правила оплаты берутся из файла AgreementText.htm
 +
Если данный файл отсутствует, то описание правил оплаты берется из стандартного файла AgreementText_Standard.htm
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="agreementText" value="templates/AgreementText.htm" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 7
 +
| Настройка способа учёта типов тура из <code>&lt;paymentAvailabilities&gt;</code> (атрибут <code>tourTypes</code>) при определении доступности оплаты. Если <code>value="true"</code>, оплата доступна только когда у тура присутствуют все типы, указанные в <code>tourTypes</code>. Если <code>false</code> или настройка отсутствует – оплата доступна, когда у тура есть хотя бы один тип из <code>tourTypes</code>.
 +
| '''false''' или '''отсутствие настройки''' – оплата доступна при наличии хотя бы одного типа из <code>tourTypes</code>;<br>
 +
'''true''' – оплата доступна только при наличии всех типов из <code>tourTypes</code>.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="allowPaymentIfAllTypeAllowed" value="true" />
 +
</syntaxhighlight>
 +
|}
  
Секция описания способов оплаты в платежных системах: <br />
+
===Настройки в секции paymentMethods модуля EntryPoint===
 +
В данной секции происходит настройка описания способов оплаты в платежных системах.
 +
Настройки секции <code><paymentMethods></code> файла <code>web.config</code> модуля EntryPoint.
 
  <paymentMethods>
 
  <paymentMethods>
 
     <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />
 
     <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />
Строка 198: Строка 259:
 
* '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 
* '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 
* '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений:
 
* '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений:
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете)|Alfabank]]
+
** Alfabank
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Sberbank (оплата картой в личном кабинете)|Sberbank]] и Сбербанк-Мир, Сбербанк МИР Дети
+
** Sberbank и SberbankMir, SberbankChildren
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Tinkoff (оплата картой в личном кабинете)|Tinkoff]]
+
** Tinkoff
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)|Uniteller]]
+
** Uniteller и UnitellerMir, UnitellerChildren
 +
** Assist
 +
** WebPay
 +
** PayOnline
 
* '''LogoLink''' - расположение логотипа способа оплаты;
 
* '''LogoLink''' - расположение логотипа способа оплаты;
 
* '''maximumAmount''' - максимальный размер платежа;
 
* '''maximumAmount''' - максимальный размер платежа;
Строка 207: Строка 271:
 
Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.<br />
 
Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.<br />
 
Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br />
 
Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br />
* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты;
+
* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты.
  
Секция описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю:
+
===Настройки в секции paymentAvailabilities модуля EntryPoint===
 +
В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю.
 
  <paymentAvailabilities>
 
  <paymentAvailabilities>
  <add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100"  paymentConditionCode="2" tourTypes="2"/>
+
  <add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100" tourTypes="2"/>
 
  </paymentAvailabilities>
 
  </paymentAvailabilities>
  
* '''code''' - идентификатор доступности способа оплаты, должен быть уникальным;
+
* '''code''' идентификатор доступности способа оплаты, должен быть уникальным;
* '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
+
* '''paymentMethodCode''' идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
* '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
+
* '''countryCode''' ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
* '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки. Может быть пустым - доступен для всех филиалов;
+
* '''filialCode''' ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле ''PR_COD''). Может быть пустым - доступен для всех филиалов;
* '''consumerCode''' - ограничение по типу забронировавшего: турист или агентство. ''Person'' - для частных лиц, ''Agency'' - для турагентств;
+
* '''consumerCode''' ограничение по типу забронировавшего: турист или агентство. ''Person'' для частных лиц, ''Agency'' для турагентств;
* '''isAvailable''' - включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции;
+
* '''isAvailable''' включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции;
* '''priority''' - приоритет при выборе нескольких доступных вариантов оплаты;
+
* '''priority''' приоритет при выборе нескольких доступных вариантов оплаты;
* '''paymentConditionCode''' - идентификатор (''code'') из секции ''paymentConditions'';
+
* '''tourTypes''' ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр оплата доступна для всех типов туров (допускается внесение нескольких параметров через ","). Если требуется оплата с типом тура ''Индивидуально'', то в настройку необходимо добавить ключ ''0''
* '''tourTypes''' - ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров.
+
 
 +
===Настройки подключения и параметров используемых платежных систем модуля EntryPoint===
 +
Настройка подключения и параметров используемых платежных систем производится в конкретной секции платежной системы.
  
==Настройка секций платежных систем==
+
====Alfabank====
==Alfabank==
 
 
Настройки задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 
Настройки задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
  
Строка 282: Строка 348:
  
 
| 5
 
| 5
 +
|Ссылка на платежный шлюз <br>
 +
|
 +
Ссылка на платежный шлюз
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 6
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
Строка 292: Строка 369:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 7
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|  
 
|  
Строка 303: Строка 380:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 8
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 313: Строка 390:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 8
+
| 9
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 323: Строка 400:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 10
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
 
|
 
|
Строка 334: Строка 411:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 11
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 344: Строка 421:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 11
+
| 12
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
Строка 353: Строка 430:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 12
+
| 13
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 364: Строка 440:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 13
+
| 14
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 375: Строка 450:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 14
+
| 15
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
Строка 385: Строка 459:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 15
+
| 16
 
| Настройка, определяющая '''адрес электронной почты по умолчанию'''.  
 
| Настройка, определяющая '''адрес электронной почты по умолчанию'''.  
 
|Используется в том случае, если не указан адрес электронной почты главного туриста.
 
|Используется в том случае, если не указан адрес электронной почты главного туриста.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="defaultEmail" value="" />
 
<add key="defaultEmail" value="" />
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
 
|}<br />
 
|}<br />
 
+
=====Формирование чеков Alfabank=====
==Sberbank==
+
Настройки для формирования чека задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 
+
Обратите внимание, настройки являются обязательными.
==Tinkoff==
 
Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
  
Строка 411: Строка 481:
  
 
| 1
 
| 1
| '''Адрес платежной службы'''
+
| '''Система налогообложения'''  
Обязательная настройка.
+
| Значения:
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
  general — общая
 +
  simple_income — упрощенная (доходы)
 +
  simple_profit — упрощенная (доходы минус расходы)
 +
  patent — патентная
 +
  unified_agricultural — единый сельскохозяйственный налог
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
+
<add key="TaxationCode" value="general" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 2
| '''Адрес платежной службы'''
+
| '''Ставка НДС'''
Обязательная настройка.
+
| Значения:
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
  no — без НДС
 +
  0 — 0%
 +
  10 — 10%
 +
  20 — 20%
 +
  10/110 — 10/110
 +
  20/120 — 20/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
+
<add key="Tax" value="no" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}<br />
 +
Обратите внимание, что для каждой услуги отправляется на уровне кода:</br>
 +
* typename - ServiceType согласно ключу SvKey, нигде в чеке не фигурирует;</br>
 +
* number - ключ услуги в БД;</br>
 +
* quantity - 1(услуга);</br>
 +
* name - "Туристическая услуга по путевке {код договора}";</br>
 +
* amount - сумма оплаты по услуге и валюта;</br>
 +
* taxation_item_settlement_method - "full_prepayment";</br>
 +
* taxation_item_type - "service";</br>
 +
* taxation_system - "general" по умолчанию, если не указано иное в конфиге;</br>
 +
* taxes - налог, где</br>
 +
** amount - вычисляется согласно выбранной системе расчета налога и валюта;</br>
 +
** percentage - "no" по умолчанию, иначе - из конфига "20/120" и т.д.;</br>
 +
** type - "vat";</br>
 +
** source - "shop"</br>
 +
 +
[[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
 +
Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija  или запросить информацию в технической поддержке Альфа-Банка<br />
  
|- style="vertical-align:text-top"
+
====Sberbank====
 +
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 +
<br /><br />
  
| 2
+
Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''.
| '''Адрес для оплаты по QR коду'''
+
В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:
Обязательная настройка.
+
* '''логин'''
| Адрес сервиса оплаты через карту банка «Tinkoff» по QR коду.
+
* '''пароль'''
|<syntaxhighlight lang="xml" enclose="div">
+
* '''ссылку на платежный шлюз'''
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
+
 
</syntaxhighlight>
+
При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></code> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса.
 +
<br /><br />
 +
 
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 3
+
| 1
| '''Адрес метода для получения статуса платежа'''
+
| Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется логин, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес метода для получения статуса платежа.
+
| '''Идентификатор клиента'''
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
+
<add key="userName" value="логин sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 2
| 4
+
| Пароль клиента, который выдается платежной системой Sberbank.<br /><br />
| '''Адрес метода возвращающего статус заказа'''
+
При использовании '''Юкасса по API Сбербанка''' используется пароль, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес метода возвращающего статус заказа.
+
| '''Пароль клиента'''
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
+
<add key="password" value="пароль sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 3
 +
| Ссылка на платежный шлюз Sberbank.<br /><br />
 +
Также поддерживается прием оплат через '''Юкасса''' по '''API Сбербанка'''. В этом случае необходимо указать ссылку на шлюз, предоставленную Юкасса.
 +
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods><br /><br />
 +
Пример ссылки, предоставляемой Юкасса:<br />
 +
<code>https://3dsec-payments.yookassa.ru/payment/rest/</code>
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
 +
</syntaxhighlight>
 +
<br />
 +
<syntaxhighlight lang="xml" enclose="div">
 +
<add key="sberbankPaymentApplicationUrl" value="https://3dsec-payments.yookassa.ru/payment/rest/" />
 +
</syntaxhighlight>
  
| 5
+
|- style="vertical-align:text-top"
| '''Идентификатор терминала'''
+
| 4
 +
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TerminalKey" value="1587990738"/>
+
<add key="masterTourUser" value="95" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 5
 +
| Настройка, позволяющая создавать объект '''orderBundle''' (товарная корзина), в котором передаются все необходимые данные о товаре/услуге.
 +
|
 +
* '''true''' - включено создание объекта '''orderBundle'''
 +
* '''false''' или отсутствие настройки -  объект '''orderBundle''' не создается <br />
 +
По умолчанию настройка имеет значение false.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="useFiscalization" value="false"/>
 +
</syntaxhighlight>
  
 +
|- style="vertical-align:text-top"
 
| 6
 
| 6
| '''Пароль терминала'''
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
+
<add key="PaymentOperationId" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 7
 
| 7
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
Обязательная настройка.
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br>
|
+
<br /><font style="color:red">''Внимание!''</font><br />
* '''ru''' - русский язык
+
Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными.
* '''en''' - английский язык
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LanguageFormCode" value="ru"/>
+
<add key="paymentOperationCommissionId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 8
 
| 8
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
|
+
Для корректной работы настройки в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
* '''osn''' – общая система налогообложения
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
* '''usn_income''' – упрощенная система налогообложения (Доход)
+
Комиссия указывается '''в процентах'''.<br />
* '''usn_income_outcome''' – упрощенная СН (Доход минус Расход)
+
По умолчанию комиссия для агентств равна нулю.
* '''patent''' – патентная система налогообложения
 
* '''envd''' – единый налог на вмененный доход
 
* '''esn''' – единый сельскохозяйственный налог
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxationCode" value="osn"/>
+
<add key="addAgencyComission" value="3.627" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 9
 
| 9
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
|
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
* '''none''' – не облагается НДС
+
Комиссия указывается '''в процентах'''.<br />
* '''vat0''' – облагается НДС по ставке 0%
+
По умолчанию комиссия для частных лиц равна нулю.
* '''vat10''' – облагается НДС по ставке 10%
 
* '''vat20''' – облагается НДС по ставке 20%
 
* '''vat110''' – облагается НДС по ставке 10/110
 
* '''vat120''' – облагается НДС по ставке 18/120
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="Tax" value="none"/>
+
<add key="addPersonalComission" value="5.0" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|- style="vertical-align:text-top"
 
 
 
| 10
 
| 10
| Настройка, определяющая '''тип операции при проведении платежа'''.
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Обязательная настройка.
+
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="6" />
+
<add key="NewDogovorServiceServiceListKey" value="450" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 11
 
| 11
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentOperationCommissionId" value="" />
+
<add key="NewDogovorServiceSvKey" value="1055" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 12
 
| 12
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
Обязательная настройка.
+
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="masterTourUser" value="80" />
+
<add key="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 13
 
| 13
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
+
| Настройка, включающая расчет через Мастер финанс.
Обязательная настройка.
+
|
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentFilialKey" value="1" />
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
|}
 +
<br />
 +
 +
====Tinkoff (Т-Банк)====
 +
Настройки задаются в секции <code><paymentMethods></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 +
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 +
|- style="background-color:#F2F2F2"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 14
+
| 1
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
+
| '''Платежный метод'''
 
Обязательная настройка.
 
Обязательная настройка.
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+
| способ оплаты в платежной системе «Tinkoff (Т-Банк)».
 +
*'''code="1"''' – идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
 +
*'''name="Tinkoff"''' – название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 +
*'''paymentSystem="Tinkoff"''' – название платежной системы.
 +
*'''LogoLink''' – расположение логотипа способа оплаты;
 +
*'''maximumAmount''' – максимальный размер платежа;
 +
*'''skipDescriptionPage''' – отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.
 +
**Если значение '''skipDescriptionPage=true''', то сразу происходит переход к оплате.
 +
**Если значение '''skipDescriptionPage=false''', то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.
 +
*'''displayWindowWithEditingRequestData''' – настройка включающая проверку e-mail и телефона плательщика, при отсутствии выводит модальное окно с просьбой ввести e-mail и телефон плательщика. после ввода данных отправлять на оплату.
 +
**'''false''' – проверка не проводится
 +
**'''true''' – проверка проводится
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="departmentKey" value="2" />
+
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
 +
    maximumAmount="1000000"
 +
    skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
  
|- style="vertical-align:text-top"
+
Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
  
| 15
+
! width="2%" | №
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+
! width="28%" | Описание
|
+
! width="35%" | Значение
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
+
! width="35%" | Настройка
Комиссия указывается в процентах.
 
| <syntaxhighlight lang="xml" enclose="div">
 
<add key="addAgencyComission" value="15,8" />
 
</syntaxhighlight>
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 16
+
| 1
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
+
| '''Адрес платежной службы'''
|  
+
Обязательная настройка.
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».
Комиссия указывается в процентах.
+
|<syntaxhighlight lang="xml" enclose="div">
| <syntaxhighlight lang="xml" enclose="div">
+
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
<add key="addPersonalComission" value="17,4" />  
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 17
+
| 2
| Настройка, включающая расчет через Мастер финанс.
+
| '''Адрес для оплаты по QR коду'''
|
+
Обязательная настройка.
* '''false''' - расчет через мастер финанс не включен;
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.
* '''true''' - расчет через мастер финанс включен.
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="AddPaymentsToMasterFinance" value="false"/>
+
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 18
+
| 3
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+
| '''Адрес метода для получения статуса платежа'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+
| Адрес метода для получения статуса платежа.
Название услуги комиссии в путевке берется из этого параметра
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceServiceListKey" value="450" />
+
<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 19
+
| 4
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+
| '''Адрес метода возвращающего статус заказа'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
Название услуги комиссии в путевке берется из этого параметра
+
| Адрес метода возвращающего статус заказа.
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceSvKey" value="1055" />
+
<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 20
+
| 5
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
+
| '''Идентификатор терминала'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServicePartnerKey" value="12921" />
+
<add key="TerminalKey" value="1587990738"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
|}
 
<br />
 
  
==Uniteller==
+
|- style="vertical-align:text-top"
Настройки задаются в секции <code><Uniteller></code> файла <code>web.config</code> приложения '''EntryPoint'''.
 
  
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+
| 6
 +
| '''Пароль терминала'''
 +
Обязательная настройка.
 +
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 +
</syntaxhighlight>
  
|- style="background-color:#F2F2F2"
+
|- style="vertical-align:text-top"
  
! width="2%" | №
+
| 7
! width="28%" | Описание
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
! width="35%" | Значение
+
Обязательная настройка.
! width="35%" | Настройка
+
|
 +
* '''ru''' - русский язык
 +
* '''en''' - английский язык
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="LanguageFormCode" value="ru"/>
 +
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 8
| '''Точки продажи''' ('''shopIDP''')
+
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
Обязательная настройка.
+
|
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
+
* '''osn''' – общая система налогообложения
 +
* '''usn_income''' – упрощенная система налогообложения (Доход)
 +
* '''usn_income_outcome''' – упрощенная СН (Доход минус Расход)
 +
* '''patent''' – патентная система налогообложения
 +
* '''envd''' – единый налог на вмененный доход
 +
* '''esn''' – единый сельскохозяйственный налог
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="shopIDP" value="00005432"/>
+
<add key="TaxationCode" value="osn"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 2
+
| 9
| '''Логин'''
+
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
Обязательная настройка.
+
|
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
+
* '''none''' – не облагается НДС
 +
* '''vat0''' – облагается НДС по ставке 0%
 +
* '''vat10''' – облагается НДС по ставке 10%
 +
* '''vat20''' – облагается НДС по ставке 20%
 +
* '''vat110''' – облагается НДС по ставке 10/110
 +
* '''vat120''' – облагается НДС по ставке 18/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="login" value="2281" />
+
<add key="Tax" value="none"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 +
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 3
+
| 10
| '''Пароль'''
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
+
<add key="PaymentOperationId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 4
+
| 11
|Платёжная система кредитной карты.
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
|
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
* '''0''' или '''отсутствует значение''' - любая
+
|<syntaxhighlight lang="xml" enclose="div">
* '''1''' - VISA
+
<add key="paymentOperationCommissionId" value="" />
* '''2''' - MasterCard
+
</syntaxhighlight>
* '''3''' - Diners Club
+
 
* '''4''' - JCB
+
|- style="vertical-align:text-top"
* '''5''' - American Express
+
 
 +
| 12
 +
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="meanType" value="" />
+
<add key="masterTourUser" value="80" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 5
+
| 13
|Тип электронной валюты.
+
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
|
+
Обязательная настройка.
* '''0''' или '''отсутствует значение''' - любая система электронных платежей
+
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
* '''1''' - Яндекс.Деньги
+
|<syntaxhighlight lang="xml" enclose="div">
* '''2''' - RBK Money
+
<add key="paymentFilialKey" value="1" />
* '''3''' - MoneyMail
+
</syntaxhighlight>
* '''4''' - WebCreds
+
 
* '''6''' - Platezh.ru
+
|- style="vertical-align:text-top"
* '''7''' - Деньги@Mail.Ru
+
 
* '''8''' - Мобильный платёж Мегафон
+
| 14
* '''9''' - Мобильный платёж МТС
+
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
* '''10''' - Мобильный платёж Билайн
+
Обязательная настройка.
* '''11''' - PayPal
+
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
* '''12''' - ВКонтакте
 
* '''13''' - Евросеть
 
* '''14''' - Yota.money
 
* '''15''' - QIWI Кошелек
 
* '''16''' - ПлатФон
 
* '''17''' - Moneybookers
 
* '''29''' - WebMoney WMR
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="eMoneyType" value="" />
+
<add key="departmentKey" value="2" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 15
| Таймаут между попытками запроса результата
+
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
По умолчанию 100.
+
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
|<syntaxhighlight lang="xml" enclose="div">
+
Комиссия указывается в процентах.
<add key="requestTimeout" value="100" />
+
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="15,8" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 16
| Количество попыток запроса результата
+
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|  
 
|  
По умолчанию 5.
+
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
|<syntaxhighlight lang="xml" enclose="div">
+
Комиссия указывается в процентах.
<add key="requestAttempts" value="5" />
+
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="17,4" />  
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 8
+
| 17
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+
| Настройка, включающая расчет через Мастер финанс.
Обязательная настройка.
+
|
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
+
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="masterTourUser" value="80" />
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 18
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Обязательная настройка.
+
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
Название услуги комиссии в путевке берется из этого параметра
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentFilialKey" value="1" />
+
<add key="NewDogovorServiceServiceListKey" value="450" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 19
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
+
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
Обязательная настройка.
+
Название услуги комиссии в путевке берется из этого параметра
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="departmentKey" value="2" />
+
<add key="NewDogovorServiceSvKey" value="1055" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
|- style="vertical-align:text-top"
+
| 20
| 11
+
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
+
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
Обязательная настройка.
 
|
 
* '''Contract''' - оплата в ''валюте путевки'';
 
* '''Tour''' -  оплата в ''валюте тура'';<br />
 
* '''National''' – оплата в ''национальной валюте'';<br />
 
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="currencyToPay" value="Contract" />
+
<add key="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 12
+
|21
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
+
| Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться ''full_payment'' – полный расчет.
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
+
* Если сумма, которую мы оплачиваем меньше суммы, которую нужно оплатить, способ расчета определяется следующим образом:
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
+
** Если ''PaymentMethodPrepayment'' имеет значение, то берем его. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
<syntaxhighlight lang="xml">
+
* Если по договору уже есть какая-то ранее оплаченная сумма, то способ расчета считается следующим образом:
<currencyMap>
+
** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodFull''. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
      <add key="рб" value="RUB"/>
+
* Если у нас нет ранее оплаченной суммы, то способ расчета считается следующим образом:
      <add key="грн" value="UAH"/>
+
** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodMain''. Если он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
      <add key="azn" value="AZN"/>
+
| Возможные значения:
      <add key="тг" value="KZT"/>
+
* '''full_prepayment''' – предоплата 100%
</currencyMap></syntaxhighlight>.
+
* '''prepayment''' – предоплата
 +
* '''advance''' – аванс
 +
* '''full_payment''' – полный расчет
 +
* '''partial_payment''' – частичный расчет и кредит
 +
* '''credit''' – передача в кредит
 +
* '''credit_payment''' – оплата кредита
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="currency" value="рб" />
+
<add key="PaymentMethodMain" value="prepayment" />
 +
<add key="PaymentMethodPrepayment" value="full_prepayment" />
 +
<add key="PaymentMethodFull" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
 +
 +
====Uniteller====
 +
Настройки задаются в секции <code><Uniteller></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании UnitellerMir или UnitellerChildren необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 +
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 +
|- style="background-color:#F2F2F2"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 13
+
| 1
| Включение функционала фискализации платежей.<br />
+
| '''Точки продажи''' ('''shopIDP''')
После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
+
Обязательная настройка.
|  
+
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
* '''true''' – использовать фискализацию при оплате
 
* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="UseFiscalization" value="true"/>
+
<add key="shopIDP" value="00005432"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 14
+
| 2
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+
| '''Логин'''
 
+
Обязательная настройка.
|  
+
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
* '''0''' – общая система налогообложения
 
* '''1''' – упрощенная система налогообложения (Доход)
 
* '''2''' – упрощенная СН (Доход минус Расход)
 
* '''3''' – единый налог на вмененный доход
 
* '''4''' – единый сельскохозяйственный налог
 
* '''5''' – патентная система налогообложения
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxMode" value=""/>
+
<add key="login" value="2281" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 15
+
| 3
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+
| '''Пароль'''
 
+
Обязательная настройка.
|
+
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
* '''-1''' – не облагается НДС
 
* '''0''' – облагается НДС по ставке 0%
 
* '''10''' – облагается НДС по ставке 10%
 
* '''18''' – облагается НДС по ставке 18%
 
* '''110''' – облагается НДС по ставке 10/110
 
* '''118''' – облагается НДС по ставке 18/118
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxRateCode" value=""/>
+
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 16
+
| 4
| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".
+
|Платёжная система кредитной карты.
Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+
|
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
* '''0''' или '''отсутствует значение''' - любая
 +
* '''1''' - VISA
 +
* '''2''' - MasterCard
 +
* '''3''' - Diners Club
 +
* '''4''' - JCB
 +
* '''5''' - American Express
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="InsuranceServiceKey" value="6"/>
+
<add key="meanType" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 17
+
| 5
| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+
|Тип электронной валюты.
 
+
|
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
* '''0''' или '''отсутствует значение''' - любая система электронных платежей
|<syntaxhighlight lang="xml" enclose="div">
+
* '''1''' - Яндекс.Деньги
<add key="OperatorTourServiceKey" value="1134"/>
+
* '''2''' - RBK Money
</syntaxhighlight>
+
* '''3''' - MoneyMail
 
+
* '''4''' - WebCreds
|- style="vertical-align:text-top"
+
* '''6''' - Platezh.ru
|- style="vertical-align:text-top"
+
* '''7''' - Деньги@Mail.Ru
| 18
+
* '''8''' - Мобильный платёж Мегафон
| Настройка, определяющая '''тип операции при проведении платежа'''.
+
* '''9''' - Мобильный платёж МТС
Обязательная настройка.
+
* '''10''' - Мобильный платёж Билайн
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
* '''11''' - PayPal
 +
* '''12''' - ВКонтакте
 +
* '''13''' - Евросеть
 +
* '''14''' - Yota.money
 +
* '''15''' - QIWI Кошелек
 +
* '''16''' - ПлатФон
 +
* '''17''' - Moneybookers
 +
* '''29''' - WebMoney WMR
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="1" />
+
<add key="eMoneyType" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 19
+
| 6
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+
| Таймаут между попытками запроса результата
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
|  
 +
По умолчанию 100.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentOperationCommissionId" value="6" />
+
<add key="requestTimeout" value="100" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 20
+
| 7
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
+
| Количество попыток запроса результата
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+
|  
Комиссия указывается '''в процентах'''.<br />
+
По умолчанию 5.
Сумма оплаты вычисляется следующим образом:<br />
 
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 
Пример:<br />
 
Стоимость путевки - '''100 у.е.''' <br />
 
В настройке указана комиссия - '''50%'''.<br />
 
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="addAgencyComission" value="3,627" />
+
<add key="requestAttempts" value="5" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 21
+
| 8
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+
Обязательная настройка.
Комиссия указывается '''в процентах'''.<br />
+
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
Сумма оплаты вычисляется следующим образом:<br />
+
|<syntaxhighlight lang="xml" enclose="div">
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
+
<add key="masterTourUser" value="80" />
Пример:<br />
 
Стоимость путевки - '''100 у.е.''' <br />
 
В настройке указана комиссия - '''50%'''.<br />
 
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="addPersonalComission" value="5" />
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 22
+
| 9
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+
Обязательная настройка.
 +
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceServiceListKey" value="450" />
+
<add key="paymentFilialKey" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 23
+
| 10
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
Обязательная настройка.
 +
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceSvKey" value="1055" />
+
<add key="departmentKey" value="2" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
| 24
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 11
| 24
+
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
| Настройка, задающая форму оплаты на шлюзе Unitellere
+
Обязательная настройка.
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
+
|  
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
+
* '''Contract''' - оплата в ''валюте путевки'';
 +
* '''Tour''' - оплата в ''валюте тура'';<br />
 +
* '''National''' – оплата в ''национальной валюте'';<br />
 +
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentFormType" value="Card" />
+
<add key="currencyToPay" value="Contract" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 25
+
| 12
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
+
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
+
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
+
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
+
<syntaxhighlight lang="xml">
1 - добавляет в чек комиссию отдельной строкой<br>
+
<currencyMap>
 
+
      <add key="рб" value="RUB"/>
 +
      <add key="грн" value="UAH"/>
 +
      <add key="azn" value="AZN"/>
 +
      <add key="тг" value="KZT"/>
 +
</currencyMap></syntaxhighlight>.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="ComissionShowModeInVoucher" value ="0"/>
+
<add key="currency" value="рб" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 26
+
| 13
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
+
| Включение функционала фискализации платежей.<br />
+
После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
+
|
По умолчанию - "Комиссия платежной системы"
+
* '''true''' – использовать фискализацию при оплате
 
+
* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
+
<add key="UseFiscalization" value="true"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 27
+
| 14
| Вид формирования чека <br>
+
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
 
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
 
true - разбить по услугам отдельно, </br>
 
false - одной строкой из ключа VoucherServiceText</br>
 
По умолчанию настройка в состоянии false.</br>
 
  
 +
|
 +
* '''0''' – общая система налогообложения
 +
* '''1''' – упрощенная система налогообложения (Доход)
 +
* '''2''' – упрощенная СН (Доход минус Расход)
 +
* '''3''' – единый налог на вмененный доход
 +
* '''4''' – единый сельскохозяйственный налог
 +
* '''5''' – патентная система налогообложения
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="VoucherShowDetails" value="false"/>
+
<add key="TaxMode" value=""/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 28
+
| 15
| Наименование услуги в чеке <br>
+
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
 
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
 
%dogovor% (не обязательно) - для вставки номера договора.</br>
 
  
 +
|
 +
*-1 – не облагается НДС
 +
*0 – облагается НДС по ставке 0%
 +
*5 - облагается НДС по ставке 5%
 +
*7 - облагается НДС по ставке 7%
 +
*10 – облагается НДС по ставке 10%
 +
*20 – облагается НДС по ставке 20%
 +
*105 – облагается НДС по ставке 5/105
 +
*107 – облагается НДС по ставке 7/107
 +
*110 – облагается НДС по ставке 10/110
 +
*120 – облагается НДС по ставке 20/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>
+
<add key="TaxRateCode" value=""/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
|}
+
| 16
<br />
+
| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".
===Фискализация в Uniteller===
+
Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
Настройки задаются в секции <code><<paymentMethods>></code> файла <code>web.config</code> приложения '''EntryPoint'''.</br>
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
В зависимости от типа используемой фискализации прописывается соответствующая настройка.
+
|<syntaxhighlight lang="xml" enclose="div">
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+
<add key="InsuranceServiceKey" value="6"/>
 
+
</syntaxhighlight>
|- style="background-color:#F2F2F2"
 
 
 
! width="2%" | №
 
! width="28%" | Описание
 
! width="35%" | Значение
 
! width="35%" | Настройка
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 17
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.1.0'''.<br>
+
| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
 
 
|
 
  
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
+
<add key="OperatorTourServiceKey" value="1134"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 18
 +
| Настройка, определяющая '''тип операции при проведении платежа'''.
 +
Обязательная настройка.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="1" />
 +
</syntaxhighlight>
  
 +
|- style="vertical-align:text-top"
  
| 2
+
| 19
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.2.0'''.<br>
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
|
 
 
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>
+
<add key="paymentOperationCommissionId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|}
 
  
Добавлены следующие возможности в версии 2.0 от версии 1.0:</br>
+
| 20
* Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.</br>
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
* Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.</br>
+
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
* Возврат авансов и покупок, оплаченых частично либо полностью авансами.</br>
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
* Отнесение авансов в доход.</br>
+
Комиссия указывается '''в процентах'''.<br />
* Осуществления агентских продаж.</br>
+
Сумма оплаты вычисляется следующим образом:<br />
* Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.</br>
+
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
Добавлены следующие сценарии:</br>
+
Пример:<br />
* Операция оплаты с использованием платежной формы (версия 2.0).</br>
+
Стоимость путевки - '''100 у.е.''' <br />
* Операция оплаты с использованием API (версия 2.0).</br>
+
В настройке указана комиссия - '''50%'''.<br />
* Операция оплаты через ApplePay с использованием API (версия 2.0).</br>
+
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
* Операция подтверждения преавторизации (версия 2.0).</br>
+
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
* Операция отнесения авансов в доход с помощью API.</br>
+
|<syntaxhighlight lang="xml" enclose="div">
* Операция отнесения авансов в доход с помощью ЛК.</br>
+
<add key="addAgencyComission" value="3,627" />
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller (версия 2.0).</br>
+
</syntaxhighlight>
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller через ЛК (версия 2.0).</br>
+
 
* В сценарии регистрации заказа добавлена возможность регистрации для интерфейса 2.0.</br>
+
|- style="vertical-align:text-top"
* Добавлены программные интерфейсы для новых сценариев.</br>
+
 
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
+
| 21
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
  
===Настройка индивидуальных подписей и ссылок для кнопки оплаты===
+
| 22
Начиная с релиза 15.8 появилась возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы.
+
| Настройка, включающая расчет через Мастер финанс.
Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты:
+
|
<syntaxhighlight lang="xml" enclose="div">
+
* '''false''' - расчет через мастер финанс не включен;
<add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg"
+
* '''true''' - расчет через мастер финанс включен.
header="Оплата тура для участников программы «Кешбэк по карте МИР»"
+
|<syntaxhighlight lang="xml" enclose="div">
returnMoneyText = "В последствии можно будет вернуть часть средств"
+
<add key="AddPaymentsToMasterFinance" value="false"/>
paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»"
+
</syntaxhighlight>
paymentTermsLink = "https://payment.webpay.by/"
 
pair = "1"
 
maximumAmount="1000000"
 
skipDescriptionPage="true" paymentSystem="Uniteller" link="https://fpay.uniteller.ru/v2/pay"/>  
 
</syntaxhighlight>
 
<br>[[Файл: Ea_105.png|Описание]]<br />
 
* '''header''' - шапка с основным описанием способа оплаты<br />
 
* '''returnMoneyText''' -  дополнительное описание способа оплаты<br />
 
* '''paymentTermsText''' -  текст гиперссылки<br />
 
* '''paymentTermsLink''' -  ссылка на которую происходит переход при нажатии на текст гиперссылки<br />
 
* '''pair''' -  параметр позволяющий связать 2 баннера в пару<br />
 
В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.<br />
 
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе '''paymentAvailabilities''' друг за другом.<br />
 
<br>[[Файл: Ea_106.png|Способы оплаты]]<br/>
 
  
===Настройка стилей===
+
|- style="vertical-align:text-top"
В папке приложения '''EntryPoint''' есть файл ''Views\Shared\'' '''_Layout.cshtml'''.
 
В тегах <nowiki><div></nowiki> можно разместить информацию в '''Нeader''' и '''Footer'''. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <nowiki><div></nowiki>.
 
  
<nowiki><div id="header">
+
| 23
    Header
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
  </div>
+
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
  . . .
+
|<syntaxhighlight lang="xml" enclose="div">
  <div id="footer">
+
<add key="NewDogovorServiceServiceListKey" value="450" />
    Footer
+
</syntaxhighlight>
  </div></nowiki>
 
  
==Подготовка данных==
+
|- style="vertical-align:text-top"
Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
 
Перед использованием приложения '''EntryPoint''' необходимо в таблице tbl_Country в поле CN_RateKey проставить ключи национальных валют для стран, в которых зарегистрированы филиалы продающие путевки.
 
  
==Работа в системе==
+
| 24
===Поиск путевки===
+
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
Список заявок, забронированных в базе данных туроператора, доступен в экране [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
  
[[Файл: am_063.png|left|Предупреждение]]<br />
+
|- style="vertical-align:text-top"
Экран [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] доступен только для '''зарегистрированных''' и '''авторизованных в системе''' пользователей.
 
<br />
 
  
После ввода имени пользователя и пароля загрузится '''список заявок''', оформленных на '''покупателя'''/'''агентство''', указанного в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Регистрация нового пользователя|поле «Партнер в БД МТ»]] при регистрации пользователя в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web|Системе администрирования ПК «Мастер-Web»]], который сопоставлен имени текущего пользователя.
+
| 25
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
  
[[Файл: am_1061.png|x500px|Экран «Список заказов»]]<br />
+
| 26
<br />
+
| Настройка, задающая форму оплаты на шлюзе Uniteller
 +
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
 +
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentFormType" value="Card" />
 +
</syntaxhighlight>
  
Для отбора путевок можно использовать фильтры:
+
|- style="vertical-align:text-top"
* '''Поиск по номеру заявки''';
 
* '''Поиск по фамилии туриста''';
 
* '''Поиск по статусу документов на визу''';
 
* '''Поиск по стране''';
 
* '''Поиск по дате заявки''';
 
* '''Дата тура с...''' и '''Дата тура по...''';
 
* '''Путевки с наличием услуги «Виза»''';
 
* '''Путевки с задолженностями'''.
 
  
===Способ оплаты===
+
| 27
 
+
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
[[Файл: am_063.png|left|Предупреждение]]<br />
+
  Модуль "Выбор платежной системы" доступен '''только''' для путевок '''имеющих статус''', '''ключ''' которого [[#Настройки ПК «Мастер-Web»|указан в настройке paymentsStatuses]].
+
|0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
<br />
+
1 - добавляет в чек комиссию отдельной строкой<br>
 
+
 
Способ оплаты доступен из в экранов [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе («OrderInfo.aspx»)|«Информация о заказе»]].
+
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ComissionShowModeInVoucher" value ="0"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 28
 +
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
 +
 +
|По умолчанию - "Комиссия платежной системы"
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 29
 +
| Вид формирования чека <br>
 +
 +
|true - разбить по услугам отдельно, </br>
 +
false - одной строкой из ключа VoucherServiceText</br>
 +
По умолчанию настройка в состоянии false.</br>
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="VoucherShowDetails" value="false"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 30
 +
| Наименование услуги в чеке <br>
 +
 +
|%dogovor% (не обязательно) - для вставки номера договора.</br>
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 31
 +
| Типы договоров поставщиков, для которых необходимо указывать данные поставщика в фискальном чеке.<br>
 +
Работает совместно с настройкой '''VoucherShowDetails'''.<br><br>
 +
* Если VoucherShowDetails = true и типы договоров не указаны — в чеке будет просто список услуг.<br>
 +
* Если VoucherShowDetails = true и типы договоров указаны, и в путёвке есть услуги с поставщиком указанного типа — в чеке по этим услугам будет указана информация о поставщике.<br>
 +
* Если VoucherShowDetails = false — настройка не используется.
 +
| Список типов договоров, перечисленных через запятую.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="SendDetailPartnerByDogovorTypes" value=""/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 32
 +
| Код ставки налогообложения для поставщиков, типы договоров которых указаны в настройке '''SendDetailPartnerByDogovorTypes'''.<br>
 +
Если не указан — используется значение общей настройки '''TaxRateCode'''.<br>
 +
Допустимые значения:<br>
 +
* -1 – не облагается НДС<br>
 +
* 0 – ставка 0%<br>
 +
* 5 – ставка 5%<br>
 +
* 7 – ставка 7%<br>
 +
* 10 – ставка 10%<br>
 +
* 20 – ставка 20%<br>
 +
* 105 – 5/105<br>
 +
* 107 – 7/107<br>
 +
* 110 – 10/110<br>
 +
* 120 – 20/120
 +
| Код ставки НДС.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxRateCodePartner" value="20" />
 +
</syntaxhighlight>
 +
|}
 +
<br />
 +
=====Фискализация в Uniteller=====
 +
Настройки задаются в секции <code><<paymentMethods>></code> файла <code>web.config</code> приложения '''EntryPoint'''.</br>
 +
В зависимости от типа используемой фискализации прописывается соответствующая настройка.
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 1
 +
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.1.0'''.<br>
 +
 
 +
|
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
 
 +
| 2
 +
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.2.0'''.<br>
 +
 
 +
|
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
|}
 +
 
 +
Добавлены следующие возможности в версии 2.0 от версии 1.0:</br>
 +
* Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.</br>
 +
* Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.</br>
 +
* Возврат авансов и покупок, оплаченых частично либо полностью авансами.</br>
 +
* Отнесение авансов в доход.</br>
 +
* Осуществления агентских продаж.</br>
 +
* Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.</br>
 +
Добавлены следующие сценарии:</br>
 +
* Операция оплаты с использованием платежной формы (версия 2.0).</br>
 +
* Операция оплаты с использованием API (версия 2.0).</br>
 +
* Операция оплаты через ApplePay с использованием API (версия 2.0).</br>
 +
* Операция подтверждения преавторизации (версия 2.0).</br>
 +
* Операция отнесения авансов в доход с помощью API.</br>
 +
* Операция отнесения авансов в доход с помощью ЛК.</br>
 +
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller (версия 2.0).</br>
 +
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller через ЛК (версия 2.0).</br>
 +
* В сценарии регистрации заказа добавлена возможность регистрации для интерфейса 2.0.</br>
 +
* Добавлены программные интерфейсы для новых сценариев.</br>
 +
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
 +
 
 +
====Uniteller для юридических лиц====
 +
Настройки задаются в секции <code><UnitellerPerson></code> файла <code>web.config</code> приложения '''EntryPoint'''.
 +
 
 +
При использовании платёжной системы для юридических лиц — Платформа Юнителлер для юридических лиц, добавляется соответствующий paymentMethod, paymentAvailability, configSection, а также настройки в секции <code><UnitellerPerson></code>.
 +
 
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 1
 +
| '''Точки продажи''' ('''shopIDP''')
 +
Обязательная настройка.
 +
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopIDP" value="00005432"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 2
 +
| '''Логин'''
 +
Обязательная настройка.
 +
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="login" value="2281" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 3
 +
| '''Пароль'''
 +
Обязательная настройка.
 +
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 4
 +
| Платёжная система кредитной карты.
 +
|
 +
 
 +
*'''0''' или '''отсутствует значение''' - любая
 +
*'''Any''' или пустое значение - любая
 +
*'''VISA''' - VISA
 +
*'''MasterCard''' - MasterCard
 +
*'''DinersClub''' - Diners Club
 +
*'''JCB''' - JCB
 +
*'''AmericanExpress''' - American Express
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="meanType" value="" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 5
 +
| Тип электронной валюты.
 +
|
 +
 
 +
*'''Any''' или пустое значение - любая система электронных платежей
 +
*'''YandexMoney''' - Яндекс.Деньги
 +
*'''RBKMoney''' - RBK Money
 +
*'''MoneyMail''' - MoneyMail
 +
*'''WebCreds''' - WebCreds
 +
*'''PlatezhRu''' - Platezh.ru
 +
*'''MailRuMoney''' - Деньги@Mail.Ru
 +
*'''MobileMegafon''' - Мобильный платёж Мегафон
 +
*'''MobileMTS''' - Мобильный платёж МТС
 +
*'''MobileBeeline''' - Мобильный платёж Билайн
 +
*'''EuroSet''' - Евросеть
 +
*'''QIWI''' - QIWI Кошелек
 +
*'''WebMonewWMR''' - WebMoney WMR
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="eMoneyType" value="" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 6
 +
| Таймаут между попытками запроса результата (в миллисекундах).
 +
| По умолчанию 100.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="requestTimeout" value="100" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 7
 +
| Количество попыток запроса результата.
 +
| По умолчанию 5.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="requestAttempts" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 8
 +
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ пользователя''', к которому привязывается оплата (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="80" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 9
 +
| Настройка, определяющая '''филиал''' (партнера), к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ филиала''', к которому привязывается оплата (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="filialKey" value="1" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 10
 +
| Настройка, определяющая '''отдел''' (кассу), к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ отдела''' (кассы), к которому привязывается оплата (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="0" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 11
 +
| Настройка, определяющая '''валюту''', в которой будет совершаться платеж через систему «Uniteller».
 +
Обязательная настройка.
 +
|
 +
 
 +
*'''Contract''' — оплата в валюте путевки;
 +
*'''Tour''' — оплата в валюте тура;
 +
*'''National''' — оплата в национальной валюте;
 +
*'''DefinedBySettings''' — оплата в валюте, определенной настройкой '''currency'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="currencyToPay" value="National" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 12
 +
| Настройка, определяющая '''код валюты''', в которой будет совершаться платеж через систему «Uniteller» при значении '''DefinedBySettings''' настройки '''currencyToPay'''.
 +
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
 +
Сопоставление кодов валют ПК «Мастер-Тур» и системы «Uniteller» задается в секции <code><currencyMap></code>, например:
 +
<syntaxhighlight lang="xml">
 +
<currencyMap>
 +
<add key="рб" value="RUB"/>
 +
<add key="грн" value="UAH"/>
 +
<add key="azn" value="AZN"/>
 +
<add key="тг" value="KZT"/>
 +
</currencyMap>
 +
</syntaxhighlight>
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="currency" value="рб" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 13
 +
| Включение функционала фискализации платежей.
 +
После включения необходимо заполнить настройки '''TaxMode''' и '''TaxRateCode'''.
 +
|
 +
 
 +
*'''true''' — использовать фискализацию при оплате;
 +
*'''false''' или отсутствие настройки — не использовать фискализацию при оплате.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="UseFiscalization" value="true"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 14
 +
| Код системы налогообложения, необходимый для работы фискализации платежей.
 +
|
 +
 
 +
*'''0''' — общая система налогообложения;
 +
*'''1''' — упрощенная система налогообложения (Доход);
 +
*'''2''' — упрощенная система налогообложения (Доход минус Расход);
 +
*'''3''' — единый налог на вмененный доход;
 +
*'''4''' — единый сельскохозяйственный налог;
 +
*'''5''' — патентная система налогообложения.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="TaxMode" value="2" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 15
 +
| Код ставки налогообложения, необходимый для работы фискализации платежей.
 +
|
 +
 
 +
*-1 – не облагается НДС
 +
*0 – облагается НДС по ставке 0%
 +
*5 - облагается НДС по ставке 5%
 +
*7 - облагается НДС по ставке 7%
 +
*10 – облагается НДС по ставке 10%
 +
*20 – облагается НДС по ставке 20%
 +
*105 – облагается НДС по ставке 5/105
 +
*107 – облагается НДС по ставке 7/107
 +
*110 – облагается НДС по ставке 10/110
 +
*120 – облагается НДС по ставке 20/120
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="TaxRateCode" value="20" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 16
 +
| Пути к шаблонам для формирования запросов и подписи.
 +
|
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="base" value="templates/unitellerBaseRequestTemplate.txt" />
 +
<add key="signature" value="templates/unitellerSignatureTemplate.txt" />
 +
<add key="otherParams" value="templates/unitellerOtherParamsTemplate.txt" />
 +
<add key="resultRequest" value="templates/unitellerResultRequestTemplate.txt" />
 +
<add key="fiscalizationParams" value="templates/unitellerFiscalizationParamsTemplate.txt" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 17
 +
| Валюты, поддерживаемые системой Uniteller.
 +
| В системе Uniteller возможны только следующие валюты платежа: RUB, UAH, AZN, KZT
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="рб" value="RUB" />
 +
<add key="грн" value="UAH" />
 +
<add key="azn" value="AZN" />
 +
<add key="тг" value="KZT" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 18
 +
| Ключ услуги страхования, добавляемой в фискальный чек. Применяется, если отсутствует скрытая услуга "Операторский тур".
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="InsuranceServiceKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 19
 +
| Ключ услуги для скрытой услуги "Операторский тур", отображаемой в фискальном чеке.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="OperatorTourServiceKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 20
 +
| Настройка, определяющая '''тип операции при проведении платежа'''.
 +
Обязательная настройка.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="1" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 21
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationComissionId" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 22
 +
| Настройка, позволяющая задавать '''размер комиссии''', включаемой в сумму оплаты (для агентств).
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 +
| Значение комиссии в процентах. При вычислении итоговой суммы платежа в Uniteller из неё вычитается процент комиссии, чтобы получить стоимость путевки.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 23
 +
| Настройка, позволяющая задавать '''размер комиссии''', включаемой в сумму оплаты (для частных лиц).
 +
| Значение комиссии в процентах. При вычислении итоговой суммы платежа в Uniteller из неё вычитается процент комиссии, чтобы получить стоимость путевки.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 24
 +
| Настройка, включающая расчет через Мастер финанс.
 +
|
 +
 
 +
*'''false''' — расчет через Мастер финанс не включен;
 +
*'''true''' — расчет через Мастер финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="AddPaymentsToMasterFinance" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 25
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 26
 +
| Настройка, задающая класс услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 27
 +
| Настройка, задающая партнера, который является поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.
 +
| Ключ партнера (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 28
 +
| Настройка, задающая форму оплаты на шлюзе Uniteller.
 +
|
 +
 
 +
*'''All''' — и карта и СБП;
 +
*'''Card''' — только карта;
 +
*'''SBP''' — только СБП.
 +
Если параметр не указан, или пустой, используется значение по умолчанию — '''All'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="PaymentFormType" value="Person" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 29
 +
| Тип отображения комиссии платежной системы в фискальном чеке.
 +
|
 +
 
 +
*'''0''' — комиссия увеличивает стоимость позиций по чеку на указанный процент комиссии;
 +
*'''1''' — комиссия добавляется отдельной строкой в чеке.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="ComissionShowModeInVoucher" value="0" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 30
 +
| Текст наименования позиции в чеке для комиссии при типе отображения '''1'''.
 +
| По умолчанию — "Комиссия платежной системы".
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ComissionTextInVoucher" value="Юнителлер комиcсия" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 31
 +
| Вид формирования чека.
 +
|
 +
 
 +
*'''true''' — разбить по услугам отдельно;
 +
*'''false''' — одной строкой из ключа VoucherServiceText.
 +
По умолчанию — '''false'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="VoucherShowDetails" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 32
 +
| Наименование услуги в чеке.
 +
| Поддерживается вставка номера договора через параметр '''%dogovor%'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 33
 +
| Типы договоров поставщиков, для которых необходимо указывать данные поставщика в фискальном чеке.<br>
 +
Работает совместно с настройкой '''VoucherShowDetails'''.<br><br>
 +
* Если VoucherShowDetails = true и типы договоров не указаны — в чеке будет просто список услуг.<br>
 +
* Если VoucherShowDetails = true и типы договоров указаны, и в путёвке есть услуги с поставщиком указанного типа — в чеке по этим услугам будет указана информация о поставщике.<br>
 +
* Если VoucherShowDetails = false — настройка не используется.
 +
| Список типов договоров, перечисленных через запятую.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="SendDetailPartnerByDogovorTypes" value=""/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 34
 +
| Код ставки налогообложения для поставщиков, типы договоров которых указаны в настройке '''SendDetailPartnerByDogovorTypes'''.<br>
 +
Если не указан — используется значение общей настройки '''TaxRateCode'''.<br>
 +
Допустимые значения:<br>
 +
* -1 – не облагается НДС<br>
 +
* 0 – ставка 0%<br>
 +
* 5 – ставка 5%<br>
 +
* 7 – ставка 7%<br>
 +
* 10 – ставка 10%<br>
 +
* 20 – ставка 20%<br>
 +
* 105 – 5/105<br>
 +
* 107 – 7/107<br>
 +
* 110 – 10/110<br>
 +
* 120 – 20/120
 +
| Код ставки НДС.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxRateCodePartner" value="20" />
 +
</syntaxhighlight>
 +
|}
 +
 
 +
====YandexPay====
 +
Настройки задаются в секции <code><YandexPay></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top
 +
 
 +
 
 +
| 1
 +
| '''Таймаут запроса'''
 +
Обязательная настройка.
 +
| Время ожидания ответа от сервера в миллисекундах.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="RequestTimeout" value="10" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 2
 +
| '''API-ключ'''
 +
Обязательная настройка.
 +
| Уникальный ключ API для доступа к сервисам Yandex Pay.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 3
 +
| '''URL создания заказа'''
 +
Обязательная настройка.
 +
| URL для запроса на создание ссылки на оплату заказа.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 4
 +
| '''URL получения деталей заказа'''
 +
Обязательная настройка.
 +
| URL для запроса на получение деталей заказа.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="GetOrderDetailsUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 5
 +
| '''Ставка НДС'''
 +
Обязательная настройка.
 +
| Значение ставки НДС:
 +
 
 +
* '''1''' - НДС по ставке 20%
 +
* '''2''' - НДС по ставке 10%
 +
* '''3''' - НДС по расчетной ставке 20/120
 +
* '''4''' - НДС по расчетной ставке 10/110
 +
* '''5''' - НДС по ставке 0%
 +
* '''6''' - Без НДС
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="Tax" value="1" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 6
 +
| '''Доступные методы оплаты'''
 +
Опциональная настройка.
 +
| Методы оплаты, доступные на платежной форме Yandex Pay:
 +
 
 +
* '''0''' - CARD
 +
* '''1''' - SPLIT
 +
* '''2''' - CARD, SPLIT
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AvailablePaymentMethods" value="2" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 7
 +
| '''Сплит при наличии комиссии'''
 +
Опциональная настройка.
 +
| Указывает, доступен ли сплит, когда есть комиссия:
 +
 
 +
* '''true''' - доступен
 +
* '''false''' - не доступен
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AvailableSplitMethodWhenCommission" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 8
 +
| '''Ключ пользователя'''
 +
Обязательная настройка.
 +
| Ключ пользователя, к которому привязывается оплата.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="106" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 9
 +
| '''Ключ филиала'''
 +
Обязательная настройка.
 +
| Ключ филиала, к которому привязывается оплата.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentFilialKey" value="7" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 10
 +
| '''Ключ отдела'''
 +
Обязательная настройка.
 +
| Ключ отдела (кассы), к которому привязывается оплата.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="7" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 11
 +
| '''Тип операции при проведении платежа'''
 +
Обязательная настройка.
 +
| Ключ операции из таблицы PaymentOperations, определяющий тип операции при проведении платежа.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="36" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 12
 +
| '''Тип операции для комиссий'''
 +
Опциональная настройка.
 +
| Ключ операции из таблицы PaymentOperations для комиссий.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="7" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 13
 +
| '''Размер комиссии для агентств'''
 +
Опциональная настройка.
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 +
| Размер комиссии для агентств в процентах.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="10" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 14
 +
| '''Размер комиссии для частных лиц'''
 +
Опциональная настройка.
 +
| Размер комиссии для частных лиц в процентах.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 15
 +
| '''Класс услуги для комиссии'''
 +
Опциональная настройка.
 +
| Класс услуги, добавляемой в путевку при наличии комиссии.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 16
 +
| '''Услуга для комиссии'''
 +
Опциональная настройка.
 +
| Услуга, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="982" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 17
 +
| '''Партнер для комиссии'''
 +
Опциональная настройка.
 +
| Партнер, являющийся поставщиком для услуги, добавляемой в путевку при наличии комиссии.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="10760" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 18
 +
| '''Расчеты через MasterFinance'''
 +
Опциональная настройка.
 +
| Указывает, проводятся ли платежи через MasterFinance:
 +
 
 +
* '''true''' - проводятся
 +
* '''false''' - не проводятся
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 19
 +
| '''Система налогообложения'''
 +
Обязательная настройка.
 +
| Указывает, какая система налогообложения будет использоваться при платежах:
 +
 
 +
* '''osn'''  — общая СН
 +
* '''usn_income''' — упрощенная СН (доходы)
 +
* '''usn_income_outcome''' – упрощенная СН (доходы минус расходы)
 +
* '''esn''' – единый сельскохозяйственный налог
 +
* '''patent''' – патентная СН
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxationCode" value="osn" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 20
 +
| '''Идентификатор группы ККТ'''
 +
Обязательная настройка.
 +
| Идентификатор группы контрольно-кассовой техники.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptGroupCode" value="2ca8430a-ff34-421a-b2aa-2071d79eb782" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 21
 +
| '''Логин для авторизации в сервисе формирования чеков'''
 +
Обязательная настройка.
 +
| Логин для авторизации в сервисе формирования чеков.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptLogin" value="7709624788" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 22
 +
| '''Пароль для авторизации в сервисе формирования чеков'''
 +
Обязательная настройка.
 +
| Пароль для авторизации в сервисе формирования чеков.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptPassword" value="79161128982" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 23
 +
| '''URL для авторизации в сервисе формирования чеков'''
 +
Обязательная настройка.
 +
| URL для авторизации в сервисе формирования чеков.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
| 24
 +
| '''Почта для отправки чеков по умолчанию'''
 +
Опциональная настройка.
 +
| Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" />
 +
</syntaxhighlight>
 +
|}
 +
 
 +
====Assist====
 +
Настройки задаются в секции <code><Assist></code> файла <code>web.config</code> приложения '''EntryPoint'''.
 +
<br /><br />
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
| 1
 +
| Ключ интернет-магазина
 +
| '''Ключ магазина''', который предоставляет Assist
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopID" value="326055"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Логин для авторизации в системе Assist
 +
| '''Логин''' для авторизации, который предоставляет Assist. Необходимо добавить обе настройки.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopLogin" value="login"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Пароль для авторизации в системе Assist
 +
| '''Пароль''' для авторизации, который предоставляет Assist
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopPassword" value="password"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 4
 +
| Логин для авторизации
 +
| '''Логин''' веб-сервиса, который предоставляет Assist
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="webServiceLogin" value=" login "/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 5
 +
| Настройка, определяющая пользователя, к которому будет привязываться оплата
 +
| '''Ключ пользователя''' из таблицы '''[UserList]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="100006"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 6
 +
| Настройка, определяющая партнера, к которому будет привязываться оплата
 +
| '''Ключ партнера''' из таблицы '''[tbl_Partners]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentFilialKey" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 7
 +
| Настройка, определяющая отдел, к которому будет привязываться оплата
 +
| '''Ключ отдела (кассы)''' из таблицы '''[PrtDeps]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="2"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 8
 +
| Боевой/тестовый адрес. Откуда получать ответ.
 +
| '''Боевой адрес''', который предоставляет Assist
 +
либо белорусский тестовый сервис:<br />
 +
''https://test.paysec.by/orderstate/orderstate.cfm''<br />
 +
либо питерский тестовый сервис:<br />
 +
''https://payments.demo.paysecure.ru/orderstate/orderstate.cfm<br />''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="assistGetTransaction" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 9
 +
| Секретное слово из личного кабинета
 +
| '''Секретное слово''', которое указывается в личном кабинете в Assist 
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="salt" value="" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
|- style="vertical-align:text-top"
 +
| 10
 +
| Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему Assist
 +
| '''Код валюты''' из таблицы '''[Rates]''', в которой будет совершаться платеж
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="assistPaymentsRate" value="рб" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 11
 +
| Настройка, определяющая тип операции при проведении платежа
 +
| '''Ключ операции''' из таблицы '''[PaymentOperations]'''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationId" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 12
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
 +
 
 +
 
 +
|- style="vertical-align:text-top"
 +
| 13
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «Assist» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="3,627" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 14
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «Assist» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 15
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 16
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 17
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 18
 +
| Настройка, включающая расчет через Мастер Финанс.
 +
|
 +
* '''false''' - расчет через Мастер Финанс не включен;
 +
* '''true''' - расчет через Мастер Финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +