Изменения

Перейти к навигации Перейти к поиску

Интеграция со сторонними системами АПИ

26 173 байта добавлено, 20:45, 30 января 2015
Выгрузка информации о заказах
*price - цена полиса для пассажира;
*rloc - номер заказа у поставщика.
 
</div>
</div>
 
=== Выгрузка заказа для компонента «Отели» ===
Для компонента '''«Отели»''' доступна выгрузка заказов в формате Nemo.
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Формат Nemo ====
<div class="mw-collapsible-content">
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<?xml version="1.0" encoding="UTF-8"?>
<PNR>
<Common>
<id>263462</id>
<Type>HOTELS</Type>
<Service>ACADEM</Service>
<Locator>3028655</Locator>
<BeginDateTime>2014.04.15-00:00</BeginDateTime>
<EndDateTime>2014.04.16-00:00</EndDateTime>
<TotalPrice>
<Amount>1950</Amount>
<CurrencyCode>RUB</CurrencyCode>
</TotalPrice>
<UserId>123</UserId>
<EEUserId />
<UserLogin>userLogin</UserLogin>
<GroupId>332</GroupId>
<UserStatus>Менеджер</UserStatus>
<DateCreate>2014.03.21-16:11</DateCreate>
</Common>
<Payment>
<Status>booked</Status>
<PenaltyDate>2014.04.13-00:00</PenaltyDate>
<Timelimit>2014-04-13 00:00:00</Timelimit>
<Charge>
<Amount>0</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Charge>
<Book>
<Amount>1950</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Book>
<Penalty>
<Amount>0</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Penalty>
<Total>
<Amount>1950</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Total>
<Commission>
<Amount>112</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Commission>
<PaidValue>
<Amount>0</Amount>
<CurrencyCode>RUB</CurrencyCode>
</PaidValue>
</Payment>
<Client>
<LastName>Сидоров</LastName>
<Name>Владимир</Name>
<MiddleName>Константинович</MiddleName>
<Number>1806326598</Number>
<Birth>1987-05-20</Birth>
<Email>mail@host.com</Email>
<Phone>+79871234567</Phone>
</Client>
<Passengers>
<Passenger>
<nationality>RU</nationality>
<lastname>IVANOV</lastname>
<name>IVAN</name>
</Passenger>
</Passengers>
<Info>
<Name>Интурист</Name>
<City>
<Code>34</Code>
<Name>Великий Новгород</Name>
</City>
<Location />
<StarRating>3</StarRating>
<Days>2</Days>
<Nights>1</Nights>
<CheckInDate>2014.04.15</CheckInDate>
<CheckOutDate>2014.04.16</CheckOutDate>
<CheckInTime>14:00</CheckInTime>
<CheckOutTime>12:00</CheckOutTime>
<OnRequest>false</OnRequest>
</Info>
<Rooms>
<Room>
<Name>Двухместный стандарт (две кровати)</Name>
<Type>SNGL</Type>
<FareId>1</FareId>
</Room>
</Rooms>
<Fares>
<Fare>
<Id>1</Id>
<Price>
<Amount>1950</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Price>
<Meals>Завтрак "Шведский стол",Отсутствует</Meals>
<Description>Одноместный</Description>
</Fare>
</Fares>
<CancelCharges>
<Charge>
<DateFrom>2014.04.13-00:00</DateFrom>
<DateTo>2014.04.15-00:00</DateTo>
<Amount>1488</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Charge>
</CancelCharges>
<ModifyCharges />
<ModificationMethods>
<Method>MOD_PASS_NAMES</Method>
<Method>MOD_DATES</Method>
</ModificationMethods>
</PNR>
</syntaxhighlight>
</div>
</div>
 
