КТЖ — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
Содержание
Процесс подключения к КТЖ в Nemo.travel
- В системе Nemo.Travel на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
- Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.Документация КТЖ );
- Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
Получение продакшен реквизитов
- После сертификации вы должны задать логин и пароль дилера и передать в КТЖ, так же вам надо будет настроить VPN и АРМ ЦУС.
- Создать терминал с указанием юридического адреса компании.
- Создать тикет в Jira КТЖ на активацию АРМ.
- Создать тикет в Jira КТЖ для получения сертификатов с указанием ЭЦП и пароля для сертификата(PIN).
- Создайте кассира с указанием ФИО, рабочего и личного телефона, email адреса. Важно убрать чекбокс "Вход по сертификату" и оставить только вход по логину и паролю. Используете OpenSSL.
- КТЖ активирует терминал и передаст ID дилера.
Правила оформления детей
Для детей от 15 лет и старше приобретаются проездные документы (билеты), как для взрослых. Возраст ребенка определяется на день начала поездки. Плата за проезд по территории Республики Казахстан детей в возрасте от 7 до 15 лет взыскивается в размере 50% от стоимости проезда, установленной для взрослого пассажира.
Особенности КТЖ
- Если в заказе есть ребенок, возврат билета для взрослого возможен только после возврата детского билета.
- Тариф(взрослый или ребенок) определяется на основании возраста пассажира.
- Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)». Формы билетов и КРС обязательно должны соответствовать требованиям КТЖ.
- В большинстве случаев пассажиру выставляется счет за белье. Пассажир имеет право не оплачивать белье только если вагон типа Плацкарта и время в пути менее 6 часов.
- Для межгосударственных поездок и поездок по России в ответах от поставщика получаем информацию о пассажирах по тарифу "Детский без места". Для поездок внутри Республики Казахстан получаем информацию только о пассажирах по тарифам "Полный" и "Детский"(ДЕТ). Соответственно в ответах от сервера ЖД информация о пассажирах по тарифу "Детский без места" не возвращается.
- При бронировании перевозки для младенца без места в запросе к поставщику данные о младенце должны передаваться после блока с данными о взрослом пассажире. Т.е. При бронировании перевозки для двух пассажиров по тарифу "Полный" и двух пассажиров по тарифу "Детский без места" в запросе к поставщику блоки с информацией о пассажирах передаются в следующем порядке: информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места", информация о пассажире по тарифу "Полный", информация о пассажире по тарифу "Детский без места". Дело в том, что во внутригосударственной перевозке по территории Республики Казахстан оформление билетов для детей до 7-ми лет не требуется, а в межгосударственной перевозке дети до 5-ти лет должны быть оформлены по детскому тарифу с льготой ДЕТ5.
- Для станций на территории Республики Казахстан(начинаются на 27) время отправления и прибытия отображается в часовом поясе Астаны. Для станций Российской Федерации(начинаются на 20), Киргизии(начинаются на 59) и Таджикистана(начинаются на 66) время отправления и прибытия московское. Для всех остальных станций время отправления и прибытия местное.
- Информация по техническому перерыву:
- Основная цель технического перерыва: целостность данных при смене отчетного периода.
- Типы технического перерыва: ежемесячный технический перерыв (при смене месяца, с 23:45 по 00:00), ежедневный технический перерыв (при смене суток, с 23:55 по 00:00).
- Во время технического перерыва не доступны билетно-кассовые операции (бронирование, возврат), а также открытие новой рабочей смены. Операция подтверждение оплаты заказа не запрещена.
- Типы документов, допустимых для оформления перевозки(формируются на стороне сервера ЖД, поставщик конкретный список документов для перевозки не возвращает):
- ПК Паспорт Казахстана - для граждан Казахстана
- ПН Паспорт РФ - для граждан России
- ЗП Заграничный паспорт, выданный гражданам РФ (9 цифр) - для граждан России
- ПУ Паспорт Узбекистана - для граждан Узбекистана
- УЛ Удостоверение личности - для граждан Казахстана
- СР Свидетельство о рождении ( до 16 цифр, а также: римская цифра, 2 буквы русского алфавита, 6 цифр). - для граждан Казахстана и России (в том числе и для продажи межгос направлений)
- ВБ Военный билет - для граждан Казахстана
- ЗЗ Другие иностранные документы(любые буквы и цифры) - для иностранных граждан
- БГ Удостоверение личности лица без гражданства
- СУ Справка об утере удостоверения личности/паспорта, временное удостоверение личности
- СО Справка об освобождении
- ВЖ Вид на жительство
- Возврат электронных билетов возможен за 1 час до отправления поезда. Возврату подлежат только билеты со статусами PaymentConfirmedElReg и PaymentConfirmed в заказе со статусом Done в системе поставщика. В случае получения других статусов(от поставщика), пассажир произвел дополнительные действия с электронным билетом: получил бланк в билетной кассе или ТТС, возвратил их в билетной кассе или истекло время возврата электронных билетов с помощью интернет-каналов продаж.
- Для оформления возврата отправляется запрос к поставщику, являющийся заявкой на возврат. В течении 2 минут производится проверка статуса заявки. Если заявка одобрена в течении данного времени - отправляется запрос на регистрацию возврата и статус заказа в нашей системе изменяется на "Отменен". Если заявка на возврат отклонена, возвращается сообщение с ошибкой, статус заказа остается без изменений. В случае, если заявка не была обработана в течении указанного времени, заказ следует обновить через некоторое время.
- По требованиям поставщика документы для заказа возвращаются только в формате 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 необходим юридический адрес компании.
Для создания кассира необходимы ЭЦП(если нет - оформить в НУЦ РК),фамилия, имя, отчество, адрес, телефон, мобильный телефон, электронный адрес.
Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС, далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
- Тип среды - Тип площадки/среды поставщика
- Тип сервера - Тип площадки Nemo Travel
- Логин диллера - логин диллера(выдается КТЖ)
- Пароль диллера - пароль диллера(выдается КТЖ)
- Ид диллера - уникальный номер диллера (выдается КТЖ)
- Логин кассира - логин кассира (выдается КТЖ)
- Пароль кассира - пароль кассира (выдается КТЖ)
- Имя терминала - имя терминала (выдается КТЖ)
- Machine key - ключ машины (выдается КТЖ)
- Имя файла сертификата - имя файла сертификата(указывается вместе с расширением .p12)
- Пароль к сертификату - пароль к сертификату(Более подробно см.Документация КТЖ)
Более подробная документация находится по адресу 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, после выполнения этого запроса вы получите параметр OrderID, используйте этот параметр для получения проездного документа и КРС через запрос GetDocument в формате Base64.