Мастер-Тур(15):Интеграция с Приорбанк — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Редактирование платежа)
 
(не показаны 4 промежуточные версии 2 участников)
Строка 7: Строка 7:
  
 
==Введение==
 
==Введение==
Данное решение позволяет загружать платежи с использованием API банка "Приорбанк".
+
Данное решение позволяет загружать платежи с использованием API банка ''Приорбанк''.
  
 
==Установка==
 
==Установка==
Специальных действий для установки не требуется. Все работает в стандартной поставке приложения.
+
Специальных действий для установки не требуется. Все работает в стандартной поставке приложения.<br />
 +
В личном кабинете Приорбанка необходимо в строке "Адрес обратного вызова" прописать API адрес в формате '''сетевой путь к службе поиска/PriorBankAuth''' (также указывается в форме авторизации)<br />
 +
[[Файл:Ea_373.png|Приорбанк]]<br />
  
 
==Работа в системе==
 
==Работа в системе==
 
Начиная с версии 15 релиза 8 и выше в Программе туров доступен новый плагин, расположенный по пути '''Администрирование &rarr; Плагины &rarr; ПриорБанк''' <br />
 
Начиная с версии 15 релиза 8 и выше в Программе туров доступен новый плагин, расположенный по пути '''Администрирование &rarr; Плагины &rarr; ПриорБанк''' <br />
При переходе на экран появляется форма авторизации, в которe. необходимо ввести APi-адрес, логин и пароль и нажать кнопку авторизация.<br />
+
При переходе на экран появляется форма авторизации, в которой необходимо ввести APi-адрес, логин и пароль и нажать кнопку авторизация.<br />
 
[[Файл:Ea_361.png|ПриорбанкМТ]]<br />
 
[[Файл:Ea_361.png|ПриорбанкМТ]]<br />
Произойдет переход на форму авторизации на стороне ПриорБанка, в которой необходимо заполнить имя пользователя и пароль.<br />
+
Произойдет переход на форму авторизации на стороне Приорбанка, в которой необходимо заполнить имя пользователя и пароль.<br />
 
[[Файл:Ea_360.png|800px|Приорбанк]]<br />
 
[[Файл:Ea_360.png|800px|Приорбанк]]<br />
После успешной авторизации будет выведено сообщение "Успешная авторизация. Можно продолжать работу в предыдущем приложении." <br />
+
После успешной авторизации будет выведено сообщение ''Успешная авторизация. Можно продолжать работу в предыдущем приложении.''<br />
 
Далее необходимо перейти обратно на форму авторизации на стороне Программы туров.<br />
 
Далее необходимо перейти обратно на форму авторизации на стороне Программы туров.<br />
 
[[Файл:Ea_362.png|Приорбанк]]<br />
 
[[Файл:Ea_362.png|Приорбанк]]<br />
 
==Просмотр платежей==
 
==Просмотр платежей==
Для работы с платежами необходимо нажать кнопку "Просмотр платежей".<br />
+
Для работы с платежами необходимо нажать кнопку '''Просмотр платежей'''.<br />
 
[[Файл:Ea_362.png|Приорбанк]]<br />
 
[[Файл:Ea_362.png|Приорбанк]]<br />
 
Откроется экран работы с платежами.<br />
 
Откроется экран работы с платежами.<br />
Далее необходимо выбрать интервал дат (не более 90 дней) и нажать кнопку "Загрузить данные".<br />
+
Далее необходимо выбрать интервал дат (не более 90 дней) и нажать кнопку '''Загрузить данные'''.<br />
 
[[Файл:Ea_369.png|1000px|Приорбанк]] <br />
 
[[Файл:Ea_369.png|1000px|Приорбанк]] <br />
*№ – номер платежа от ПриорБанк
+
*№ – номер платежа от Приорбанк
*Дата – Дата платежа
+
*Дата – дата платежа
*Партнер – Партнер по путевке (если индивидуально, то отсутвует ИНН и плательщик физическое лицо)
+
*Партнер – партнер по путевке (если индивидуально, то отсутствует ИНН и плательщик физическое лицо)
*ИНН – номер ИНН (если отсутвует, то партнер - индивидуально, то есть физическое лицо)
+
*ИНН – номер ИНН (если отсутствует, то партнер индивидуально, то есть физическое лицо)
 
