Изменения

Агентский API Отели

17 917 байт добавлено, 10:02, 7 октября 2013

→‎Бронирование

=== Бронирование ===

==== Запрос ====

Схема запроса позволяет указывать несколько услуг для бронирования сразу. Это было сделано с заделом на возможность расширения функциональности в будущем при сохранении совместимости.

Сейчас же необходимо указывать только 1 услугу-отель (элемент Item) в запросе на бронирование.

Для успешного запроса нужно указать:

#Услугу. В запросе не требуется перечислять все параметры из результатов поиска, достаточно указать уникальный ID результата.

#Информация о клиентах. Все клиенты перечисляются в отдельной ветке и нумеруются по порядку. Указатели (элементы с номером клиента), также добавляются в описание услуги.

#Заказчик. Указатель на одну персону.

WSDL (тестовый сервер): [http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking]

<soapenv:Header/>

<soapenv:Body>

<ver:booking>

<Items>

<Item>

<Rooms>

</Persons>

</Room>

</Persons>

</Room>

</Rooms>

</HotelBookData>

</Customer>

</Item>

</Items>

<Lastname>IVANOV</Lastname>

<Middlename>IVANOVICH</Middlename>

<Email>m.rudenko@mute-lab.com</Email>

</Document>

</Person>

<Lastname>PETROV</Lastname>

<Middlename>MIKHAILOVICH</Middlename>

<Email>m.rudenko@mute-lab.com</Email>

</Document>

</Person>

<Lastname>SIDOROV</Lastname>

<Middlename>SERGEEVICH</Middlename>

<Email>m.rudenko@mute-lab.com</Email>

</Document>

</Person>

</Persons>

</Booking>

</Request>

</Source>

</RequestBin>

</ver:booking>

</soapenv:Body>

</soapenv:Envelope>

</pre>

Элемент Booking.

{| style="width: 800px" class="wikitable"

|-

! scope="col" width="200" | Элемент

! scope="col" width="300" | Описание

! scope="col" width="300" | Допустимые значения

|-

| Items

| Обязательный. Массив элементов Item.

| Элемент Item

|-

| Customer

| Обязательный. Элемент установки заказчика.

|  

|-

| Persons

| Обязательный. Массив клиентов.

|  

|}

Данные об услугах записываются в элементы <Item>.

Элемент Item.

{| style="width: 800px" class="wikitable"

|-

! scope="col" width="200" | Элемент

! scope="col" width="300" | Описание

! scope="col" width="300" | Допустимые значения

|-

| HotelBookData

| Обязательный. В зависимости от типа объекта бронирования. В данный момент возможно указать только данные для отеля.

|  

|-

| Persons

| Необязательный. Привязка клиентов к услуге. Если не указаны, будут привязаны все из указанных в главном элементе Booking.

| [<Person Number=''"1"'' />]

|}

<u>Бронирование отеля.</u>

Для бронирования отеля необходимы следующие параметры:

# ID результата поиска - один отель

# ID выбранной категории этого отеля

# Распределение клиентов по комнатам.

Элемент HotelBookData.

{| style="width: 800px" class="wikitable"

|-

! scope="col" width="200" | Элемент

! scope="col" width="300" | Описание

! scope="col" width="300" | Допустимые значения

|-

| CacheId

| Обязательный. Идентификатор результата поиска для данного отеля в системе Nemo.

| Целое число

|-

| CategoryId

| Обязательный. Идентификатор категории.

| Целое число

|-

| Rooms

| Обязательный. Распределение клиентов по комнатам.

| Список элементов Room

|-

| Room

| Атрибут Id

Ид комнаты из результата поиска

Элемент Persons

| Целое число

|-

| Persons

| Обязательный.

Список людей

| Список элементов Person

|-

| Person

| Обязательный.

Атрибут Number

Номер пассажира из Booking ->Persons->Person->Number

|

Целое число

|}

<u>Информация о клиентах.</u>

Для успешного завершения бронирования нужно указать как минимум одного клиента. Максимальное число клиентов в текущей версии не ограничено.

