КТЖ: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Работа через API Nemo Connect)
(Особенности КТЖ)
Строка 25: Строка 25:
 
# Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)». Формы билетов и КРС обязательно должны соответствовать требованиям КТЖ.  
 
# Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)». Формы билетов и КРС обязательно должны соответствовать требованиям КТЖ.  
 
# В большинстве случаев пассажиру выставляется счет за белье. Пассажир имеет право не оплачивать белье только если вагон типа Плацкарта и время в пути менее 6 часов.  
 
# В большинстве случаев пассажиру выставляется счет за белье. Пассажир имеет право не оплачивать белье только если вагон типа Плацкарта и время в пути менее 6 часов.  
# Для межгосударственных поездок и поездок по России в ответах от поставщика получаем информацию о пассажирах по тарифу "Детский без места". Для поездок внутри Республики Казахстан получаем информацию только о пассажирах по тарифам "Полный" и "Детский"(ДЕТ). Соответственно в ответах от сервера ЖД информация о пассажирах по тарифу "Детский без места" не возвращается.
 
 
# При бронировании перевозки для младенца без места в запросе к поставщику данные о младенце должны передаваться после блока с данными о взрослом пассажире. Т.е. При бронировании перевозки для двух пассажиров по тарифу "Полный" и двух пассажиров по тарифу "Детский без места" в запросе к поставщику блоки с информацией о пассажирах передаются в следующем порядке: информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места",  информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места". Дело в том, что во внутригосударственной перевозке по территории Республики Казахстан оформление билетов для детей до 7-ми лет не требуется, а в межгосударственной перевозке дети до 5-ти лет должны быть оформлены по детскому тарифу с льготой ДЕТ5.
 
# При бронировании перевозки для младенца без места в запросе к поставщику данные о младенце должны передаваться после блока с данными о взрослом пассажире. Т.е. При бронировании перевозки для двух пассажиров по тарифу "Полный" и двух пассажиров по тарифу "Детский без места" в запросе к поставщику блоки с информацией о пассажирах передаются в следующем порядке: информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места",  информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места". Дело в том, что во внутригосударственной перевозке по территории Республики Казахстан оформление билетов для детей до 7-ми лет не требуется, а в межгосударственной перевозке дети до 5-ти лет должны быть оформлены по детскому тарифу с льготой ДЕТ5.
 
# Для станций на территории Республики Казахстан(начинаются на 27) время отправления и прибытия отображается в часовом поясе Астаны. Для станций Российской Федерации(начинаются на 20), Киргизии(начинаются на 59) и Таджикистана(начинаются на 66) время отправления и прибытия московское. Для всех остальных станций время отправления и прибытия местное.
 
# Для станций на территории Республики Казахстан(начинаются на 27) время отправления и прибытия отображается в часовом поясе Астаны. Для станций Российской Федерации(начинаются на 20), Киргизии(начинаются на 59) и Таджикистана(начинаются на 66) время отправления и прибытия московское. Для всех остальных станций время отправления и прибытия местное.

Версия 10:06, 18 сентября 2018

Логотип КТЖ

КТЖ — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.

Процесс подключения к КТЖ в Nemo.travel

  1. В системе Nemo.Travel на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
  2. Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.Документация КТЖ );
  3. Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.

Получение production реквизитов

  1. После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
  2. Получив данные агрегатора(дилера) и данные для подключения VPN, вам необходимо настроить VPN, скачать и установить АРМ ЦУС.
  3. Создать терминал с указанием адреса регистрации(юридический адрес компании).
  4. Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
  5. Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
  6. Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо предоставить сотрудникам Nemo.Travel.
  7. КТЖ активирует терминал и предоставит ID дилера.

Правила оформления детей

Для детей от 15 лет и старше приобретаются проездные документы (билеты), как для взрослых. Возраст ребенка определяется на день начала поездки. Плата за проезд по территории Республики Казахстан детей в возрасте от 7 до 15 лет взыскивается в размере 50% от стоимости проезда, установленной для взрослого пассажира.

