@@ Строка 4: / Строка 4: @@
 Модуль '''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
 ==Установка==
@@ Строка 134: / Строка 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"
+| 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>
+|}
-===Формат настроек в файле web.config модуля '''EntryPoint'''===
+===Настройки в секции appSettings модуля EntryPoint===
 Настройки секции <code><appSettings></code> файла <code>web.config</code> модуля EntryPoint.
 {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
@@ Строка 198: / Строка 230: @@
 |- 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>
 |}
-==Секция описания способов оплаты в платежных системах==
+===Настройки в секции paymentMethods модуля EntryPoint===
+В данной секции происходит настройка описания способов оплаты в платежных системах.
+Настройки секции <code><paymentMethods></code> файла <code>web.config</code> модуля EntryPoint.
   <paymentMethods>
       <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />
@@ Строка 207: / Строка 259: @@
 * '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 * '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений:
-** [[Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете)|Alfabank]]
+** Alfabank
-** [[Платежные web-сервисы: Сервис интеграции с платежной системой Sberbank (оплата картой в личном кабинете)|Sberbank]] и SberbankMir, SberbankChildren
+** Sberbank и SberbankMir, SberbankChildren
-** [[Платежные web-сервисы: Сервис интеграции с платежной системой Tinkoff (оплата картой в личном кабинете)|Tinkoff]]
+** Tinkoff
-** [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)|Uniteller]] и UnitellerMir, UnitellerChildren
+** Uniteller и UnitellerMir, UnitellerChildren
+** Assist
+** WebPay
+** PayOnline
 * '''LogoLink''' - расположение логотипа способа оплаты;
 * '''maximumAmount''' - максимальный размер платежа;
@@ Строка 216: / Строка 271: @@
 Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.<br />
 Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br />
-* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты;
+* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты.
-==Секция описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю:==
+===Настройки в секции paymentAvailabilities модуля EntryPoint===
+В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю.
   <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>
-* '''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 />
@@ Строка 292: / Строка 348: @@
 | 5
-|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+|Ссылка на платежный шлюз <br>
+|
+Ссылка на платежный шлюз
+| <syntaxhighlight lang="xml" enclose="div">
+<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 6
+|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 |
 Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
@@ Строка 302: / Строка 369: @@
 |- style="vertical-align:text-top"
-| 6
+| 7
 |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 |
@@ Строка 313: / Строка 380: @@
 |- style="vertical-align:text-top"
-| 7
+| 8
 | Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 Обязательная настройка.
@@ Строка 323: / Строка 390: @@
 |- style="vertical-align:text-top"
-| 8
+| 9
 | Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 Обязательная настройка.
@@ Строка 333: / Строка 400: @@
 |- style="vertical-align:text-top"
-| 9
+| 10
 | Настройка, включающая расчет через Мастер финанс.
 |
@@ Строка 344: / Строка 411: @@
 |- style="vertical-align:text-top"
-| 10
+| 11
 | Настройка, определяющая '''тип операции при проведении платежа'''.
 Обязательная настройка.
@@ Строка 354: / Строка 421: @@
 |- style="vertical-align:text-top"
-| 11
+| 12
 | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
@@ Строка 363: / Строка 430: @@
 |- style="vertical-align:text-top"
-| 12
+| 13
 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
@@ Строка 373: / Строка 440: @@
 |- style="vertical-align:text-top"
-| 13
+| 14
 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
@@ Строка 383: / Строка 450: @@
 |- style="vertical-align:text-top"
-| 14
+| 15
 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
@@ Строка 392: / Строка 459: @@
 |- style="vertical-align:text-top"
-| 15
+| 16
 | Настройка, определяющая '''адрес электронной почты по умолчанию'''.
 |Используется в том случае, если не указан адрес электронной почты главного туриста.
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="defaultEmail" value="" />
+</syntaxhighlight>
+|}<br />
+=====Формирование чеков Alfabank=====
+Настройки для формирования чека задаются в секции <code><Alfabank></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
+| '''Система налогообложения'''
+| Значения:
+  general — общая
+  simple_income — упрощенная (доходы)
+  simple_profit — упрощенная (доходы минус расходы)
+  patent — патентная
+  unified_agricultural — единый сельскохозяйственный налог
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="TaxationCode" value="general" />
 </syntaxhighlight>
+|- style="vertical-align:text-top"
+| 2
+| '''Ставка НДС'''
+| Значения:
+  no — без НДС
+— 0%
+— 10%
+— 20%
+/110 — 10/110
+/120 — 20/120
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="Tax" value="no" />
+</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>
-==Sberbank==
+[[Файл: 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 />
+Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''.
+В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:
+* '''логин'''
+* '''пароль'''
+* '''ссылку на платежный шлюз'''
+При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></code> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса.
+<br /><br />
 {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
@@ Строка 417: / Строка 550: @@
 | 1
-| Идентификатор клиента, который выдается платежной системой Sberbank.
+| Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br />
+При использовании '''Юкасса по API Сбербанка''' используется логин, выданный Юкасса.<br />
 Обязательная настройка.
 | '''Идентификатор клиента'''
@@ Строка 423: / Строка 557: @@
 <add key="userName" value="логин sberbank-api" />
 </syntaxhighlight>
 |- style="vertical-align:text-top"
 | 2
-| Пароль клиента, который выдается платежной системой Sberbank.
+| Пароль клиента, который выдается платежной системой Sberbank.<br /><br />
+При использовании '''Юкасса по API Сбербанка''' используется пароль, выданный Юкасса.<br />
 Обязательная настройка.
 | '''Пароль клиента'''
@@ Строка 431: / Строка 567: @@
 <add key="password" value="пароль sberbank-api" />
 </syntaxhighlight>
 |- style="vertical-align:text-top"
 | 3
-| Ссылка на платежный шлюз Sberbank
+| Ссылка на платежный шлюз Sberbank.<br /><br />
-|Аналогично настройке link в секции Sberbank в разделе<paymentMethods>
+Также поддерживается прием оплат через '''Юкасса''' по '''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>
 |- style="vertical-align:text-top"
 | 4
@@ Строка 458: / Строка 602: @@
 <add key="useFiscalization" value="false"/>
 </syntaxhighlight>
 |- style="vertical-align:text-top"
 | 6
 | Настройка, определяющая '''тип операции при проведении платежа'''.
@@ Строка 469: / Строка 613: @@
 |- style="vertical-align:text-top"
 | 7
 | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
-| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br>
+<br /><font style="color:red">''Внимание!''</font><br />
+Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными.
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="paymentOperationCommissionId" value="6" />
@@ Строка 478: / Строка 623: @@
 |- style="vertical-align:text-top"
 | 8
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
+Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 Комиссия указывается '''в процентах'''.<br />
@@ Строка 489: / Строка 634: @@
 |- style="vertical-align:text-top"
 | 9
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
@@ Строка 500: / Строка 644: @@
 |- style="vertical-align:text-top"
 | 10
 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
@@ Строка 509: / Строка 652: @@
 |- style="vertical-align:text-top"
 | 11
 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
@@ Строка 518: / Строка 660: @@
 |- style="vertical-align:text-top"
 | 12
 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
@@ Строка 524: / Строка 665: @@
 |<syntaxhighlight lang="xml" enclose=&quo

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