Различия

Показаны различия между двумя версиями страницы.

--- onlineticket:104operations:04train [2016/09/07 13:54] – kharitonov
+++ onlineticket:104operations:04train [2024/12/11 12:07] (текущий) – m.tsitseronova
@@ Строка 1: / Строка 1: @@
-===== Железнодорожные билеты =====
+====== Железнодорожные/автобусные билеты ======
-Информация о железнодорожных билетах вносится в запись об операции **TICKET** корневого узла XML документа – **TICKETS**.\\
+Информация о железнодорожных билетах вносится в запись об операции **TICKET** корневого узла XML документа – **TICKETS**.
-\\
-==== Блок "TICKET" ====
+===== Блок "TICKET" =====
 ^  Поле  ^  Описание  ^
-|**TYPE**|Тип документа: //TRAIN_TICKET//|
+|**TYPE_CARRIER**|Тип перевозки: ''TRAIN'' – железнодорожная, ''BUS'' – автобусная|
-|**SYSTEM**|Информация о системе резервирования.\\ Атрибут //id// – код системы (для ГРС – ''1H'', для других центров – их идентификатор).\\ Атрибут //session// – сеанс работы (может отсутствовать)|
+|**TYPE**|Тип документа: ''TRAIN_TICKET''|
+|**SYSTEM**|Информация о системе резервирования.\\ Атрибут //id// – код системы (для МКЛ – ''1H'', для других центров – их идентификатор).\\ Атрибут //session// – сеанс работы (может отсутствовать)|
 |**CURRENCY**|Код валюты оплаты билета (например, ''USD'', ''RUB'')|
-|**DEALDATE**|Дата продажи, возврата, обмена – дата сделки|
+|**DEALDATE**|Дата операции|
-|**DEALTIME**|Время продажи, возврата, обмена – время сделки|
+|**DEALTIME**|Время операции|
-|**OPTYPE**|Тип операции: //SALE// – финансовые средства берутся с клиента, //REFUND// – финансовые средства возвращаются клиенту|
+|**OPTYPE**|Тип операции: ''SALE'' – финансовые средства берутся с клиента, ''REFUND'' – финансовые средства возвращаются клиенту|
-|**TRANS_TYPE**|Общий тип транзакции: //SALE//, REFUND//|
+|**TRANS_TYPE**|Общий тип транзакции: ''SALE'', ''REFUND''|
 |**EMD_NUM**|Номер EMD|
 |**TICKNUM**|Номер билета|
@@ Строка 25: / Строка 25: @@
 |**TOTAL**|Общая сумма в валюте оплаты. Может содержать атрибуты (заполняются только при предоставлении данных перевозчиком):\\ • //commission_fee_vat_amount// – сумма НДС комиссионного сбора при возврате;\\ • //commission_fee_vat_rate// – ставка НДС комиссионного сбора при возврате;\\ • //refund_tax_vat_amount// – сумма НДС сбора за возврат;\\ • //refund_tax_vat_rate// – ставка НДС сбора за возврат|
 |**CARRIER_VAT_ID**|ИНН перевозчика|
