Подробнее можно узнать в нашей специальной статье [http://support.nemo.travel/ru/%D0%90%D0%B3%D0%B5%D0%BD%D1%82%D1%81%D0%BA%D0%B8%D0%B9_API_%D0%9E%D1%82%D0%B5%D0%BB%D0%B5%D0%B9 Агентский АПИ отелей]
==== Штрафы за аннуляцию ====
Всегда в явном виде нужно указывать пользователю информацию о штрафах за аннуляцию до бронирования.
Штрафы получаются по каждой услуге отдельным запросом. Нужно указать тип услуги, идентификатор результата поиска и выбранную категорию.
Внимание. Для отелей из Hotelbeds (Supplier=HOTELBEDS) штрафы до бронирования получить невозможно.
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
===== Запрос =====
<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;">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
<soapenv:Header/>
<soapenv:Body>
<ver:penalty>
<RequestBin>
<Request>
<Penalty>
<Item>
<Type>HOTELS</Type>
<CacheId>1867246</CacheId>
<CategoryId>1</CategoryId>
</Item>
</Penalty>
</Request>
<Source>
<ClientId></ClientId>
<APIKey></APIKey>
<Language>ru</Language>
<Currency>RUB</Currency>
</Source>
</RequestBin>
</ver:penalty>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
Элемент '''Item'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| Type
| Обязательный. Тип объекта.
| HOTELS
|-
| CacheId
| Обязательный. Идентификатор результата поиска в системе Nemo.
| Целое число
|-
| CategoryId
| Обязательный. Идентификатор категории.
| Целое число
|}
Элемент '''Source'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| ClientID
| Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Целое число.
|-
| APIKey
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
===== Ответ =====
<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;">
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
<SOAP-ENV:Body>
<ns1:penaltyResponse>
<ResponseBin>
<Response>
<Penalty>
<ItemDateBegin>2013-10-15 00:00:00</ItemDateBegin>
<CancelCharges>
<Charge>
<DateFrom>2013-10-12 00:00:00</DateFrom>
<DateTo>2013-10-15 23:59:59</DateTo>
<Money Currency="RUB">74733.84</Money>
</Charge>
<Charge>
<DateFrom>2013-09-23 00:00:00</DateFrom>
<DateTo>2013-10-11 00:00:00</DateTo>
<Money Currency="RUB">67260.46</Money>
</Charge>
<Charge>
<DateFrom>2013-08-01 17:59:00</DateFrom>
<DateTo>2013-09-22 00:00:00</DateTo>
<Money Currency="RUB">12455.64</Money>
</Charge>
</CancelCharges>
<ModifyCharges/>
</Penalty>
</Response>
</ResponseBin>
</ns1:penaltyResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</syntaxhighlight>
Элемент '''Penalty'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| ItemDateBegin
| Обязательный. Дата начала услуги (дата заселения в отель).
| Формат гггг-мм-дд чч:мм:сс
|-
| CancelCharges
| Необязательный. Содержит информацию о штрафах за аннуляцию.
| Элемент Charge
|-
| ModifyCharges
| Необязательный. Содержит информацию о штрафах за модификацию.
| Элемент Charge
|}
Штрафы разбиваются по временным интервалам. На каждом интервале указывается значение штрафа.
Элемент '''Charge'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| DateFrom
| Обязательный. Дата/время начала интервала.
| Формат гггг-мм-дд чч:мм:сс
|-
| DateTo
| Необязательный. Дата/время окончания интервала.
| Формат гггг-мм-дд чч:мм:сс
|-
| Money
| Обязательный. Сумма штрафа.
| Вещественное число.
Атрибут: Currency - код валюты.
|}
</div>
</div>