Skip to main content

Flowchart​

Lets your users search for and book airport lounge access across a global network of terminals. The flow starts with fetching active contracts and available airport services, then narrows down to specific lounges by IATA code, features, and time window. Once a product is selected, an order is created and a PDF voucher is issued for the passenger.

Sequence diagram​

Lounge search and booking flow​

This scenario describes the interaction flow between the client and the ETT API via the WebApp for searching, filtering, booking lounges, and retrieving a voucher.

Overall process logic​

The process consists of the following steps:

  1. Retrieve available contracts
  2. Search for airports with lounges
  3. Retrieve the list of lounges
  4. Apply filters
  5. Create an order
  6. Retrieve order details
  7. Generate a voucher

The WebApp acts as an intermediary between the client and the ETT API.

1. Retrieve contracts​

  • Method: getContracts
  • Description: Retrieves the list of available contracts for the agent.
  • Result: A list of contracts available for further operations.

2. Search airports with lounges​

  • Method: getAirportServices(contractId, searchTerm)
  • Parameters:
    • contractId — selected contract identifier
    • searchTerm — search query (city, airport, etc.)
  • Description: Returns a list of airports where lounges are available.
  • Result: A list of airports with available lounges.

3. Retrieve lounges​

  • Method: getLounges(contractId, IATA)
  • Parameters:
    • contractId — contract identifier
    • IATA — airport code
  • Description: Returns a list of lounges for the selected airport.
  • Result: A list of available lounges.

4. Retrieve features​

  • Method: getFeatures
  • Description: Retrieves the list of available features for filtering lounges.
  • Result: A list of features with their identifiers.

5. Filter lounges​

  • Method:
    getLounges(contractId, IATA, featureIds, terminals, startDateTime, endDateTime, typesOfTerminals)
  • Parameters:
    • contractId — contract identifier
    • IATA — airport code
    • featureIds — list of feature IDs
    • terminals — list of terminals
    • startDateTime — start date and time
    • endDateTime — end date and time
    • typesOfTerminals — terminal types
  • Description: Returns a filtered list of lounges based on the provided criteria.
  • Result: A filtered list of lounges.

6. Create order​

  • Method: createOrder(product, passengerDetails, visitDate)
  • Parameters:
    • product — selected product (lounge)
    • passengerDetails — passenger information
    • visitDate — visit date
  • Description: Creates an order for lounge access.
  • Result: Order confirmation with orderId.

7. Retrieve order details​

  • Method: getOrder(orderId)
  • Parameters:
    • orderId — order identifier
  • Description: Retrieves full information about the order.
  • Result: Order details and list of items.

8. Generate voucher​

  • Method: generateOrderItemCoupon(orderId, orderItemId)
  • Parameters:
    • orderId — order identifier
    • orderItemId — order item identifier
  • Description: Generates a PDF voucher for the selected order item.
  • Result: A downloadable PDF document.