@@ Строка 136: / Строка 136: @@
 |- style="vertical-align:text-top"
+|}
+===Настройки логирования===
+Настройки секции <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>
 |}
@@ Строка 211: / Строка 240: @@
 |- 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>
 |}
@@ Строка 243: / Строка 279: @@
   </paymentAvailabilities>
-* '''code''' - идентификатор доступности способа оплаты, должен быть уникальным;
+* '''code''' – идентификатор доступности способа оплаты, должен быть уникальным;
-* '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
+* '''paymentMethodCode''' – идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
-* '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
+* '''countryCode''' – ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
-* '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле ''PR_COD''). Может быть пустым - доступен для всех филиалов;
+* '''filialCode''' – ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле ''PR_COD''). Может быть пустым - доступен для всех филиалов;
-* '''consumerCode''' - ограничение по типу забронировавшего: турист или агентство. ''Person'' - для частных лиц, ''Agency'' - для турагентств;
+* '''consumerCode''' – ограничение по типу забронировавшего: турист или агентство. ''Person'' – для частных лиц, ''Agency'' – для турагентств;
-* '''isAvailable''' - включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции;
+* '''isAvailable''' – включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции;
-* '''priority''' - приоритет при выборе нескольких доступных вариантов оплаты;
+* '''priority''' – приоритет при выборе нескольких доступных вариантов оплаты;
-* '''tourTypes''' - ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров (допускается внесение нескольких параметров через ",").
+* '''tourTypes''' – ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр – оплата доступна для всех типов туров (допускается внесение нескольких параметров через ","). Если требуется оплата с типом тура ''Индивидуально'', то в настройку необходимо добавить ключ ''0''
-** ключ ''tourTypes'' может быть:
-***-1 – Все туры
-*** 0 – Индивидуальный тур
-*** 1 – Комбинированный тур
-*** 2 – Стандартный тур
-*** 3 – Авиаперелет
-*** 4 – Многодневная экскурсия
-*** 5 – Специальное предложение
-*** 8 – Дополнительный тур
-[[Файл:Am 063.png]] Значения ключей могут отличаться в зависимости от того как вносились в справочник [[Мастер-Тур(15):Типы туров|Типы туров]] и добавлялись в таблицу ''TipTur''.
 ===Настройки подключения и параметров используемых платежных систем модуля EntryPoint===
@@ Строка 333: / Строка 359: @@
 | 6
 |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 |
 Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
