Центр поддержки системы бронирования - Вклад участника [ru]

КТЖ

2020-09-28T11:33:59Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов типа OpenSSL, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов типа OpenSSL для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери, стоимость билета должна быть '''не более 1000 тенге'''. В данном случае не будет штрафов за возврат. Выписывать билеты необходимо на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.
# Для оформления ЭБ с формой оплаты Наличные необходимо пройти сертификацию, для этого нужно создать тикет в Jira с просьбой провести сертификацию на возможность оформления ЭБ с формой оплаты Наличные. В тикете указать наименование терминала.

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

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

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:48:34Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери, стоимость билета должна быть '''не более 1000 тенге'''. В данном случае не будет штрафов за возврат. Выписывать билеты необходимо на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.

== Правила оформления детей ==
Для детей от 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:48:03Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери, стоимость билета должна быть '''не более 1000 тенге'''. В данном случае не будет штрафов за возврат. Необходимо выписать билеты на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.

== Правила оформления детей ==
Для детей от 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:47:33Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери, бронировать билет необходимо '''стоимостью не более 1000 тенге'''. В данном случае не будет штрафов за возврат. Необходимо выписать билеты на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.

== Правила оформления детей ==
Для детей от 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:46:07Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билетов и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери бронировать билет необходимо '''стоимостью не более 1000 тенге'''. В данном случае не будет штрафов за возврат. Необходимо выписать билеты на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624. Обратите внимание, что предварительно клиенту необходимо пополнить счет агрегатора.

== Правила оформления детей ==
Для детей от 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:44:02Z

Пархоменко Александра:

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билеты и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери бронировать билет необходимо стоимостью не более 1000 тенге. В данном случае не будет штрафов за возврат. Необходимо выписать билеты на поезд '''Петропавловск - Смирново''' и обратно, поезд 623/624.

== Правила оформления детей ==
Для детей от 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:43:24Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит ID дилера.
# После настройки реквизитов необходима их проверка и предоставление сотрудникам КТЖ билеты и КРС в формате *.pdf на заказы, оформленные по боевым реквизитам. Чтобы исключить финансовые потери бронировать билет необходимо стоимостью не более 1000 тенге. В данном случае не будет штрафов за возврат. Необходимо выписать билеты на поезд Петропавловск - Смирново и обратно, поезд 623/624.

== Правила оформления детей ==
Для детей от 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

КТЖ

2019-04-23T10:34:45Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо переименовать по формату ЛогинКассира_gost.p12 и предоставить сотрудникам Nemo.Travel .
# КТЖ активирует терминал и предоставит 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. Каждый бланк - на отдельной странице.

{{Attention| Необходимо оплатить и завершить оформление в течение 15 минут после бронирования.}}

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин дилера - логин дилера (выдается КТЖ)
# Пароль дилера - пароль дилера (выдается КТЖ)
# Ид дилера - уникальный номер дилера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату (Более подробно см. [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.
Особенности формирования запроса поиска.

Ценообразование (Отели)

2018-11-21T12:15:44Z

Пархоменко Александра: /* Параметры правил ценообразования */

[[Категория:Модули]] [[Категория:Встроенные модули]]

==Назначение==
Модуль '''Ценообразование''' автоматизирует процесс расчета [[Комиссия (термин)|сборов]] для отелей, управления сборами [[Агентство|агентства]].

==Принцип работы==
Работа модуля основана на правилах ценообразования, которые заводит агентство.

'''Правило''' — ''значение сбора'' и ''условия его применения''.<br>
'''Условие применения сбора''' — набор параметров отеля, к которым будут применяться сборы правила (''поставщик'', ''страна'', ''сезон заезда'', ''название отеля'' и пр.)

Правил ценообразования может быть несколько.<br>
Для одного варианта, представленного на выдаче, (или заказа) '''выбирается и применяется только одно правило''', подходящее по условию применения правила.

Сборы '''рассчитываются при каждом обновлении''' [[Заказы|заказа]] по правилам, загруженным в систему '''на момент проверки''':
* при формировании выдачи результатов поиска,
* при бронировании,
* при переходе к оплате и выписке,
* при обновлении страницы заказа.

==Заведение правил ценообразования==

Правила ценообразования хранятся и настраиваются в разделе '''Управление продажами → Отели → Управление ценами → Ценовые правила'''.

Для создания правила:
* Зайдите в раздел '''Управление продажами → Отели → Управление ценами → Ценовые правила'''.
* Нажмите кнопку '''Создать новую запись'''.
* Задайте параметры правила - условие применения правила и величину сбора.
* Нажмите кнопку '''Сохранить'''.

== Параметры правил ценообразования==
Для просмотра описания параметров <span style="background-color:gold">разверните таблицу</span>:

