0% found this document useful (0 votes)
2 views27 pages

BookingAPI Group

Uploaded by

unishaktmtrip
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
2 views27 pages

BookingAPI Group

Uploaded by

unishaktmtrip
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

September

This document contain XML Application Program Interface (API) document and
implementation guide to integrate airlines booking engine with Nepal’s Domestic
Airlines Reservation and E-Ticketing System.

Plasma Technologist (P) Ltd


64Sangam Marg,Kathmandu
Tel -977 1 4420735/4439095
E-Mail- info@[Link]

0
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

UNITED SOLUTIONS
(AIRLINE RESERVATION SYSTEM)

API Implementation Guide

S/N DETAIL

1 INTRODUCTION
2 REQUIREMENT
3 AUDIENCE OF THIS DOCUMENT
4 FUNCTIONS LIST
5 RESERVATION PROCESS
6 SECTOR CODE
7 CHECK BALANCE
8 FLIGHT AVAILABILITY
9 RESERVATION
10 ISSUE TICKET
11 GET ITINERARY
12 GET FLIGHT DETAIL

13 SALES REPORT
14 GET PNR DETAIL
15 TEST ENVIRONMENT
16 API SUPPORT CONTACT

1
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

INTRODUCTION
This document provides the technical information necessary to integrate (United Solutions) Nepal’s
Domestic Airlines Reservation System API. This document also includes all functions and requires
parameters including SOAP request and response sample. The United Solutions API enables you to
integrate Reservation and Ticketing functions described in this document..

AUDIENCE OF THIS DOCUMENT


The target audiences of this document are the integrators or programmers who will develop the
interface between the Booking Interface and the United Solutions API. This document also include
code sample in JAVA and can be used as a guide for your application integration.

Functions
S/N Function Description Response

1 SectorCode Return Sector Name and Sector Code XML

2 CheckBalance Return Agency Balance Amount XML

Return Available flights detail of given flight date and


3 FlightAvailability XML
sector

4 Reservation Reserved seats and hold for payment process XML

5 IssueTicket Proceed payment of hold seats and generate ticket XML

6 GetItinerary Return PNR or Ticket detail XML

7 GetFlightDetail Return Detail of given FlightID XML

Return URL for PNR Maintenance


8 GetPnrDetail XML
(Reschedule/Cancellation)

9 SalesReport Return Sales Report for given period XML

2
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Reservation Process

S/N Process Description

Search flights available for given date and sector.


1 FlightAvailability A unique flight ID shall be returned for Select flight ID of appropriate
flight/class.

Call Reservation with selected flight ID.


Reservation Response with PNR Number and Reservation Status.
You can proceed IssueTicket call is Reservation Status is HK.
2 Reservation
This function holds your booking for a defined time period.
Time limit to issue ticket is included in Reservation response.
User should complete issue ticket operation within the time limit.

Call issue ticket function if Reservation call is successful and a PNR number is
returned from reservation call.
3 IssueTicket IssueTicket function issue tickets and return Flight itinerary if successful.
IssueTicket function should be called before TTL time expire.
Otherwise, do not call issue ticket function.

3
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

UNITED SOLUTIONS
FUNCTIONS AND EXAMPLE

Function Name SectorCode

Description Return sector code and sector name

Output XML

Parameters

Name Data Type Description

strUserId String User ID provided by Airline

Request Sample -1
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:SectorCode>
<strUserId>USERID</strUserId>
</book:SectorCode>
</soapenv:Body>
</soapenv:Envelope>

Request Sample -2
package bookingService;
import [Link];
import [Link];
public class sampleCode {
public static void main(String[] args)
{
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice =[Link]();
[Link]("USERID");
}}

4
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Response Sample
<S:Envelope xmlns:S="[Link]
<S:Body>
<ns2:SectorCodeResponse xmlns:ns2="[Link]
<return><![CDATA[<FlightSector>
<Sector>
<SectorCode>BDP</SectorCode>
<SectorName>BHADRAPUR</SectorName>
</Sector>
<Sector>...........</Sector>
<Sector>............</Sector>
<Sector>...........</Sector>
</FlightSector>]]></return>
</ns2:SectorCodeResponse>
</S:Body>
</S:Envelope>

