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

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
<
(Uniteller)
(Sberbank)
 
(не показано 66 промежуточных версий 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 />
  
Строка 284: Строка 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>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
Строка 294: Строка 369:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 7
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|  
 
|  
Строка 305: Строка 380:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 8
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 315: Строка 390:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 8
+
| 9
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 325: Строка 400:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 10
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
 
|
 
|
Строка 336: Строка 411:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 11
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 346: Строка 421:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 11
+
| 12
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
Строка 355: Строка 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>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 366: Строка 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>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 377: Строка 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">
Строка 387: Строка 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"
  
Строка 413: Строка 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 />
 +
 +
====Sberbank====
 +
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 +
<br /><br />
  
|- style="vertical-align:text-top"
+
Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''.
 +
В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:
 +
* '''логин'''
 +
* '''пароль'''
 +
* '''ссылку на платежный шлюз'''
  
| 2
+
При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></code> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса.
| '''Адрес для оплаты по QR коду'''
+
<br /><br />
Обязательная настройка.
+
 
| Адрес сервиса оплаты через карту банка «Tinkoff» по QR коду.
+
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
|<syntaxhighlight lang="xml" enclose="div">
+
 
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
+
|- style="background-color:#F2F2F2"
</syntaxhighlight>
+
 
 +
! 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
| 5
+
| Ссылка на платежный шлюз Sberbank.<br /><br />
| '''Идентификатор терминала'''
+
Также поддерживается прием оплат через '''Юкасса''' по '''API Сбербанка'''. В этом случае необходимо указать ссылку на шлюз, предоставленную Юкасса.
Обязательная настройка.
+
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods><br /><br />
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
Пример ссылки, предоставляемой Юкасса:<br />
 +
<code>https://3dsec-payments.yookassa.ru/payment/rest/</code>
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TerminalKey" value="1587990738"/>
+
<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>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 4
| 6
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
| '''Пароль терминала'''
 
 
Обязательная настройка.
 
Обязательная настройка.
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
+
<add key="masterTourUser" value="95" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 5
| 7
+
| Настройка, позволяющая создавать объект '''orderBundle''' (товарная корзина), в котором передаются все необходимые данные о товаре/услуге.
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
 
Обязательная настройка.
 
 
|  
 
|  
* '''ru''' - русский язык
+
* '''true''' - включено создание объекта '''orderBundle'''
* '''en''' - английский язык
+
* '''false''' или отсутствие настройки - объект '''orderBundle''' не создается <br />
 +
По умолчанию настройка имеет значение false.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LanguageFormCode" value="ru"/>
+
<add key="useFiscalization" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 6
| 8
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+
Обязательная настройка.
|
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
* '''osn''' – общая система налогообложения
 
* '''usn_income''' – упрощенная система налогообложения (Доход)
 
* '''usn_income_outcome''' – упрощенная СН (Доход минус Расход)
 
* '''patent''' – патентная система налогообложения
 
* '''envd''' – единый налог на вмененный доход
 
* '''esn''' – единый сельскохозяйственный налог
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxationCode" value="osn"/>
+
<add key="PaymentOperationId" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 7
| 9
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br>
|  
+
<br /><font style="color:red">''Внимание!''</font><br />
* '''none''' – не облагается НДС
+
Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными.
* '''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="paymentOperationCommissionId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|- style="vertical-align:text-top"
+
| 8
 
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
| 10
+
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
| Настройка, определяющая '''тип операции при проведении платежа'''.
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
Обязательная настройка.
+
Комиссия указывается '''в процентах'''.<br />
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
По умолчанию комиссия для агентств равна нулю.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="6" />
+
<add key="addAgencyComission" value="3.627" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 9
| 11
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
Комиссия указывается '''в процентах'''.<br />
 +
По умолчанию комиссия для частных лиц равна нулю.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentOperationCommissionId" value="" />
+
<add key="addPersonalComission" value="5.0" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 10
| 12
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
Обязательная настройка.
 
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="masterTourUser" value="80" />
+
<add key="NewDogovorServiceServiceListKey" value="450" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 11
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
  
| 13
+
|- style="vertical-align:text-top"
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
+
| 12
Обязательная настройка.
+
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentFilialKey" value="1" />
+
<add key="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 13
| 14
+
| Настройка, включающая расчет через Мастер финанс.
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
+
|
Обязательная настройка.
+
* '''false''' - расчет через мастер финанс не включен;
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+
* '''true''' - расчет через мастер финанс включен.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="departmentKey" value="2" />
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
|- style="vertical-align:text-top"
+
|}
 +
<br />
  
| 15
+
====Tinkoff (Т-Банк)====
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+
Настройки задаются в секции <code><paymentMethods></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
|
+
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
+
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
Комиссия указывается в процентах.
 
| <syntaxhighlight lang="xml" enclose="div">
 
<add key="addAgencyComission" value="15,8" />
 
</syntaxhighlight>
 
  
|- style="vertical-align:text-top"
+
|- style="background-color:#F2F2F2"
  
| 16
+
! width="2%" | №
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
+
! width="28%" | Описание
|
+
! width="35%" | Значение
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
+
! width="35%" | Настройка
Комиссия указывается в процентах.
 
| <syntaxhighlight lang="xml" enclose="div">
 
<add key="addPersonalComission" value="17,4" />
 
</syntaxhighlight>
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 17
+
| 1
| Настройка, включающая расчет через Мастер финанс.
+
| '''Платежный метод'''
|
+
Обязательная настройка.
* '''false''' - расчет через мастер финанс не включен;
+
| способ оплаты в платежной системе «Tinkoff (Т-Банк)».
* '''true''' - расчет через мастер финанс включен.
+
*'''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="AddPaymentsToMasterFinance" value="false"/>
+
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
 +
    maximumAmount="1000000"
 +
    skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
 +
 +
Настройки задаются в секции <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"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 18
+
| 1
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+
| '''Адрес платежной службы'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».
Название услуги комиссии в путевке берется из этого параметра
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceServiceListKey" value="450" />
+
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 19
+
| 2
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+
| '''Адрес для оплаты по QR коду'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
Название услуги комиссии в путевке берется из этого параметра
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceSvKey" value="1055" />
+
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 20
+
| 3
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
+
| '''Адрес метода для получения статуса платежа'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
| Адрес метода для получения статуса платежа.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServicePartnerKey" value="12921" />
+
<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
|}
 
<br />
 
  
==Uniteller==
+
|- style="vertical-align:text-top"
Настройки задаются в секции <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"
+
| 4
 
+
| '''Адрес метода возвращающего статус заказа'''
|- style="background-color:#F2F2F2"
+
Обязательная настройка.
 
+
| Адрес метода возвращающего статус заказа.
! width="2%" | №
+
|<syntaxhighlight lang="xml" enclose="div">
! width="28%" | Описание
+
<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
! width="35%" | Значение
+
</syntaxhighlight>
! width="35%" | Настройка
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 5
| '''Точки продажи''' ('''shopIDP''')
+
| '''Идентификатор терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="shopIDP" value="00005432"/>
+
<add key="TerminalKey" value="1587990738"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 2
+
| 6
| '''Логин'''
+
| '''Пароль терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
+
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="login" value="2281" />
+
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 3
+
| 7
| '''Пароль'''
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
 
Обязательная настройка.
 
Обязательная настройка.
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
+
|  
 +
* '''ru''' - русский язык
 +
* '''en''' - английский язык
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
+
<add key="LanguageFormCode" value="ru"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 4
+
| 8
|Платёжная система кредитной карты.
+
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
|
+
|  
* '''0''' или '''отсутствует значение''' - любая
+
* '''osn''' – общая система налогообложения
* '''1''' - VISA
+
* '''usn_income''' – упрощенная система налогообложения (Доход)
* '''2''' - MasterCard
+
* '''usn_income_outcome''' – упрощенная СН (Доход минус Расход)
* '''3''' - Diners Club
+
* '''patent''' – патентная система налогообложения
* '''4''' - JCB
+
* '''envd''' – единый налог на вмененный доход
* '''5''' - American Express
+
* '''esn''' – единый сельскохозяйственный налог
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="meanType" value="" />
+
<add key="TaxationCode" value="osn"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 5
+
| 9
|Тип электронной валюты.
+
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
|
+
|  
* '''0''' или '''отсутствует значение''' - любая система электронных платежей
+
* '''none''' – не облагается НДС
* '''1''' - Яндекс.Деньги
+
* '''vat0''' – облагается НДС по ставке 0%
* '''2''' - RBK Money
+
* '''vat10''' – облагается НДС по ставке 10%
* '''3''' - MoneyMail
+
* '''vat20''' – облагается НДС по ставке 20%
* '''4''' - WebCreds
+
* '''vat110''' – облагается НДС по ставке 10/110
* '''6''' - Platezh.ru
+
* '''vat120''' – облагается НДС по ставке 18/120
* '''7''' - Деньги@Mail.Ru
+
|<syntaxhighlight lang="xml" enclose="div">
* '''8''' - Мобильный платёж Мегафон
+
<add key="Tax" value="none"/>
* '''9''' - Мобильный платёж МТС
+
</syntaxhighlight>
* '''10''' - Мобильный платёж Билайн
+
 
* '''11''' - PayPal
+
|- style="vertical-align:text-top"
* '''12''' - ВКонтакте
+
|- style="vertical-align:text-top"
* '''13''' - Евросеть
+
 
* '''14''' - Yota.money
+
| 10
* '''15''' - QIWI Кошелек
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
* '''16''' - ПлатФон
+
Обязательная настройка.
* '''17''' - Moneybookers
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
* '''29''' - WebMoney WMR
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="eMoneyType" value="" />
+
<add key="PaymentOperationId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 11
| Таймаут между попытками запроса результата
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
|  
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
По умолчанию 100.
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="requestTimeout" value="100" />
+
<add key="paymentOperationCommissionId" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 12
| Количество попыток запроса результата
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
|
 
По умолчанию 5.
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="requestAttempts" value="5" />
 
</syntaxhighlight>
 
 
 
|- style="vertical-align:text-top"
 
 
 
| 8
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
 
Обязательная настройка.
 
Обязательная настройка.
 
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
Строка 755: Строка 861:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 13
 
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 765: Строка 871:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 14
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 775: Строка 881:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
|- style="vertical-align:text-top"
+
| 15
| 11
+
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
+
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
Обязательная настройка.
 
 
|  
 
|  
* '''Contract''' - оплата в ''валюте путевки'';
+
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
* '''Tour''' - оплата в ''валюте тура'';<br />
+
Комиссия указывается в процентах.
* '''National''' – оплата в ''национальной валюте'';<br />
+
| <syntaxhighlight lang="xml" enclose="div">
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
+
<add key="addAgencyComission" value="15,8" />
|<syntaxhighlight lang="xml" enclose="div">
+
</syntaxhighlight>
<add key="currencyToPay" value="Contract" />
+
 
</syntaxhighlight>
 
 
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 12
+
| 16
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
+
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
+
|  
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
+
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
<syntaxhighlight lang="xml">
+
Комиссия указывается в процентах.
<currencyMap>
+
| <syntaxhighlight lang="xml" enclose="div">
      <add key="рб" value="RUB"/>
+
<add key="addPersonalComission" value="17,4" />  
      <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>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 13
+
| 17
| Включение функционала фискализации платежей.<br />
+
| Настройка, включающая расчет через Мастер финанс.
После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
+
|
|  
+
* '''false''' - расчет через мастер финанс не включен;
* '''true''' – использовать фискализацию при оплате
+
* '''true''' - расчет через мастер финанс включен.
* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="UseFiscalization" value="true"/>
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 14
+
| 18
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
Название услуги комиссии в путевке берется из этого параметра
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
  
|  
+
| 19
* '''0''' – общая система налогообложения
+
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
* '''1''' – упрощенная система налогообложения (Доход)
+
Название услуги комиссии в путевке берется из этого параметра
* '''2''' – упрощенная СН (Доход минус Расход)
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
* '''3''' – единый налог на вмененный доход
 
* '''4''' – единый сельскохозяйственный налог
 
* '''5''' – патентная система налогообложения
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxMode" value=""/>
+
<add key="NewDogovorServiceSvKey" value="1055" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 15
+
| 20
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
+
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
|
 
* '''-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="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 16
+
|21
| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".
+
| Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться ''full_payment'' – полный расчет.
Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+
* Если сумма, которую мы оплачиваем меньше суммы, которую нужно оплатить, способ расчета определяется следующим образом:
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
** Если ''PaymentMethodPrepayment'' имеет значение, то берем его. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
 +
* Если по договору уже есть какая-то ранее оплаченная сумма, то способ расчета считается следующим образом:
 +
** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodFull''. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
 +
* Если у нас нет ранее оплаченной суммы, то способ расчета считается следующим образом:
 +
** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodMain''. Если он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
 +
| Возможные значения:
 +
* '''full_prepayment''' – предоплата 100%
 +
* '''prepayment''' – предоплата
 +
* '''advance''' – аванс
 +
* '''full_payment''' – полный расчет
 +
* '''partial_payment''' – частичный расчет и кредит
 +
* '''credit''' – передача в кредит
 +
* '''credit_payment''' – оплата кредита
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="InsuranceServiceKey" value="6"/>
+
<add key="PaymentMethodMain" value="prepayment" />
 +
<add key="PaymentMethodPrepayment" value="full_prepayment" />
 +
<add key="PaymentMethodFull" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
  
|- style="vertical-align:text-top"
+
====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"
  
| 17
+
|- style="background-color:#F2F2F2"
| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
 
  
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
! width="2%" | №
|<syntaxhighlight lang="xml" enclose="div">
+
! width="28%" | Описание
<add key="OperatorTourServiceKey" value="1134"/>
+
! width="35%" | Значение
</syntaxhighlight>
+
! width="35%" | Настройка
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|- style="vertical-align:text-top"
+
 
| 18
+
| 1
| Настройка, определяющая '''тип операции при проведении платежа'''.
+
| '''Точки продажи''' ('''shopIDP''')
 
Обязательная настройка.
 
Обязательная настройка.
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="1" />
+
<add key="shopIDP" value="00005432"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 19
+
| 2
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+
| '''Логин'''
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
Обязательная настройка.
 +
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentOperationCommissionId" value="6" />
+
<add key="login" value="2281" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 20
+
| 3
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
+
| '''Пароль'''
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+
Обязательная настройка.
Комиссия указывается '''в процентах'''.<br />
+
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
Сумма оплаты вычисляется следующим образом:<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="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 21
+
| 4
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
+
|Платёжная система кредитной карты.
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+
|
Комиссия указывается '''в процентах'''.<br />
+
* '''0''' или '''отсутствует значение''' - любая
Сумма оплаты вычисляется следующим образом:<br />
+
* '''1''' - VISA
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
+
* '''2''' - MasterCard
Пример:<br />
+
* '''3''' - Diners Club
Стоимость путевки - '''100 у.е.''' <br />
+
* '''4''' - JCB
В настройке указана комиссия - '''50%'''.<br />
+
* '''5''' - American Express
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="addPersonalComission" value="5" />
+
<add key="meanType" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 22
+
| 5
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+
|Тип электронной валюты.
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+
|
|<syntaxhighlight lang="xml" enclose="div">
+
* '''0''' или '''отсутствует значение''' - любая система электронных платежей
<add key="NewDogovorServiceServiceListKey" value="450" />
+
* '''1''' - Яндекс.Деньги
 +
* '''2''' - RBK Money
 +
* '''3''' - MoneyMail
 +
* '''4''' - WebCreds
 +
* '''6''' - Platezh.ru
 +
* '''7''' - Деньги@Mail.Ru
 +
* '''8''' - Мобильный платёж Мегафон
 +
* '''9''' - Мобильный платёж МТС
 +
* '''10''' - Мобильный платёж Билайн
 +
* '''11''' - PayPal
 +
* '''12''' - ВКонтакте
 +
* '''13''' - Евросеть
 +
* '''14''' - Yota.money
 +
* '''15''' - QIWI Кошелек
 +
* '''16''' - ПлатФон
 +
* '''17''' - Moneybookers
 +
* '''29''' - WebMoney WMR
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="eMoneyType" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 23
+
| 6
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+
| Таймаут между попытками запроса результата
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
|  
 +
По умолчанию 100.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceSvKey" value="1055" />
+
<add key="requestTimeout" value="100" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 24
+
| 7
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
+
| Количество попыток запроса результата
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
|  
 +
По умолчанию 5.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServicePartnerKey" value="12921" />
+
<add key="requestAttempts" value="5" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 24
+
| 8
| Настройка, задающая форму оплаты на шлюзе Unitellere
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
+
Обязательная настройка.
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
+
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentFormType" value="Card" />
+
<add key="masterTourUser" value="80" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 25
+
| 9
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
+
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
+
Обязательная настройка.
|0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
+
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
1 - добавляет в чек комиссию отдельной строкой<br>
 
 
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="ComissionShowModeInVoucher" value ="0"/>
+
<add key="paymentFilialKey" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 26
+
| 10
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
+
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
+
Обязательная настройка.
|По умолчанию - "Комиссия платежной системы"
+
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
+
<add key="departmentKey" value="2" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 27
 
| Вид формирования чека <br>
 
 
|true - разбить по услугам отдельно, </br>
 
false - одной строкой из ключа VoucherServiceText</br>
 
По умолчанию настройка в состоянии false.</br>
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="VoucherShowDetails" value="false"/>
 
</syntaxhighlight>
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 11
| 28
+
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
| Наименование услуги в чеке <br>
+
Обязательная настройка.
+
|  
|%dogovor% (не обязательно) - для вставки номера договора.</br>
+
* '''Contract''' - оплата в ''валюте путевки'';
 
+
* '''Tour''' -  оплата в ''валюте тура'';<br />
 +
* '''National''' – оплата в ''национальной валюте'';<br />
 +
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>
+
<add key="currencyToPay" value="Contract" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
|}
+
| 12
<br />
+
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
===Фискализация в Uniteller===
+
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
Настройки задаются в секции <code><<paymentMethods>></code> файла <code>web.config</code> приложения '''EntryPoint'''.</br>
+
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
В зависимости от типа используемой фискализации прописывается соответствующая настройка.
+
<syntaxhighlight lang="xml">
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+
<currencyMap>
 
