How to use the ENS GUI
Learn how to use the Event Notification Services (ENS) graphical user interface to manage your subscriptions to passenger name record (PNR), profile, and queue changes.
Topics
- Prerequisites
- How to log-in to the GUI
- What is Event Notification Services (ENS)?
- What is the ENS GUI?
- How often do I receive notifications?
- When to use the ENS GUI
- How and when a change notification is triggered
- How to get started
- How to create/edit a subscription
- How to unsubscribe from a subscription
- How to create multiple subscriptions
- How to update your contact information
Prerequisites
You must be an active Travel Network customer and have been granted access to Sabre APIs by your Sabre account manager (or be a Sabre APIs down-line customer). Your Sabre account manager must have granted you access to ENS. You must have had your Sabre account manager add the queue numbers and/or PCC(s) to which you would like to subscribe. Behind the scenes, these are added to the ENS database, and will thereby be associated to your log-in credentials in ENS.
Not a customer? Contact us and use the subject "I want to become a Sabre customer". When you request access to ENS, you should also establish the PCCs and queue numbers for which you would like to receive notifications.
-->
How to log-in to the GUI
Log-in to the ENS GUI with the same token credentials (EPR, PCC, password) you would use to get a token to call Sabre APIs. Upon log-in, you will be directed to the home page, which contains a summary of your current subscriptions.
- Test URL: https://cert.eventnotification.sabre.com
- Production URL: https://eventnotification.sabre.com
What is Event Notification Services (ENS)?
Event Notification Services (ENS) is an application that manages notifications for updates to Sabre passenger name records (PNRs), profiles and queues. If any updates have occurred, we'll send you a notification (but not the actual content of the update).
What is the ENS GUI?
The ENS GUI allows you to manage your subscriptions to notifications for passenger name record (PNR), profile and queue updates received by ENS.
How often do I receive notifications?
You can receive notifications in real-time or in batches, based on whether you select Consolidated notifications (step 6) in your #create subscription.
When to use the ENS GUI
When you have completed changes to a passenger name record (PNR), profile or queue for a traveler (PCC) and would like to subscribe to notifications. All change notifications are sent to the URL of your choice as an XML payload.
How and when a change notification is triggered
A change notification (also known as an event) is a notification of changes to a Sabre passenger name record (PNR), profile, or queue (associated with a PCC). Notifications are sent based on the notification filters you specify, and run from the start date/time you specify until the expiration date is met, or until you unsubscribe from the subscription.
PNRs
Triggered by the "end transaction" on the create and update request of a passenger name record.
NOTE: You must ask your Sabre account manager to receive create notifications; whereas, update notifications are triggered by default.
Profiles
Automatically triggered on the create, update, delete, restore requests of a profile.
Queues
Automatically triggered on the update request of a PNR. Notifications are sent only once per minute. If no changes have been made within this one minute window, a notification will not be generated. For example, if there are continuous placements on a queue, then the notification will be triggered only for the first queue placement of the minute. Subsequent placements in that minute will not trigger a notification. This is a restriction put in place to reduce the number of notifications generated that could impact system performance.
How to get started
- Get access to Event Notification Services from your Sabre account manager. Ask your Sabre account manager to add the queue numbers and/or PCC(s) to which you would like to subscribe.
- Complete changes to the Sabre Passenger Name Record (PNR), profile, or queue according to when a notification is triggered.
- Log into the ENS GUI.
- Create a subscription for your traveler PNRs, profiles, or queues.
- #Update your contact information.
- Receive notifications to the URL you specified (as an XML payload).
- Parse the content and redistribute as needed within your application.
- Monitor and manage subscriptions as needed in the ENS GUI.
How to create/edit a subscription
Learn the steps required to create or edit a subscription. (Create/edit is functionally the same.)
Create
In the top-left navigation, click Subscribe > PNR Subscription, Profile Subscription, or Queue Subscription. Follow the steps below.
Update
From the home page, click the down arrow of the subscription you would like to update and click edit/view. Follow the steps below (as you would to create a subscription).
Steps
| Step | Task | Required | Details |
|---|---|---|---|
| 1 | Subscription Title. Enter a title for your subscription. | yes |
|
| 2 | Start Subscription Date. Enter the date you would like subscription tracking to begin. | yes |
|
| 3 | End Subscription Date. Enter the date you would like subscription tracking to end. | yes |
|
| 4 | URL. Enter the URL where you would like notifications delivered. | yes |
|
| 5 | Validate URL. Click Validate URL so we can ping the URL you specified. | yes |
|
| 6 | Consolidated Notifications. Select this option if you would like to receive a stream of messages. | optional |
|
| 7 | Max # of Messages and/or Max Time. Receive a batch of messages (rather than real-time). | optional |
|
| 8 | Authorized filters. Select the PCC(s) or queue numbers for which you would to subscribe to notifications, then click Add. | yes |
|
| 9 | Notification filters. Receive all notifications by default, or select Enable to select the types of notifications you would like to subscribe. | optional |
|
| 10 | Select Create or Update. | yes | You're done! |
Tips
- URL. You can create an additional subscription to the same PCC, as long as you provide a unique URL for each subscription.
- Consolidated Notifications. Queue and Profile do not allow Consolidated Notifications.
Notification filters
The following list describes the filters available for you to receive notifications.
| Field | Description |
|---|---|
| Itinerary | Receive notifications when the traveler's itinerary (like the arrival/departure date or an air/hotel/car segment is added, updated or removed) has changed |
| Name | Receive notifications when the traveler's name has changed |
| Phone | Receive notifications when the traveler's phone number has changed |
| ReceivedFrom | Receive notifications when the booking travel agency's name has changed |
| Ticketing | Receive notifications when the traveler's ticketing information has changed (like issuing a ticket or changes the ticketing time limit) |
| PassengerAddress | Receive notifications when the traveler's address field has changed |
| PassengerDetail | Receive notifications when traveler-related information has changed (like email address, passenger type) |
| PreReservedSeats | Receive notifications when the traveler's seat number has changed |
| HostFacts | Receive notifications when the information sent to/by the airline has been added or updated (like SSRs, OSIs) sent via the host facts field |
| GeneralFacts | Receive notifications when the information sent to/by the airline has been added or updated (like SSRs, OSIs) sent via the general facts field |
| AgencyAccountingData | Receive notifications when the booking travel agency's accounting line information has changed |
| Remarks | Receive notifications when the remarks have changed (like the invoice) |
| FrequentTraveler | Receive notifications when the frequent traveler information has changed |
| MiscTicketing | Receive notifications when the miscellaneous ticketing information (like MCO) has changed |
How to unsubscribe from a subscription
From the home page, click the down arrow of the subscription you intend to cancel and click unsubscribe.
Steps
| Step | Task | Required | Details |
|---|---|---|---|
| 1 | Unsubscribe. Click the unsubscribe button next to the subscription you would like to cancel. | yes | A window will pop-up asking you to confirm. Click Yes to confirm. (Or click No, if you changed your mind). |
How to create multiple subscriptions
To create multiple subscriptions to a single change notification, you simply need to choose parameters which vary from the original #create subscription. For example, you can create two PNR subscriptions for the same PCC by providing a unique URL.
How to update your contact information
In the event of an issue/outage with your URL, we send notification reports to your email address. Go to Settings, then provide your contact information in each field (based on the below descriptions).
| Field | Description | Notes |
|---|---|---|
| Customer ID | Your iPCC/PCC | Cannot be modified |
| Customer Name | Your travel agency name | Cannot be modified |
| Email Address | Enter your travel agency email address | N/A |
| Outage Notification Address | Enter an email where we can send alerts (if/when your URL is down) | N/A |
| Phone Number | Enter a phone number where we can contact you (if/when your URL is down) | N/A |
Related tasks
- Get your credentials to call Sabre APIs. Use your token credentials to get a token. Your security token gets you connected to Sabre APIs. See How to get a ttoken.
- Learn from our sequencing approach. See how we sequenced this workflow using a Sabre profile to obtain traveler information that is then used to create a passenger name record. See How to manage a token.
- Learn common workflows. Check out the different ways to accomplish common travel workflows with our Sabre APIs: workflows.
- Optimize your workflows. Did you know using a sessionless token can reduce the number of calls to Sabre? See Best practices: optimize workflows.
- Learn about the Sabre work area. The Sabre work area is where you build a passenger name record. See SOAP APIs 101: Intro to the Sabre work area.
- Learn about passenger name records. Identify requirements and get sequencing ideas in Sabre APIs 101: Intro to PNRs.
Frequently asked questions (FAQs)
Can I add a PCC using Event Notification Services (ENS)?
No, you are not allowed to add a PCC via ENS. You must contact your Sabre account manager and ask them to add the PCC(s) to eServices on your behalf.
Can I set-up duplicate subscriptions for the same PCC?
No, not exactly. Technically, you would create a new subscription by providing a unique URL.
Why can't I see any PCCs?
You must validate your URL to auto-populate a list of your available PCCs. If you still don't see any PCCs, see #Prerequisites.
How do I renew a subscription?
Select a new expiration date sometime in the future in the #update subscription steps.
How many times does ENS attempt to redeliver a message?
We retry to deliver notifications for 72 hours. If ENS is unable to deliver notifications after 72 hours, it stops attempting to deliver notifications to the endpoint. The undelivered notifications are stored in the database for future resend. Follow the instructions for #Request re-delivery of failed notifications.
How long are failed notifications stored?
Failed notifications are stored for a period of 6 months for re-delivery. Follow the instructions for #Request re-delivery of failed notifications.
What happens (on the edit/update view) if I click the subscribe button again?
The PCC will not be displayed in the Authorized filters (that is, your traveler PCCs) list once the Validate URL button is clicked. If you would like to create two subscriptions for the same PCC, you must create a new subscription and provide a unique URL.
Is there a maximum number of PCCs for a single subscription?
No, there is no maximum quantity of PCCs for a single subscription for PNR, Queue, or Profile.
I need to open firewall access for ENS—what are the IPs?
CERT:
- cert.eventnotification.sabre.com
- IP address: 151.193.119.48
PROD:
- Name: eventnotification.sabre.com
- IP address: 151.193.119.1
Below are mandatory to be whitelisted prior to Feb 2023.
|
us-central1 |
us-central2 |
|
34.69.44.134 |
108.59.89.113 |
|
35.222.49.21 |
35.186.123.63 |
|
35.223.170.93 |
107.167.174.56 |
|
35.192.181.145 |
35.186.72.210 |
|
34.132.184.222 |
35.186.75.38 |
How can I get access to the GUI for someone else in my agency?
Ask your Sabre account manager to add the user to the ENS order.
Can ENS send messages to any port?
ENS can only deliver messages to ports 80 and 443.
What is this PNR notification with locator ZZZZZZ?
This is a test message sent when the URL is validated in the GUI.
Questions?