@@ Строка 496: / Строка 523: @@
 [[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
-Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija  или запросить информацию в технической поддержке Альфа-Банка
+Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут 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"
@@ Строка 513: / Строка 550: @@
 | 1
-| Идентификатор клиента, который выдается платежной системой Sberbank.
+| Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br />
+При использовании '''Юкасса по API Сбербанка''' используется логин, выданный Юкасса.<br />
 Обязательная настройка.
 | '''Идентификатор клиента'''
@@ Строка 519: / Строка 557: @@
 <add key="userName" value="логин sberbank-api" />
 </syntaxhighlight>
 |- style="vertical-align:text-top"
 | 2
-| Пароль клиента, который выдается платежной системой Sberbank.
+| Пароль клиента, который выдается платежной системой Sberbank.<br /><br />
+При использовании '''Юкасса по API Сбербанка''' используется пароль, выданный Юкасса.<br />
 Обязательная настройка.
 | '''Пароль клиента'''
@@ Строка 527: / Строка 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>
@@ Строка 554: / Строка 602: @@
 <add key="useFiscalization" value="false"/>
 </syntaxhighlight>
 |- style="vertical-align:text-top"
 | 6
 | Настройка, определяющая '''тип операции при проведении платежа'''.
@@ Строка 565: / Строка 613: @@
 |- style="vertical-align:text-top"
 | 7
 | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
@@ Строка 576: / Строка 623: @@
 |- style="vertical-align:text-top"
 | 8
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
+Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 Комиссия указывается '''в процентах'''.<br />
@@ Строка 587: / Строка 634: @@
 |- style="vertical-align:text-top"
 | 9
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
@@ Строка 598: / Строка 644: @@
 |- style="vertical-align:text-top"
 | 10
 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
@@ Строка 607: / Строка 652: @@
 |- style="vertical-align:text-top"
 | 11
 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
@@ Строка 616: / Строка 660: @@
 |- style="vertical-align:text-top"
 | 12
 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
@@ Строка 625: / Строка 668: @@
 |- style="vertical-align:text-top"
 | 13
 | Настройка, включающая расчет через Мастер финанс.
@@ Строка 841: / Строка 883: @@
 | 15
 |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 |
 Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
@@ Строка 1125: / Строка 1168: @@
 |
-* '''-1''' – не облагается НДС
+*-1 – не облагается НДС
-* '''0''' – облагается НДС по ставке 0%
+*0 – облагается НДС по ставке 0%
-* '''10''' – облагается НДС по ставке 10%
+*5 - облагается НДС по ставке 5%
-* '''18''' – облагается НДС по ставке 18%
+*7 - облагается НДС по ставке 7%
-* '''110''' – облагается НДС по ставке 10/110
+*10 – облагается НДС по ставке 10%
-* '''118''' – облагается НДС по ставке 18/118
+*20 – облагается НДС по ставке 20%
+*105 – облагается НДС по ставке 5/105
+*107 – облагается НДС по ставке 7/107
+*110 – облагается НДС по ставке 10/110
+*120 – облагается НДС по ставке 20/120
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="TaxRateCode" value=""/>
@@ Строка 1178: / Строка 1225: @@
 | 20
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
+Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 Комиссия указывается '''в процентах'''.<br />
@@ Строка 1302: / Строка 1350: @@
 |- 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 />
@@ Строка 1359: / Строка 1438: @@
 * Добавлены программные интерфейсы для новых сценариев.</br>
 * Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
+====Uniteller для юридических лиц====
+Настройки задаются в секции <code><UnitellerPerson></code> файла <code>web.config</code> приложения '''EntryPoint'''.
+При использовании платёжной системы для юридических лиц — Платформа Юнителлер для юридических лиц, добавляется соответствующий paymentMethod, paymentAvailability, configSection, а также настройки в секции <code><UnitellerPerson></code>.
+{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+|- style="background-color:#F2F2F2"
+! width="2%" | №
+! width="28%" | Описание
+! width="35%" | Значение
+! width="35%" | Настройка
+|- style="vertical-align:text-top"
+| 1
+| '''Точки продажи''' ('''shopIDP''')
+Обязательная настройка.
+| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="shopIDP" value="00005432"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 2
+| '''Логин'''
+Обязательная настройка.
+| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="login" value="2281" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 3
+| '''Пароль'''
+Обязательная настройка.
+| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 4
+| Платёжная система кредитной карты.
+|
+*'''0''' или '''отсутствует значение''' - любая
+*'''Any''' или пустое значение - любая
+*'''VISA''' - VISA
+*'''MasterCard''' - MasterCard
+*'''DinersClub''' - Diners Club
+*'''JCB''' - JCB
+*'''AmericanExpress''' - American Express
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="meanType" value="" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 5
+| Тип электронной валюты.
+|
+*'''Any''' или пустое значение - любая система электронных платежей
+*'''YandexMoney''' - Яндекс.Деньги
+*'''RBKMoney''' - RBK Money
+*'''MoneyMail''' - MoneyMail
+*'''WebCreds''' - WebCreds
+*'''PlatezhRu''' - Platezh.ru
+*'''MailRuMoney''' - Деньги@Mail.Ru
+*'''MobileMegafon''' - Мобильный платёж Мегафон
+*'''MobileMTS''' - Мобильный платёж МТС
+*'''MobileBeeline''' - Мобильный платёж Билайн
+*'''EuroSet''' - Евросеть
+*'''QIWI''' - QIWI Кошелек
+*'''WebMonewWMR''' - WebMoney WMR
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="eMoneyType" value="" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 6
+| Таймаут между попытками запроса результата (в миллисекундах).
+| По умолчанию 100.
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="requestTimeout" value="100" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 7
+| Количество попыток запроса результата.
+| По умолчанию 5.
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="requestAttempts" value="5" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 8
+| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+Обязательная настройка.
+| '''Ключ пользователя''', к которому привязывается оплата (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="masterTourUser" value="80" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 9
+| Настройка, определяющая '''филиал''' (партнера), к которому будет '''привязываться оплата'''.
+Обязательная настройка.
+| '''Ключ филиала''', к которому привязывается оплата (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="filialKey" value="1" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 10
+| Настройка, определяющая '''отдел''' (кассу), к которому будет '''привязываться оплата'''.
+Обязательная настройка.
+| '''Ключ отдела''' (кассы), к которому привязывается оплата (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="departmentKey" value="0" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 11
+| Настройка, определяющая '''валюту''', в которой будет совершаться платеж через систему «Uniteller».
+Обязательная настройка.
+|
+*'''Contract''' — оплата в валюте путевки;
+*'''Tour''' — оплата в валюте тура;
+*'''National''' — оплата в национальной валюте;
+*'''DefinedBySettings''' — оплата в валюте, определенной настройкой '''currency'''.
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="currencyToPay" value="National" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 12
+| Настройка, определяющая '''код валюты''', в которой будет совершаться платеж через систему «Uniteller» при значении '''DefinedBySettings''' настройки '''currencyToPay'''.
+| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
+Сопоставление кодов валют ПК «Мастер-Тур» и системы «Uniteller» задается в секции <code><currencyMap></code>, например:
+<syntaxhighlight lang="xml">
+<currencyMap>
+<add key="рб" value="RUB"/>
+<add key="грн" value="UAH"/>
+<add key="azn" value="AZN"/>
+<add key="тг" value="KZT"/>
+</currencyMap>
+</syntaxhighlight>
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="currency" value="рб" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"

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