=== Выгрузка заказа для компонента «ЖД» ===
Для компонента '''«ЖД»''' доступна выгрузка заказов в формате Nemo.
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Формат Nemo ====
<div class="mw-collapsible-content">
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<?xml version="1.0" encoding="UTF-8"?>
<PNR>
<Common>
<id>123456</id>
<Type>TRAINS</Type>
<Service>UFS</Service>
<Locator>64345987</Locator>
<BeginDateTime>2014.04.26-00:15</BeginDateTime>
<EndDateTime>2014.04.26-13:33</EndDateTime>
<TicketingDateTime>2014.06.06-15:10</TicketingDateTime>
<VoidDateTime>2014.06.07-14:19</VoidDateTime>
<TotalPrice>
<Amount>57505.8</Amount>
<CurrencyCode>RUB</CurrencyCode>
</TotalPrice>
<UserId>123</UserId>
<EEUserId />
<UserLogin>mikhalevtur</UserLogin>
<GroupId>122</GroupId>
<UserStatus>Менеджер</UserStatus>
<DateCreate>2014.04.24-15:03</DateCreate>
</Common>
<Payment>
<Title>Testpay</Title>
<Method>Testpay</Method>
<BillingId>117603370</BillingId>
<Date>2014-04-24 15:10:12</Date>
<CreateDate>2014-06-06 15:10:00</CreateDate>
<Status>cancelled</Status>
<PenaltyDate />
<Timelimit>2014-04-24 15:18:01</Timelimit>
<Charge>
<Amount>52278</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Charge>
<Book>
<Amount>5227.8</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Book>
<Penalty>
<Amount>0</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Penalty>
<TotalAgencyChargeForRefund>
<Amount>100</Amount>
<CurrencyCode>RUB</CurrencyCode>
</TotalAgencyChargeForRefund>
<Total>
<Amount>57505.8</Amount>
<CurrencyCode>RUB</CurrencyCode>
</Total>
<PaidValue>
<Amount>0</Amount>
<CurrencyCode>RUB</CurrencyCode>
</PaidValue>
</Payment>
<Client>
<LastName>Сидоров</LastName>
<Name>Владимир</Name>
<MiddleName>Константинович</MiddleName>
<Number>1806326598</Number>
<Birth>1987-05-20</Birth>
<Email>mail@host.com</Email>
<Phone>+79871234567</Phone>
</Client>
<Passengers>
<Passenger>
<name>Владимир</name>
<middlename>Константинович</middlename>
<phone>
<country />
<city />
<number>+79271031610</number>
<expansion />
</phone>
<email>mlsdsar@gmail.com</email>
<nationality>RU</nationality>
<passenger_type>ADT</passenger_type>
<lastname>Сидоров</lastname>
<doc_type>C</doc_type>
<passport_number>1806326598</passport_number>
<passenger_id>1</passenger_id>
<gender>M</gender>
<date_of_birth>20.04.1984</date_of_birth>
<TotalPrice>28752.9</TotalPrice>
<FarePrice>2613.9</FarePrice>
<Charge>26139</Charge>
<RefundMoney>8649.3</RefundMoney>
<ChargeForRefund>100</ChargeForRefund>
<TicketNumber>74944708487545</TicketNumber>
<SeatNumber>033</SeatNumber>
<HasSeat>true</HasSeat>
</Passenger>
<Passenger>
<nationality>RU</nationality>
<middlename>Константинович</middlename>
<passenger_type>ADT</passenger_type>
<lastname>Сидоров</lastname>
<name>Иван</name>
<doc_type>C</doc_type>
<passport_number>1806326554</passport_number>
<passenger_id>2</passenger_id>
<gender>M</gender>
<date_of_birth>05.04.1984</date_of_birth>
<TotalPrice>28752.9</TotalPrice>
<FarePrice>2613.9</FarePrice>
<Charge>26139</Charge>
<TicketNumber />
<SeatNumber>034</SeatNumber>
<HasSeat>true</HasSeat>
</Passenger>
</Passengers>
<Info>
<trainNumber>098ХА</trainNumber>
<trainName />
<departureStation>МОСКВА КАЗ</departureStation>
<arrivalStation>КАЗАНЬ ПАС</arrivalStation>
<trainCategory>1</trainCategory>
<beginStation>Москва</beginStation>
<endStation>Казань</endStation>
<startDate>2014-04-26 00:15:00</startDate>
<endDate>2014-04-26 13:33:00</endDate>
<timeInRoad>47880</timeInRoad>
<carNumber>8</carNumber>
<carType>4</carType>
<choosenSeats>
<type>
<lower>1</lower>
</type>
<type>
<upper>1</upper>
</type>
<type>
<lower_side>0</lower_side>
</type>
<type>
<upper_side>0</upper_side>
</type>
<type>
<undefined>0</undefined>
</type>
</choosenSeats>
<choosenRange>
<start>0</start>
<end>0</end>
</choosenRange>
<serviceClass>В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.</serviceClass>
</Info>
</PNR>
</syntaxhighlight>
 