Function Name CheckBalance


Description Return balance amount
Output XML
Parameters
Name Data Type Description
strUserId String User ID provided by Airline
U4 – Buddha Air, S1-Saurya Airlines, RMK-Simrik
strAirlineID String Airlines, YT-Yeti Airlines, GA-Goma Airlines, SHA-Shree
Airlines, ST-Sita Air

Request Sample 1
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:CheckBalance>
<strUserId>USERID</strUserId>
<strAirlineId>U4</strAirlineId>
</book:CheckBalance>
</soapenv:Body></soapenv:Envelope>

5
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Request Sample 2
package bookingService;
import [Link];
import [Link];
public class checkBalance {
public static void main(String[] args)
{
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("USERID", "AIRLINEID");
}}

Response Sample
<S:Envelope xmlns:S="[Link]
<S:Body>
<ns2:CheckBalanceResponse xmlns:ns2="[Link]
<return>
<![CDATA[<Balance>
<Airline>
<AirlineName>BUDDHA AIR</AirlineName>
<AgencyName>AGENT NAME</AgencyName>
<BalanceAmount>1244764.41</BalanceAmount>
</Airline>
<Airline>
<AirlineName>SAURYA AIR</AirlineName>
<AgencyName>AGENT NAME</AgencyName>
<BalanceAmount>12464.41</BalanceAmount>
</Airline>
<Airline>
<AirlineName>SHREE AIR</AirlineName>
<AgencyName>AGENT NAME</AgencyName>
<BalanceAmount>15421.00</BalanceAmount>
</Airline>
</Balance>]]></return>
</ns2:CheckBalanceResponse>
</S:Body></S:Envelope>

6
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Function Name FlightAvailability

Description Return available flights for given date and sector

Output XML

Parameters

Name Data Type Description

strUserId String User ID

strPassword String Password

strAgencyId String Agency ID

Origin Sector (3-Letter Sector Codes returned from


strSectorFrom String
SectorCode())
Distination Sector (3-Letter Airport Codes returned from
strSectorTo String
SectorCode())

strFlightDate String Departure Date (Format : DD-MM-YYYY/DD-MON-YYYY)

strTripType String (O/R) O=One Way / R=Round Trip

strReturnDate String Return Date (Format : DD-MM-YYYY/DD-MON-YYYY)

strNationality String ISO 2-letter (A-2) country codes

intAdult String Number of Adult

intChild String Number of Child

strClientIP String IP Address of passenger (end user) searching for flight

Note: strClientIP is mandatory. You may also provide your b2b agent's userid in strClientIP
parameter.

