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:
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.