{| class="wikitable mw-collapsible mw-collapsed"
|colspan="2" align="center"| '''Параметры правил ценообразования'''
|-
! scope="col" | Название параметра
! scope="col" | Описание
|-
| Поставщик
| Определяет для каких поставщиков будет применимо правило.
|-
| Активно
| Применять или нет правило при расчётах.
|-
| Скидка от тарифа
| Если включено, то правило определяет размер скидки, а не наценки.
|-
| Страны
| Позволяет задать правило для всех страны, либо только для некоторых.
|-
| Список стран
| Задаёт страны, для которых применяется правило. Отображается и применяется если в параметре ''Страны'' задано значение ''Выбрать из списка'' или ''Все страны, кроме выбранных''.
|-
| Категории
| Позволяет задать правило для всех категорий отеля, либо выбрать определённые.
|-
| Список категорий
| Задаёт категории отелей, для которых применяется правило. Отображается и применяется если в параметре ''Категории'' задано значение ''Выбрать из списка''.
|-
| Список отелей
| Список отелей, для которых применяется правило. Задаётся в виде <язык>:<часть названия>, где:
<язык> - двухбуквенное обозначение языка, для которого будет производится проверка названия отеля,<br>
<часть названия> - часть названия отеля, проверка будет проводится по полному или частичному совпадению.
|-
| Сезон по заезду (с)
| Минимально допустимая дата заезда. Для срабатывания правила, дата заезда должна быть больше или равна указанной.
|-
| Сезон по заезду (по)
| Максимально допустимая дата заезда. Для срабатывания дата заезда должна быть меньше или равна указанной.
|-
| Сезон бронирования с
| Минимально допустимая дата оформления заказа (не путать с датой заезда). Для срабатывания правила, текущая дата должна быть больше или равна указанной.
|-
| Сезон бронирования по
| Максимально допустимая дата оформления заказа и дата заезда. Для срабатывания правила текущая дата должна быть меньше или равна указанной.
|-
| Тип mark-up
| Тип наценки - в виде процента к цене нетто, или в виде фиксированной стоимости за одну ночь проживания (за каждый номер).
|-
| Валюта
| Валюта наценки. Отображается и используется если в параметре ''Тип mark-up'' выбрано значение ''Фиксированная цена за 1 ночь проживания (за каждый номер)''.
|-
| Значение mark-up
| Значение наценки, определённое договором агентства с поставщиком. Размер устанавливается на стороне поставщика. Если в параметре ''Тип mark-up'' выбрано значение ''Фиксированная цена за 1 ночь проживания (за каждый номер)'', то данный параметр определяет абсолютное значение наценки, а противном случае определяет процент наценки.
|-
| Тип агентского сбора
| Тип агентского сбора - в виде процента к цене нетто или в виде фиксированной стоимости за бронь/за человека.
|-
| Валюта
| Валюта агентского сбора. Отображается и используется если в параметре ''Тип агентского сбора'' выбрано значение ''Фиксированная цена за бронь'' или ''Фиксированная цена за человека''.
|-
| Значение агентского сбора
| Значение агентского сбора. Если в параметре ''Тип агентского сбора'' выбрано значение ''Процент к цене нетто'', то данный параметр определяет процент сбора, а противном случае определяет абсолютное значение сбора.
|-
| Тип сервисного сбора
| Тип сервисного сбора - в виде процента к цене нетто или в виде фиксированной стоимости за бронь/за человека.
|-
| Валюта
| Валюта сервисного сбора. Отображается и используется если в параметре ''Тип сервисного сбора'' выбрано значение ''Фиксированная цена за бронь'' или ''Фиксированная цена за человека''.
|-
| Значение сервисного сбора
| Значение сервисного сбора. Если в параметре ''Тип сервисного сбора'' выбрано значение ''Процент к цене нетто'', то данный параметр определяет процент сбора, а противном случае определяет абсолютное значение сбора.
|}

КТЖ

2018-10-03T08:57:39Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 и логин нового кассира необходимо предоставить сотрудникам Nemo.Travel.
# КТЖ активирует терминал и предоставит 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату(Более подробно см.[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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через 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.
Особенности формирования запроса поиска.

КТЖ

2018-09-18T07:11:40Z

Пархоменко Александра: /* Настройка КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо предоставить сотрудникам Nemo.Travel.
# КТЖ активирует терминал и предоставит 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# ID терминала - ID терминала (выдается КТЖ)
# Machine key - ключ машины (выдается КТЖ)
# Пароль к сертификату - пароль к сертификату(Более подробно см.[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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через 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.
Особенности формирования запроса поиска.

КТЖ

2018-09-18T07:11:30Z

Пархоменко Александра: /* Настройка КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо предоставить сотрудникам Nemo.Travel.
# КТЖ активирует терминал и предоставит 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки 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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через 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.
Особенности формирования запроса поиска.

КТЖ

2018-09-18T07:08:28Z

Пархоменко Александра: /* Особенности КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо предоставить сотрудникам Nemo.Travel.
# КТЖ активирует терминал и предоставит 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# 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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через 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.
Особенности формирования запроса поиска.

КТЖ

2018-09-18T07:06:55Z

Пархоменко Александра: /* Особенности КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, [[Подробная_инструкция_по_настройке_VPN_и_установке_АРМ_ЦУС|вам необходимо настроить VPN, скачать и установить АРМ ЦУС]].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо предоставить сотрудникам Nemo.Travel.
# КТЖ активирует терминал и предоставит 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# 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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через 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.
Особенности формирования запроса поиска.

КТЖ

2018-08-21T08:02:20Z

Пархоменко Александра: /* Получение production реквизитов */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде.
== Получение production реквизитов ==
# После успешной сертификации вы должны создать тикет в Jira КТЖ на получение боевых доступов.
# Получив данные агрегатора(дилера) и данные для подключения VPN, вам необходимо настроить VPN, скачать и установить АРМ ЦУС. [https://drive.google.com/file/d/1mBuPIeAn7amExk10nJahR-YsAycJvboJ/view?usp=sharing Гайд по настройке].
# Создать терминал с указанием адреса регистрации(юридический адрес компании).
# Создать тикет в Jira КТЖ на активацию терминала. В тикете указать адрес терминала и идентификатор. Тема тикета: "Подключение нового терминала (имя терминала)". Описание: "Просим вас активировать терминал (наименование терминала), идентификатор терминала - (идентификатор, доступен в АРМ ЦУС после создания терминала). Адрес: (адрес терминала, указанный при создании)". Также следует указать на чьей стороне будет проходить фискализация. Например, "Фискализация будет проходить на нашей стороне".
# Создать тикет в Jira КТЖ для получения сертификатов, приложить ЭЦП и PIN для сертификата. Тема тикета: "Генерация сертификатов новых кассиров (название компании)". Описание: "Просим вас произвести генерацию сертификатов для создания учетных данных кассиров в ЦУС. Ключи ЭЦП, заверенные НУЦ, прилагаю. Пароль для авторизации - (пароль)".
# Создайте кассира с указанием ФИО, рабочего и личного телефона, e-mail адреса. Важно убрать чекбокс "Вход по сертификату". Тип сертификата: OpenSSL. В поле "Сертификат" необходимо указать файл полученного от КТЖ сертификата формата *.cer. Сертификат формата *.p12 необходимо предоставить сотрудникам Nemo.Travel.
# КТЖ активирует терминал и предоставит 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# 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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа, будет использоваться [http://docs.nemo.travel/ru/nemo-backoffice-api BackOffice API] . Вам нужно будет создать заказ в бэк-офисе запросом [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getorder GetOrder], после выполнения этого запроса вы получите параметр OrderID, используйте этот параметр для получения проездного документа и КРС через запрос [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getdocument GetDocument] в формате Base64.

КТЖ

2018-08-17T08:31:40Z

