Skip Navigation

Boarding Pass Output Format

Boarding Pass is one of the most important documents during the Passenger's journey. It confirms that the Passenger can board the aircraft. Each document contains the following details:

  • First and last name of the Passenger
  • Flight details such as Airline name, flight number, origin and destination, departure date and time
  • Assigned seat number

Nowadays the paper printed boarding pass is not always mandatory and can be replaced with the electronic form.

The Passenger can complete check-in process using different channels which results in returning boarding pass in different forms. The following values of the outputFormat field are returned:

  • IMAGE
  • PECTAB
  • BPXML
  • ZPL
  • NONE

Boarding pass can be retrieved by using the Digital Connect Check-In services in the different situations:

  • As a result of check-in operation (the /dcci/passenger/checkin response)
  • As a result of a seat change operation when the Passenger has been already checked-in (the /dcci/seats/select response)
  • On-demand reprint (the /dcci/passenger/details and the /dcci/passenger/boardingpass responses)

If the boarding pass is returned in any of the above scenarios, the below structure is included in the request message:

{
  "outputFormat": "IMAGE"
}

Image

When the 'Image' format is requested, Digital Connect Check-In returns a boarding pass in the PNG format so the POS can return ready to print boarding pass to the Passenger. All data included in the boarding pass image comes from the downline system and it is not possible to change or adjust any details on Digital Connect Check-In or POS level.

{
  "formattedBoardingPass": {
      "image": {
        "value":"dGhpcyBpcyBhbiBleGFtcGxl",

        "contentType": "base64",
        "name": "image"
      }
  }
}

The boarding pass is encoded with base64 and after decoding it the boarding pass image shows:

Boarding Pass Example

Pectab

When the 'PECTAB' format is requested, Digital Connect Check-In returns the boarding pass in two pieces:

  • Details about the layout of the final boarding pass template which is visible to the Passenger
  • Real boarding pass data which is placed inside the template

Both fields - the layout and the data - are encoded with base64 twice.

{
  "formattedBoardingPass": {
    "pectab": {
        "layout": {
          "value": "dGhpcyBpcyBhbiBleGFtcGxl",

          "contentType": "pectab"
        },
        "data": {
          "value": "dGhpcyBpcyBhbiBleGFtcGxl",

          "contentType": "pectab"
        }
    }
  }
}

BPXML

When 'BPXML' format is requested, the POS needs to build the final boarding pass document. Digital Connect Check-In can only return raw data which POS uses to build the final document. The following is a simple example of the boarding pass returned as raw data:

{
   "boardingPasses": [
    {
      "passengerFlightId": "p03.01.s1.f1",
      "boardingPass": {
        "source": "HOST",
        "priorityVerificationCard": false,
        "recordLocator": "FQYFGE",
        "ticketNumber": {
          "airlineAccountingCode": "795",
          "serialNumber": "2158136860",
          "checkDigit": "3",
          "number": "79521581368603"
        },
        "ticketCouponNumber": "1",
        "personName": {
          "first": "BRAD",
          "last": "SMITH"
        },
        "flightDetail": {
          "estimatedDepartureTime": "2020-01-09T06:00:00+11:00",
          "estimatedArrivalTime": "2020-01-09T07:35:00+11:00",
          "departureFlightScheduleStatus": "ON_TIME",
          "boardingTime": "2020-01-09T05:30:00+11:00",
          "departureTerminal": "D",
          "departureGate": "GATE",
          "departureCountry": "AU",
          "arrivalCountry": "AU",
          "commuter": false,
          "airline": "VA",
          "flightNumber": "800",
          "departureAirport": "SYD",
          "departureTime": "2020-01-09T06:00:00+11:00",
          "arrivalAirport": "MEL",
          "arrivalTime": "2020-01-09T07:35:00+11:00",
          "operatingAirline": "VA",
          "operatingFlightNumber": "800",
          "equipment": "73W"
        },
        "fareInfo": {
          "bookingClass": "Y"
        },
        "seat": {
          "value": "15C"
        },
        "deck": {
          "value": "MAIN",
          "code": "L"
        },
        "group": "2",
        "zone": "2",
        "checkInSequenceNumber": "00003",
        "barCode": "M1SMITH/BRAD          EFQYFGE SYDMELVA 0800 009Y015C0003 157>1181MR0008BVA              297952158136860 0                             Y            ",
        "agent": {
          "sign": "WK1",
          "city": "HDQ",
          "country": "AU"
        },
        "supplementaryData": {
          "exclusiveWaitingArea": false,
          "loungeAccess": false
        },
        "displayData": {
          "operatingAirlineName": "VIRGIN AUSTRALIA",
          "boardingTime": "053000",
          "scheduledDepartureDate": "2020-01-09",
          "scheduledDepartureTime": "060000",
          "departureAirportName": "SYDNEY",
          "scheduledArrivalTime": "073500",
          "arrivalAirportName": "MELBOURNE",
          "cabinClassCode": "Y",
          "ticketTypeText": "ELECTRONIC",
          "documentTypeText": "BOARDING PASS",
          "pingTipText": "N",
          "cabinText": "ECONOMY",
          "agentCityName": "SYDNEY"
        }
      }
    }
  ]
}

ZPL

The ZPL boarding pass format is requested by POS as the best option while printing the boarding pass using a Bluetooth printer. This format is supported by mobile printers which could be used by POS. The boarding pass returned by Digital Connect Check-In is encoded with base64.

{
  "formattedBoardingPass": {
    "zpl": {
      "value": "dGhpcyBpcyBhbiBleGFtcGxl",     
 
      "contentType": "ZPL"
    }
  }
}

None

All output formats mentioned above are responsible for returning the boarding pass document which can be sent to the Passenger in electronic form. When 'None' format is requested, the virtual version of the boarding pass is not returned to POS. In such case, if real LNIATA printer is assigned to the host session, the boarding pass is physically printed on the assigned printer.