Просмотр кода страницы Веб-служба выписки

== Информация ==

Агентский АПИ выписки позволяет определить валидирующего перевозчика и значение комиссии от авиакомпании для брони, а также запустить процедуру выписки билета.

<span style="background-color:#fff0f5;"><span style="font-size:large;"><span style="color:#ff0000;">!</span></span> Как правило для выписки билета достаточно чтобы у заказа был статус "Оплачено". При включенной опции '''''«Для успешных бронирований производить оформление: автоматически после изменения статуса на "Оплачено"»''''' из раздела '''«Заказы»''' ⇨ '''«Настройки бронирования»''' билет будет автоматически выписан после оплаты.

В Nemo 2.0 в агентский сервис (интерфейс к серверу бронирования) добавлены дополнительные настройки для выписки авиабилетов. В новой версии АПИ позволяет:
 
*сообщать ВП (валидирующего перевозчика) по данной комбинации;
*сообщать комиссию по данной комбинации;
*сообщать эндорсменты по данной комбинации;
*принимать запрос на тикетинг;
*проверять наличие брони в ГДС;
*синхронизировать бронь;
*выписывать билет;
*войдировать билет.


== Общий формат запроса / ответа выписки ==
Данный запрос запускается после оплаты заказа, может быть запущен как в ручном режиме — пользователем, у которого есть на это права, так и автоматически. Выписать неоплаченный заказ через Nemo возможности нет. При запуске запроса на выписку также запускается процесс обновления заказа, в ходе которого сверяется цена и остальные параметры заказа, а также проверяется его актуальность. Заказы, с истекшим таймлимитом выписать нельзя.

WSDL: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=Ticketing