'''Элемент PNR'''
Элемент '''PNR''' — Passenger Name Record — запись, состоящая из группы отдельных элементов (полей), содержащих информацию об одном или более пассажирах, путешествующих вместе, и деталях путешествия.
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| Common
| Общая информация по заказу.
| Элементы id, Type, Service, Locator, BeginDateTime, EndDateTime, TicketingDateTime, TotalPrice, UserId, EEUserId, UserLogin, GroupId, UserStatus, DateCreate.
|-
| Payment
| Информация о стоимости, штрафах, статусе заказа.
| Элементы Status, PenaltyDate, Timelimit, Charge, Book, Penalty, Total, PaidValue.
|-
| Client
| Информация о заказчике.
| Элементы Name, MiddleName, Number, Birth, Email, Phone.
|-
| Passengers
| Записи о пассажирах.
| Элементы Passenger.
|-
| Info
| Типовая информация по заказу в контексте услуги.
| Элементы trainNumber, trainName, departureStation, arrivalStation, trainCategory, beginStation, endStation, startDate, endDate, timeInRoad, carNumber, carType, choosenSeats, choosenRange, serviceClass.
|}
 
'''Элемент Common'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| id
| Номер заказа в Немо.
| Число. Пример: 268281.
|-
| Type
| Тип услуги.
| Строка: Пример: FLIGHTS.<br/>Допустимые значения: <ul><li>FLIGHTS — авиа,</li><li>HOTELS — отели,</li><li>TRAINS — ЖД.</li></ul>
|-
| Service
| Поставщик услуги.
| Строка. Пример: UFS.
|-
| Locator
| Идентификатор в системе поставщика.
| Число. Пример: 65525140.
|-
| BeginDateTime
| Дата и время отправления первого сегмента.
| Дата и время. Пример: 2014.03.06-00:15.
|-
| EndDateTime
| Дата и время прибытия последнего сегмента.
| Дата и время. Пример: 2014.03.06-13:33.
|-
| TicketingDateTime
| Дата и время выписки билета.
| Дата и время. Пример: 2014.10.17-17:23
|-
| VoidDateTime
| Дата и время возврата билета.
| Дата и время. Пример: 2014.10.17-17:23
|-
| TotalPrice
| Общая стоимость заказа.
| Элементы Amount — номинал стоимости, CurrencyCode — валюта стоимости.
|-
| UserId
| Идентификатор пользователя в системе Немо, оформившего заказ.
| Число. Пример: 123.
|-
| UserLogin
| Логин пользователя в системе Немо, оформившего заказ.
| Строка. Пример: userLogin.
|-
| GroupId
| Идентификатор группы пользователя в системе Немо, оформившего заказ.
| Число. Пример: 122.
|-
| UserStatus
| Тип пользователя в системе Немо.
| Строка. Пример: Менеджер.
|-
| DateCreate
| Дата и время резервирования в системе поставщика.
| Дата и время. Пример: 2014.03.05-15:08
|}
 
'''Элемент TotalPrice'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| Amount
| Номинал.
| Число. Пример: 1884.
|-
| CurrencyCode
| Валюта.
| Строка (Код ISO 4217 alfa-3). Пример: RUB.
|}
 
