Мастер-Тур(15):Получение туркода (Камкор)

Версия статьи от 3-08-2023.

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

Введение

Данное решение позволяет передавать данные туристов в фонд Камкор для получения туркода с последующим выводом этого туркода в отчетных документах.

Установка

Специальных действий для установки не требуется. Все работает в стандартной поставке приложения.

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

Начиная с версии 15 релиза 8 и выше в Программе туров доступен новый плагин, расположенный по пути Администрирование → Плагины → Получение туркода (Камкор)

Экран содержит информацию следующую информацию:

• API адрес
• Логин
• Пароль
• Сохранить – при нажатии данные для подключения будут сохранены в базу данных приложения
• Отправить – при нажатии будет отправлен запрос в фонд Камкор для получения туркодов по туристам.

Отправка запроса осуществляется за 24 часа до вылета (то есть, отправляются все туристы во всех путевках, 
у которых дата заезда – следующий день), а также у которых в путевки присутствует услуга с классом услуги Туристический код.

Для корректной отработки запроса должны быть заполнены:

• ИНН фирмы-владельца
• Код авиакомпании (ИАТА)
• Код аэропорта (ИАТА)
• День рождения туриста
• Серия/номер паспорта туриста (загран. или нац.)
• Дата выдачи паспорта туриста (загран. или нац.)

После отправки запроса в результирующей таблице будет выведена информация о полученных данных.

• Получено туркодов – количество успешно полученных туркодов
• Пропущено – с информацией о ФИО туриста, путевки и причине пропуска

Детализацию обработки запросов можно посмотреть в логе MTS KamkorLogger.txt, предварительно их включив в конфигурационном файле

<Logger level="OFF" name="KamkorLogger" console="false" />

Отправляемые и получаемые запросы можно посмотреть в логе MTS KamkorDetailLogger.txt, предварительно их включив в конфигурационном файле

<Logger level="OFF" name="KamkorDetailLogger" console="false" />

Полученный туркод сохраняется в истории путевки. Далее его можно вывести в клиентский профиля отчета Ваучер (Многоплечевой перелет)

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

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

-ExecutionPolicy RemoteSigned -NonInteractive -WindowStyle Hidden -File "M:\Kamkor\kamkorRegistrationScript.ps1"

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

Шаблон файла kamkorRegistrationScript.ps1

#Kamkor Settings $login = "test" #Логин от Камкор $password = "test" #Пароль от Камкор $urlKamkorProtocol = "http" #Протокол передачи (http/https) $urlKamkorAddress = "test.fondkamkor.kz" #Адрес API #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}/Plugins/KamkorRegistration" ` -Method "POST" ` -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}/${urlTourProgramsName}/" "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`"" } ` -ContentType "application/x-www-form-urlencoded; charset=UTF-8" ` -Body "queryString=%7B%22ApiUrl%22%3A%22$urlKamkorProtocol%3A%2F%2F$urlKamkorAddress%22%2C%22Login%22%3A%22$Login%22%2C%22Password%22%3A%22$Password%22%7D"