Особенности КТЖ

  1. Если в заказе есть ребенок, возврат билета для взрослого возможен только после возврата детского билета.
  2. Тариф(взрослый или ребенок) определяется на основании возраста пассажира.
  3. Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)». Формы билетов и КРС обязательно должны соответствовать требованиям КТЖ.
  4. В большинстве случаев пассажиру выставляется счет за белье. Пассажир имеет право не оплачивать белье только если вагон типа Плацкарта и время в пути менее 6 часов.
  5. При бронировании перевозки для младенца без места в запросе к поставщику данные о младенце должны передаваться после блока с данными о взрослом пассажире. Т.е. При бронировании перевозки для двух пассажиров по тарифу "Полный" и двух пассажиров по тарифу "Детский без места" в запросе к поставщику блоки с информацией о пассажирах передаются в следующем порядке: информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места", информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места". Дело в том, что во внутригосударственной перевозке по территории Республики Казахстан оформление билетов для детей до 7-ми лет не требуется, а в межгосударственной перевозке дети до 5-ти лет должны быть оформлены по детскому тарифу с льготой ДЕТ5.
  6. Для станций на территории Республики Казахстан(начинаются на 27) время отправления и прибытия отображается в часовом поясе Астаны. Для станций Российской Федерации(начинаются на 20), Киргизии(начинаются на 59) и Таджикистана(начинаются на 66) время отправления и прибытия московское. Для всех остальных станций время отправления и прибытия местное.
  7. Информация по техническому перерыву:
    • Основная цель технического перерыва: целостность данных при смене отчетного периода.
    • Типы технического перерыва: ежемесячный технический перерыв (при смене месяца, с 23:45 по 00:00), ежедневный технический перерыв (при смене суток, с 23:55 по 00:00).
    • Во время технического перерыва не доступны билетно-кассовые операции (бронирование, возврат), а также открытие новой рабочей смены. Операция подтверждение оплаты заказа не запрещена.
  8. Типы документов, допустимых для оформления перевозки(формируются на стороне сервера ЖД, поставщик конкретный список документов для перевозки не возвращает):
    • ПК Паспорт Казахстана - для граждан Казахстана
    • ПН Паспорт РФ - для граждан России
    • ЗП Заграничный паспорт, выданный гражданам РФ (9 цифр) - для граждан России
    • ПУ Паспорт Узбекистана - для граждан Узбекистана
    • УЛ Удостоверение личности - для граждан Казахстана
    • СР Свидетельство о рождении ( до 16 цифр, а также: римская цифра, 2 буквы русского алфавита, 6 цифр). - для граждан Казахстана и России (в том числе и для продажи межгос направлений)
    • ВБ Военный билет - для граждан Казахстана
    • ЗЗ Другие иностранные документы(любые буквы и цифры) - для иностранных граждан
    • БГ Удостоверение личности лица без гражданства
    • СУ Справка об утере удостоверения личности/паспорта, временное удостоверение личности
    • СО Справка об освобождении
    • ВЖ Вид на жительство
  9. Возврат электронных билетов возможен за 1 час до отправления поезда. Возврату подлежат только билеты со статусами PaymentConfirmedElReg и PaymentConfirmed в заказе со статусом Done в системе поставщика. В случае получения других статусов(от поставщика), пассажир произвел дополнительные действия с электронным билетом: получил бланк в билетной кассе или ТТС, возвратил их в билетной кассе или истекло время возврата электронных билетов с помощью интернет-каналов продаж.
  10. Для оформления возврата отправляется запрос к поставщику, являющийся заявкой на возврат. В течении 2 минут производится проверка статуса заявки. Если заявка одобрена в течении данного времени - отправляется запрос на регистрацию возврата и статус заказа в нашей системе изменяется на "Отменен". Если заявка на возврат отклонена, возвращается сообщение с ошибкой, статус заказа остается без изменений. В случае, если заявка не была обработана в течении указанного времени, заказ следует обновить через некоторое время.
  11. По требованиям поставщика документы для заказа возвращаются только в формате PDF. Каждый бланк на отдельной странице.

Список доступных переменных

Справочник шаблонных переменных