'''Элемент Payment'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| Title
| Название платежного шлюза<sup>*</sup>.
| Строка. Пример: Testpay.
|-
| Method
| Тип формы оплаты<sup>*</sup>.
| Строка. Пример: Testpay.
|-
| BillingId
| Идентификатор транзакции Немо.
| Строка. Пример: 117603370.
|-
| Date
| Дата и время оплаты платежной транзакции Немо.
| Строка. Пример: 2014-04-24 15:10:12.
|-
| CreateDate
| Дата и время создания платежной транзакции Немо.
| Строка. Пример: 2014-06-06 15:10:00.
|-
| Status
| Статус заказа в системе Немо.
| Строка. Пример: booked.<br/>Допустимые значения:
<ul>
<li>pending — в ожидании,</li>
<li>booked — зарезервирован,</li>
<li>ticket — выписан,</li>
<li>cancelled — отменен.</li>
</ul>
|-
| PenaltyDate
| Дата и время наступления штрафных санкций.
| Дата и время. Пример: 2014-03-05 15:23:40.
|-
| Timelimit
| Таймлимит на оплату и подтверждение заказа.
| Дата и время. Пример: 2014-03-05 15:23:40.
|-
| Charge
| Сбор агентства.
| См. элемент Common.TotalPrice.
|-
| Book
| Тариф.
| См. элемент Common.TotalPrice.
|-
| Penalty
| Штраф.
<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' На данный момент параметр неактуален и при выгрузке всегда принимает нулевое значение.</span>
| См. элемент Common.TotalPrice.
|-
| TotalAgencyChargeForRefund
| Общий сбор агентства за возврат.
| См. элемент Common.TotalPrice.
|-
| Total
| Общая стоимость.
| См. элемент Common.TotalPrice.
|-
| PaidValue
| Оплачено.
| См. элемент Common.TotalPrice.
|}
 
<sup>*</sup> — список возможный платежных шлюзов:<br/>
Acquiro, Chronopay, Copayco, CourierNew, Deposit, EasyPay, GatelineNew, ITransfer, Invoice, Offices, PayU, Payture, Platron, PrivatBank, Qiwi, Rapida, Receipt, Sberbank, Sirena, Sirena2, UnitellerNew, WebMoney.
 
'''Элемент Client'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| Name
| Фамилия и имя заказчика.
| Строка. Пример: Иванов Иван.
|-
| MiddleName
| Отчество заказчика.
| Строка. Пример: Иванович.
|-
| Number
| Серия и номер документа.
| Строка. Пример: 1806123456.
|-
| Birth
| Дата рождения заказчика.
| Дата. Пример: 1984-06-30.
|-
| Email
| Адрес электронной почты заказчика.
| Строка. Пример: client@host.com.
|-
| Phone
| Номер телефона заказчика.
| Строка. Пример: +74951234567
|}
 
