Открыть главное меню

Изменения

КТЖ

5724 байта добавлено, 18:32, 27 октября 2021
Особенности КТЖ
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Получение реквизитов Процесс подключения к КТЖв Nemo.travel==
Для получения реквизитов# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, необходимо следовать описанному процессу:  1. Договор: Агент для этого агент заключает с Организацией КТЖ договор на оказание услуг и соглашение о конфиденциальности;  2. Подготовка к работе: # Получите ключ сертификата (*.p12) и предоставьте его в Nemo. Публичную часть ключа (*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде. == Получение production реквизитов ==3# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов. Тестовая площадка# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].# Создать терминал с указанием адреса регистрации(юридический адрес компании).# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес:(адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".  После # Создать тикет в Jira КТЖ для получения сертификатов вам будут предоставлены доступы типа OpenSSL, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов типа OpenSSL для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (логин/пароль) для площадки Nemo;".  4# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". СертификацияТип сертификата:OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel . # КТЖ активирует терминал и предоставит ID дилера.Движок Nemo прошел сертификацию # После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖбилетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери, поэтому новым агентствам стоимость билета должна быть '''не более 1000 тенге'''. В данном случае не нужно будет ее проходитьштрафов за возврат. Выписывать билеты необходимо на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.# Для оформления ЭБ с формой оплаты Наличные необходимо пройти сертификацию, достаточно заключить договор и получить боевые реквизитыдля этого нужно создать тикет в Jira с просьбой провести сертификацию на возможность оформления ЭБ с формой оплаты Наличные. В тикете указать наименование терминала.
== Правила оформления детей ==
== Особенности КТЖ ==
# Если в заказе есть ребенок, возврат билета для взрослого возможен только после возврата детского билета.
# Тариф(взрослый или ребенок) определяется на основании возраста пассажира.# Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)». Формы билетов и КРС обязательно должны соответствовать требованиям КТЖ. # В большинстве случаев пассажиру выставляется счет за белье. Пассажир имеет право не оплачивать белье , только если вагон типа Плацкарта и время в пути менее 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.
Особенности формирования запроса поиска.
'