Изменения

Перейти к навигации Перейти к поиску

КТЖ

3039 байт добавлено, 18:32, 27 октября 2021
Особенности КТЖ
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Получение реквизитов Процесс подключения к КТЖв Nemo.travel==Основные этапы подключения агентских технологических платформ
Для подключения агентских технологических платформ (интернет-сайты, мобильные приложения, платежные терминалы самообслуживания) # В системе {{NameSystem}} на данный момент можно реализовать подключение к системе «Mobius»КТЖ, необходимо следовать описанному процессу:  1. Договор:Агент для этого агент заключает с Организацией КТЖ договор на оказание услуг и соглашение о конфиденциальности; 2# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Подготовка к работе: По законодательству РК, все денежные операции должны быть подписаны личным сертификатом Публичную часть ключа(ключ ЭЦП*.cer), который необходимо получить на компанию или ее представителя отправьте в КТЖ (на ваше усмотрение) - httpБолее подробно см.[https://pkidevelop.govipayments.kz/indexpages/viewpage.php/ru/poluchenie-klyuchej-etspaction?pageId=131334166 Документация КТЖ] );# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.== Получение production реквизитов ==# После получения комплекта разработчика успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.# Получив данные агрегатора(дилера) и ключей ЭЦПданные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо публичную часть ключа ЭЦП настроить VPN, скачать и установить АРМ ЦУС]].# Создать терминал с указанием адреса регистрации(*юридический адрес компании).cer формат DER) отправить посредством заявки # Создать тикет в системе ЭСОЗ Jira, в теле письма КТЖ на активацию терминала. В тикете указатьадрес терминала и идентификатор. Тема тикета: "Публичный ключ ЭЦП для сайта ______Подключение нового терминала (имя терминала)"Описание: "Просим предоставить доступ к технической документации и тестовой площадки для интеграции с системой «Mobius». Контакты специалистов: - технический специалист вас активировать терминал (полное ФИО, телефоннаименование терминала), eидентификатор терминала -mail(идентификатор, Skypeдоступен в АРМ ЦУС после создания терминала), который будет интегрировать вашу систему, и получать консультации от руководителя группы разработки Организации; - кассир . Адрес: (полное ФИО, телефонадрес терминала, e-mailуказанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, который "Фискализация будет поддерживать вашу систему в бою проходить на нашей стороне".   3# Создать тикет в Jira КТЖ для получения сертификатов типа OpenSSL, приложить ЭЦП и PIN для сертификата. Техническая документация и тестовая площадкаТема тикетаПосле получения "Генерация сертификатов из пновых кассиров (название компании)".2 вам будут предоставлены доступы Описание: "Просим вас произвести генерацию сертификатов типа OpenSSL для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (логин/пароль) до Технической документации, которая является интерактивной страницей, и до Тестовой площадки"Агент начинает интеграцию собственной технологической платформы # Создайте кассира с системой «Mobius».   4. Сертификация: После тогоуказанием ФИО, как вы завершите свои работы на тестовой площадке рабочего и будете готовы переходить в боевой режим продаж электронных билетовличного телефона, вам необходимо отправить заполненную анкету посредством заявки в системе ЭСОЗ Jira, в теме письма указать e-mail адреса. Важно убрать чекбокс "Запрос на проведение сертификацииВход по сертификату". Руководитель группы разработки проведет сертификацию прежде, чем выпускать вас Тип сертификата: OpenSSL. В поле "в бойСертификат"необходимо указать файл полученного от КТЖ сертификата формата *.cer. Весь фидбэк формируется на созданной для вас страницы пСертификат формата *.3p12 необходимо переименовать по формату ЛогинКассира_gost.    6p12 и предоставить сотрудникам Nemo. Боевой запускTravel .# КТЖ активирует терминал и предоставит ID дилера.# После успешного прохождения сертификации вам будут предоставлены боевые доступы посредством отражения настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери, стоимость билета должна быть '''не более 1000 тенге'''. В данном случае не будет штрафов за возврат. Выписывать билеты необходимо на созданной поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.# Для оформления ЭБ с формой оплаты Наличные необходимо пройти сертификацию, для вас страницы пэтого нужно создать тикет в Jira с просьбой провести сертификацию на возможность оформления ЭБ с формой оплаты Наличные.3В тикете указать наименование терминала.
== Правила оформления детей ==
== Особенности КТЖ ==
# Если в заказе есть ребенок, возврат билета для взрослого возможен только после возврата детского билета.
# Тариф(взрослый или ребенок) определяется на основании возраста пассажира.# Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)». Формы билетов и КРС обязательно должны соответствовать требованиям КТЖ. # В большинстве случаев пассажиру выставляется счет за белье. Пассажир имеет право не оплачивать белье , только если вагон типа Плацкарта и время в пути менее 6 часов. # Для межгосударственных поездок и поездок по России в ответах от поставщика получаем информацию о пассажирах по тарифу "Детский без места". Для поездок внутри Республики Казахстан получаем информацию только о пассажирах по тарифам "Полный" и "Детский"(ДЕТ). Соответственно в ответах от сервера отелей информация о пассажирах по тарифу "Детский без места" не возвращается. # При бронировании перевозки для младенца без места в запросе к поставщику данные о младенце должны передаваться после блока с данными о взрослом пассажире. Т.е. При при бронировании перевозки для двух пассажиров по тарифу "Полный" и двух пассажиров по тарифу "Детский без места" в запросе к поставщику блоки с информацией о пассажирах передаются в следующем порядке: информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места", информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места". Дело в том, что во внутригосударственной перевозке по территории Республики Казахстан оформление билетов для детей до 7-ми лет не требуется, а в межгосударственной перевозке дети до 5-ти лет должны быть оформлены по детскому тарифу с льготой ДЕТ5.# Для На этапе поиска для станций на территории Республики Казахстан(начинаются на 27) время отправления и прибытия отображается в часовом поясе Астаны. Для станций Российской Федерации(начинаются на 20), Киргизии(начинаются на 59) и Таджикистана(начинаются на 66) время отправления и прибытия московское. Для всех остальных станций время отправления и прибытия местное. После бронирования заказа информация о времени отправления и прибытия обновляется.# При оформлении заказа существует выбор формы оплаты: наличный расчёт или безналичный. Для каждой формы оплаты будет отправляться определенный параметр в КТЖ для отображения в ЭБ и КРС (СА для наличной оплаты, IN для безналичной), но для наличного расчёта требуется пройти сертификацию ("Получение production реквизитов", 9ый пункт).
# Информация по техническому перерыву:
#* Основная цель технического перерыва: целостность данных при смене отчетного периода.
#* ПУ Паспорт Узбекистана - для граждан Узбекистана
#* УЛ Удостоверение личности - для граждан Казахстана
#* СР Свидетельство о рождении ( до 16 цифр, а также: римская цифра, 2 буквы русского алфавита, 6 цифр). - для граждан Казахстана и России (в том числе и для продажи межгос направлений)
#* ВБ Военный билет - для граждан Казахстана
#* ЗЗ Другие иностранные документы(любые буквы и цифры) - для иностранных граждан
#* БГ Удостоверение личности лица без гражданства
#* СУ Справка об утере удостоверения личности/паспорта, временное удостоверение личности
#* СО Справка об освобождении
#* ВЖ Вид на жительство
#* ИИН Индивидуальный идентификационный номер пассажира# Возврат электронных билетов возможен за 1 час до отправления поезда. Возврату подлежат только билеты со статусами PaymentConfirmedElReg и PaymentConfirmed в заказе со статусом Done в системе поставщика. В случае получения других статусов(от поставщика), пассажир произвел дополнительные действия с электронным билетом: получил бланк в билетной кассе или ТТС, возвратил их в билетной кассе или истекло время возврата электронных билетов с помощью интернет-каналов продаж.# Для оформления возврата к поставщику отправляется запрос к поставщику, являющийся заявкой на возврат. В течении 2 минут производится проверка статуса заявки. Если заявка одобрена в течении данного времени - отправляется запрос на регистрацию возврата и статус заказа в нашей системе изменяется на "Отменен". Если заявка на возврат отклонена, возвращается сообщение с ошибкой, статус заказа остается без изменений. В случае, если заявка не была обработана в течении указанного времени, заказ следует обновить через некоторое время.# По требованиям поставщика документы для заказа возвращаются только в формате PDF. Каждый бланк - на отдельной странице. {{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}
== Список доступных переменных ==
== Настройка КТЖ ==
Для создания терминала Nemo необходим юридический адрес компании.
 
