Transcription
Sabre ProfilesTechnical User GuideApril 2018
2018, Sabre Inc. All rights reserved.Document Revision: 20172002.5.0This documentation is the confidential and proprietary intellectualproperty of Sabre Inc. Any unauthorized use, reproduction,preparation of derivative works, performance, or display of thisdocument, or software represented by this document, without theexpress written permission of Sabre Inc. is strictly prohibited.Sabre and the Sabre logo design are trademarks and/or servicemarks of an affiliate of Sabre Inc. All other trademarks, servicemarks, and trade names are owned by their respectivecompanies.
Table of ContentsIntroduction . 1About this Guide . 1Standards and Specifications . 1About Sabre Profiles Web Services . 2Security . 3Line Security . 4Authentication . 4Authorization . 5Confidentiality . 5Network Connectivity. 5Web Services Sessions. 5SessionCreateRQ Request XML Example . 5The Envelope . 5The SOAP Payload . 6The SOAP Envelope . 7Ending the Session. 8Credit Card Data Security . 9Access . 9Storage and Internal Security Measures . 10Technical Support . 10Email . 10Additional Support . 11Accessing Sabre Profiles Web Services . 12Activation. 12Types of Web Services . 13Session Management Services . 14Sabre Profiles Services . 14Domain Access Rules . 17Message Structure . 17Requesting Payload Content . 18Sabre Profile Access validation by PCC. 20Web Services Error Handling . 21Sabre Profile Types . 24Profile Types . 24Traveler . 24Logic for specific schema elements/attributes within the Profile . 25Operational. 27Corporate . 27Sabre Profiles Technical User GuideApril 2018 Confidential and Proprietary Sabre Inc.iii
Group . 27Agency . 28Agent . 28Replication of Sabre Host EPRs into Agent Profiles . 28Audit information tracking using AccessInfo in the API . 30Common attributes within the Payload . 31ClientContextCode . 31Profile SubTypes . 32How to Determine the Profile Data Needed . 33Use of Dictionary Control Table Values. 33Use of Status codes . 35Domain “Status”. 35Profile “Status” . 36Profile Associations . 36Common Rules and Elements across Profile Types . 37Common Elements and Attributes . 41Management of Non-standard English Characters . 42Profile UniqueID . 43Create Service . 44Creating Profiles . 44How to Create a Profile . 44Sample XML Create Profile Request . 44Sample XML Create Profile Successful Response . 46Sample XML Create Profile Error Response . 46Read Service . 48Reading Profiles . 48Sample XML Read Successful Response . 52Credit Card Tokenizer . 52Sample XML Read Error Response . 54Update Service . 56Updating Profiles . 56How to Update a Profile using Full Replace . 62How to Update a Profile ignoring time stamp check . 63Sample XML Update Successful Response . 64Sample XML Update Error Response . 64Search Service . 66Searching for Profiles . 66Online Profile Search. 66Sabre Profiles Technical User GuideApril 2018 Confidential and Proprietary Sabre Inc.iv
Offline Profile Search. 75Delete/Restore Service . 90Deleting and Restoring Profiles . 90Sample XML Profile Delete Request . 90Sample XML Profile Delete Successful Response . 91Sample XML Profile Delete Error Response . 91Restore Profile Service. 92Profile History Service . 93Overview . 93Sample XML Profile History Request . 93Sample XML Profile History Successful Response . 94Sample XML Profile History Error Response . 98Profile Data Management Service . 100Copying/Moving Profiles to a Branched Pseudo City Code . 100Moving a Profile to a Branched PCC . 100Copying an Association to a Branched PCC . 101Shared Association objects . 102Profile Merge Service . 107Merging Profiles . 107How to Merge a Profile . 107Merge process flow . 109Sample XML Profile Merge Request . 109System Access Permissions . 111ProfileToPNR Service . 112ProfileToPNR Service Overview . 112Moving Remarks to PNR Using a Filter . 113Move Order Logic for Profiles with Associated Formats and Profiles . 114The Filter Path . 115Specifying the Profile . 115Specifying the Filter . 116Searching for a Filter . 117Searching for a Default Filter . 117Filter’s Associated Profiles . 118Temporary Filter Path. 121ProfileToPNR Service Response Message . 122Shared objects in P2PNR. 123Sabre Profiles Technical User GuideApril 2018 Confidential and Proprietary Sabre Inc.v
Profile Index . 130PNR Profile Index display. 131Display Profile using the Profile Index value . 132Filters . 133Filter Overview . 133Creating Filters . 133How to Create a Filter. 134Sample XML Create Filter Request . 134Sample XML Create Filter Successful Response . 136Sample XML Create Filter Error Response . 137Reading Filters . 137Sample XML Read Filter Successful Response . 137Sample XML Read Filter Error Response . 138Updating Filters . 138Sample XML Filter Update Successful Response . 139Sample XML Filter Update Error Response . 139Searching for Filters . 140Deleting Filters . 141Sample XML Filter Delete Request . 141Sample XML Filter Delete Successful Response . 142Sample XML Filter Delete Error Response . 142Object inheritance scenario . 142Formats . 144Format Overview . 144Identifying Format Types . 144Creating Formats. 148How to Create a Format . 148Sample XML Create Format Request. 148Sample XML Create Format Successful Response. 151Sample XML Create Format Error Response . 151Using XPath Expressions for Formats . 151Date Conversion Features . 153Conditional XPath Format Functions . 154Processing Format Data. 157Read Formats . 158Sample XML Format Read Successful Response . 158Sample XML Format Read Error Response . 158Updating Formats . 159Sample XML Update Format Successful Response . 159Sample XML Update Format Error Response . 159Searching for Formats . 160Deleting Formats . 161Sabre Profiles Technical User GuideApril 2018 Confidential and Proprietary Sabre Inc.vi
Sample XML Format Delete Request . 161Sample XML Format Delete Successful Response . 162Sample XML Format Delete Error Response . 162Templates/Associations with Metadata . 163Overview . 163Association Object. 164The logic of the Association object . 164Creating an Association object . 165Attaching an Association to a profile. 166Updating and Deleting Association Objects . 167Shared Association Objects . 168Shared Association objects creation/update . 168Shared Association Object Business Rules . 168Attaching an Association to another Association (child/parent functionality) . 170Child Association Object Business Rules . 171Branch Access Closed . 171Validators . 172Sample Validator . 172Sample Validator with multiple rules . 173Validator Rules descriptions . 174Restriction . 174Occurrence Rule. 174Regexp Rule . 174List Rule . 175Pre-defined Rule. 175Metadata . 175Bulk Read Services . 177Bulk Read Service Overview . 177Bulk Read – Profiles – Request Message . 177Bulk Read – Profiles – Response Message . 178Bulk Read Error Scenarios . 179Error response . 179Warning response . 180Bulk Read – Associations – Request Message . 181Bulk Read – Associations – Response Message . 181Bulk Read – Formats – Request Message . 182Bulk Read – Formats – Response Message . 182Bulk Read – Filters – Request Message . 183Bulk Read – Filters – Response Message . 183Bulk Read – Metadata objects – Request Message . 184Bulk Read – Metadata Objects – Response Message . 184Bulk Read – Validators – Request Message . 185Sabre Profiles Technical User GuideApril 2018 Confidential and Proprietary Sabre Inc.vii
Bulk Read – Validators – Response Message . 185Profile Data Service . 187Overview . 187Sample Retrieve Custom Field Codes XML Data Service Request . 187Sample Create Custom Field Codes XML Data Service Request . 188Sample Create Dictionary XML Data Service Request . 189Sample Read Dictionary XML Data Service Request . 190Sample Update Dictionary XML Data Service Request. 191Sample Delete Dictionary XML Data Service Request . 194Sample Copy Dictionary XML Data Service Request . 196Data Service Error Response . 197Roles. 198Roles Overview . 198Roles Management . 198Creating a Role . 203Reading a Role . 203Sample XML Read Role Error Response . 203Updating a Role .
property of Sabre Inc. Any unauthorized use, reproduction, preparation of derivative works, performance, or display of this document, or software represented by this document, without the express written permission of Sabre Inc. is strictly prohibited. Sabre and the Sabre logo design are trademarks and/or service marks of an affiliate of Sabre Inc.