Пархоменко Александра: /* Настройка КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде. После успешной проверки выдаются боевые реквизиты.

== Правила оформления детей ==
Для детей от 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# 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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа, будет использоваться [http://docs.nemo.travel/ru/nemo-backoffice-api BackOffice API] . Вам нужно будет создать заказ в бэк-офисе запросом [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getorder GetOrder], после выполнения этого запроса вы получите параметр OrderID, используйте этот параметр для получения проездного документа и КРС через запрос [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getdocument GetDocument] в формате Base64.

КТЖ

2018-08-13T19:06:23Z

Пархоменко Александра: /* Особенности КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде. После успешной проверки выдаются боевые реквизиты.

== Правила оформления детей ==
Для детей от 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. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# Machine key - генерируется на сервере Nemo Connect
# Имя файла сертификата - имя файла сертификата(указывается вместе с расширением .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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа, будет использоваться [http://docs.nemo.travel/ru/nemo-backoffice-api BackOffice API] . Вам нужно будет создать заказ в бэк-офисе запросом [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getorder GetOrder], после выполнения этого запроса вы получите параметр OrderID, используйте этот параметр для получения проездного документа и КРС через запрос [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getdocument GetDocument] в формате Base64.

КТЖ

2018-08-13T19:05:59Z

Пархоменко Александра: /* Особенности КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде. После успешной проверки выдаются боевые реквизиты.

== Правила оформления детей ==
Для детей от 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 по требованиям поставщика. Каждый бланк на отдельной странице.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# Machine key - генерируется на сервере Nemo Connect
# Имя файла сертификата - имя файла сертификата(указывается вместе с расширением .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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа, будет использоваться [http://docs.nemo.travel/ru/nemo-backoffice-api BackOffice API] . Вам нужно будет создать заказ в бэк-офисе запросом [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getorder GetOrder], после выполнения этого запроса вы получите параметр OrderID, используйте этот параметр для получения проездного документа и КРС через запрос [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getdocument GetDocument] в формате Base64.

КТЖ

2018-08-13T18:57:53Z

Пархоменко Александра: /* Процесс подключения к КТЖ в Nemo.travel */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.
==Процесс подключения к КТЖ в Nemo.travel==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к КТЖ, для этого агент заключает с КТЖ договор на оказание услуг и соглашение о конфиденциальности;
# Получите ключ сертификата(*.p12) и предоставьте его в Nemo. Публичную часть ключа(*.cer) отправьте в КТЖ (Более подробно см.[https://develop.ipayments.kz/pages/viewpage.action?pageId=131334166 Документация КТЖ] );
# Агенту выдают тестовые реквизиты, чтобы проверить работоспособность в тестовой среде. После успешной проверки выдаются боевые реквизиты.

== Правила оформления детей ==
Для детей от 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 минут производится проверка статуса заявки. Если заявка одобрена в течении данного времени - отправляется запрос на регистрацию возврата и статус заказа в нашей системе изменяется на "Отменен". Если заявка на возврат отклонена, возвращается сообщение с ошибкой, статус заказа остается без изменений. В случае, если заявка не была обработана в течении указанного времени, заказ следует обновить через некоторое время.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

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

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

Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - Тип площадки/среды поставщика
# Тип сервера - Тип площадки Nemo Travel
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# Machine key - генерируется на сервере Nemo Connect
# Имя файла сертификата - имя файла сертификата(указывается вместе с расширением .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 Nemo Connect ==
Работу с коннектором КТЖ можно осуществлять через API запросы к NemoConnect. Обратите внимание, для получения проездного документа, будет использоваться [http://docs.nemo.travel/ru/nemo-backoffice-api BackOffice API] . Вам нужно будет создать заказ в бэк-офисе запросом [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getorder GetOrder], после выполнения этого запроса вы получите параметр OrderID, используйте этот параметр для получения проездного документа и КРС через запрос [http://docs.nemo.travel/ru/nemo-backoffice-api/orders_workflow/getdocument GetDocument] в формате Base64.

КТЖ

2018-07-16T13:36:30Z

Пархоменко Александра: /* Особенности КТЖ */

[[Категория:Железнодорожные билеты]]
[[Файл:Kazakhstan_Temir_Zholy_Logo.svg.png|300px|right|Логотип КТЖ]]
'''КТЖ''' — (каз. Казахстан темир жолы — Казахстанские железные дороги) крупнейший оператор магистральной железнодорожной сети Казахстана.

== Правила оформления детей ==
Для детей от 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 минут производится проверка статуса заявки. Если заявка одобрена в течении данного времени - отправляется запрос на регистрацию возврата и статус заказа в нашей системе изменяется на "Отменен". Если заявка на возврат отклонена, возвращается сообщение с ошибкой, статус заказа остается без изменений. В случае, если заявка не была обработана в течении указанного времени, заказ следует обновить через некоторое время.

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

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|-
|%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%
|Информация
|}

</div>
</div>

== Настройка КТЖ ==
Параметры подключения настраиваются под администратором системы. Реквизиты подключения находятся в разделе '''Управление продажами → Ж/Д билеты→ Реквизиты подключения к ГДС''', далее, для настройки, в верхнем баре нужно выбрать КТЖ и нажать на кнопку "Создать новую запись", затем нужно заполнить все необходимые поля.
# Тип среды - определяет тип среды Test или Prod
# Тип сервера - определяет, куда будут отправляться запросы
# Логин диллера - логин диллера(выдается КТЖ)
# Пароль диллера - пароль диллера(выдается КТЖ)
# Ид диллера - уникальный номер диллера (выдается КТЖ)
# Логин кассира - логин кассира (выдается КТЖ)
# Пароль кассира - пароль кассира (выдается КТЖ)
# Имя терминала - имя терминала (выдается КТЖ)
# 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.

КТЖ

2018-07-16T13:28:56Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-16T13:26:56Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-16T13:26:20Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-16T13:25:09Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-16T13:18:27Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-16T13:15:48Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-16T12:33:00Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-13T10:34:34Z

Пархоменко Александра: /* Особенности КТЖ */

КТЖ

2018-07-13T10:28:45Z

Пархоменко Александра: /* Особенности КТЖ */

Академсервис

2018-05-29T20:46:24Z

Пархоменко Александра: /* Особенности работы с Академсервис */

[[Category:Поставщики наземных услуг|Поставщики_наземных_услуг]]

'''Академсервис''' — крупный [[Туроператор (ТО)]] и туристическая компания (Россия). [[File:Academ.jpg|right|Academ.jpg]] Основные направления деятельности: гостиничное размещение, трансферы, транспортное обслуживание, визовая поддержка туристов, авиаперелеты, VIP-сервис в аэропортах, железнодорожные переезды, экскурсии, круизы по рекам и морям на территории бывшего СССР.