Набор обязательных данных может меняться в зависимости от типов услуг в бронировании. Рекомендуемый набор обязательных параметров: Lastname, Name, DateOfBirth. Остальные обязательные параметры будут устанавливаться индивидуально при подключении к сервису.

Элемент Person.

{| style="width: 800px" class="wikitable"

|-

! scope="col" width="200" | Элемент

! scope="col" width="300" | Описание

! scope="col" width="300" | Допустимые значения

|-

| Атрибут Number

| Обязательный. Номер клиента, необходим для правильной привязки к услугам.

| Целое число

|-

| Type

| Обязательный.

Тип пассажира.

| Строка.

Возможные значения:

ADT

CLD

INF

|-

| Lastname

| Фамилия.

| Строка в произвольном формате.

|-

| Name

| Имя.

| Строка в произвольном формате.

|-

| Middlename

| Отчество.

| Строка в произвольном формате.

|-

| DateOfBirth

| Дата рождения.

| Формат гггг-мм-дд.

|-

| Phone

| Телефон.

Рекомендуемый формат:

+79871234567

| Строка

|-

| Email

| Электронный адрес.

| Строка

|-

| Gender

| Пол.

| MR - мужчина,

MS - женщина.

|-

| Document

| Документ

| Элемент Document

|}

Для некоторых услуг может потребоваться информация о документах.

Элемент Document.

{| style="width: 800px" class="wikitable"

|-

! scope="col" width="200" | Элемент

! scope="col" width="300" | Описание

! scope="col" width="300" | Допустимые значения

|-

| Атрибут Type

| Обязательный. Тип документа.

| P - загранпаспорт

C - внутренний гражданский паспорт

B - свидетельство о рождении

|-

| Series

| Необязательный. Серия документа. Можно указать слитно с номером в Number.

| Строка в произвольном формате

|-

| Number

| Обязательный. Номер документа.

| Строка в произвольном формате

|-

| IssueDate

| Необязательный. Дата выдачи документа.

| Формат гггг-мм-дд

|-

| ExpiryDate

| Необязательный. Дата истечения срока действия документа.

| Формат гггг-мм-дд

|}

==== Ответ ====

После выполнения запроса сразу поступит информация о бронировании. В первую очередь нужно внимательно проверить статусы <Status> всех услуг в бронировании. Если бронировалась услуга со статусом в результатах поиска RQ (по запросу), то статус скорее всего будет не равен «booked». Через некоторое время проверять реальный статус бука отправляя запрос на чтение данных о бронировании.

<SOAP-ENV:Body>

<ns1:bookingResponse>

<Items>

<Name>ADLON KEMPINSKI</Name>

<Rooms>

</Rooms>

</Category>

</Categories>

<Desc>Standard Twin</Desc>

<Meal>Full Breakfast</Meal>

</Service>

<Desc>Standard Twin</Desc>

<Meal>Full Breakfast</Meal>

</Service>

</Services>

<Rooms>

</Rooms>

</Hotel>

<Type>HOTELS</Type>

<Status>waiting</Status>

</Prices>

<Dates>

</Dates>

</Statuses>

</Customer>

</Persons>

</Item>

</Items>

<Lastname>IVANOV</Lastname>

<Middlename>IVANOVICH</Middlename>

<Email>m.rudenko@mute-lab.com</Email>

</Document>

</Person>

<Lastname>PETROV</Lastname>

<Middlename>MIKHAILOVICH</Middlename>

<Email>m.rudenko@mute-lab.com</Email>

</Document>

</Person>

<Lastname>SIDOROV</Lastname>

<Middlename>SERGEEVICH</Middlename>

<Email>m.rudenko@mute-lab.com</Email>

</Document>

</Person>

</Persons>

</Booking>

</Response>

</ResponseBin>

</ns1:bookingResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

</pre>

==== Ошибки ====

=== Выгрузка актуальных данных по заказу(ам) ===

==== Запрос ====

Сергей Михалёв

2804

правки