Различия

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

--- onlineticket:103description:05train [2022/08/03 14:34] – aleshina
+++ onlineticket:103description:05train [2025/02/21 16:04] (текущий) – kharitonov
@@ Строка 1: / Строка 1: @@
-====== Железнодорожные билеты ======
+====== Железнодорожные/автобусные билеты ======
 Формат обменного файла с данными железнодорожных билетов:
-<code>
+<code xml>
-<TICKETS version='2.6'>
+<TICKETS version='2.10'>
   <TICKET>
-    <TYPE DESC='TRAIN_TICKET'>varchar2(10)</TYPE>
+    <TYPE_CARRIER DESC='тип перевозки: TRAIN – железнодорожная, BUS – автобусная'>varchar2(5)</TYPE_CARRIER>
-    <SYSTEM id='код системы. Для ГРС – 1Н, для других центров – их идентификатор varchar2(3)' session='сеанс работы (может отсутствовать) varchar2(20)' DESC='информация о системе резервирования'/>
+    <TYPE DESC='TRAIN_TICKET'>varchar2(10)</TYPE>
-    <DEALDATE DESC='дата операции'>varchar2(8)</DEALDATE>
+    <SYSTEM id='код системы. Для МКЛ – 1Н, для других центров – их идентификатор varchar2(3)' session='сеанс работы (может отсутствовать) varchar2(20)' DESC='информация о системе резервирования'/>
-    <DEALTIME DESC='время операции'>varchar2(6)</DEALTIME>
+    <DEALDATE DESC='дата операции'>varchar2(8)</DEALDATE>
-    <OPTYPE DESC='SALE, REFUND'>varchar2(10)</OPTYPE>
+    <DEALTIME DESC='время операции'>varchar2(6)</DEALTIME>
-    <TRANS_TYPE DESC='SALE, REFUND'>varchar2(10)</TRANS_TYPE>
+    <OPTYPE DESC='SALE, REFUND'>varchar2(10)</OPTYPE>
-    <EMD_NUM DESC='номер EMD'>varchar2(20)</EMD_NUM>
+    <TRANS_TYPE DESC='SALE, REFUND'>varchar2(10)</TRANS_TYPE>
-    <TICKNUM DESC='номер билета'>varchar2(20)</TICKNUM>
+    <EMD_NUM DESC='номер EMD'>varchar2(20)</EMD_NUM>
-    <ORDER_NUM DESC='номер заказа ЖД'>varchar2(20)</ORDER_NUM>
+    <TICKNUM DESC='номер билета'>varchar2(20)</TICKNUM>
-    <PNR DESC='номер заказа на кириллице'>varchar2(8)</PNR>
+    <ORDER_NUM DESC='номер заказа ЖД'>varchar2(20)</ORDER_NUM>
-    <PNR_LAT DESC='номер заказа на латинице'>varchar2(8)</PNR_LAT>
+    <PNR DESC='номер заказа на кириллице'>varchar2(8)</PNR>
-    <FARETYPE DESC='тип тарифа'>varchar2(100)</FARETYPE>
+    <PNR_LAT DESC='номер заказа на латинице'>varchar2(8)</PNR_LAT>
-    <FARE vat_amount='сумма НДС' vat_rate='ставка НДС' DESC='тариф'>number</FARE>
+    <FARETYPE DESC='тип тарифа'>varchar2(100)</FARETYPE>
-    <FARE_CURR DESC='валюта тарифа'>varchar2(100)</FARE_CURR>
+    <FARE vat_amount='сумма НДС' vat_rate='ставка НДС' DESC='тариф'>number</FARE>
-    <INSURANCE DESC='страховой тариф (в валюте тарифа)'>number</INSURANCE>
+    <FARE_CURR DESC='валюта тарифа'>varchar2(100)</FARE_CURR>
-    <SERVICES DESC='сервисные услуги (в валюте тарифа)' vat_amount='сумма НДС сервисных услуг' vat_rate='ставка НДС сервисных услуг'>number</SERVICES>
+    <INSURANCE DESC='страховой тариф (в валюте тарифа)'>number</INSURANCE>
-    <COMMISSION DESC='сборы комиссионные(в валюте тарифа)'>number</COMMISSION>
+    <SERVICES DESC='сервисные услуги (в валюте тарифа)' vat_amount='сумма НДС сервисных услуг' vat_rate='ставка НДС сервисных услуг'>number</SERVICES>
-    <CURRENCY DESC='валюта оплаты'>varchar2(100)</CURRENCY>
+    <COMMISSION DESC='сборы комиссионные(в валюте тарифа)'>number</COMMISSION>
-    <TOTAL DESC='общая сумма в валюте оплаты' commission_fee_vat_amount='сумма НДС комиссионного сбора при возврате' commission_fee_vat_rate='ставка НДС комиссионного сбора при возврате' refund_tax_vat_amount='сумма НДС сбора за возврат' refund_tax_vat_rate='ставка НДС сбора за возврат'>number</TOTAL>
+    <CURRENCY DESC='валюта оплаты'>varchar2(100)</CURRENCY>
-    <CARRIER_VAT_ID DESC='ИНН перевозчика'>varchar2(50)</CARRIER_VAT_ID>
+    <TOTAL DESC='общая сумма в валюте оплаты' commission_fee_vat_amount='сумма НДС комиссионного сбора при возврате' commission_fee_vat_rate='ставка НДС комиссионного сбора при возврате' refund_tax_vat_amount='сумма НДС сбора за возврат' refund_tax_vat_rate='ставка НДС сбора за возврат'>number</TOTAL>
-    <DEAL agency='код агенства varchar(6)' date='дата проведения операции по местному времени пульта varchar2(8)' disp='идентификатор оператора varchar(15)' opr_num='номер оператора number' stamp='идентификатор ппр, в котором была проведена операция varchar(15)' tap='пульт, с которого была проведена операция varchar(15)' time='время проведения операции по местному времени пульта varсhar2(6)' utc='UTC дата и время проведения операции в ISO формате (YYYYMMDDThhmmss) varchar2(15)' DESC='информация о сделке'/>
+    <CARRIER_VAT_ID DESC='ИНН перевозчика'>varchar2(50)</CARRIER_VAT_ID>
-    <SALE agency='код агенства varchar(6)' date='дата продажи по местному времени пульта varchar2(8)' disp='идентификатор оператора-продавца varchar(15)' opr_num='номер оператора number' stamp='идентификатор ппр, в котором была проведена продажа varchar(15)' tap='пульт, с которого была проведена продажа varchar(15)' time='время проведение продажи по местному времени пульта varсhar2(6)' utc='UTC дата и время проведения продажи в ISO формате (YYYYMMDDThhmmss) varсhar2(15)' DESC='информация о продаже'/>
+    <DEAL agency='код агенства varchar(6)' date='дата проведения операции по местному времени пульта varchar2(8)' disp='идентификатор оператора varchar(15)' opr_num='номер оператора number' stamp='идентификатор ппр, в котором была проведена операция varchar(15)' tap='пульт, с которого была проведена операция varchar(15)' time='время проведения операции по местному времени пульта varсhar2(6)' utc='UTC дата и время проведения операции в ISO формате (YYYYMMDDThhmmss) varchar2(15)' DESC='информация о сделке'/>
-    <SEGMENTS DESC='участки перевозки'>
+    <SALE agency='код агенства varchar(6)' date='дата продажи по местному времени пульта varchar2(8)' disp='идентификатор оператора-продавца varchar(15)' opr_num='номер оператора number' stamp='идентификатор ппр, в котором была проведена продажа varchar(15)' tap='пульт, с которого была проведена продажа varchar(15)' time='время проведение продажи по местному времени пульта varсhar2(6)' utc='UTC дата и время проведения продажи в ISO формате (YYYYMMDDThhmmss) varсhar2(15)' DESC='информация о продаже'/>
-        <SEGMENT DESC='участок перевозки'>
+    <SEGMENTS DESC='участки перевозки'>
-            <SEGNO DESC='порядковый номер участка (всегда равен 1)'>number</SEGNO>
+        <SEGMENT DESC='участок перевозки'>
-            <DEPDATE DESC='дата отправления'>varchar2(8)</DEPDATE>
+            <SEGNO DESC='порядковый номер участка (всегда равен 1)'>number</SEGNO>
-            <DEPTIME DESC='время отправления'>varchar2(8)</DEPTIME>
+            <DEPDATE DESC='дата отправления'>varchar2(8)</DEPDATE>
-            <DEPPORT DESC='код пункта отправления'>varchar2(80)</DEPPORT>
+            <DEPTIME DESC='время отправления'>varchar2(8)</DEPTIME>
-            <ARRDATE DESC='дата прибытия'>varchar2(8)</DEPDATE>
+            <DEPPORT DESC='код пункта отправления'>varchar2(80)</DEPPORT>
-            <ARRTIME DESC='время прибытия'>varchar2(8)</DEPTIME>
+            <ARRDATE DESC='дата прибытия'>varchar2(8)</DEPDATE>
-            <ARRPORT DESC='код пункта прибытия'>varchar2(80)</ARRPORT>
+            <ARRTIME DESC='время прибытия'>varchar2(8)</DEPTIME>
-            <TRAIN DESC='номер поезда'>varchar2(20)</TRAIN>
+            <ARRPORT DESC='код пункта прибытия'>varchar2(80)</ARRPORT>
-            <COACH num='номер вагона' type='тип вагона'/>
+            <TRAIN DESC='номер поезда'>varchar2(20)</TRAIN>
-            <CLASS DESC='класс обслуживания'>varchar2(20)</CLASS>
+            <COACH num='номер вагона' type='тип вагона'/>
-            <SEATS>
+            <CLASS DESC='класс обслуживания'>varchar2(20)</CLASS>
-                <SEAT DESC='номер места' tier='ярус места'>varchar2(8)</SEAT>
+            <SEATS>
-            </SEATS>
+                <SEAT DESC='номер места' tier='ярус места'>varchar2(8)</SEAT>
-        </SEGMENT>
+            </SEATS>
-    </SEGMENTS>
+        </SEGMENT>
-    <PASSENGERS DESC='данные пассажиров'>
+    </SEGMENTS>
-        <PASSENGER DESC='данные пассажира'>
+    <PASSENGERS DESC='данные пассажиров'>
-            <PASSNO DESC='номер пассажира'>number</PASSNO>
+        <PASSENGER DESC='данные пассажира'>
-            <FIO DESC='ФИО пассажира'>varchar2(100)</FIO>
+            <PASSNO DESC='номер пассажира'>number</PASSNO>
-            <SURNAME DESC='фамилия пассажира'>varchar2(100)</SURNAME>
+            <FIO DESC='ФИО пассажира'>varchar2(100)</FIO>
-            <NAME DESC='имя и отчество пассажира'>varchar2(100)</NAME>
+            <SURNAME DESC='фамилия пассажира'>varchar2(100)</SURNAME>
-            <PASS DESC='документ, удостоверяющий личность пассажира'>varchar2(100)</PASS>
+            <NAME DESC='имя и отчество пассажира'>varchar2(100)</NAME>
-            <GENDER DESC='пол пассажира (M – мужской, F – женский)'>varchar2(1)</GENDER>
+            <PASS DESC='документ, удостоверяющий личность пассажира'>varchar2(100)</PASS>
-            <CITIZENSHIP DESC='гражданство пассажира (ISO код страны)'>varchar2(3)</CITIZENSHIP>
+            <GENDER DESC='пол пассажира (M – мужской, F – женский)'>varchar2(1)</GENDER>
-            <BIRTH_DATE DESC='дата рождения пассажира в формате ДДММГГГГ'>varchar2(8) </BIRTH_DATE>
+            <CITIZENSHIP DESC='гражданство пассажира (ISO код страны)'>varchar2(3)</CITIZENSHIP>
-        </PASSENGER>
+            <BIRTH_DATE DESC='дата рождения пассажира в формате ДДММГГГГ'>varchar2(8)</BIRTH_DATE>
-    </PASSENGERS>
+        </PASSENGER>
-   <CONTACTS>
+    </PASSENGERS>
-     <CONTACT DESC='контактная информация по каждому пассажиру'>varchar2(50)</CONTACTS>
+    <CONTACTS>
-   </CONTACTS>
+        <CONTACT DESC='контактная информация по каждому пассажиру (номер телефона или e-mail)'>varchar2(50)</CONTACTS>
-  </TICKET>
+    </CONTACTS>
+  </TICKET>
 </TICKETS>
 </code>