*Сумма – сумма по платежу в национальной валюте
 
*Сумма – сумма по платежу в национальной валюте
 
*Путевки – номер путевки по платежу
 
*Путевки – номер путевки по платежу
*Комментарии – комментарий к платежу. Здесь может отображаться информация почему платеж не распознан (Нет путевки в системе, отсутствует ИНН партнера))
+
*Комментарии – комментарий к платежу. Здесь может отображаться информация, почему платеж не был распознан (возможные причины: нет путевки в системе, в платеже указано несколько путевок)
 
*Тип операции – тип платежной операции
 
*Тип операции – тип платежной операции
*Обработан – обработан ли платеж (если, да то отображается чек-бокс с галкой на сером фоне)
+
*Обработан – обработан ли платеж (если да, то отображается выбранный чек-бокс на сером фоне)
 
==Основные элементы взаимодействия с экраном==
 
==Основные элементы взаимодействия с экраном==
[[Файл:Ea_363.png|1000px|Приорбанк]] <br />
+
[[Файл:Moism priorsite.png|1200px|Приорбанк]]<br />
 
[[Category:Мастер-Тур(15)]]
 
[[Category:Мастер-Тур(15)]]
*Название партнера – отбор по названию партнера из справочника "Партнеры"<br />
+
*Название партнера – отбор по названию партнера из справочника '''Партнеры'''<br />
 
*Даты с – дата создания платежа от<br />
 
*Даты с – дата создания платежа от<br />
 
*Даты по – дата создания платежа до<br />
 
*Даты по – дата создания платежа до<br />
Строка 49: Строка 51:
 
*Загрузить данные – кнопка загрузки платежей из банка <br />
 
*Загрузить данные – кнопка загрузки платежей из банка <br />
 
*Выгрузить в кассу – кнопка выгрузки выбранных платежей в кассу ПК "Мастер-Тур" <br />
 
*Выгрузить в кассу – кнопка выгрузки выбранных платежей в кассу ПК "Мастер-Тур" <br />
 +
 +
'''Внимание!''' В случае, если ИНН плательщика по путевке не был найден в базе - покупатель будет распознан как Индивидуально. Такие платежи необходимо дополнительно обрабатывать через окно Редактирование платежа
  
 
==Выгрузка платежа в кассу==
 
==Выгрузка платежа в кассу==
Для выгрузки платежа в кассу необходимо выбрать платеж, выбрав чек-бокс напротив необходимого платежа, и нажать кнопку "Выгрузить в кассу".<br />
+
Для выгрузки платежа в кассу необходимо выбрать платеж, выбрав чек-бокс напротив необходимого платежа и нажать кнопку '''Выгрузить в кассу'''.<br />
 
[[Файл:Ea_367.png|1000px|Приорбанк]]<br />
 
[[Файл:Ea_367.png|1000px|Приорбанк]]<br />
Выгрузить в кассу можно только распознанные платежи.
+
Выгрузить в кассу можно только распознанные платежи.
  
 
==Редактирование платежа==
 
==Редактирование платежа==
Имеется возможность заменить путевку в платеже от Приорбанка путевкой из ПК "Мастер-Тур", заменить партнера в платеже партнером из базы данных "Партнеры".<br />
+
Имеется возможность заменить путевку в платеже от Приорбанка путевкой из ПК "Мастер-Тур", заменить партнера в платеже партнером из справочника '''Партнеры'''.<br />
Для редактирования платежа необходимо в списке платежей щелкнуть по номеру платежа, подсвеченному синим шрифтом.<br />
+
Для редактирования платежа необходимо в списке платежей нажать по номеру платежа, подсвеченному синим шрифтом.<br />
 
Откроется окно редактирования платежа.<br />
 
Откроется окно редактирования платежа.<br />
 