+
      <add key="рб" value="RUB"/>
|- style="background-color:#F2F2F2"
+
      <add key="грн" value="UAH"/>
 
+
      <add key="azn" value="AZN"/>
! width="2%" | №
+
      <add key="тг" value="KZT"/>
! width="28%" | Описание
+
</currencyMap></syntaxhighlight>.
! width="35%" | Значение
+
|<syntaxhighlight lang="xml" enclose="div">
! width="35%" | Настройка
+
<add key="currency" value="рб" />
 +
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 13
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.1.0'''.<br>
+
| Включение функционала фискализации платежей.<br />
 
+
После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
 
|  
 
|  
 
+
* '''true''' – использовать фискализацию при оплате
 +
* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
+
<add key="UseFiscalization" value="true"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
 +
| 14
 +
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
 +
 +
|
 +
* '''0''' – общая система налогообложения
 +
* '''1''' – упрощенная система налогообложения (Доход)
 +
* '''2''' – упрощенная СН (Доход минус Расход)
 +
* '''3''' – единый налог на вмененный доход
 +
* '''4''' – единый сельскохозяйственный налог
 +
* '''5''' – патентная система налогообложения
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxMode" value=""/>
 +
</syntaxhighlight>
  
| 2
+
|- style="vertical-align:text-top"
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.2.0'''.<br>
+
 
 +