Request Sample 1
package bookingService;
import [Link];
import [Link];
public class sampleCode {public static void main(String[] args){
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("USERID", "PASSWORD", "AGENTID", "KTM", "PKR", "30-DEC-
2014", "01-JAN-2015", "R", "US", "2", "1","[Link]")); } }

7
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Request Sample 2
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:FlightAvailability>
<strUserId>SAURYA</strUserId>
<strPassword>PASSWORD</strPassword>
<strAgencyId>PLZ501</strAgencyId>
<strSectorFrom>KTM</strSectorFrom>
<strSectorTo>BDP</strSectorTo>
<strFlightDate>16-JUN-2024</strFlightDate>
<strReturnDate></strReturnDate>
<strTripType>O</strTripType>
<strNationality>NP</strNationality>
<intAdult>1</intAdult>
<intChild>0</intChild>
<strClientIP>111</strClientIP>
</book:FlightAvailability>
</soapenv:Body>
</soapenv:Envelope>

Response Sample
<Flightavailability>
<Outbound>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>
<FlightNo>S1303</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>09:00</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>09:35</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>d6c65563-7da2-4527-bf70-54ee0f8c808e</FlightId>
<FlightClassCode>S</FlightClassCode>

8
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<Currency>NPR</Currency>
<AdultFare>4891.5</AdultFare>
<ChildFare>4891.5</ChildFare>
<InfantFare>0</InfantFare>
<ResFare>0</ResFare>
<FuelSurcharge>0</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>591.5</AdultVAT>
<ChildVAT>591.5</ChildVAT>
<Refundable>F</Refundable>
<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>null</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>
<FlightNo>S1303</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>09:00</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>09:35</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>306f4a84-c2a7-4aaa-b36e-bb02008223e4</FlightId>
<FlightClassCode>R</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>3393.5</AdultFare>
<ChildFare>3393.5</ChildFare>
<InfantFare>0</InfantFare>
<ResFare>0</ResFare>
<FuelSurcharge>1950</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>643.5</AdultVAT>
<ChildVAT>643.5</ChildVAT>
<Refundable>F</Refundable>

9
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>null</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>
<FlightNo>S1303</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>09:00</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>09:35</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>cbbabdf0-115a-47e8-ba7c-bca3aa1908ab</FlightId>
<FlightClassCode>Q</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>3845.5</AdultFare>
<ChildFare>3845.5</ChildFare>
<InfantFare>0</InfantFare>
<ResFare>0</ResFare>
<FuelSurcharge>1950</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>695.5</AdultVAT>
<ChildVAT>695.5</ChildVAT>
<Refundable>F</Refundable>
<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>null</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>

10
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<FlightNo>S1303</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>09:00</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>09:35</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>9e0fe856-081c-4166-8e21-b6ee49f6c02a</FlightId>
<FlightClassCode>P</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>5201.5</AdultFare>
<ChildFare>5201.5</ChildFare>
<InfantFare>0</InfantFare>
<ResFare>0</ResFare>
<FuelSurcharge>1950</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>851.5</AdultVAT>
<ChildVAT>851.5</ChildVAT>
<Refundable>T</Refundable>
<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>100</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>
<FlightNo>S1303</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>09:00</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>09:35</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>4873aedd-9ec9-44e3-a34b-c3c55af2e2ab</FlightId>

11
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<FlightClassCode>O</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>6557.5</AdultFare>
<ChildFare>6557.5</ChildFare>
<InfantFare>0</InfantFare>
<ResFare>0</ResFare>
<FuelSurcharge>1950</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>1007.5</AdultVAT>
<ChildVAT>1007.5</ChildVAT>
<Refundable>T</Refundable>
<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>100</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>
<FlightNo>S1303</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>09:00</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>09:35</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>9c9ef39b-e48b-4891-9486-fef8dca5154f</FlightId>
<FlightClassCode>N</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>7913.5</AdultFare>
<ChildFare>5396.43</ChildFare>
<InfantFare>675</InfantFare>
<ResFare>11812.5</ResFare>
<FuelSurcharge>1950</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>1163.5</AdultVAT>
<ChildVAT>873.93</ChildVAT>

12
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<Refundable>T</Refundable>
<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>100</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
<Availability>
<Airline>S1</Airline>
<AirlineLogo>[Link]
<FlightDate>16-JUN-2024</FlightDate>
<FlightNo>S1301</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>11:10</DepartureTime>
<Arrival>BHADRAPUR</Arrival>
<ArrivalTime>11:45</ArrivalTime>
<AircraftType>CRJ200</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>688c06a4-64b3-4ae5-94fc-4b7c643cc990</FlightId>
<FlightClassCode>N</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>7913.5</AdultFare>
<ChildFare>5396.43</ChildFare>
<InfantFare>675</InfantFare>
<ResFare>11812.5</ResFare>
<FuelSurcharge>1950</FuelSurcharge>
<Tax>250</Tax>
<AdultVAT>1163.5</AdultVAT>
<ChildVAT>873.93</ChildVAT>
<Refundable>T</Refundable>
<FreeBaggage>20 + 5 KG</FreeBaggage>
<AgencyCommission>200</AgencyCommission>
<ChildCommission>100</ChildCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>SAURYA</CallingStation>
</Availability>
</Outbound>
<Inbound/>
</Flightavailability>

13
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

NOTE:

FlightId Should be retain and pass in Reservation() and IssueTicket() request parameter.
Outbound FlightId should be passed as "strFlightId" and Inbound FlightId as "strReturnFlightId".
Total Adult Fare = AdultFare+ FuelSurcharge +Tax
Total Child Fare = ChildFare + FuelSurcharge +Tax + ChildTaxAdjustment
ResFare is fare for foreigners holding residential visa.(Not applicable for agency booking)
AgencyCommission is agency commission amount for Adult pax booking in particular FlightId.
ChildCommission is agency commission amount for Child Pax booking in particular FlightId.
Child Discounted Fare is applicable only in Upper class fare in all sectors except “Mountain Flight”.
Child fare for classes other then Upper Class is same as adult fare.
Infant ticket booking is not available from API. Infant Ticket shall be issued at Airport Check-In counter.

Function Name Reservation

Proceed reservation and hold seats on selected flights for maximum


Description
15 Min. IssueTicket() function should be completed within TTL time.

Output Success or Error XML

Parameters

Name Data Type Description


Flight Id retained from FlightAvailability
strFlightId String
Response.
Flight Id retained from FlightAvailability
strReturnFlightId String Response.(Inbound> This Parameter is optional
and require only when Round Trip is selected

Request Sample 1
package bookingService;
import [Link];
import [Link];
public class sampleCode {
public static void main(String[] args) {
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("4cbdb05f-c095-44eb-b957-d313d69d731a",
"c6bfdad0-6b99-4603-b8cb-2ff105b54fae"));
}}

14
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Request Sample 2
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:Reservation>
<!--Optional:-->
<strFlightId>4cbdb05f-c095-44eb-b957-d313d69d731a</strFlightId>
<strReturnFlightId >c6bfdad0-6b99-4603-b8cb-2ff105b54fae</strReturnFlightId>
</book:Reservation>
</soapenv:Body>
</soapenv:Envelope>

Response Sample
<S:Envelope xmlns:S="[Link]
<S:Body>
<ns2:ReservationResponse xmlns:ns2="[Link]
<ReservationDetail>
<PNRDetail>
<AirlineID>U4</AirlineID>
<FlightId>d27185d1-dc00-491e-88bf-17905b44c162</FlightId>
<PNRNO>TMPPNR</PNRNO>
<ReservationStatus>HK</ReservationStatus>
<TTLDate>29-DEC-2014</TTLDate>
<TTLTime>12:20</TTLTime>
</PNRDetail>
</ReservationDetail>
</ns2:ReservationResponse>
</S:Body>
</S:Envelope>

15
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Function Name IssueTicket


Description Proceed payment and generate ticket.
Output Itinerary XML

Parameters

Name Data Type Description


Flight Id retained from FlightAvailability
strFlightId String
Response.
Flight Id retained from FlightAvailability
Response.(Inbound>
strReturnFlightId String
This Parameter is optional and require only when
Round Trip is selected

strContactName String Booking contact person

strContactEmail String Contact email address

strContactMobile String Contact mobile number

strPassengerDetail XML Passenger Detail XML ( Appendix-1)

strInvoiceParty String Invoice Party Name

strPanNo XML PAN Number of customer (if Available)

Request Sample
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:IssueTicket>
<strFlightId>249d4579-c0a0-4fbc-bf59-155c4b943a37</strFlightId>
<strReturnFlightId></strReturnFlightId>
<strContactName>CONTACT NAME</strContactName>
<strContactEmail>EMAIL ADDRESS</strContactEmail>
<strContactMobile>CONTACT NO</strContactMobile>
<strPassengerDetail>APPENDIX 1</strPassengerDetail>
<strInvoiceParty>INVOICE PARTY NAME</strInvoiceParty>
<strPanNo>PARTY PAN NO</strPanNo>
</book:IssueTicket>
</soapenv:Body>

16
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

</soapenv:Envelope>

APPENDIX 1
<![CDATA[<?xml version="1.0" ?>
<PassengerDetail>
<Passenger>
<PaxType>ADULT</PaxType>
<Title>Mr</Title>
<Gender>M</Gender>
<FirstName>FIRST NAME</FirstName>
<LastName>LAST NAME</LastName>
<Nationality>NP</Nationality>
<PaxRemarks>XYZ</PaxRemarks>
</Passenger>
</PassengerDetail>]]>

Response Sample
<S:Envelope xmlns:S="[Link]

<S:Body>

<ns2:IssueTicketResponse xmlns:ns2="[Link]

<Itinerary>
<Passenger>
<Airline>YT</Airline>
<PnrNo>A1R8UG</PnrNo>
<Title/>
<Gender>M</Gender>
<FirstName>MR BASU DEV GHIMIRE</FirstName>
<LastName/>
<PaxNo/>
<PaxType>ADULT</PaxType>
<Nationality>NP</Nationality>
<PaxId/>
<IssueFrom>PLZ008</IssueFrom>
<AgencyName>PLZ008</AgencyName>
<IssueDate>04-SEP-2017</IssueDate>
<IssueBy>ESEWA</IssueBy>
<FlightNo>893</FlightNo>
<FlightDate>05-SEP-2017</FlightDate>
<Departure>KTM</Departure>
<FlightTime>1630</FlightTime>
<TicketNo>9992102407881</TicketNo>
17
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<BarCodeValue/>
<BarcodeImage/>
<Arrival>BWA</Arrival>
<ArrivalTime>17:00</ArrivalTime>
<Sector>KTM-BWA</Sector>
<ClassCode>N</ClassCode>
<Currency>NPR</Currency>
<Fare>4065</Fare>
<Surcharge>1685</Surcharge>
<TaxCurrency>NPR</TaxCurrency>
<Tax>200</Tax>
<CommissionAmount>447.15</CommissionAmount>
<Refundable>Refundable</Refundable>
<ReportingTime>One Hour Before Flight Time</ReportingTime>
<FreeBaggage>10KG</FreeBaggage>
</Passenger>
</Itinerary>
</ns2:IssueTicketResponse>

</S:Body></S:Envelope>

Function Name GetItinerary

Description Return Itinerary Detail

Output XML
Parameters

Name Data Type Description

strPnoNo String PNR Number

strTicketNo String Ticket Number

strAirlineId String Airline ID

Request Sample 1
package bookingService;
import [Link];
import [Link];
public class sampleCode {public static void main(String[] args){
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("PNRNO","TICKETNO","AGENCYID");
}}
Request Sample 2
18
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/> <soapenv:Body>
<book:GetItinerary>
<strPnoNo>PNRNO</strPnoNo>
<strTicketNo>TICKET NO</strTicketNo>
<strAgencyId>AGENTID</strAgencyId>
</book:GetItinerary>
</soapenv:Body></soapenv:Envelope>

Response Sample
<S:Envelope xmlns:S="[Link]

<S:Body>

<ns2:IssueTicketResponse xmlns:ns2="[Link]

<Itinerary>

<Passenger>

<Airline>YT</Airline>

<PnrNo>A0X60N</PnrNo>

<Title></Title>

<Gender>F</Gender>

<FirstName>MISS SABITA RAI</FirstName>

<LastName></LastName>

<PaxNo></PaxNo>

<PaxType>ADULT</PaxType>

<Nationality>NP</Nationality>

<PaxId></PaxId>

<IssueFrom>PLZ004</IssueFrom>

<AgencyName>PLZ004</AgencyName>

<IssueDate>21-JAN-2014</IssueDate>

<IssueBy>IPAY</IssueBy>

<FlightNo>797</FlightNo>

<FlightDate>21-JAN-2014</FlightDate>

<Departure>KTM</Departure>

<FlightTime>1630</FlightTime>

<TicketNo>9992101191551</TicketNo>

<BarCodeValue>668402988</BarCodeValue>

<BarcodeImage> </BarcodeImage>
19
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<Arrival>BIR</Arrival>

<ArrivalTime>N/A</ArrivalTime>

<Sector>KTM-BIR</Sector>

<ClassCode>G</ClassCode>

<Currency>NPR</Currency>

<Fare>2290</Fare>

<Surcharge>3075</Surcharge>

<TaxCurrency>NPR</TaxCurrency>

<Tax>200</Tax>

<CommissionAmount>297.7</CommissionAmount>

<Refundable>Non-Refundable</Refundable>

<ReportingTime>One Hour Before Flight Time</ReportingTime>

<FreeBaggage>10KG</FreeBaggage>

</Passenger>

</Itinerary>

</ns2:IssueTicketResponse>

</S:Body></S:Envelope>

Function Name GetFlightDetail

Description Return Flight Detail of Given Flight ID

Output XML
Parameters

Name Data Type Description

strUserId String User ID

strFlightId String Flight ID

Request Sample 1
package bookingService;
import [Link];
import [Link];
public class sampleCode {
public static void main(String[] args)
{
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("USERID", "FLIGHTID");
}}
20
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

Request Sample 2
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:GetFlightDetail>
<strUserId>USERID</strUserId>
<strFlightId>FLIGHTID</strFlightId>
</book:GetFlightDetail>
</soapenv:Body>
</soapenv:Envelope>

Response Sample
<S:Envelope xmlns:S="[Link]
<S:Body>
<ns2:GetFlightDetailResponse xmlns:ns2="[Link]
<return>
<![CDATA[<Availability>
<Airline>YT</Airline>
<FlightDate>05-SEP-2017</FlightDate>
<FlightNo>YT893</FlightNo>
<Departure>KATHMANDU</Departure>
<DepartureTime>16:30</DepartureTime>
<Arrival>BHAIRAHAWA</Arrival>
<ArrivalTime>17:00</ArrivalTime>
<AircraftType>J41</AircraftType>
<Adult>1</Adult>
<Child>0</Child>
<Infant>0</Infant>
<FlightId>611dee5f-bc39-4d93-bf2d-4d86b5518bab</FlightId>
<FlightClassCode>N</FlightClassCode>
<Currency>NPR</Currency>
<AdultFare>4065</AdultFare>
<ChildFare>30</ChildFare>

21
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<InfantFare>406.5</InfantFare>
<ResFare>0</ResFare>
<FuelSurcharge>1685</FuelSurcharge>
<Tax>200</Tax>
<Refundable>T</Refundable>
<FreeBaggage>10 KG</FreeBaggage>
<AgencyCommission>813</AgencyCommission>
<CallingStationId>[Link]</CallingStationId>
<CallingStation>ESEWA</CallingStation>
</Availability>]]></return>
</ns2:GetFlightDetailResponse>
</S:Body>
</S:Envelope>

Error Response
<?xml version="1.0" ?><S:Envelope xmlns:S="[Link]
<S:Body><ns2:GetFlightDetailResponse xmlns:ns2="[Link]
<Error> Flight Detail Not Found in Flight Database</Error>
</ns2:GetFlightDetailResponse>
</S:Body>
</S:Envelope>

Function Name salesReport

Description Return Flight Detail of Given Flight ID

Output XML
Parameters

Name Data Type Description

strUserId String UserID

strPassword String Password

strAgencyId String Agency ID

strFromDate String Start Date (DD-MM-YYYY) OR (DD-MON-YYYY)

strToDate String End Date (DD-MM-YYYY) OR (DD-MON-YYYY)

Request Sample 1
package bookingService;
import [Link];
import [Link];
public class sampleCode {
public static void main(String[] args)

22
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

{
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("USERID","PASSWORD","AGENCYID","01-JAN-2014","30-JAN-2014");
} }

Request Sample 2
<soapenv:Envelope xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/><soapenv:Body>
<book:SalesReport>
<strUserId>USERID</strUserId>
<strPassword>PASSWORD</strPassword>
<strAgencyId>AGENCYID</strAgencyId>
<strPnrNo>STARTDATE</strPnrNo>
<strTicketNo>ENDDATE</strTicketNo>
</book:SalesReport>
</soapenv:Body> </soapenv:Envelope>

Response Sample
<SalesSummary>
<TicketDetail>
<PnrNo>A0S0AD</PnrNo>
<Airline>U4</Airline>
<IssueDate>06-AUG-2014</IssueDate>
<FlightNo>794</FlightNo>
<FlightDate>17-AUG-2014</FlightDate>
<SectorPair>BIR-KTM</SectorPair>
<ClassCode>H</ClassCode>
<TicketNo>9992100980153</TicketNo>
<PassengerMame>PASSENGERNAME</PassengerMame>
<Nationality>NP</Nationality>
<PaxType>ADULT</PaxType>
<Currency>NPR</Currency>
<Fare>990</Fare>
<FSC>3305</FSC>
<TAX>200</TAX>
</TicketDetail>
<TicketDetail>
<PnrNo>A0S0AD</PnrNo>
<Airline>U4</Airline>

23
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

<IssueDate>06-AUG-2014</IssueDate>
<FlightNo>794</FlightNo>
<FlightDate>17-AUG-2014</FlightDate>
<SectorPair>BIR-KTM</SectorPair>
<ClassCode>H</ClassCode>
<TicketNo>9992100980154</TicketNo>
<PassengerMame>PASSENGERNAME</PassengerMame>
<Nationality>NP</Nationality>
<PaxType>ADULT</PaxType>
<Currency>NPR</Currency>
<Fare>990</Fare>
<FSC>3305</FSC>
<TAX>200</TAX>
</TicketDetail>
<TicketDetail>
<PnrNo>A0S0AD</PnrNo>
<Airline>U4</Airline>
<IssueDate>06-AUG-2014</IssueDate>
<FlightNo>794</FlightNo>
<FlightDate>17-AUG-2014</FlightDate>
<SectorPair>BIR-KTM</SectorPair>
<ClassCode>H</ClassCode>
<TicketNo>9992100980155</TicketNo>
<PassengerMame>PASSENGERNAME</PassengerMame>
<Nationality>NP</Nationality>
<PaxType>ADULT</PaxType>
<Currency>NPR</Currency>
<Fare>990</Fare>
<FSC>3305</FSC>
<TAX>200</TAX>
</TicketDetail>
<SalesSummary>

Function Name getPnrDetail

Description Return URL for PNR Maintenance

Output XML
Parameters

Name Data Type Description

strUserId String UserID

strPassword String Password

24
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

strAgencyId String Agency ID

strPnr String PNR number require modification

strLastName String Last Name of one passenger present in PNR


Request Sample 1
package bookingService;
import [Link];
import [Link];
public class sampleCode {public static void main(String[] args) {
UnitedSolutionsService MyService = new UnitedSolutionsService();
UnitedSolutions bookingservice=[Link]();
[Link]("USERID", "PASSWORD","AGENCYID", "PNRNO", "LAST NAME" );
} }
Request Sample 2
<soapenv:Envelope
xmlns:soapenv="[Link]
xmlns:book="[Link]
<soapenv:Header/>
<soapenv:Body>
<book:GetPnrDetail>
<strUserId>USERID</strUserId>
<strPassword>PASSWORD</strPassword>
<strAgencyId>AGENCYID</strAgencyId>
<strPnrNo>PNRNO</strPnrNo>
<strLastName>LASTNAME</strLastName>
</book:GetPnrDetail>
</soapenv:Body>
</soapenv:Envelope>

Response Sample
<S:Envelope xmlns:S="[Link]
<S:Body> <ns2:GetPnrDetailResponse xmlns:ns2="[Link]
<PnrDetail>
<AccessURL>[Link]
sn=AAbFSRAKKSJJDKI2121SW5DWSAlZT971SkglukKD6XQfCcZLP/1/q
</AccessURL>
</PnrDetail>
</ns2:GetPnrDetailResponse>
</S:Body></S:Envelope>

Test Environment
[Link]
25
INFORMATION CONTAINED IN THIS MATERIAL IS CONFIDENTIAL AND PROPRIETARY TO PLAZMATECH AND ITS AFFILIATES AND
MAY NOT BE MODIFIED, COPIED, PUBLISHED, DISCLOSED, DISTRIBUTED, DISPLAYED OR EXHIBITED, IN EITHER ELECTRONIC OR
PRINTED FORMATS WITHOUT AUTHORIZATION OF AN OFFICER OF PLAZMATECH OR ITS AFFILIATES.

USERID: BUDB2C
PASSWORD: PASSWORD
AGENCYID: PLZ115
API Implementation Technical Support

API Technical Support Contact

Mr Ritesh Bista ritesh@[Link]


1 Software Engineer 977 1 4493674 977 1 4499496 cc:
PlazmaTech apisupport@[Link]

26

You might also like