<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://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DTicketing">
   <soapenv:Header/>
   <soapenv:Body>
      <ver:Ticketing>
         <RequestBin>
            <Request>
               <Ticketing>
                  <BookID>?</BookID>
                  <!--BookID — Id заказа в системе Nemo-->
                  <ValCompany>?</ValCompany>
                  <!--ValCompany — валидирующий перевозчик (тот кто выписывает билет)-->
                  <Comission Amount="?" Percent="?" CurrencyCode="?"/>
                  <!--Comission Amount — комиссии, указываются или в валюте, или в процентах, для валюты обязательным является 
                   код валюты. Если указана и в валюте и в процентах, то у поставщика комиссия устанавливается в валюте-->
                  <!--Amount — комиссия в валюте-->
                  <!--Percent — комиссия в процентах-->
                  <!--CurrencyCode — код валюты комиссии-->
                  <PassengerFops>
                     <!--Zero or more repetitions:-->
                     <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 - код проверки подлинности карты платёжной системы, например, 123-->
                           </Fop>
                        </Fops>
                     </PassengerFop>
                  </PassengerFops>
               </Ticketing>
            </Request>
            <Source>
               <ClientId>?</ClientId>
               <!--ClientId — ID клиента в системе Nemo. Можно посмотреть/добавить в разделе
               "Администрирование" ⇨ "Веб-служба. Авторизация".-->
               <APIKey>?</APIKey>
               <!--APIKey — секретный ключ доступа к API Nemo. Можно посмотреть/добавить в разделе
               "Администрирование" ⇨ "Веб-служба. Авторизация".-->
               <Language>?</Language>
               <!--Language — язык, например: RU-->
               <Currency>?</Currency>
               <!-- Currency — валюта, например: RUB, EUR-->
            </Source>
         </RequestBin>
      </ver:Ticketing>
   </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</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://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DTicketing" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:TicketingResponse>
         <ResponseBin>
            <Response>
               <Ticketing ID="?" Status="?" Code="?">
               <!--ID — Id брони в системе Nemo, целое число, обязательный-->
               <!--Status — индикатор состояния брони, возможные значения:
                                                booked — забронировано,
                                                canceled — бронь отменена,
                                                ticket — выписана
                                                UNDEFINED — статус не определён-->
               <!--Code — код брони в системе поставщика-->
                  <QueryPlace xsi:nil="true"/>
                  <!--QueryPlace — положение брони в очереди, Number — номер брони в очереди-->
                  <Flight FlightId="?">
                  <!--FlightId — Id перелёта в системе Nemo-->
                     <WebService>?</WebService>
                     <!--WebService — поставщик перелёта-->
                     <ValCompany>?</ValCompany>
                     <!--ValCompany — код авиакомпании, являющейся валидирующим перевозчиком, IATA-->
                     <URL>?</URL>
                     <!--URL — ссылка на бронирование конкретного перелета-->
                     <Segments>
                        <Segment SegNum="?" SegGroupNum="?">
                        <!--SegNum — номер сегмента в перелёте-->
                        <!--SegGroupNum – номер плеча перелёта-->
                           <DepAirp CodeType="IATA">?</DepAirp>
                           <!--DepAirp — аэропорт отправления, например: MOW — любой аэропорт в г.Москва
                           или SVO — Шереметьево-->
                           <DepTerminal>?</DepTerminal>
                           <!--DepTerminal — терминал пункта отправления, если пустое значение,
                           то в аэропорту всего 1 терминал-->
                           <ArrAirp CodeType="IATA">?</ArrAirp>
                           <!--ArrAirp — аэропорт прибытия-->
                           <ArrTerminal>?</ArrTerminal>
                           <!--ArrTerminal — терминал пункта прибытия, если пустое значение,
                           то в аэропорту всего 1 терминал-->
                           <OpAirline>?</OpAirline>
                           <!--OpAirline — авиакомпания перевозчик, например: SU — Аэрофлот-->
                           <MarkAirline>?</MarkAirline>
                           <!--MarkAirline — авиакомпания, продающая перелёт-->
                           <MarkAirlineName>?</MarkAirlineName>
                           <!--MarkAirlineName - полное наименование АК на кириллице-->
                           <FlightNumber>?</FlightNumber>
                           <!--FlightNumber — номер рейса-->
                           <AircraftName>?</AircraftName>
                           <!--AircraftName - наименование воздушного судна-->
                           <AircraftType>?</AircraftType>
                           <!--AircraftType — тип воздушного судна, код-->
                           <DepDateTime>?</DepDateTime>
                           <!--DepDateTime — дата и время отправления, формат ГГГГ-MM-ДДTЧЧ:ММ:СС-->
                           <ArrDateTime>?</ArrDateTime>
                           <!--ArrDateTime — дата и время прибытия, формат ГГГГ-MM-ДДTЧЧ:ММ:СС-->
                           <StopNum>?</StopNum>
                           <!--StopNum — количество остановок-->
                           <BookingCodes>
                              <BookingCode ClassType="?">
                              <!--ClassType — класс перелета, например: economy-->
                                 <BookingCode>?</BookingCode>
                                 <!--BookingCode — код класса бронирования, у разных авиакомпаний один и тот же класс
                                 может записываться разными литерами, например: L-->
                              </BookingCode>
                           </BookingCodes>
                           <FlightTime>?</FlightTime>
                           <!--FlightTime — время перелёта в минутах-->
                           <TimeZone Departure="?" Arrival="?"/>
                           <!--Departure временная зона аэропорта отправления-->
                           <!--Arrival — временная зона аэропорта прибытия-->
                           <ETicket>?</ETicket>
                           <!--ETicket — признак электронного билета, значения: true / false-->
                        </Segment>
                     </Segments>
                     <PricingInfo Refundable="?">
                     <!--Refundable — возвратный/невозвратный, true/false. Если пустое, то не известно-->
                        <PassengerFare Type="?" Quantity="?">
                        <!--Type — тип пассажира, возможные значения: ADT — взрослые, CNN — дети,
                        INF — младенцы, INS — младенцы с местом-->
                        <!--Quantity — количество пассажиров данного типа-->
                           <BaseFare Currency="?" Amount="?"/>
                           <!--BaseFare — базовая стоимость, в базовой валюте. Currency — код валюты, Amount — значение цены-->
                           <EquiveFare Currency="?" Amount="?"/>
                           <!--EquiveFare — базовая стоимость, в эквивалентной валюте(валюте продажи).
                           Currency — код валюты, Amount — значение цены-->
                           <TotalFare Currency="?" Amount="?"/>
                           <!--TotalFare — суммарная стоимость, в эквивалентной валюте.
                           Currency — код валюты, Amount — значение цены-->
                           <Taxes>
                              <Tax CurCode="?" TaxCode="?" Amount="?"/>
                              <!--CurCode — код валюты, TaxCode — код таксы, Amount — сумма таксы-->
                           </Taxes>
                           <Tariffs>
                              <Tariff Code="?" SegNum="?"/>
                              <!--Code — код тарифа, SegNum — номер сегмента, к которому применён тариф-->
                           </Tariffs>
                           <FareCalc>?</FareCalc>
                           <!--FareCalc — строка расчёта цены-->
                           <LastTicketDateTime>?</LastTicketDateTime>
                           <!--LastTicketDateTime — дата и время таймлимита по выписке в формате ГГГГ-MM-ДДTЧЧ:ММ:СС-->
                        </PassengerFare>
                     </PricingInfo>
                     <Commission Currency="?">?</Commission>
                     <Charges Currency="?">?</Charges>
                     <!--Charges — сборы, Currency — код валюты-->
                     <TotalPrice Currency="?">?</TotalPrice>
                     <!--TotalPrice — итоговая цена, Currency — код валюты-->
                  </Flight>
                  <Agency Name="?">
                  <!--Name — название агентства-->
                     <Telephone Type="?">
                     <!--Type — тип номера, обязательный, возможные значения:
                     M — мобильный, H — домашний, B — рабочий, A — агенство-->
                        <!--Optional:-->
                        <PhoneNumber>?</PhoneNumber>
                        <!--PhoneNumber — номер телефона-->
                        <!--Optional:-->
                        <CountryAccessCode>?</CountryAccessCode>
                        <!--CountryAccessCode — код страны-->
                        <!--Optional:-->
                        <AreaCityCode>?</AreaCityCode>
                        <!--AreaCityCode — код региона/города-->
                     </Telephone>
                     <Address City="?" State="?" StreetAddress="?" PostalCode="?" CountryCode="?"/>
                     <!--City — город-->
                     <!--State — штат-->
                     <!--StreetAddress — адрес в городе (улица, дом, корпус, офис и т.д.)-->
                     <!--PostalCode — почтовый индекс-->
                     <!--CountryCode — код страны (RU, UA и т.п.)-->
                  </Agency>
                  <ItinReceipts Encoding="?" Format="?">
                  <!--ItinReceipts — маршрут квитанция, Encoding — кодировка, Format — формат-->
                  <FareStored xsi:nil="true"/>
                   <PaymentTransactions>
                     <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 — оплачено, частично
                                         fully_paid — оплачено, полностью-->
                  <Travellers>
                     <!--Zero or more repetitions:-->
                     <Traveller Type="?" IsContact="?" LinkedTo="?" Num="?" TravellerId="?">
                     <!--Type — тип пассажира, обязательный, возможные значения: ADT — взрослые,
                     CNN — дети со взрослыми,UNN — дети без сопровождения взрослых, INF — младенцы, INS — младенцы с местом-->
                     <!--IsContact — если true — то данный пассажир является контактным лицом, если false — то не является,
                      контактное лицо может быть только 1, если среди пассажиров есть взрослые, то только кто-то из них
                     может быть контактным лицом, по умолчанию false-->
                     <!--Num — порядковый номер пассажира, начинается с 1-->
                     <!--LinkedTo — номер взрослого, к которому привязан младенец/ребёнок-->
                     <!--TravellerId — устаревший параметр, не используется-->
                        <Meal>?</Meal>
                        <!--Meal — код типа питания, возможные значения:
                                                NONE — отсутствует
                                                AVML — Азиатская вегетарианская кухня
                                                BLML — Блюда щадящей диеты
                                                CHML — Детское питание
                                                CHPC — Детский холодный завтрак
                                                СНСС — Детский горячий завтрак
                                                CHHC — Детский ланч, ветчина и сыр
                                                PBJS — Детский ланч, ореховое масло
                                                CHMC — Детский обед макароны с сыром
                                                DBML — Диабетическое питание
                                                FPML — Фрукты
                                                GFML — Питание без клейковины
                                                HFML — Питание богатое клетчаткой
                                                HNML — Индусская кухня
                                                BBML — Питание для младенцев
                                                KSML — Кошерная кухня
                                                SMKB — Кошерный завтрак
                                                SMKL — Кошерный ланч
                                                SMKD — Кошерный обед
                                                LPML — Малобелковое питание
                                                LCML — Низкокалорийное питание
                                                LFML — Низкохолестериновое питание
                                                PRML — Низкопуриновое питание
                                                LSML — Малосоленое питание
                                                MOML — Мюсли
                                                NLML — Безмолочные продукты
                                                ORML — Восточная кухня
                                                RVML — Сырые овощи
                                                SFML — Морепродукты
                                                SPML — Особое питание
                                                VLML — Вегетарианское, молоко и яйца
                                                VGML — Строго вегетарианское питание
                                                VJML — Джайнизское вегетарианское
                                                VOML — Восточное вегетарианское питание-->
                        <PersonalInfo DateOfBirth="?" Nationality="?" Gender="?">
                        <!--DateOfBirth — дата рождения в формате ДД.ММ.ГГГГ (например 31.12.2000)-->
                        <!--Nationality — гражданство, двух буквенный код страны (RU, UA, US и т.д.)-->
                        <!--Gender — пол пассажира, возможные значения: M — мужской(Male), F — женский(Female)-->
                           <FirstName>?</FirstName>
                           <!--FirstName — имя пассажира-->
                           <LastName>?</LastName>
                           <!--LastName — фамилия пассажира-->
                           <!--Optional:-->
                           <MiddleName>?</MiddleName>
                           <!--MiddleName — отчество пассажира-->
                        </PersonalInfo>
                        <LoyaltyCard OpCode="?" Number="?"/>
                        <!--OpCode — код авиакомпании-->
                        <!--Number — номер карточки-->
                        <ContactInfo>
                           <!--Optional:-->
                           <EmailID>?</EmailID>
                           <!--EmailID — контактный email-->
                           <!--Optional:-->
                           <Telephone Type="?">
                           <!--Type — тип номера, возможные значения: M — мобильный, H — домашний, B — рабочий-->
                              <!--Optional:-->
                              <PhoneNumber>?</PhoneNumber>
                              <!--PhoneNumber — номер телефона-->
                              <!--Optional:-->
                              <CountryAccessCode>?</CountryAccessCode>
                              <!--CountryAccessCode — код страны-->
                              <!--Optional:-->
                              <AreaCityCode>?</AreaCityCode>
                              <!--AreaCityCode — код региона/города-->
                           </Telephone>
                        </ContactInfo>
                        <DocumentInfo DocType="?" DocNum="?" CountryCode="?" DocElapsedTime="?"/>
                        <!--DocType — тип документа, возможные значения:
                                                                Р — Паспорт
                                                                A – Паспорт иностранца
                                                                С — Внутренний гражданский паспорт
                                                                F – Документ заменяющий паспорт
                                                                М — Воинское удостоверение
                                                                N – Сертификат натурализации(специфичный документ США)
                                                                T – Док.повторного въезда, паспорт беженца
                                                                V – Документ для пересечения границы-->
                        <!--DocNum — номер документа-->
                        <!--CountryCode — двух буквенный код страны выдачи паспорта (RU, UA, US и т.д.)-->
                        <!--DocElapsedTime — срок истечения срока действия паспорта в ДД.ММ.ГГГ (например 31.12.2000)-->
                        <AcquiredDocuments >
                        <VisaInfo Num="?" IssueCountry="?" IssuePlace="?" BirthCountry="?" BirthCity="?" IssueDate="?"/>
                        <!--Num — номер визы-->
                        <!--IssueDate — дата(ДД.ММ.ГГГГ) выдачи визы-->
                        <!--IssueCountry — страна выдачи визы-->
                        <!--IssuePlace — место выдачи визы-->
                        <!--BirthCountry — страна рождения(IATA код страны)-->
                        <!--BirthCity — город рождения(название)-->
                        <ArrAddress City="?" State="?" StreetAddress="?" PostalCode="?" CountryCode="?"/>
                        <!--City — город-->
                        <!--State — штат или область въезда-->
                        <!--StreetAddress — адрес: улица, номер дома, квартиры и т.д.-->
                        <!--PostalCode — почтовый код-->
                        <!--CountryCode — код страны-->
                        <PreferedPlace SmokingAllowed="?" Location="?" RowNumber="?" PlaceNumber="?" SegNumber="?"/>
                        <!--Если указаны номер ряда и номер места, то параметры SmokingAllowed и Location игнорируются-->
                        <!--SmokingAllowed — булевское значение, true — место для курящих, false — место для некурящих-->
                        <!--Location — положение места в ряде, возможные значения:
                                                        W — у окна (Window)
                                                        M — где-то в середине ряда (Middle)
                                                        NPW — возле прохода (NearPassengerWay)
                                                        NS — нет предпочтения (NotSpecified)-->
                        <!--RowNumber — номер ряда-->
                        <!--PlaceNumber — номер места-->
                        <!--SegNumber — номер сегмента-->
                        <DocStringFormats>
                           <!--Zero or more repetitions:-->
                           <DocStringFormat>?</DocStringFormat>
                           <!--DocStringFormat — формат паспортной строки, возможные значения:
                           DOCS — строка формата DOCS, FOID — строка формата FOID-->
                        </DocStringFormats>
                     </Traveller>
                  </Travellers>
               </BookFlight>
               <Requisites/>
               <RequestType xsi:nil="true"/>
               <UserID xsi:nil="true"/>
               <Errors>
                  <Error Code="?">
                  <!--Code — код ошибки в системе Nemo-->
                     <ServiceErrorMessage>?</ServiceErrorMessage>
                     <!--ServiceErrorMessage — сообщение об ошибке полученное от веб-сервиса поставщика-->
                     <Message>?</Message>
                     <!--Message — сообщение об ошибке от системы Nemo-->
                  </Error>
               </Errors>
            </Response>
         </ResponseBin>
      </ns1:TicketingResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</syntaxhighlight>
