...
Click on desired document to open it. Then, click on the cloud symbol in the top right corner of your screen to download, save, or print.
...
| Table of Contents |
|---|
Introduction
Pre-trip approval (PTA) is a process put into place to better manage business travel by allowing a notification to be sent or submit a trip to be approved or declined before it is ticketed. It offers an automatic method of controlling travel spending by designating travel approvers who can approve or deny a user's travel request.
...
Benefits
...
Benefits
Customizable: Deem utilizes JavaScripting, which allows for creativity when configuring approvals or notifications.
Allows for offline and online approvals.
Simple and quick process for Approver, simply click the Approve or Decline button within approval email.
Set up notifications and/or approval based on groups.
Limitations
Offline bookings
Limited to what can be pulled from offline bookings.
Policy violation cannot be used as a trigger for PTA when booked offline.
Example: Offline booking where the travel policy states - Require approval or notification if travel booked is $200 over the lowest logical fare, or if booking a hotel that is $250 dollars over the lowest hotel rate.
For these examples, you would need to configure all offline air or hotel bookings require approval or notification.
Another option would be to configure to trigger PTA for offline bookings based on an itinerary or profile value.
Approvals and notifications are completed through email only:
Approvals are not available within the Desktop or Mobile app.
Approval and notification emails cannot be re-generated.
TMC does not have access to approve on the behalf of the client, or to see what trips are waiting approval.
Single layer approval process:
Unable to require approval from more individual and then another.
Changes to approved trips will not be sent for approval.
Need to Know
Travelfusion and Instant Purchase carriers can be excluded from PTA.
Travelfusion and Instant Purchase carriers will be auto-approved.
...
Primary approver: First user responsible for approving or declining trips triggered by the process.
Secondary approver: Second/backup User identified to take action for trips triggered by the process. If the primary approver does not take action within the configured amount of time, an approval request will be sent to the secondary approver.
Expired Bookings: Bookings which have not been approved or declined by the primary or secondary approvers within the configured amount of time. Expired bookings can be configured to auto-cancel.
Enabling PTA - Who to Contact
Contact Deem Channel Sales Director
...
PTA can easily be enabled on additional domains. Admins will only need to file a support ticket if they plan to use the travelers profiled approver.
...
The Deem Configuration Team will enable the ability for the approver to be set in the traveler’s profiles.
Note: If configuring a static approver email within the PTA configuration, no email to support is required.
Gather information
Approvals or Notifications
Determine if approvals/notifications will be sent to a static email or manager within the profile.
Determine if clients require approvals or notification:
Approvals Required: Approval email is generated, thereby requiring a manager from the traveler’s profile or a static approver to approve or decline a trip before being sent to the TMC for ticketing.
Notification only: Notification email is generated to manage within the traveler’s profile or static approver for notification purposes only. No action required on the behalf of the email recipient. Travelers are not alerted when notifications are sent.
PTA Triggers
Identify parameters which will drive the PTA process. Examples of parameters that can be used are:
...
If you require customized scripting for PTA triggers, please submit a request via a support ticket.
Queues
Identify processing queues
...
Select the Service tab.
Click Travel Agency.
Click Agency Settings.
Select the active settings name.
Scroll to the bottom of the page and click Add PTA Configurations.
Note: You may see Edit PTA Configuration if previously set up.
...
Enter Pseudo-city and Queue for each Approved, Declined and Expired bookings.
Enter the time windows for the primary and secondary approvers to approve or decline the trip.
Notes:The first time window is the time in which a reminder email will be sent to the designated approver if they have not taken action.
The second time window is the time in which second reminder will be sent to the designated approver if they have not taken action.
Tips:
The first time window is the time in which the primary approver has to make a decision. If the primary does not approve within this window, a reminder email will be sent as well as an approval request generated to the secondary approver.
The second time window is the time in which both the primary and secondary have left to make a decision before the PTA process expires.
Best practice is to select between 11 and 14 hours total as most fares will expire by the end of day.
Click Save.
Setting Up Approvals and Notifications (Custom fields)
Creating Custom Field Collection
...
Click the Services tab.
Click Custom Fields.
Click Custom Field Collections.
Click Add a New Collection.
Complete the following:
Name: Enter a name, such as PTA, PTAManager, PTAGuest. Label clearly, name in a way that it define the collection clearly. No spaces or special characters.
Label: Will prefill from what is enter in the Name field. Update as needed. Spaces are acceptable.
Description: This will be the header displayed to the user on the purchase page alerting them that the reservation requires approval. HTML is supported here if you wish to change font size or color.
Select Ask for User Input on the Purchase Page (required).
Select Save.
You will be brought back to The Custom Field Collections , where you will screen displays to add the Pre-Trip approval notifications triggers to the collection.
...
Click on the Collection Name under Custom Field Collections.
Click Add Custom Field.
Complete the following:
Name: Enter Pre-Trip Approval Name. This does not display to the user.
Label: Will prefill from what is enter in the Name field, please update. Spaces are acceptable. This will display to the user above a box where the user can send additional details to the approver. Best practice is to label “Note to Approver” so the travelers know the purpose.
Field Type: Select PTA.
Click Approval required or Notification only.
Decide whether to send the approval email to the manager within the profile, or to a default approver.
Click Send approval email to traveler’s profiled approver: if manager within profile is required.
If the setting for "Send approval email to traveler’s profiled approver" is used, the default approver email value is required.
Notes:The default approver is ignored unless the traveler doesn't have a profiled approver. The default approver will be used in the case the traveler does not have an associated approver within their profile.
If approvers are to be taken from traveler profiles additional steps are required to first grant permission to approvers and then to associate travelers to approvers.
Leave Send approval email to traveler’s profiled approver
...
unchecked if default approver required.
Enter the email addresses for the default approver and the secondary approver. If the default approver has not approved or declined the itinerary within the defined period, a reminder email is sent to the primary approver and an approval request is sent to the secondary approver.
Select the following options:
Auto cancel declined PNR's?: Check box if trip should be cancelled if declined by approver.
Auto approve or cancel expired PNR's?: Select action that should be taken if trip has expired. Has not been approved within desiccated time established within Agency Settings.
Note: Only online generated reservations can be auto-cancelled.
...
Enter message which will
...
display on both the purchase page as well as email notifications in PTA Rules Description. This should reflect the reason the trip has been submitted for approval (out of policy, class of service, price etc.).
...
Click Advanced to enter JavaScript if specific conditions are required to trigger PTA.
Enter JavaScript code.
Click Save.
Use Case JavaScripts
Standard JavaScript Examples
If you need further help creating a script, please open a Support Case
Example Script
Simple script
...
//INTERNATIONAL SEGMENT
var Int=UserPnrData.UserBooking.HasInternationalSegment;
...
else {out.print("false");}
Flying to specific airport
...
//Alaska and Hawaii
if((UserPnrData.UserSession.AirSearch.FlightLeg[0].DestinationAirportCode=="ANC")||
...
Add PTA Collection to the appropriate Custom Field Set.
Click Back to Custom Field Configuration.
Navigate back to Custom Field Configurations and click Custom Field Sets.
Select
...
which Set to
...
add PTA.
Click on Add Collection to Set.
Click the check box next to collection you would like to add to the set and click Add.
Optionally, adjust the order in which the fields appear and select Save.
Confirm Travel Service Rules are updated properly, by ensuring you have the correct custom field sets assigned to the correct groups.
Commit Changes shown at the top of the screen.
...
Select the changes not applied link at the top right of the page which opens the Commit Changes page.
Click Commit.
Note: Once the Commit button is selected, the updates are made to production. There is no undo button.
Test your settings thoroughly.
Configuring a Custom
...
PNR
Configure pending queue under Custom PNR
Click the Services tab
Click Travel Agency.
Click Custom PNR.
Select mapping to be configured.
Navigate to the bottom of the mapping and click Add PNR Line.
Enter or select values for the following:
Line No.: Enter line number which script will reside in your mapping. In this example we are using line 159.
PNR Field Type:
For the “Pending Approval” remark select Accounting ID.
For “Approved,” ”Declined,” and “Expired,” remarks, select Pre-Trip Approval.
Custom PNR Requirement: Enter Script.
Requirement Type: Select Script.
GDS: Select the GDS your script writes to.
Click Save.
Standard PTA scripts can be found here.
...
Download the approvers template (Deem_Approvers.csv) and complete the spreadsheet with the approver’s externalID.
Download the travelers template (deem_appassociation.csv) and complete the spreadsheet with the traveler’s externalID and the associated approvers. The TravelApproverID also needs to be the approvers externalID.
As an admin, log into the console and navigate to the Profiles tab.
Select Schedule Profile Upload.
Navigate to the File Options and select:
File Source: Upload from local file
File Format: CSV
Click Choose File and select your Deem_Approvers.csv file.
Navigate to Load Options and select Update Only (ignore new users) and Ignore empty double quotes. Do not select any other boxes.
Suggest verbiage here around different ways approvers can be added and associated to travelers here. This being manually then instructions on uploading.
Setting up Permissions
Designating Approver Status Manually
Click the User tab.
Click Account Permission.
Click Travel Approver Permission.
Click Save.
Assigning Manager Manually to Traveler Profile
Click the Users tab.
Click Personal and Employee Info.
Click Travel Approver Name.
Select an approver from list.
Click Save.
Upload Approver
You can upload a file to establish user-approver relationships. Templates are available under the Profile tab.
...
You may need to upload two separate profile uploads to establish an approver roll, and then a file to assign an approver to the user’s account. If you upload all files at the same time, there may be random issues with one of the files.
...
See HR Feed with Pre-trip Approval for more information.
Pre-trip Offline booked PNRs
The Agency queues the PNR to PNR Synchronization queue listed in Agency settings.
Note: Deem does not have an independent queue for for Pre-Trip Approval.Deem will determine if the reservation requires approval via the PTA configurations:
If trip is does not require approval, the TMC is responsible for sending to the ticketing queue..
If trip requires approval an email will be sent to the approver.
Once approved or declined it will be sent back to the designated queues for processing.
Note: In the event the fare expires, the hotel is within the cancellation policy, or a trip will commence within the first approvers time window, the system will auto-approve the trip. This is not a configurable item.
Pre-trip approval messaging
Pending Approval Message
To Traveler – ‘Your trip is pending approval for travel. You will be notified once it is approved, and the trip will be sent to [agency name] for processing. Online changes are not allowed until the tip is approved for travel, please contact your agency directly for changes.’
To Approver 1 – Pre-trip approval required [rules description]
Reminder Approval Message
To Approver 2 – Pre-trip approval required. Primary approver did not respond within the expected timeframe. [rule description]
Approval Message
To Traveler – ‘Your trip has been approved for travel.’ Existing confirmation message – Your trip has been completed.
To Approver 1 – Pre-trip approval has been received and the trip has been sent to [agency name] for processing
To Approver 2 – Pre-trip approval has been received and the trip has been sent to [agency name] for processing
Declined Message
To Traveler – Your trip has been declined for travel. The trip has been sent to [agency name] for processing.
To Approver 1 – This trip has been declined for travel and sent to [agency name] for processing
To Approver 2 – This trip has been declined for travel and sent to [agency name] for processing
Declined Auto Cancel Message
To Traveler – Your trip was declined for travel and auto canceled. [existing auto cancellation message]
To Approver 1 – This trip was declined for travel and auto canceled
To Approver 2 – The trip was declined for travel and auto canceled
Expired Approval Message
To Traveler – Pre-trip approval was not received for this trip. The approval process has expired, please contact your agency for further assistance.
To Approver 1 – Pre-trip approval was not received for this trip and the approval process has expired.
To Approver 2 – Pre-trip approval was not received for this trip and the approval process has expired.
Notification Only Email
To Approver 1 – You are being notified that this trip has been sent to [agency name] for processing. [rule description]
Pre-trip
...
Status and Explanations
Waiting for Approval: Bookings have not been approved or declined and are within the configured amount of time for review.
...