[[Файл:Ea_368.png|600px|Приорбанк]]<br />
 
[[Файл:Ea_368.png|600px|Приорбанк]]<br />
После завершения редактирования необходимо нажать на кнопку "Сохранить".<br />
+
После завершения редактирования необходимо нажать на кнопку '''Сохранить'''.<br />
У отредактированных платежей в графе комментарии отображается информация о номере путевки из платежа от ПриорБанк.<br />
+
У отредактированных платежей в графе комментарии отображается информация о номере путевки из платежа от Приорбанк.<br />
 
[[Файл:Ea_370.png|1000px|Приорбанк]]<br />
 
[[Файл:Ea_370.png|1000px|Приорбанк]]<br />
 +
 +
==Альтернативная выгрузка в кассу через планировщик задач==
 +
Для автоматической выгрузки платежей в кассу возможно использовать задачу в планировщике заданий Windows. Для этого необходимо на вкладке Действия
 +
в поле Программа или сценарий указать значение powershell.exe,
 +
в поле Добавить аргументы указать значение -ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "ПУТЬ ДО СКРИПТА".
 +
 +
Пример:
 +
''-ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "-ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "C:\Prior\PriorbankScript.ps1"" ''<br />
 +
 +
[[Файл:Moism priorplag.png|600px|Приорбанк]]<br />
 +
 +
А также заполнить в файле PriorbankScript.ps1 настройки подключения к службе поиска и турпрограмме
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Шаблон файла PriorbankScript.ps1
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
<syntaxhighlight lang="java" enclose="div">
 +
 +
#TourPrograms Settings
 +
$urlTourProgramsPort = "80" #Порт программы туров
 +
$urlTourProgramsProtocol = "http" #Протокол передачи (http/https)
 +
$urlTourProgramsDomainName = "supp-08.megatec.ru" #ip-адрес или доменное имя
 +
$urlTourProgramsName = "TourPrograms" #Название приложения программы туров
 +
 +
$session = New-Object Microsoft.PowerShell.Commands.WebRequestSession
 +
$session.UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36"
 +
Invoke-WebRequest -UseBasicParsing -Uri "${urlTourProgramsProtocol}://${urlTourProgramsDomainName}:${urlTourProgramsPort}/${urlTourProgramsName}/PriorBank/GetAutoCashier" `
 +
-Method "GET" `
 +