| 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">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>
+
<add key="TaxRateCode" value=""/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|}
 
  
Добавлены следующие возможности в версии 2.0 от версии 1.0:</br>
+
| 16
* Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.</br>
+
| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".  
* Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.</br>
+
Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
* Возврат авансов и покупок, оплаченых частично либо полностью авансами.</br>
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
* Отнесение авансов в доход.</br>
+
|<syntaxhighlight lang="xml" enclose="div">
* Осуществления агентских продаж.</br>
+
<add key="InsuranceServiceKey" value="6"/>
* Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.</br>
+
</syntaxhighlight>
Добавлены следующие сценарии:</br>
+
 
* Операция оплаты с использованием платежной формы (версия 2.0).</br>
+
|- style="vertical-align:text-top"
* Операция оплаты с использованием 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>
 
  
==Настройка индивидуальных подписей и ссылок для кнопки оплаты==
+
| 17
Начиная с релиза 15.8 появилась возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы.
+
| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты:
 
<syntaxhighlight lang="xml" enclose="div">
 
<add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg"
 
header="Оплата тура для участников программы «Кешбэк по карте МИР»"
 
returnMoneyText = "В последствии можно будет вернуть часть средств"
 
paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»"
 
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/>
 
  
==Настройка стилей==
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
В папке приложения '''EntryPoint''' есть файл ''Views\Shared\'' '''_Layout.cshtml'''.
+
|<syntaxhighlight lang="xml" enclose="div">
В тегах <nowiki><div></nowiki> можно разместить информацию в '''Нeader''' и '''Footer'''. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <nowiki><div></nowiki>.
+
<add key="OperatorTourServiceKey" value="1134"/>
 +
