КТЖ

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

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

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

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

1. Если в заказе есть ребенок, возврат билета для взрослого возможен только после возврата детского билета.
2. Тариф(взрослый или ребенок) определяется на основании возраста пассажира.
3. Шлюз КТЖ не возвращает готовых документов, поэтому мы генерируем их на своей стороне. Для билета используется шаблон «Электронный посадочный документ(КТЖ)». Шаблон квитанции разных сборов задается в шаблоне «Электронная квитанция разных сборов(КТЖ)».

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

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

Переменная	Описание переменной
%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%	Информация

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

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

1. Тип среды - определяет тип среды Test или Prod
2. Тип сервера - определяет, куда будут отправляться запросы
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.