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.