Travel Itinerary API v4 with Business Events
Introduction
The event driven GET Itinerary v4 API will provide a scalable solution by allowing partners to get near real time updates for trips being created, updated, cancelled, deleted, and anonymized.
Data Scope
Events will be raised for all trips saved to the itinerary data store. This includes trips booked in Concur Travel, offline with a TMC, or directly with a TripLink supplier. It also includes plans sent by users to TripIt travel segments added to Concur Request. Data sources can be differentiated by source, documented in the References for Enumeration Types section.
Because some sources of travel data are indirect (through email parsing, for example) or only signal traveler intent, it is not uncommon for records to be incomplete or populated with suspicious data. Data customers must develop a strategy for incomplete records, as appropriate for their use cases. For example, in duty of care services, a flight from JFK to LHR without a flight number (or a fake flight number), should be interpreted as traveler intent to be in London on that date.
Event Details
The Event Subscription Service (ESS) enables the set up/creation of a subscription using partner’s App & a webhook. Using the following resources, the end point can be set up and a subscription to the Travel Itinerary Event can be created.
Itinerary v4 API
Using a Company Level Token and the href from the Events payload, partners use the Itinerary v4 API endpoint to obtain trip details.
Schema and Sample API Request and Response can be found in:
References for Enumeration Types
Itinerary Source Names
Note: The source name appears both at the Itinerary level and the Booking level. The value at the Booking level is generally more useful. The value at the Itinerary level represents that value of the first booking added to the Itinerary and could therefore be misleading.
| Itin Source Name | Description |
|---|---|
| Cliqbook | Bookings created using Concur Travel or booked directly with a TMC agent and sent via the GDS. |
| Panama | Trip confirmation emails sent to plans@concur.com, a feature of Concur TripLink. Note: The plans@concur.com functionality has been deprecated. |
| Agency | Bookings made on other booking tools and posted to the SAP Concur platform. |
| TravelSupplier | Concur TripLink bookings made directly on supplier websites & mobile apps and posted to the SAP Concur platform. |
| TripIt | Trip confirmation emails sent to plans@tripit.com, a feature of Concur TripLink. |
| TravelRequest | Travel plans from Concur Request that signal traveler intent but might not yet have actual reservations in place. |
Trip Status Values
| Status Types | Status Number |
|---|---|
| Confirmed | 0 |
| Ticketed | 1 |
| Withdrawn | 2 |
| Virtual | 4 |
| VirtualCancelled | 5 |
| Proposal | 6 |
| BookedProposal | 7 |
| Removed | Byte.MaxValue |
Airline Adjustment Types
| Charge Type | Description |
|---|---|
| V | Void |
| R | Refund |
| C | Credit |
| A | Ancillary |
| O | Other |
Rail Adjustment Types
| Description | Charge Type |
|---|---|
| Refund | R |
| Credit | C |
| Ancillary | A |
| Other | O |
Airline Charge Types
| Charge Type | Description |
|---|---|
| T | Airline Ticket |
| J | Airline Adjustments |
| Q | Airfare Quote |
| M | Miscellaneous Charge Oder |
| A | Manual Airline Ticket |
| R | Rail Payment |
| U | Rail Adjustment |
| L | Rail Quote |