662
правки
Изменения
Перейти к навигации
Перейти к поиску
Нет описания правки
[[Категория:Интеграция]]
<!-- -->
== Информация ==
Агентский АПИ выписки позволяет определить валидирующего перевозчика и значение комиссии от авиакомпании для брони, а также запустить процедуру выписки билета.
Как правило для выписки билета достаточно чтобы у заказа был статус "Оплачено"«Оплачено». При включенной опции '''''«Для {{Setting|Для успешных бронирований производить оформление: автоматически после изменения статуса на "Оплачено"''''' «Оплачено»}} из раздела '''«Заказы»''' ⇨ '''«Для техподдержки» → «Устаревшие настройки» → «Настройки бронирования»''' билет будет автоматически выписан после оплаты. Однако, это не является обязательным условием, так как реализован дополнительный функционал, предоставляющий возможность получения выписки билета, не требующей оплаты. Такая опция реализована настройкой '''''«Допустимые ip адреса»''''' {{Setting|Допустимые IP адреса}} в разделе '''''«Администрирование»''' ⇨ '''→ «Веб-сервисы»''''', определяющей диапазон ipIP-адресов, для которых будет доступно получение выписки без оплаты. IP-адреса имеют следующий допустимый формат: 125.125.25.5/8, то есть возможно задавать с маской подсети. При этом если диапазон допустимых ipIP-адресов не задан, то выписка билета, не требующая оплаты, будет допустима всем.
В Nemo 2.0 в агентский сервис (интерфейс к серверу бронирования) добавлены дополнительные настройки для выписки авиабилетов. В новой версии АПИ позволяет:
* сообщать ВП (валидирующего перевозчика) по данной комбинации;
* сообщать комиссию по данной комбинации;
* сообщать эндорсменты по данной комбинации;
* принимать запрос на тикетинг;
* проверять наличие брони в ГДСГРС;
* синхронизировать бронь;
* выписывать билет;
== Общий формат запроса / ответа выписки ==
Данный запрос запускается после оплаты заказа, может быть запущен как в ручном режиме — пользователем, у которого есть на это права, так и автоматически. Выписать неоплаченный заказ через Nemo {{NameSystem}} возможности нет. При запуске запроса на выписку также запускается процесс обновления заказа, в ходе которого сверяется цена и остальные параметры заказа, а также проверяется его актуальность. Заказы, с истекшим таймлимитом выписать нельзя.
WSDL: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=Ticketing
<Ticketing>
<BookID>?</BookID>
<!--BookID — Id заказа в системе Nemonemo.travel-->
<ValCompany>?</ValCompany>
<!--ValCompany — валидирующий перевозчик (тот кто выписывает билет)-->
<PassengerFop>
<PassengerId>?</PassengerId>
<!--PassengerId - — порядковый номер пассажира в перелете-->
<Fops>
<!--Zero or more repetitions:-->
<Fop>
<Type>?</Type>
<!--Type - — форма оплаты: CC (по кредитной карте) или СА (наличными)-->
<Money Currency="?">?</Money>
<!--Money - — сумма платежа--> <!--Currency - — код валюты-->
<VendorCode>?</VendorCode>
<!--VendorCode - — код типа карты: (например, VI - — Visa, MC - — MasterCard, AX - — American Express DC - — DCL, CA - — EURO, IK - — EURO, JB - — JCB, JC - — JCB, BA - — Visa)-->
<Number>?</Number>
<!--Number - — номер карты-->
<ExpireDate>?</ExpireDate>
<!--ExpireDate - — срок действия карты, например 12.2020-->
<ManualApprovalCode>?</ManualApprovalCode>
<!--ManualApprovalCode - Код преавторизации транзакции, по которой были заблокированы средства для выписки. Это НЕ CVV код. Необязательный. Если не указан, то он будет автоматически получен нашей системой через GDSГРС/-->
</Fop>
</Fops>
<DataItem>
<Type>Remark</Type>
<!--Type - — тип контента в данном блоке, например: Meal, Remark-->
<Remark>
<Type>?</Type>
<!--Type - — тип ремарки, например: General, Historical-->
<Text>?</Text>
<!--Text - — содержание ремарки-->
</Remark>
</DataItem>
<Source>
<ClientId>?</ClientId>
<!--ClientId — ID клиента в системе Nemonemo.travel. Можно посмотреть/добавить в разделе "Администрирование" ⇨ "Веб-служба«Настройки системы» → «Интеграция» → «Nemo 1. Авторизация"0 (SOAP API)».-->
<APIKey>?</APIKey>
<!--APIKey — секретный ключ доступа к API Nemonemo.travel. Можно посмотреть/добавить в разделе "Администрирование" ⇨ "Веб-служба«Настройки системы» → «Интеграция» → «Nemo 1. Авторизация"0 (SOAP API)».-->
<Language>?</Language>
<!--Language — язык, например: RU-->
<Response>
<Ticketing ID="?" Status="?" Code="?">
<!--ID — Id брони в системе Nemonemo.travel, целое число, обязательный-->
<!--Status — индикатор состояния брони, возможные значения:
booked — забронировано,
<!--QueryPlace — положение брони в очереди, Number — номер брони в очереди-->
<Flight FlightId="?">
<!--FlightId — Id перелёта в системе Nemonemo.travel-->
<WebService>?</WebService>
<!--WebService — поставщик перелёта-->
<!--FlightNumber — номер рейса-->
<AircraftName>?</AircraftName>
<!--AircraftName - — наименование воздушного судна-->
<AircraftType>?</AircraftType>
<!--AircraftType — тип воздушного судна, код-->
<Transaction>
<Id>?</Id>
<!--Id - — номер транзакции в Немо-->
<Status>?</Status>
<!--Status - — статус транзакции-->
<GatewayName>?</GatewayName>
<!--GatewayName - — название платежного шлюза-->
<MoneyPaid Currency="?">?</MoneyPaid>
<!--MoneyPaid - — сумма оплаты--> <!--Currency - — валюта-->
<PaymentDateTime>?</PaymentDateTime>
<!--PaymentDateTime - — дата и время оплаты-->
<CreateDateTime>?</CreateDateTime>
<!--CreateDateTime - — дата и время создания платежной транзакции-->
<Description/>
</Transaction>
</PaymentTransactions>
<PaymentStatus>?</PaymentStatus>
<!--PaymentStatus - — статус оплаты:
not_paid — не оплачено
partly_paid — оплачено, частично
<VoidTicket>
<BookID>?</BookID>
<!--BookID — Id брони в системе Nemonemo.travel, целое число-->
</VoidTicket>
</Request>
<Source>
<ClientId>?</ClientId>
<!--ClientId — ID клиента в системе Nemonemo.travel. Можно посмотреть/добавить в разделе "Администрирование" ⇨ "Веб-служба«Настройки системы» → «Интеграция» → «Nemo 1. Авторизация"0 (SOAP API)».-->
<APIKey>?</APIKey>
<!--APIKey — секретный ключ доступа к API Nemonemo.travel. Можно посмотреть/добавить в разделе "Администрирование" ⇨ "Веб-служба«Настройки системы» → «Интеграция» → «Nemo 1. Авторизация"0 (SOAP API)».-->
<Language>?</Language>
<!--Language — язык, например: RU-->
<Response>
<VoidTicket BookID="?">
<!--BookID — Id брони в системе Nemonemo.travel, целое число-->
<Result Success="?"/>
<!--Sucscess — результат отмены выписки, true или false-->
== См. также ==
*[[Агентский АПИ]]*[[Бронирование]] [[Категория:Интеграция]]