</syntaxhighlight>
  
<nowiki><div id="header">
+
|- style="vertical-align:text-top"
    Header
+
|- style="vertical-align:text-top"
  </div>
+
| 18
  . . .
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
  <div id="footer">
+
Обязательная настройка.
    Footer
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
  </div></nowiki>
+
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="1" />
 +
</syntaxhighlight>
  
==Подготовка данных==
+
|- style="vertical-align:text-top"
Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
 
Перед использованием приложения '''EntryPoint''' необходимо в таблице tbl_Country в поле CN_RateKey проставить ключи национальных валют для стран, в которых зарегистрированы филиалы продающие путевки.
 
  
==Работа в системе==
+
| 19
===Поиск путевки===
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
Список заявок, забронированных в базе данных туроператора, доступен в экране [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
  
[[Файл: am_063.png|left|Предупреждение]]<br />
+
|- style="vertical-align:text-top"
Экран [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] доступен только для '''зарегистрированных''' и '''авторизованных в системе''' пользователей.
 
<br />
 
  
После ввода имени пользователя и пароля загрузится '''список заявок''', оформленных на '''покупателя'''/'''агентство''', указанного в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Регистрация нового пользователя|поле «Партнер в БД МТ»]] при регистрации пользователя в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web|Системе администрирования ПК «Мастер-Web»]], который сопоставлен имени текущего пользователя.
+
| 20
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<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="addAgencyComission" value="3,627" />
 +
</syntaxhighlight>
  
[[Файл: am_1061.png|x500px|Экран «Список заказов»]]<br />
+
|- style="vertical-align:text-top"
<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
 
+
| Настройка, включающая расчет через Мастер финанс.
[[Файл: am_063.png|left|Предупреждение]]<br />
+
|
  Модуль "Выбор платежной системы" доступен '''только''' для путевок '''имеющих статус''', '''ключ''' которого [[#Настройки ПК «Мастер-Web»|указан в настройке paymentsStatuses]].
+
* '''false''' - расчет через мастер финанс не включен;
<br />
+
* '''true''' - расчет через мастер финанс включен.
 
+
|<syntaxhighlight lang="xml" enclose="div">
Способ оплаты доступен из в экранов [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе («OrderInfo.aspx»)|«Информация о заказе»]].
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 23
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 24
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 25
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 26
 +
| Настройка, задающая форму оплаты на шлюзе Uniteller
 +
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
 +
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentFormType" value="Card" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 27
 +
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
 +
 +
|0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
 +
1 - добавляет в чек комиссию отдельной строкой<br>
 +
 
 +
|<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">