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

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.

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.

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 request of a profile.

Queues

Automatically triggered on the update request of a passenger name record. 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
  • Example: Germany PNR Updates
2 Start Subscription Date. Enter the date you would like subscription tracking to begin. yes
  • Select a start date.
  • Select a start time (optional).
  • Default: current date/time
3 End Subscription Date. Enter the date you would like subscription tracking to end. yes
  • If you do not specify an end date, then the non-expiring box must be selected. This action auto-populates the end date to 2099.
4 URL. Enter the URL where you would like notifications delivered. yes
  • Accepts one URL or IP address.
  • Example: http://www.mytravelagency.com/PNR/Germany/notifications
  • See Tips for more information.
5 Validate URL. Click Validate URL so we can ping the URL you specified. yes
  • A URL must always be validated to receive notifications, and to auto-populate your available PCCs in step 8.
  • Success message: "Test message successfully sent."
  • Fail message: "Invalid URL. Please check."
6 Consolidated Notifications. Select this option if you would like to receive a stream of messages. optional
  • Must be combined with step 7.
  • See Tips for more information.
7 Max # of Messages and/or Max Time. Receive a batch of messages (rather than real-time). optional
  • Must be combined with step 6. Select Max # of Messages and/or Max Time (min).
  • Max # of Messages: use the slider to select the number of messages you would like to receive at a time (e.g. every 30 messages).
  • Max Time: use the slider to select the frequency of time you would like to receive messages (e.g. every 5 minutes).
  • If Max # and Max Time are both selected, then whichever option occurs first will be fulfilled.
8 Authorized filters. Select the PCC(s) or queue numbers for which you would to subscribe to notifications, then click Add. yes
  • Auto-populates the PCCs and queue numbers (Ex: PCC.QUEUE) available for subscription.
  • Search for available PCCs and queue numbers by typing in the Authorized Filters box. For example, to find PCC0, type PCC0 into the Authorized Filters field.
  • Any PCCs and queue numbers selected for subscription will display under Selected Filters. To remove a subscription from Selected Filters, select the queue number or PCC, and click Remove.
  • Don't see any PCCs? You must have completed step 5 (Click Validate URL).
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
  1. URL. You can create an additional subscription to the same PCC, as long as you provide a unique URL for each subscription.
  2. Consolidated Notifications. Queue and Profile does 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 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 token .
  • 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 don'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

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 and OWNPCC FF9A?
This is a test message sent when the URL is validated in the GUI.


Questions?

Contact Support