-WebSession $session `
 +
-Headers @{
 +
"Accept"="application/json, text/javascript, */*; q=0.01"
 +
  "Accept-Encoding"="gzip, deflate, br"
 +
  "Accept-Language"="en-US,en;q=0.9,ru-RU;q=0.8,ru;q=0.7"
 +
  "Cache-Control"="no-cache"
 +
  "Origin"="${urlTourProgramsProtocol}://${urlTourProgramsDomainName}:${urlTourProgramsPort}"
 +
  "Referer"="${urlTourProgramsProtocol}://${urlTourProgramsDomainName}:${urlTourProgramsPort}"
 +
  "Pragma"="no-cache"
 +
  "Sec-Fetch-Dest"="empty"
 +
  "Sec-Fetch-Mode"="cors"
 +
  "Sec-Fetch-Site"="same-origin"
 +
  "X-Requested-With"="XMLHttpRequest"
 +
  "sec-ch-ua"="`"Not_A Brand`";v=`"99`", `"Google Chrome`";v=`"109`", `"Chromium`";v=`"109`""
 +
  "sec-ch-ua-mobile"="?0"
 +
  "sec-ch-ua-platform"="`"Windows`""
 +
} `
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 +
'''Задание в планировщике имеет ряд ограничений:'''<br />
 +
*Планировщиком обрабатываются только платежи на текущую дату;<br />
 +
*Для загрузки платежи должны быть распознаны;<br />
 +
*Планировщик не загружает платежи с Партнером Индивидуально;<br />
 +
*В платеже должна быть только 1 путевка.<br />
 +
 +
Информацию о загруженных платежах можно найти в логе TourPrograms PriorBankLogger.txt <br />
 +
В логе пишется информация об авторизации в Приорбанке, а также информация о ручной или автоматической загрузке платежа в кассу.
 +
 +
==Печать отчета по платежам в плагине==
 +
Отчет предназначен для экспорта загруженных на экран платежей от Приорбанка. Отчет выводит информацию в виде таблиц, в которых содержится информация о номере и дате платежа, партнере и его ИНН (при наличии), сумме платежа, а также информация о номере путевки в Мастер Туре. Отчет выгружается в Excel на одном листе.<br />
 +
Вызов отчета доступен в экране программе туров, в разделе список туров по кнопке [[Файл:As024.JPG]] <br />
 +
 +
Отчет выгружается в следующем формате <br />
 +
[[Файл:Moism excel.png|1000px|Приорбанк]]<br />
 +
 +
[[Category:Мастер-Тур(15)]]

Текущая версия на 15:43, 22 февраля 2024

Версия статьи от 22-02-2024.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 15 версии


Введение

Данное решение позволяет загружать платежи с использованием API банка Приорбанк.

Установка

Специальных действий для установки не требуется. Все работает в стандартной поставке приложения.
В личном кабинете Приорбанка необходимо в строке "Адрес обратного вызова" прописать API адрес в формате сетевой путь к службе поиска/PriorBankAuth (также указывается в форме авторизации)
Приорбанк

Работа в системе

Начиная с версии 15 релиза 8 и выше в Программе туров доступен новый плагин, расположенный по пути Администрирование → Плагины → ПриорБанк
При переходе на экран появляется форма авторизации, в которой необходимо ввести APi-адрес, логин и пароль и нажать кнопку авторизация.
ПриорбанкМТ
Произойдет переход на форму авторизации на стороне Приорбанка, в которой необходимо заполнить имя пользователя и пароль.
Приорбанк
После успешной авторизации будет выведено сообщение Успешная авторизация. Можно продолжать работу в предыдущем приложении.
Далее необходимо перейти обратно на форму авторизации на стороне Программы туров.
Приорбанк

Просмотр платежей

Для работы с платежами необходимо нажать кнопку Просмотр платежей.
Приорбанк
Откроется экран работы с платежами.
Далее необходимо выбрать интервал дат (не более 90 дней) и нажать кнопку Загрузить данные.
Приорбанк

  • № – номер платежа от Приорбанк
  • Дата – дата платежа
  • Партнер – партнер по путевке (если индивидуально, то отсутствует ИНН и плательщик физическое лицо)
  • ИНН – номер ИНН (если отсутствует, то партнер – индивидуально, то есть физическое лицо)
  • Сумма – сумма по платежу в национальной валюте
  • Путевки – номер путевки по платежу
  • Комментарии – комментарий к платежу. Здесь может отображаться информация, почему платеж не был распознан (возможные причины: нет путевки в системе, в платеже указано несколько путевок)
  • Тип операции – тип платежной операции
  • Обработан – обработан ли платеж (если да, то отображается выбранный чек-бокс на сером фоне)

Основные элементы взаимодействия с экраном

Приорбанк

  • Название партнера – отбор по названию партнера из справочника Партнеры
  • Даты с – дата создания платежа от
  • Даты по – дата создания платежа до
  • Необработанные платежи – показывать только необработанные платежи
  • Обработанные платежи – показывать только обработанные платежи
  • Только нераспознанные платежи – показывать только нераспознанные платежи
  • Выбрать все – выбрать все платежи на странице
  • Снять все – снять выбор со всех платежей на странице
  • Загрузить данные – кнопка загрузки платежей из банка
  • Выгрузить в кассу – кнопка выгрузки выбранных платежей в кассу ПК "Мастер-Тур"

Внимание! В случае, если ИНН плательщика по путевке не был найден в базе - покупатель будет распознан как Индивидуально. Такие платежи необходимо дополнительно обрабатывать через окно Редактирование платежа

Выгрузка платежа в кассу

Для выгрузки платежа в кассу необходимо выбрать платеж, выбрав чек-бокс напротив необходимого платежа и нажать кнопку Выгрузить в кассу.
Приорбанк

Выгрузить в кассу можно только распознанные платежи.

Редактирование платежа

Имеется возможность заменить путевку в платеже от Приорбанка путевкой из ПК "Мастер-Тур", заменить партнера в платеже партнером из справочника Партнеры.
Для редактирования платежа необходимо в списке платежей нажать по номеру платежа, подсвеченному синим шрифтом.
Откроется окно редактирования платежа.
Приорбанк
После завершения редактирования необходимо нажать на кнопку Сохранить.
У отредактированных платежей в графе комментарии отображается информация о номере путевки из платежа от Приорбанк.
Приорбанк

Альтернативная выгрузка в кассу через планировщик задач

Для автоматической выгрузки платежей в кассу возможно использовать задачу в планировщике заданий Windows. Для этого необходимо на вкладке Действия в поле Программа или сценарий указать значение powershell.exe, в поле Добавить аргументы указать значение -ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "ПУТЬ ДО СКРИПТА".

Пример: -ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "-ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "C:\Prior\PriorbankScript.ps1""

Приорбанк

А также заполнить в файле PriorbankScript.ps1 настройки подключения к службе поиска и турпрограмме

Шаблон файла PriorbankScript.ps1
#TourPrograms Settings
$urlTourProgramsPort = "80" #Порт программы туров
$urlTourProgramsProtocol = "http" #Протокол передачи (http/https)
$urlTourProgramsDomainName = "supp-08.megatec.ru" #ip-адрес или доменное имя
$urlTourProgramsName = "TourPrograms" #Название приложения программы туров

$session = New-Object Microsoft.PowerShell.Commands.WebRequestSession
$session.UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36"
Invoke-WebRequest -UseBasicParsing -Uri "${urlTourProgramsProtocol}://${urlTourProgramsDomainName}:${urlTourProgramsPort}/${urlTourProgramsName}/PriorBank/GetAutoCashier" `
-Method "GET" `
-WebSession $session `
-Headers @{
"Accept"="application/json, text/javascript, */*; q=0.01"
  "Accept-Encoding"="gzip, deflate, br"
  "Accept-Language"="en-US,en;q=0.9,ru-RU;q=0.8,ru;q=0.7"
  "Cache-Control"="no-cache"
  "Origin"="${urlTourProgramsProtocol}://${urlTourProgramsDomainName}:${urlTourProgramsPort}"
  "Referer"="${urlTourProgramsProtocol}://${urlTourProgramsDomainName}:${urlTourProgramsPort}"
  "Pragma"="no-cache"
  "Sec-Fetch-Dest"="empty"
  "Sec-Fetch-Mode"="cors"
  "Sec-Fetch-Site"="same-origin"
  "X-Requested-With"="XMLHttpRequest"
  "sec-ch-ua"="`"Not_A Brand`";v=`"99`", `"Google Chrome`";v=`"109`", `"Chromium`";v=`"109`""
  "sec-ch-ua-mobile"="?0"
  "sec-ch-ua-platform"="`"Windows`""
} `


Задание в планировщике имеет ряд ограничений:

  • Планировщиком обрабатываются только платежи на текущую дату;
  • Для загрузки платежи должны быть распознаны;
  • Планировщик не загружает платежи с Партнером Индивидуально;
  • В платеже должна быть только 1 путевка.

Информацию о загруженных платежах можно найти в логе TourPrograms PriorBankLogger.txt
В логе пишется информация об авторизации в Приорбанке, а также информация о ручной или автоматической загрузке платежа в кассу.

Печать отчета по платежам в плагине

Отчет предназначен для экспорта загруженных на экран платежей от Приорбанка. Отчет выводит информацию в виде таблиц, в которых содержится информация о номере и дате платежа, партнере и его ИНН (при наличии), сумме платежа, а также информация о номере путевки в Мастер Туре. Отчет выгружается в Excel на одном листе.
Вызов отчета доступен в экране программе туров, в разделе список туров по кнопке As024.JPG

Отчет выгружается в следующем формате
Приорбанк