'''Элемент Passenger'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| lastname
| Фамилия пассажира.
| Строка. Пример: Сидоров.
|-
| name
| Имя пассажира.
| Строка. Пример: Владимир.
|-
| middlename
| Отчество пассажира.
| Строка. Пример: Константинович.
|-
| doc_type
| Тип документа.
| Строка. Пример: C.<br/>Допустимые значения:
<ul>
<li>C — Российский паспорт</li>
<li>P — Заграничный паспорт</li>
<li>A — Иностранный документ</li>
<li>S — Паспорт моряка</li>
<li>M — Военный билет</li>
<li>B — Свидетельство о рождении</li>
</ul>
|-
| passport_number
| Серия и номер документа.
| Строка. Пример: 1806123456.
|-
| gender
| Пол пассажира.
| Строка. Пример: M.<br/>Допустимые значения:
<ul>
<li>M — мужской</li>
<li>F — женский</li>
</ul>
|-
| date_of_birth
| Дата рождения пассажира.
| Дата. Пример: 20.05.1987.
|-
| nationality
| Гражданство пассажира.
| Строка (ISO 3166-1 Alpha-2). Пример: RU.
|-
| passenger_type
| Тип пассажира.
| Строка. Пример: ADT.<br/>Допустимые значения:
<ul>
<li>ADT — взрослый</li>
<li>CLD — ребенок до 10 лет<sup>*, **</sup></li>
<li>INF — ребенок до 5 лет<sup>*, ***</sup></li>
</ul>
|-
| passenger_id
| Порядковый номер пассажира в заказе.
| Число. Пример: 2.
|-
| TotalPrice
| Общая стоимость билета со сборами для данного пассажира.
| Число. Пример: 1934.
|-
| FarePrice
| Стоимость по тарифу тарифу.
| Число. Пример: 1884.
|-
| Charge
| Сбор агентства.
| Число. Пример: 50.
|-
| RefundMoney
| Сумма к возврату. Значение, полученное от поставщика, уменьшенное на сумму сбора агентства за возврат.
| Число. Пример: 1643.
|-
| ChargeForRefund
| Cбор агентства за возврат.
| Число. Пример: 100.
|-
| TicketNumber
| Номер билета.
| Число. Пример: 73944708472624.
|-
| SeatNumber
| Номер места.
| число. Пример: 21.
|-
| TariffType
| Наименование тарифа.
| Строка. Пример: ПОЛНЫЙ.
|-
| HasSeat
| Занимает ли пассажир отдельное место.
| Допустимые значения:<ul><li>true — с местом,</li><li>false — без места.</li></ul>
|}
 
<sup>*</sup> — Не включая верхний предел. Возраст ребенка определяется на день совершения поездки.
 
<sup>**</sup> — Нижний и верхний пределы определяются видом сообщения:
* от 5 до 10 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
* от 6 до 17 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
* от 4 до 12 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.
 
<sup>***</sup> — Верхний предел определяется видом сообщения:
* до 5 лет — Внутригосударственное сообщение, а также международное сообщение со странами-участниками СНГ, Литовской, Латвийской, Эстонской Республиками, Республикой Абхазия.
* до 6 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Россия-Финляндия.
* до 4 лет — Международное сообщение в дальнем зарубежье по глобальным ценам. Направление Восток-Запад.
 
'''Элемент Passenger'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| trainNumber
| Номер поезда.
| Строка. Пример: 098ХА.
|-
| trainName
| Имя фирменного поезда. Приходит от поставщика.
| Строка. Пример: Россия.
|-
| departureStation
| Станция отправления пассажира.
| Строка. Пример: МОСКВА КАЗ.
|-
| arrivalStation
| Станция прибытия пассажира.
| Строка. Пример: КАЗАНЬ ПАС.
|-
| trainCategory
| Тип поезда.
| Число. Пример: 1.<br/>Допустимые значения:
<ul>
<li>0 — неизвестный тип поезда</li>
<li>1 — скорый поезд</li>
<li>2 — фирменный поезд</li>
<li>3 — скоростной поезд</li>
<li>4 — фирменный скоростной поезд</li>
</ul>
|-
| beginStation
| Начальная станция в маршруте поезда.
| Строка. Пример: Казань
|-
| endStation
| Конечная станция в маршруте поезда.
| Строка. Пример: Москва
|-
| startDate
| Дата и время отправления со станции отправления пассажира.
| Дата и время. Пример: 2014-03-06 00:15:00.
|-
| endDate
| Дата и время прибытия со станции отправления пассажира.
| Дата и время. Пример: 2014-03-06 13:33:00.
|-
| timeInRoad
| Время в пути от станции отправления до станции прибытия пассажира.
| Число (секунд). Пример: 47880.
|-
| carNumber
| Номер вагона.
| Число. Пример: 7.
|-
| carType
| Тип вагона.
| Число. Пример: 1.<br/>Допустимые значения:
<ul>
<li>1 - общий вагон</li>
<li>2 - сидячий вагон</li>
<li>3 - плацкарта</li>
<li>4 - купе</li>
<li>5 - люкс</li>
<li>6 - мягкий</li>
<li>7 - неизвестный тип</li>
</ul>
|-
| choosenSeats
| Элемент описывает количество нижних, нижних боковых, верхних, верхних боковых мест.
| Элементы type.
|-
| choosenRange
| Выбранный диапазон мест в вагоне.
| Элементы start, end.
|-
| serviceClass
| Описание услуг. Приходит от поставщика.
| Текст. Пример: В стоимость входит - постельное белье. Наличие установки кондиционирования воздуха не гарантировано.
|}
 
'''Элемент type'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| lower
| Количество нижних мест.
| Число. Пример: 1.
|-
| upper
| Количество верхних мест.
| Число. Пример: 0.
|-
| lower_side
| Количество нижних боковых мест.
| Число. Пример: 1.
|-
| upper_side
| Количество верхних боковых мест.
| Число. Пример: 1.
|-
| undefined
| Количество мест неопределенного типа.
| Число. Пример: 0.
|}
 
'''Элемент choosenRange'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| start
| Начало выбранного диапазон мест в вагоне<sup>*</sup>.
| Число. Пример: 4.
|-
| end
| Конец выбранного диапазон мест в вагоне<sup>*</sup>.
| Число. Пример: 17.
|}
 
<sup>*</sup> — Если диапазон не был зада пользователем на этапе выбора мест, то поля start и end будут содержать нули.
</div>

Навигация

'