Переменная Описание переменной
%ER_STATUS% Статус электронного билета
%ER_DATE% Дата и время оформления электронного билета
%ER_CANCEL_DATE% Таймлимит на отмену ЭР
%VALID_FOR_BOARDING_TEXT% Действительность электронного билета
%CODE_1D% 1D код - идентификатор заказа АСУ «Экспресс-3»
%BARCODE_2D% 2D баркод – штрих код формата PDF417
%UID% Номер документа(билета)
%ORDER_NUM% Номер заказа
%RAIL_NAME% Наименование железной дороги
%YEAR% Год совершения поездки
%PASS_FULL_NAME% ФИО пассажира
%PASS_DOC% Документ пассажира
%PASS_DATE_OF_BIRTH% Дата рождения пассажира
%PASS_GENDER% Пол
%PASS_CITIZENSHIP% Гражданство
%SEAT_NUMBER% Номер места
%PASS_TARIFF% Тариф
%PASS_FULL_PRICE% Общая сумма
%PASS_TARIFF_PRICE% Стоимость билета по тарифу
%PASS_TICKET_PRICE% Цена билета для пассажира
%PASS_RESERVED_PRICE% Плацкарт
%SERVICE_COST% Сервис
%PASS_CHARGE% Сбор за конкретного пассажира
%PASS_COUNT% Количество пассажиров
%BEGIN_DATE% Дата и время выезда
%BEGIN_STATION% Станция, с которой отправляется клиент
%BEGIN_STATION_CODE% Код станции отправления
%END_DATE% Дата и время прибытия
%END_STATION% Станция, на которую пребывает клиент
%END_STATION_CODE% Код станции прибытия
%SERVICE_CLASS% Класс обслуживания
%TRAIN_NUMBER% Номер поезда
%CAR_NUMBER% Номер вагона
%TIME_DESCRIPTION_DEP% Ремарка о часовом поясе отправления
%SERVICE% Сервис(постельное белье, чай)
%CARRIER% Наименование перевозчика
%CARRIER_BIN% БИН перевозчика
%CARRIER_NDS_CERT% Свидетельство НДС перевозчика
%SERVICE_INFO% Служебная информация
%PAYER_INFO_NAME% Наименование налогоплательщика
%PAYER_BIN% БИН налогоплательщика
%PAYER_NDS_CERT% Свидетельство НДС налогоплательщика
%CONTROL_CHECK_NUMBER% Номер контрольного чека
%FISCAL_SIGN% Фискальный признак
%TERMINAL% Терминал
%REG_NUM_OF_THE_MACHINE% Регистрационный номер машины
%PAYMENT_TYPE% Способ оплаты
%PAY_DATETIME% Дата и время оплаты
%KRS_ID% Номер квитанции
%PASS_SUM_FOR_REFUND% Сумма к возврату
%PASS_CHARGE_FOR_REFUND% Сбор за возврат
%PASS_REFUND_DATE% Дата и время возврата
%PASS_FKS_NUMBER% Финансовый номер ФКС
%TIME_RETURN_TO_DEPARTURE% Время до отправления с момента возврата
%TYPE_OF_REFUND_MONEY% Информация

Настройка КТЖ

Для создания терминала Nemo необходим юридический адрес компании.

Для создания кассира необходимы ЭЦП(если нет - оформить в НУЦ РК),фамилия, имя, отчество, адрес, телефон, мобильный телефон, электронный адрес.

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС, далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.

  1. Тип среды - Тип площадки/среды поставщика
  2. Тип сервера - Тип площадки Nemo Travel
  3. Логин диллера - логин диллера(выдается КТЖ)
  4. Пароль диллера - пароль диллера(выдается КТЖ)
  5. Ид диллера - уникальный номер диллера (выдается КТЖ)
  6. Логин кассира - логин кассира (выдается КТЖ)
  7. Пароль кассира - пароль кассира (выдается КТЖ)
  8. Имя терминала - имя терминала (выдается КТЖ)
  9. Machine key - ключ машины (выдается КТЖ)
  10. Имя файла сертификата - имя файла сертификата(указывается вместе с расширением .p12)
  11. Пароль к сертификату - пароль к сертификату(Более подробно см.Документация КТЖ)

Более подробная документация находится по адресу 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 Nemo Connect

Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа, будет использоваться BackOffice API . Вам нужно будет создать заказ в бэк-офисе запросом GetOrder. После выполнения запроса GetOrder вы получите параметр OrderID. Используйте параметр OrderID для получения проездного документа и КРС через запрос GetDocument в формате Base64. Особенности формирования запроса поиска.