-|**DEAL**|Информация о сделке заключена в атрибутах:\\ • //agency// – код агентства, в котором была проведена операция;\\ • //date// – дата проведения операции;\\ • //disp// – идентификатор оператора, проведшего операцию;\\ • //ersp// – код интернет пункта продажи (может отсутствовать);\\ • //pcc// – код PCC (pseudo city code), может отсутствовать, сейчас заполняется для сеанса B1G;\\ • //opr_num// – номер (жетон) оператора, проведшего операцию;\\ • //stamp// – идентификатор ППР, в котором была проведена операция;\\ • //tap// – пульт, с которого была проведена операция;\\ • //time// – время проведения операции;\\ • //utc// – UTC дата и время проведения операции в iso формате (//YYYYMMDDThhmmss//)|
+|**DEAL**|Информация о сделке заключена в атрибутах:\\ • //agency// – код агентства, в котором была проведена операция;\\ • //date// – дата проведения операции;\\ • //disp// – идентификатор оператора, проведшего операцию;\\ • //ersp// – код интернет пункта продажи (может отсутствовать);\\ • //pcc// – код PCC (pseudo city code), может отсутствовать, сейчас заполняется для сеанса B1G;\\ • //opr_num// – номер (жетон) оператора, проведшего операцию;\\ • //stamp// – идентификатор ППР, в котором была проведена операция;\\ • //tap// – пульт, с которого была проведена операция;\\ • //time// – время проведения операции;\\ • //utc// – UTC дата и время проведения операции в ISO формате (//YYYYMMDDThhmmss//)|
-|**SALE**|Информация об операции продажи при возврате заключена в атрибутах:\\ • //agency// – код агентства, в котором была проведена операция продажи;\\ • //date// – дата проведения операции продажи;\\ • //disp// – идентификатор оператора, проведшего операцию продажи;\\ • //opr_num// – номер (жетон) оператора, проведшего операцию продажи;\\ • //stamp// – идентификатор ППР, в котором была проведена операция продажи;\\ • //tap// – пульт, с которого была проведена операция продажи;\\ • //time// – время проведения операции продажи;\\ • //utc// – UTC дата и время проведения операции продажи в iso формате (//YYYYMMDDThhmmss//)|
+|**SALE**|Информация об операции продажи при возврате заключена в атрибутах:\\ • //agency// – код агентства, в котором была проведена операция продажи;\\ • //date// – дата проведения операции продажи;\\ • //disp// – идентификатор оператора, проведшего операцию продажи;\\ • //opr_num// – номер (жетон) оператора, проведшего операцию продажи;\\ • //stamp// – идентификатор ППР, в котором была проведена операция продажи;\\ • //tap// – пульт, с которого была проведена операция продажи;\\ • //time// – время проведения операции продажи;\\ • //utc// – UTC дата и время проведения операции продажи в ISO формате (//YYYYMMDDThhmmss//)|
 |**SEGMENTS**|Массив информации по участкам перевозки **SEGMENT**|
 |**PASSENGERS**|Массив информации о пассажирах с элементами **PASSENGER**|
+|**CONTACTS**|Массив информации о контактах пассажиров с элементами **CONTACT**, где может быть указан адрес электронной почты или телефон|
-==== Блок **SEGMENT** ====
+===== Блок "SEGMENT" =====
 ^  Поле  ^  Описание  ^
-|**SEGNO**|Номер сегмента|
+|**SEGNO**|Порядковый номер участка (всегда равен 1)|
-|**DEPPORT**|Название пункта отправления|
+|**DEPPORT**|Код пункта отправления|
-|**ARRPORT**|Название пункта прибытия|
+|**ARRPORT**|Код пункта прибытия|
 |**CLASS**|Класс обслуживания|
-|**SEATS**|Массив записей **SEAT**.\\ Каждая из записей содержит номер места и может содержать атрибут //tier// — ярусность места|
+|**SEATS**|Массив записей **SEAT**.\\ Каждая из записей содержит номер места и необязательный атрибут //tier// — ярус места|
 |**DEPDATE**|Дата отправления в формате //ДДММГГГГ//|
 |**DEPTIME**|Время отправления в формате //ЧЧММ//|
@@ Строка 45: / Строка 45: @@
 |**COACH**|Номер вагона|
-==== Блок "PASSENGER" ====
+===== Блок "PASSENGER" =====
 ^  Поле  ^  Описание  ^
 |**PASSNO**|Порядковый номер пассажира|
 |**FIO**|ФИО пассажира|
-|**PASS**|Документ, удостоверяющий личность|
+|**SURNAME**|Фамилия пассажира|
+|**NAME**|Имя и отчество пассажира|
+|**PASS**|Документ, удостоверяющий личность пассажира|
+|**GENDER**|Пол пассажира (''M'' – мужской, ''F'' – женский)|
+|**CITIZENSHIP**|Гражданство пассажира (ISO код страны)|
+|**BIRTH_DATE**|Дата рождения пассажира в формате //ДДММГГГГ//|
+===== Блок "CONTACTS" =====
+^  Поле  ^  Описание  ^
+|**CONTACT**|Контактная информация по пассажиру. Может быть указан либо адрес электронной почты, либо телефон.\\ • Формат номера телефона: без знака «+», не более 14 цифр.\\ • Формат адреса электронной почты:\\    • поле может включать один символ «''@''», после которого возможна одна точка;\\    • допускаются цифры, русские, латинские символы, точки, тире и подчеркивания;\\    • если указана хотя бы одна латинская буква, то следует указать все буквы латинскими;\\    • не допускается два специальных символа подряд (точка, тире, подчеркивание)|
 ----