</div>
</div>

== Общий формат запроса / ответа войдирования ==
Данный запрос запускается после выписки билета, если необходимо его отменить.

WSDL: http://CLIENT_DOMAIN/nemoflights/wsdl.php?for=VoidTicket

<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://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DVoidTicket">
   <soapenv:Header/>
   <soapenv:Body>
      <ver:VoidTicket>
         <RequestBin>
            <Request>
               <VoidTicket>
                  <BookID>?</BookID>
                  <!--BookID — Id брони в системе Nemo, целое число-->
               </VoidTicket>
            </Request>
            <Source>
               <ClientId>?</ClientId>
               <!--ClientId — ID клиента в системе Nemo. Можно посмотреть/добавить в разделе
               "Администрирование" ⇨ "Веб-служба. Авторизация".-->
               <APIKey>?</APIKey>
               <!--APIKey — секретный ключ доступа к API Nemo. Можно посмотреть/добавить в разделе
               "Администрирование" ⇨ "Веб-служба. Авторизация".-->
               <Language>?</Language>
               <!--Language — язык, например: RU-->
               <Currency>?</Currency>
               <!-- Currency — валюта, например: RUB, EUR-->
            </Source>
         </RequestBin>
      </ver:VoidTicket>
   </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</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://CLIENT_DOMAIN/nemoflights/?version%3D1.0%26for%3DVoidTicket" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:VoidTicketResponse>
         <ResponseBin>
            <Response>
               <VoidTicket BookID="?">
               <!--BookID — Id брони в системе Nemo, целое число-->
                  <Result Success="?"/>
                  <!--Sucscess — результат отмены выписки, true или false-->
               </VoidTicket>
               <Requisites/>
               <RequestType xsi:nil="true"/>
               <UserID xsi:nil="true"/>
               <Errors xsi:nil="true"/>
            </Response>
         </ResponseBin>
      </ns1:VoidTicketResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</syntaxhighlight>
</div>
</div>

== См. также ==

*[[Агентский АПИ]]
*[[Бронирование]]

[[Категория:Интеграция]]