Amadeus Integration

Import and manage airline tickets from Amadeus, and link them to customer orders.

The Amadeus integration allows you to import airline ticket data from the Amadeus reservation system, manage tickets by PNR (Passenger Name Record), and link them to customer orders in Itsy.

A PNR is a 6-character code that uniquely identifies a booking in the airline system. Each PNR can contain multiple tickets for different passengers or services. In Itsy, PNRs serve as the primary grouping for imported tickets.

AIR files

AIR files are structured text files exported from Amadeus that contain ticket data. Each file includes passenger information, flight segments, fares, taxes, and payment details. A single file may contain tickets for multiple passengers.

Tickets

Each ticket represents an individual travel document within a PNR. Tickets contain flight segments, fare breakdowns, tax details, and passenger information.

Workflow

1. Upload an AIR file

Navigate to Inventory > Amadeus > Air Files and upload a file by providing:

PNR code — The 6-character booking reference.
File name — The original filename.
File content — The raw text from Amadeus.

The file starts in Pending status after upload.

2. Parse the file

Click Parse on the uploaded file to preview its contents. The parser extracts tickets, segments, fares, and passenger data. It reports any errors or warnings found during parsing:

Errors prevent import and must be resolved.
Warnings are informational and do not block import.

3. Import tickets

After reviewing the parsed data, click Import to bring the tickets into Itsy. You can import all tickets in the file or select specific groupings. The file status changes to Completed on success or Failed if there are errors.

4. Browse PNRs

Navigate to Inventory > Amadeus to see all imported PNRs. Each PNR shows:

PNR code
Link status — Green (all tickets linked), Orange (some linked), or Gray (none linked).
Ticket count — Total tickets and how many are linked.
Orders — Which orders the tickets are linked to.
Last updated — When the most recent change occurred.

Use the filters to search by PNR code, link status, order code, or date range.

5. Link tickets to orders

Click on a PNR to view its tickets. Select the tickets you want to link (void tickets and already-linked tickets cannot be selected), then choose one of two options:

Create new order — Select a client and segment, and Itsy creates a new order with the selected tickets. Participants are automatically created from the ticket passenger data.
Link to existing order — Choose an existing order from the dropdown. The tickets are added to the order and participants are created or matched.

When linking, Itsy automatically:

Creates a "Tickets" booking group in the order.
Adds the PNR as an external reference on the order.
Creates participants from ticket passenger data.

Ticket details

Expanding a ticket shows full details:

Flight segments

Each segment includes:

Flight number and airline
Origin and destination airports
Departure and arrival dates/times
Class of service and fare basis
Baggage allowance

Pricing

Flight price (fare)
Taxes
Form of payment
Commission rate
Endorsement restrictions (if any)

Ticket information

Ticket number (airline code + number)
Passenger name
Passenger contact information (phone or email when available)
Issue date
Office ID and IATA number
Ticketing agent

EMD (Electronic Miscellaneous Document) details

Tickets may include associated EMDs for ancillary services such as baggage, seat upgrades, or other airline extras. Each EMD shows:

EMD type and reason for issuance code
Marketing and servicing carrier codes
Route information (origin and destination)
Validity period
Pricing breakdown (base fare, taxes, equivalent amounts, net fare)
Excess baggage details (where applicable)

Automatic file detection

Itsy can automatically detect AIR files uploaded to your workspace's cloud storage bucket. When enabled, new files are picked up and added in Pending status for you to review, parse, and import.

How it connects

Linked tickets appear as bookings in Orders.
PNRs are stored as external references on orders for traceability.
Ticket passenger data creates participants within orders.
Suppliers for flights can be tracked via Suppliers.