-**CONTACT** - контактная информация пассажира, которая может состоять из адресов электронных почт и телефона. Каждый адрес электронной почты, также номер телефона предаются в отдельном тэге CONTACT.
-Формат телефона: без ''+'', не более 10 знаков.
-Формат электронной почты: поле может включать один символ ''@''. Справа от ''@'' одна точка.
-Допускаются цифры, русские, латинские символы, точки, тире и подчеркивания.
-Если хотя бы одна латинская буква — все буквы латинские.
-Не допускается два специальных символа подряд (точка, тире).
-Пример:
-<code>
-<?xml version="1.0" encoding="UTF-8"?>
-<TICKETS version="2.6">
-    <TICKET>
-        <TYPE>TRAIN_TICKET</TYPE>
-        <SYSTEM id="ГРТ" session="ТКП"></SYSTEM>
-        <DEALDATE>25072022</DEALDATE>
-        <DEALTIME>0932</DEALTIME>
-        <OPTYPE>SALE</OPTYPE>
-        <TRANS_TYPE>SALE</TRANS_TYPE>
-        <EMD_NUM>97A1000301371</EMD_NUM>
-        <TICKNUM>75520868044225</TICKNUM>
-        <ORDER_NUM>75520868044214</ORDER_NUM>
-        <PNR>10ДФЖТ</PNR>
-        <PNR_LAT>10DFZT</PNR_LAT>
-        <FARETYPE>ПОЛНЫЙ</FARETYPE>
-        <FARE vat_amount="0.00" vat_rate="0.00">3352.00</FARE>
-        <FARE_CURR>РУБ</FARE_CURR>
-        <INSURANCE>0.00</INSURANCE>
-        <SERVICES vat_amount="139.17" vat_rate="20.00">835.00</SERVICES>
-        <COMISSION>0.00</COMISSION>
-        <CURRENCY>РУБ</CURRENCY>
-        <TOTAL commission_fee_vat_rate="0.00" refund_tax_vat_rate="0.00">3352.00</TOTAL>
-        <CARRIER_VAT_ID>7708709686</CARRIER_VAT_ID>
-        <DEAL agency="99ГРС" date="25072022" disp="ТКП99ГРС222" opr_num="222" stamp="00118580" tap="МОВДМА" time="0932" utc="20220725T063250"></DEAL>
-        <SALE></SALE>
-        <SEGMENTS>
-            <SEGMENT>
-                <SEGNO>1</SEGNO>
-                <DEPDATE>08082022</DEPDATE>
-                <DEPTIME>1638</DEPTIME>
-                <DEPPORT>МОСКВА КАЗАНСКАЯ</DEPPORT>
-                <ARRDATE>09082022</ARRDATE>
-                <ARRTIME>0503</ARRTIME>
-                <ARRPORT>КАЗАНЬ ПАСС</ARRPORT>
-                <TRAIN>086УА</TRAIN>
-                <COACH num="9" type="К"></COACH>
-                <CLASS>2Т</CLASS>
-                <SEATS>
-                    <SEAT tier="ВЕРХНЕЕ">014</SEAT>
-                </SEATS>
-            </SEGMENT>
-        </SEGMENTS>
-        <PASSENGERS>
-            <PASSENGER>
-                <PASSNO>1</PASSNO>
-                <FIO>ПЕТРОВ ПЕТР</FIO>
-                <PASS>ПН1515151515</PASS>
-                <SURNAME>ПЕТРОВ</SURNAME>
-                <NAME>ПЕТР ИВАНОВИЧ</NAME>
-                <GENDER>M</GENDER>
-                <CITIZENSHIP>RUS</CITIZENSHIP>
-                <BIRTH_DATE>12121980</BIRTH_DATE>
-            </PASSENGER>
-        </PASSENGERS>
-        <CONTACTS>
-            <CONTACT>+70987654321</CONTACT>
-            <CONTACT>TEST@YA.RU</CONTACT>
-        </CONTACTS>
-    </TICKET>
-</TICKETS>
-</code>
 ----
 См. также:
@@ Строка 143: / Строка 70: @@
   * [[onlineticket:103description:03insurance|Страховые полисы]]
   * [[onlineticket:103description:04aeroexpress|Билеты Аэроэкспресс]]