== Подключение к Академсервис ==

Для подключения отельного блока системы {{NameSystem}}, работающего с системой Академсервис необходимо выполнить следующие шаги:

1. '''Подписание договоров.'''

На сайте Академсервис надо скачать «Договор об организации продаж туристских услуг» и «Соглашение о порядке предоставления скидок с опубликованных цен» и отправить  их в Академсервис.

Договора, почтовый адрес и другая информация доступна по ссылке: [http://www.acase.ru/online/ru-forbuyers.jsp http://www.acase.ru/online/ru-forbuyers.jsp]

2. '''Подписание XML соглашения.'''

Далее с агентом свяжутся представители Академсервиса, по контактным данным указанным в договоре. Агенту будет предоставлен доступ к системе Академсервис (на сайте Академсервиса).

Необходимо обговорить, что интересует именно xml соединение. Для этого нужно заключить дополнительное xml-соглашение к Договору. После того как скан договора будет предоставлен в Академсервис, а также IP-адреса с которых будут приходить запросы (адреса системы {{NameSystem}} –для получения адресов нужно обратиться к Helpdesk Mute Lab) агенту будет высланы реквизиты подключения (Идентификатор компании, Идентификатор пользователя, Пароль).

Данные реквизиты надо указать в системе {{NameSystem}}.

3. '''Тестирование.'''

{{Attention| Перед тем, как начать работу, рекомендуется самостоятельно протестировать систему.}}

В административной части системы {{NameSystem}} в разделе «Реквизиты подключения» необходимо указать тестовое подключение к Академсервису.

Для учетной записи, которая будет использоваться при тестировании, надо отключить поиск в прочих отельных системах («Управление продажами» → «Отели» → «Настройки поиска»).

Полученные результаты в системе {{NameSystem}} нужно сравнить с результатами, полученными на сайте Академсервисе.

{{Attention| Возможны некоторое расхождение в результатах. При обнаружении значительных расхождений нужно обратиться в Helpdesk Mute Lab. Под значительными расхождениями подразумевается следующие: отсутствие в {{NameSystem}} результатов,  значительное расхождение в количестве результатов (более 10), в стоимости, в условиях бронирования и аннуляции.}}

Расхождение могут быть следствием различая в условиях xml соглашения от основного договора.

Если результаты совпадают (или расхождение не значительно), то можно переключить на боевое подключение и начать работу с системой Академсервис через систему {{NameSystem}}.

== Особенности работы с Академсервис ==

Поставщик предоставляет отели только на территории СНГ и имеет ряд особенностей:

* возможен поиск только одного номера и только для одного типа размещения в каждом запросе (1-местный/2-местный);
* свободные номера в результатах поиска — т.е. в результатах поиска идет отображение количества свободных номеров на данный момент;
* ремарки — т.е. предоставляется возможность оставить комментарии для поставщика (например: Шампанское в номер, Лучший номер и т. д.);
* не позволяет забронировать на одно имя два отеля в одном и то же городе на одни и те же даты.

Данный поставщик поддерживает возможность выбора дополнительного питания и кроватей. В {{NameSystem}} это можно сделать на странице '''«Детали размещения»'''.

Для некоторых из отелей доступны варианты раннего заезда и позднего выезда. В случае отказа в критичном раннем заезде вся услуга получит статус "Отказ поставщика". В случае отказа в некритичном раннем заезде время заезда будет изменено на время заезда по-умолчанию и вся услуга получит статус "Бронь".
Если ранний заезд был подтвержден со стороны отеля, то при подтверждении бронирования на стороне поставщика к итоговой стоимости автоматически добавляется стоимость услуги раннего заезда. До момента подтверждения бронирования, при выборе опций и бронировании, стоимость услуги необходимо добавлять к итоговой стоимости самостоятельно.
Аналогично обрабатывается поздний выезд.

== Возможные ошибки ==
=== При поиске ===
* '''9998: Доступ запрещен!''' — означает, что у агентства нет доступа для работы через XML. В этом случае клиент должен обратиться в техподдержку Академсервиса и уточнить данный вопрос.

=== При бронировании ===
* '''Указание Ref No не допустимо''' — означает, что указание внутреннего номера заказа при бронировании не допустимо. Следует обратиться в техподдержку Академсервиса, т.к. данный номер в Немо необходим.

== Поддержка SSL-шифрования ==
У Академсервис отсутствует поддержка шифрования SSL через HTTPS.

== Поддержка валют в Академсервис ==
Поддерживаются следующие валюты:
* Рубль
* Доллар
* Евро

== Обновление статических данных поставщика ==

Обновление статических данных происходит раз в сутки с использование запросов.

E-mail: support@acase.ru

== См. также ==
* [[Туроператор (ТО)]]
* [[Турагентство]]
* [[Объект размещения]]
* [[Статика]]
* [[Валюта]]
* [[Сервисная ремарка]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]

== Полезные ссылки ==
* [http://www.acase.ru Официальный сайт Академсервис]

Академсервис

2018-05-29T20:44:16Z

Пархоменко Александра: /* Особенности работы с Академсервис */

Академсервис

2018-05-29T20:41:07Z

Пархоменко Александра: /* Особенности работы с Академсервис */

[[Category:Поставщики наземных услуг|Поставщики_наземных_услуг]]

'''Академсервис''' — крупный [[Туроператор (ТО)]] и туристическая компания (Россия). [[File:Academ.jpg|right|Academ.jpg]] Основные направления деятельности: гостиничное размещение, трансферы, транспортное обслуживание, визовая поддержка туристов, авиаперелеты, VIP-сервис в аэропортах, железнодорожные переезды, экскурсии, круизы по рекам и морям на территории бывшего СССР.

== Подключение к Академсервис ==

Для подключения отельного блока системы {{NameSystem}}, работающего с системой Академсервис необходимо выполнить следующие шаги:

1. '''Подписание договоров.'''

На сайте Академсервис надо скачать «Договор об организации продаж туристских услуг» и «Соглашение о порядке предоставления скидок с опубликованных цен» и отправить  их в Академсервис.

Договора, почтовый адрес и другая информация доступна по ссылке: [http://www.acase.ru/online/ru-forbuyers.jsp http://www.acase.ru/online/ru-forbuyers.jsp]

2. '''Подписание XML соглашения.'''

Далее с агентом свяжутся представители Академсервиса, по контактным данным указанным в договоре. Агенту будет предоставлен доступ к системе Академсервис (на сайте Академсервиса).

Необходимо обговорить, что интересует именно xml соединение. Для этого нужно заключить дополнительное xml-соглашение к Договору. После того как скан договора будет предоставлен в Академсервис, а также IP-адреса с которых будут приходить запросы (адреса системы {{NameSystem}} –для получения адресов нужно обратиться к Helpdesk Mute Lab) агенту будет высланы реквизиты подключения (Идентификатор компании, Идентификатор пользователя, Пароль).

Данные реквизиты надо указать в системе {{NameSystem}}.

3. '''Тестирование.'''

{{Attention| Перед тем, как начать работу, рекомендуется самостоятельно протестировать систему.}}

В административной части системы {{NameSystem}} в разделе «Реквизиты подключения» необходимо указать тестовое подключение к Академсервису.

Для учетной записи, которая будет использоваться при тестировании, надо отключить поиск в прочих отельных системах («Управление продажами» → «Отели» → «Настройки поиска»).

Полученные результаты в системе {{NameSystem}} нужно сравнить с результатами, полученными на сайте Академсервисе.

{{Attention| Возможны некоторое расхождение в результатах. При обнаружении значительных расхождений нужно обратиться в Helpdesk Mute Lab. Под значительными расхождениями подразумевается следующие: отсутствие в {{NameSystem}} результатов,  значительное расхождение в количестве результатов (более 10), в стоимости, в условиях бронирования и аннуляции.}}

Расхождение могут быть следствием различая в условиях xml соглашения от основного договора.

Если результаты совпадают (или расхождение не значительно), то можно переключить на боевое подключение и начать работу с системой Академсервис через систему {{NameSystem}}.

== Особенности работы с Академсервис ==

Поставщик предоставляет отели только на территории СНГ и имеет ряд особенностей:

* возможен поиск только одного номера и только для одного типа размещения в каждом запросе (1-местный/2-местный);
* свободные номера в результатах поиска — т.е. в результатах поиска идет отображение количества свободных номеров на данный момент;
* ремарки — т.е. предоставляется возможность оставить комментарии для поставщика (например: Шампанское в номер, Лучший номер и т. д.);
* не позволяет забронировать на одно имя два отеля в одном и то же городе на одни и те же даты.

Данный поставщик поддерживает возможность выбора дополнительного питания и кроватей. В {{NameSystem}} это можно сделать на странице '''«Детали размещения»'''.

Для некоторых из отелей доступны варианты раннего заезда и позднего выезда. В случае отказа в критичном раннем заезде вся услуга получит статус "Отказ поставщика". В случае отказа в некритичном раннем заезде время заезда будет изменено на время заезда по-умолчанию и вся услуга получит статус "Бронь".
Если время заезда было подтверждено со стороны отеля, то при подтверждении бронирования на стороне поставщика к итоговой стоимости автоматически добавляется стоимость услуги раннего заезда. До момента подтверждения бронирования, при выборе опций и бронировании, стоимость услуги необходимо добавлять к итоговой стоимости самостоятельно.
Аналогично обрабатывается поздний выезд.

== Возможные ошибки ==
=== При поиске ===
* '''9998: Доступ запрещен!''' — означает, что у агентства нет доступа для работы через XML. В этом случае клиент должен обратиться в техподдержку Академсервиса и уточнить данный вопрос.

=== При бронировании ===
* '''Указание Ref No не допустимо''' — означает, что указание внутреннего номера заказа при бронировании не допустимо. Следует обратиться в техподдержку Академсервиса, т.к. данный номер в Немо необходим.

== Поддержка SSL-шифрования ==
У Академсервис отсутствует поддержка шифрования SSL через HTTPS.

== Поддержка валют в Академсервис ==
Поддерживаются следующие валюты:
* Рубль
* Доллар
* Евро

== Обновление статических данных поставщика ==

Обновление статических данных происходит раз в сутки с использование запросов.

E-mail: support@acase.ru

== См. также ==
* [[Туроператор (ТО)]]
* [[Турагентство]]
* [[Объект размещения]]
* [[Статика]]
* [[Валюта]]
* [[Сервисная ремарка]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]

== Полезные ссылки ==
* [http://www.acase.ru Официальный сайт Академсервис]

Академсервис

2018-05-28T14:38:34Z

Пархоменко Александра: /* Особенности работы с Академсервис */

[[Category:Поставщики наземных услуг|Поставщики_наземных_услуг]]

'''Академсервис''' — крупный [[Туроператор (ТО)]] и туристическая компания (Россия). [[File:Academ.jpg|right|Academ.jpg]] Основные направления деятельности: гостиничное размещение, трансферы, транспортное обслуживание, визовая поддержка туристов, авиаперелеты, VIP-сервис в аэропортах, железнодорожные переезды, экскурсии, круизы по рекам и морям на территории бывшего СССР.

== Подключение к Академсервис ==

Для подключения отельного блока системы {{NameSystem}}, работающего с системой Академсервис необходимо выполнить следующие шаги:

1. '''Подписание договоров.'''

На сайте Академсервис надо скачать «Договор об организации продаж туристских услуг» и «Соглашение о порядке предоставления скидок с опубликованных цен» и отправить  их в Академсервис.

Договора, почтовый адрес и другая информация доступна по ссылке: [http://www.acase.ru/online/ru-forbuyers.jsp http://www.acase.ru/online/ru-forbuyers.jsp]

2. '''Подписание XML соглашения.'''

Далее с агентом свяжутся представители Академсервиса, по контактным данным указанным в договоре. Агенту будет предоставлен доступ к системе Академсервис (на сайте Академсервиса).

Необходимо обговорить, что интересует именно xml соединение. Для этого нужно заключить дополнительное xml-соглашение к Договору. После того как скан договора будет предоставлен в Академсервис, а также IP-адреса с которых будут приходить запросы (адреса системы {{NameSystem}} –для получения адресов нужно обратиться к Helpdesk Mute Lab) агенту будет высланы реквизиты подключения (Идентификатор компании, Идентификатор пользователя, Пароль).

Данные реквизиты надо указать в системе {{NameSystem}}.

3. '''Тестирование.'''

{{Attention| Перед тем, как начать работу, рекомендуется самостоятельно протестировать систему.}}

В административной части системы {{NameSystem}} в разделе «Реквизиты подключения» необходимо указать тестовое подключение к Академсервису.

Для учетной записи, которая будет использоваться при тестировании, надо отключить поиск в прочих отельных системах («Управление продажами» → «Отели» → «Настройки поиска»).

Полученные результаты в системе {{NameSystem}} нужно сравнить с результатами, полученными на сайте Академсервисе.

{{Attention| Возможны некоторое расхождение в результатах. При обнаружении значительных расхождений нужно обратиться в Helpdesk Mute Lab. Под значительными расхождениями подразумевается следующие: отсутствие в {{NameSystem}} результатов,  значительное расхождение в количестве результатов (более 10), в стоимости, в условиях бронирования и аннуляции.}}

Расхождение могут быть следствием различая в условиях xml соглашения от основного договора.

Если результаты совпадают (или расхождение не значительно), то можно переключить на боевое подключение и начать работу с системой Академсервис через систему {{NameSystem}}.

== Особенности работы с Академсервис ==

Поставщик предоставляет отели только на территории СНГ и имеет ряд особенностей:

* возможен поиск только одного номера и только для одного типа размещения в каждом запросе (1-местный/2-местный);
* свободные номера в результатах поиска — т.е. в результатах поиска идет отображение количества свободных номеров на данный момент;
* ремарки — т.е. предоставляется возможность оставить комментарии для поставщика (например: Шампанское в номер, Лучший номер и т. д.);
* не позволяет забронировать на одно имя два отеля в одном и то же городе на одни и те же даты.

Данный поставщик поддерживает возможность выбора дополнительного питания и кроватей. В {{NameSystem}} это можно сделать на странице '''«Детали размещения»'''.

Для некоторых из отелей доступны варианты раннего заезда и позднего выезда. В случае отказа в критичном раннем заезде вся услуга получит статус "Отказ поставщика". В случае отказа в некритичном раннем заезде время заезда будет изменено на время заезда по-умолчанию и вся услуга получит статус "Бронь".
Аналогично обрабатывается поздний выезд.

== Возможные ошибки ==
=== При поиске ===
* '''9998: Доступ запрещен!''' — означает, что у агентства нет доступа для работы через XML. В этом случае клиент должен обратиться в техподдержку Академсервиса и уточнить данный вопрос.

=== При бронировании ===
* '''Указание Ref No не допустимо''' — означает, что указание внутреннего номера заказа при бронировании не допустимо. Следует обратиться в техподдержку Академсервиса, т.к. данный номер в Немо необходим.

== Поддержка SSL-шифрования ==
У Академсервис отсутствует поддержка шифрования SSL через HTTPS.

== Поддержка валют в Академсервис ==
Поддерживаются следующие валюты:
* Рубль
* Доллар
* Евро

== Обновление статических данных поставщика ==

Обновление статических данных происходит раз в сутки с использование запросов.

E-mail: support@acase.ru

== См. также ==
* [[Туроператор (ТО)]]
* [[Турагентство]]
* [[Объект размещения]]
* [[Статика]]
* [[Валюта]]
* [[Сервисная ремарка]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]

== Полезные ссылки ==
* [http://www.acase.ru Официальный сайт Академсервис]

Академсервис

2018-05-28T14:37:16Z

Пархоменко Александра: /* Особенности работы с Академсервис */

[[Category:Поставщики наземных услуг|Поставщики_наземных_услуг]]

'''Академсервис''' — крупный [[Туроператор (ТО)]] и туристическая компания (Россия). [[File:Academ.jpg|right|Academ.jpg]] Основные направления деятельности: гостиничное размещение, трансферы, транспортное обслуживание, визовая поддержка туристов, авиаперелеты, VIP-сервис в аэропортах, железнодорожные переезды, экскурсии, круизы по рекам и морям на территории бывшего СССР.

== Подключение к Академсервис ==

Для подключения отельного блока системы {{NameSystem}}, работающего с системой Академсервис необходимо выполнить следующие шаги:

1. '''Подписание договоров.'''

На сайте Академсервис надо скачать «Договор об организации продаж туристских услуг» и «Соглашение о порядке предоставления скидок с опубликованных цен» и отправить  их в Академсервис.

Договора, почтовый адрес и другая информация доступна по ссылке: [http://www.acase.ru/online/ru-forbuyers.jsp http://www.acase.ru/online/ru-forbuyers.jsp]

2. '''Подписание XML соглашения.'''

Далее с агентом свяжутся представители Академсервиса, по контактным данным указанным в договоре. Агенту будет предоставлен доступ к системе Академсервис (на сайте Академсервиса).

Необходимо обговорить, что интересует именно xml соединение. Для этого нужно заключить дополнительное xml-соглашение к Договору. После того как скан договора будет предоставлен в Академсервис, а также IP-адреса с которых будут приходить запросы (адреса системы {{NameSystem}} –для получения адресов нужно обратиться к Helpdesk Mute Lab) агенту будет высланы реквизиты подключения (Идентификатор компании, Идентификатор пользователя, Пароль).

Данные реквизиты надо указать в системе {{NameSystem}}.

3. '''Тестирование.'''

{{Attention| Перед тем, как начать работу, рекомендуется самостоятельно протестировать систему.}}

В административной части системы {{NameSystem}} в разделе «Реквизиты подключения» необходимо указать тестовое подключение к Академсервису.

Для учетной записи, которая будет использоваться при тестировании, надо отключить поиск в прочих отельных системах («Управление продажами» → «Отели» → «Настройки поиска»).

Полученные результаты в системе {{NameSystem}} нужно сравнить с результатами, полученными на сайте Академсервисе.

{{Attention| Возможны некоторое расхождение в результатах. При обнаружении значительных расхождений нужно обратиться в Helpdesk Mute Lab. Под значительными расхождениями подразумевается следующие: отсутствие в {{NameSystem}} результатов,  значительное расхождение в количестве результатов (более 10), в стоимости, в условиях бронирования и аннуляции.}}

Расхождение могут быть следствием различая в условиях xml соглашения от основного договора.

Если результаты совпадают (или расхождение не значительно), то можно переключить на боевое подключение и начать работу с системой Академсервис через систему {{NameSystem}}.

== Особенности работы с Академсервис ==

Поставщик предоставляет отели только на территории СНГ и имеет ряд особенностей:

* возможен поиск только одного номера и только для одного типа размещения в каждом запросе (1-местный/2-местный);
* свободные номера в результатах поиска — т.е. в результатах поиска идет отображение количества свободных номеров на данный момент;
* ремарки — т.е. предоставляется возможность оставить комментарии для поставщика (например: Шампанское в номер, Лучший номер и т. д.);
* не позволяет забронировать на одно имя два отеля в одном и то же городе на одни и те же даты.

Данный поставщик поддерживает возможность выбора дополнительного питания и кроватей. В {{NameSystem}} это можно сделать на странице '''«Детали размещения»'''.

Для некоторых из отелей доступны варианты раннего заезда и позднего выезда. В случае отказа в критичном раннем заезде вся услуга получит статус "Отказ поставщика". В случае отказа в Некритичном раннем заезде время заезда будет изменено на время заезда по-умолчанию и вся услуга получит статус "Бронь".
Аналогично обрабатывается поздний выезд.

== Возможные ошибки ==
=== При поиске ===
* '''9998: Доступ запрещен!''' — означает, что у агентства нет доступа для работы через XML. В этом случае клиент должен обратиться в техподдержку Академсервиса и уточнить данный вопрос.

=== При бронировании ===
* '''Указание Ref No не допустимо''' — означает, что указание внутреннего номера заказа при бронировании не допустимо. Следует обратиться в техподдержку Академсервиса, т.к. данный номер в Немо необходим.

== Поддержка SSL-шифрования ==
У Академсервис отсутствует поддержка шифрования SSL через HTTPS.

== Поддержка валют в Академсервис ==
Поддерживаются следующие валюты:
* Рубль
* Доллар
* Евро

== Обновление статических данных поставщика ==

Обновление статических данных происходит раз в сутки с использование запросов.

E-mail: support@acase.ru

== См. также ==
* [[Туроператор (ТО)]]
* [[Турагентство]]
* [[Объект размещения]]
* [[Статика]]
* [[Валюта]]
* [[Сервисная ремарка]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]

== Полезные ссылки ==
* [http://www.acase.ru Официальный сайт Академсервис]

Академсервис

2018-05-28T14:36:39Z

Пархоменко Александра: /* Особенности работы с Академсервис */

[[Category:Поставщики наземных услуг|Поставщики_наземных_услуг]]

'''Академсервис''' — крупный [[Туроператор (ТО)]] и туристическая компания (Россия). [[File:Academ.jpg|right|Academ.jpg]] Основные направления деятельности: гостиничное размещение, трансферы, транспортное обслуживание, визовая поддержка туристов, авиаперелеты, VIP-сервис в аэропортах, железнодорожные переезды, экскурсии, круизы по рекам и морям на территории бывшего СССР.

== Подключение к Академсервис ==

Для подключения отельного блока системы {{NameSystem}}, работающего с системой Академсервис необходимо выполнить следующие шаги:

1. '''Подписание договоров.'''

На сайте Академсервис надо скачать «Договор об организации продаж туристских услуг» и «Соглашение о порядке предоставления скидок с опубликованных цен» и отправить  их в Академсервис.

Договора, почтовый адрес и другая информация доступна по ссылке: [http://www.acase.ru/online/ru-forbuyers.jsp http://www.acase.ru/online/ru-forbuyers.jsp]

2. '''Подписание XML соглашения.'''

Далее с агентом свяжутся представители Академсервиса, по контактным данным указанным в договоре. Агенту будет предоставлен доступ к системе Академсервис (на сайте Академсервиса).

Необходимо обговорить, что интересует именно xml соединение. Для этого нужно заключить дополнительное xml-соглашение к Договору. После того как скан договора будет предоставлен в Академсервис, а также IP-адреса с которых будут приходить запросы (адреса системы {{NameSystem}} –для получения адресов нужно обратиться к Helpdesk Mute Lab) агенту будет высланы реквизиты подключения (Идентификатор компании, Идентификатор пользователя, Пароль).

Данные реквизиты надо указать в системе {{NameSystem}}.

3. '''Тестирование.'''

{{Attention| Перед тем, как начать работу, рекомендуется самостоятельно протестировать систему.}}

В административной части системы {{NameSystem}} в разделе «Реквизиты подключения» необходимо указать тестовое подключение к Академсервису.

Для учетной записи, которая будет использоваться при тестировании, надо отключить поиск в прочих отельных системах («Управление продажами» → «Отели» → «Настройки поиска»).

Полученные результаты в системе {{NameSystem}} нужно сравнить с результатами, полученными на сайте Академсервисе.

{{Attention| Возможны некоторое расхождение в результатах. При обнаружении значительных расхождений нужно обратиться в Helpdesk Mute Lab. Под значительными расхождениями подразумевается следующие: отсутствие в {{NameSystem}} результатов,  значительное расхождение в количестве результатов (более 10), в стоимости, в условиях бронирования и аннуляции.}}

Расхождение могут быть следствием различая в условиях xml соглашения от основного договора.

Если результаты совпадают (или расхождение не значительно), то можно переключить на боевое подключение и начать работу с системой Академсервис через систему {{NameSystem}}.

== Особенности работы с Академсервис ==

Поставщик предоставляет отели только на территории СНГ и имеет ряд особенностей:

* возможен поиск только одного номера и только для одного типа размещения в каждом запросе (1-местный/2-местный);
* свободные номера в результатах поиска — т.е. в результатах поиска идет отображение количества свободных номеров на данный момент;
* ремарки — т.е. предоставляется возможность оставить комментарии для поставщика (например: Шампанское в номер, Лучший номер и т. д.);
* не позволяет забронировать на одно имя два отеля в одном и то же городе на одни и те же даты.

Данный поставщик поддерживает возможность выбора дополнительного питания и кроватей. В {{NameSystem}} это можно сделать на странице '''«Детали размещения»'''.

Для некоторых из отелей доступны варианты раннего заезда и позднего выезда. В случае отказа в критичном раннем заезде Вся услуга получит статус "Отказ поставщика". В случае отказа в Некритичном раннем заезде время заезда будет изменено на время заезда по-умолчанию и вся услуга получит статус "Бронь".
Аналогично обрабатывается поздний выезд.

== Возможные ошибки ==
=== При поиске ===
* '''9998: Доступ запрещен!''' — означает, что у агентства нет доступа для работы через XML. В этом случае клиент должен обратиться в техподдержку Академсервиса и уточнить данный вопрос.

=== При бронировании ===
* '''Указание Ref No не допустимо''' — означает, что указание внутреннего номера заказа при бронировании не допустимо. Следует обратиться в техподдержку Академсервиса, т.к. данный номер в Немо необходим.

== Поддержка SSL-шифрования ==
У Академсервис отсутствует поддержка шифрования SSL через HTTPS.

== Поддержка валют в Академсервис ==
Поддерживаются следующие валюты:
* Рубль
* Доллар
* Евро

== Обновление статических данных поставщика ==

Обновление статических данных происходит раз в сутки с использование запросов.

E-mail: support@acase.ru

== См. также ==
* [[Туроператор (ТО)]]
* [[Турагентство]]
* [[Объект размещения]]
* [[Статика]]
* [[Валюта]]
* [[Сервисная ремарка]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]

== Полезные ссылки ==
* [http://www.acase.ru Официальный сайт Академсервис]

Ценообразование (Отели)

2017-09-29T09:11:43Z

Пархоменко Александра: /* Параметры правил ценообразования */

[[Категория:Модули]] [[Категория:Встроенные модули]]

==Назначение==
Модуль '''Ценообразование''' автоматизирует процесс расчета [[Комиссия (термин)|сборов]] для отелей, управления сборами [[Агентство|агентства]].

==Принцип работы==
Работа модуля основана на правилах ценообразования, которые заводит агентство.

'''Правило''' — ''значение сбора'' и ''условия его применения''.<br>
'''Условие применения сбора''' — набор параметров отеля, к которым будут применяться сборы правила (''поставщик'', ''страна'', ''сезон заезда'', ''название отеля'' и пр.)

Правил ценообразования может быть несколько.<br>
Для одного варианта, представленного на выдаче, (или заказа) '''выбирается и применяется только одно правило''', подходящее по условию применения правила.

Сборы '''рассчитываются при каждом обновлении''' [[Заказы|заказа]] по правилам, загруженным в систему '''на момент проверки''':
* при формировании выдачи результатов поиска,
* при бронировании,
* при переходе к оплате и выписке,
* при обновлении страницы заказа.

==Заведение правил ценообразования==

Правила ценообразования хранятся и настраиваются в разделе '''Управление продажами → Отели → Управление ценами → Ценовые правила'''.

Для создания правила:
* Зайдите в раздел '''Управление продажами → Отели → Управление ценами → Ценовые правила'''.
* Нажмите кнопку '''Создать новую запись'''.
* Задайте параметры правила - условие применения правила и величину сбора.
* Нажмите кнопку '''Сохранить'''.

== Параметры правил ценообразования==
Для просмотра описания параметров <span style="background-color:gold">разверните таблицу</span>:

{| class="wikitable mw-collapsible mw-collapsed"
|colspan="2" align="center"| '''Параметры правил ценообразования'''
|-
! scope="col" | Название параметра
! scope="col" | Описание
|-
| Поставщик
| Определяет для каких поставщиков будет применимо правило.
|-
| Активно
| Применять или нет правило при расчётах.
|-
| Скидка от тарифа
| Если включено, то правило определяет размер скидки, а не наценки.
|-
| Страны
| Позволяет задать правило для всех страны, либо только для некоторых.
|-
| Список стран
| Задаёт страны, для которых применяется правило. Отображается и применяется если в параметре ''Страны'' задано значение ''Выбрать из списка'' или ''Все страны, кроме выбранных''.
|-
| Категории
| Позволяет задать правило для всех категорий отеля, либо выбрать определённые.
|-
| Список категорий
| Задаёт категории отелей, для которых применяется правило. Отображается и применяется если в параметре ''Категории'' задано значение ''Выбрать из списка''.
|-
| Список отелей
| Список отелей, для которых применяется правило. Задаётся в виде <язык>:<часть названия>, где:
<язык> - двухбуквенное обозначение языка, для которого будет производится проверка названия отеля,<br>
<часть названия> - часть названия отеля, проверка будет проводится по полному или частичному совпадению.
|-
| Сезон по заезду (с)
| Минимально допустимая дата заезда. Для срабатывания правила, дата заезда должна быть больше или равна указанной.
|-
| Сезон по заезду (по)
| Максимально допустимая дата заезда. Для срабатывания дата заезда должна быть меньше или равна указанной.
|-
| Сезон бронирования с
| Минимально допустимая дата оформления заказа (не путать с датой заезда). Для срабатывания правила, текущая дата должна быть больше или равна указанной.
|-
| Сезон бронирования по
| Максимально допустимая дата оформления заказа и дата заезда. Для срабатывания правила текущая дата должна быть меньше или равна указанной.
|-
| Тип mark-up
| Тип наценки - в виде процента к цене нетто, или в виде фиксированной стоимости за одну ночь проживания (за каждый номер).
|-
| Валюта
| Валюта наценки. Отображается и используется если в параметре ''Тип mark-up'' выбрано значение ''Фиксированная цена за 1 ночь проживания (за каждый номер)''.
|-
| Значение mark-up
| Значение наценки. Если в параметре ''Тип mark-up'' выбрано значение ''Фиксированная цена за 1 ночь проживания (за каждый номер)'', то данный параметр определяет абсолютное значение наценки, а противном случае определяет процент наценки.
|-
| Тип агентского сбора
| Тип агентского сбора - в виде процента к цене нетто или в виде фиксированной стоимости за бронь/за человека.
|-
| Валюта
| Валюта агентского сбора. Отображается и используется если в параметре ''Тип агентского сбора'' выбрано значение ''Фиксированная цена за бронь'' или ''Фиксированная цена за человека''.
|-
| Значение агентского сбора
| Значение агентского сбора. Если в параметре ''Тип агентского сбора'' выбрано значение ''Процент к цене нетто'', то данный параметр определяет процент сбора, а противном случае определяет абсолютное значение сбора.
|-
| Тип сервисного сбора
| Тип агентского сбора - в виде процента к цене нетто или в виде фиксированной стоимости за бронь/за человека.
|-
| Валюта
| Валюта сервисного сбора. Отображается и используется если в параметре ''Тип сервисного сбора'' выбрано значение ''Фиксированная цена за бронь'' или ''Фиксированная цена за человека''.
|-
| Значение сервисного сбора
| Значение сервисного сбора. Если в параметре ''Тип сервисного сбора'' выбрано значение ''Процент к цене нетто'', то данный параметр определяет процент сбора, а противном случае определяет абсолютное значение сбора.
|}