Для создания кассира необходимы ЭЦП(если нет - оформить в НУЦ РК),фамилия, имя, отчество, адрес, телефон, мобильный телефон, электронный адрес.
 
Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - определяет тип Тип площадки/среды Test или Prod поставщика# Тип сервера - определяет, куда будут отправляться запросыТип площадки Nemo Travel# Логин диллера дилера - логин диллерадилера (выдается КТЖ) # Пароль диллера дилера - пароль диллерадилера (выдается КТЖ)# Ид диллера дилера - уникальный номер диллера дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя ID терминала - имя ID терминала (выдается КТЖ)# Machine key - уникальный машинный ключ машины (выдается КТЖ) # Имя файла сертификата - имя файла сертификата(указывается вместе с расширением .p12)# Пароль к сертификату - пароль к сертификату(выдается Более подробно см. [https://develop.ipayments.kz/pages/viewpage.action?pageId=131334192 Документация КТЖ])
Более подробная документация находится по адресу https://develop.ipayments.kz/pages/viewpage.action?pageId=20873260, логин и пароль выдается выдаются КТЖ.
==Настройка шаблонов==
 
Для того, чтобы при выписке, мы отображали билет согласно требованиям КТЖ, следует загрузить шаблон электронного проездного билета. Путь для загрузки: '''Настройки системы → Нотификация и документы → Документы → Документы для ЖД → Электронный посадочный документ(КТЖ)'''. Затем следует выбрать режим редактирования HTML кода и вставить готовый шаблон, который доступен по адресу https://drive.google.com/open?id=1GjrWlpnQ5hM2Bx6tbcm9A-iRhDRPTF4o.
Так же нужно загрузить квитанцию разных сборов. Путь для загрузки: '''Настройки системы → Нотификация и документы → Документы → Документы для ЖД → Электронная квитанция разных сборов(КТЖ)'''. Затем следует выбрать режим редактирования HTML кода и вставить готовый шаблон, который доступен по адресу https://drive.google.com/open?id=1GjrWlpnQ5hM2Bx6tbcm9A-iRhDRPTF4o.
== Работа через API {{NameProject2}} ==
Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа будет использоваться [http://docs.nemo.travel/ru/nemo-backoffice-api BackOffice API]. Вам нужно будет создать заказ в бэк-офисе запросом [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getorder GetOrder]. После выполнения запроса GetOrder вы получите параметр OrderID. Используйте параметр OrderID для получения проездного документа и КРС через запрос [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getdocument GetDocument] в формате Base64.
Особенности формирования запроса поиска.

Навигация

'