This instance is currently being migrated to the new Atlassian One Confluence sytem.
If you can't find your space anymore, it should be already in the new System: https://confluence.weareplanet.com/
Element | Attribute | Type | Num | Description + Content | Comments outbound | pAir | OnPrem |
---|---|---|---|---|---|---|
Profile | 1 | Root element for profile content | ||||
@ProfileType | OTA_CodeType PRT | 1 | Numeric reference to the type of profile such as guest, company, agent, etc. Refer to the OTA Code Lists: Profile Type (PRT) | |||
@StatusCode | OTA_CodeType PST | 1 | Numeric reference to the status of a profile. Refer to the OTA Code Lists: Profile Status (PST). | Please note: The PMS's send different StatusCodes because the handling is different: | ||
@RPH | RPH_Type | 0..1 | This is a unique reference used as an index for this profile in a reservation. | |||
@ShareAllOptOutInd | YesNoType | 0..1 | When yes, a customer has explicitly opted out of marketing communication. This is used in combination with the ShareAllMarketInd and only one of these attributes should have a value of yes. If @ShareAllOptOutInd="Yes" then all 4 contact options (Letter, telephone, email, text message) in the optin field for marketing will be set to NO. If @ShareAllOptOutInd="No", then the Attribute @ShareMarketInd on each of the primary communication types (Address, Telephone, Email) will be checked and the flag will be set accordingly. |
| ||
@CreateDateTime | dateTime | 1 | Timestamp of the creation. | |||
@CreatorID | StringLength1to32 | 1 | Identifies the profile creator. The creator could be a software system identifier or an identifier of an employee responsible for the creation. | |||
@LastModifyDateTime | dateTime | 0..1 | Timestamp of last modification. | |||
@LastModifierID | StringLength1to32 | 0..1 | Identifies the last software system or person to modify a record. | |||
Profile | Customer | 0..1 | Contains basic data on the customer’s identity, location, relationships, finances, memberships, etc. | ||||
@VIP_Indicator | boolean | 0..1 | A boolean value is used to flag a very important person.
|
| ||
@CustomerValue | StringLength1to64 | 0..1 | onPrem: A numeric and string reference (coalesced) representing a supplier’s customer ranking. This attribute relates directly to the primary and secondary VIP code assigned to a profile in the hotel property management system (PMS). pAir: A string reference representing the VIP Code of the guest. | |||
@BirthDate | date | 0..1 | The customer’s birthday information. | yyyy-mm-dd | ||
@Language | language | 0..1 | The language code for which the name data is represented. While this value is optional, it is HIGHLY RECOMMENDED that it be used. | |||
@Gender | NMTOKEN | 0..1 | A string value represents a customer’s gender.
|
| ||
Profile | Customer | PersonName | 0..5 | Detailed name information for the customer. | ||||
Profile | Customer | PersonName | Surname | StringLength1to64 | 1 | Mandatory if a guest profile is passed. This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field is used to pass the guest’s surname. | |||
Profile | Customer | PersonName | NamePrefix | StringLength1to16 | 0..3 | This field would be used to pass the guest’s NamePrefix (e.g. salutation). | |||
Profile | Customer | PersonName | NameTitle | StringLength1to16 | 0..1 | This field would be used to pass the guest's title (e.g. Prince). | |||
Profile | Customer | PersonName | GivenName | StringLength1to64 | 0..5 | This field would be used to pass the guest’s GivenName. | |||
Profile | Customer | PersonName | MiddleName | StringLength1to64 | 0..3 | The second given name of the person name. | |||
Profile | Customer | PersonName | NameSuffix | StringLength1to64 | 0..1 | The second last name of the person name (Spanish properties only) | |||
Profile | Customer | Telephone | 0..99 | Information on a telephone number for the customer. | ||||
@PhoneTechType | OTA_CodeType PTT | 1 | A numeric value represents the type of technology associated with this telephone number. Refer to OTA Code List: Phone Technology Type (PTT). | |||
@PhoneNumber | StringLength1to32 | 1 | Contains the actual number as a string of max 32 characters and it is Mandatory. | |||
@PhoneLocationType | OTA_CodeType PLT | 0..1 | A numeric value represents the type of phone. Refer to the OTA code lists: Phone Location Type (PLT) | |||
@FormattedInd | boolean | 0..1 | As country code and area code is not passed they appear in the PhoneNumber field. The entire number is passed in the PhoneNumber field and FormattedInd is set to NO to indicate that the PhoneNumber field contains the entire phone number without a specific format. |
| ||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes. reference to @ShareAllOptOutInd (only possible in OnPrem) |
| ||
@Remark | StringLength1to128 | 0..1 | A remark associated with the telephone number. onPrem: Only imported if the email address is shown under "more communication methods" in the guest profile. | |||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the phone number is the primary for the profile. |
| ||
Profile | Customer | Email | 0..99 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’s email address. | ||||
@EmailType | OTA_CodeType EAT | 0..1 | A numeric value represents the type of email address. Refer to the OTA code lists: Email Address Type (EAT) | |||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes reference to @ShareAllOptOutInd (only possible in OnPrem) |
| ||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the email address is the primary email address for the profile. onPrem: If more than one email address is imported and for one this attribute is set to "Yes", then this one will be added to the "Communication methods" - all further email addresses will be added to "more communication methods". If all passed email addresses have this attribute set to "Yes", then they will be added in order of sending - the first one to Communication methods and the remaining to "More communication methods". |
| ||
@Remark | StringLength1to128 | 0..1 | A remark associated with the email address. OnPrem: Only imported if the email address is shown under "more communication methods" in the guest profile. | |||
Profile | Customer | URL | 0..5 | Information on a URL for the customer. | ||||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes referred to @ShareAllOptOutInd |
| ||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the URL is the primary URL for the profile. |
| ||
Profile | Customer | Address | 0..99 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’s mail address. | ||||
@Type | OTA_CodeType CLT | 1 | A numeric reference to the type of address. Refer to the OTA code lists: Communication Location Type(CLT). | |||
@FormattedInd | boolean | 0..1 | Specifies if the associated data is formatted or not. When true, then it is formatted; when false, then not formatted. |
| ||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the address is the primary for the profile. |
| ||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes. |
| ||
@UseType | OTA_CodeType AUT | 0..1 | Describes the use of the address (e.g. mailing, delivery, billing, etc.). Refer to the OTA Code List: Address Use Type (AUT). | |||
Profile | Customer | Address | AddressLine | StringLength1to255 | 0..5 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’s address. More than one line can be sent. | |||
Profile | Customer | Address | CityName | StringLength1to64 | 0..1 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’s city.City (e.g., Dublin), town or postal station (i.e., a postal service territory, often used in a military address). | |||
Profile | Customer | Address | StateProv | 0..1 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’sState or Province name (e.g., Texas). | ||||
@StateCode | StateProvCodeType | 0..1 | ||||
Profile | Customer | Address | PostalCode | StringLength1to16 | 0..1 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’s Postal / ZIP code. | |||
Profile | Customer | Address | CountryName | 0..1 | This path is used to transmit the Customer details. Details of the company or Travel agency use a different path. This field would be used to pass the guest’sCountry name (e.g., Ireland). | ||||
@Code | ISO3166 | 0..1 | A 2 character country code as defined in ISO 3166 alpha-2 | |||
Profile | Customer | CitizenCountryName | 0..3 | Name of the (self-professed) country that is claimed for citizenship. | ||||
@Code | ISO3166 | 0..1 | A 2 character country code as defined in ISO 3166 alpha-2 | |||
@DefaultInd | boolean | 0..1 | When true, indicates a default value should be used. |
| ||
Profile / Customer / RelatedTraveler | 0..99 | Identifies a traveler associated with the customer. | Section is supported only on message OTA_HotelResNotifRQ | |||
@BirthDate | date | 0..1 | Related Traveler date of birth | |||
Profile / Customer / RelatedTraveler / UniqueID | 0..1 | Identifies the profile of the related traveler | ||||
@Type | 1 | A reference to the type of object defined by the UniqueID element | Unique ID Type (UIT) | |||
@ID | 1 | A unique identifying value assigned by the creating system. Used as primary-key database reference. | ||||
Profile / Customer / RelatedTraveler / PersonName | 0..1 | Person associated with the traveler. | ||||
Profile / Customer / RelatedTraveler / PersonName / NamePrefix | StringLength1to16 | 0..3 | Salutation of honorific | Mr., Mrs., Ms,... | ||
Profile / Customer / RelatedTraveler / PersonName / GivenName | StringLength1to16 | 0..5 | Given name, first name or names | |||
Profile / Customer / RelatedTraveler / PersonName / Surname | StringLength1to64 | 1 | Family name, last name | |||
Profile / Customer / RelatedTraveler / PersonName / Document | 0..1 | Document information for verification purposes | ||||
@DocID | StringLength1to32 | 0..1 | Unique number assigned by authorities to document | |||
@DocType | 0..1 | Indicates the type of document | Document Type (DOC) | |||
Profile / Customer / RelatedTraveler / TPA_Extensions / GuestStayExtensions / StayInfo | 0..1 | |||||
@Arrival | dateTime | 0..1 | Arrival DateTime of the RelatedTraveler | |||
@Departure | dateTime | 0..1 | Depature DateTime of the RelatedTraveler | |||
@RelationToPrimary | string | 0..1 | Indicates the relationship to the main guest of a reservation. | |||
@PrimaryInd | boolean | 0..1 | This indicates the primary guest on a reservation. In case of multiple guests on a reservation, the guest responsible for payment, etc. will be marked true. |
| ||
Profile | Customer | Document | 0..99 | Detailed document information for the customer (e.g.; driver's license, passport, visa). | ||||
@DocIssueCountry | ISO3166 | 0..1 | Country where the document was issued. | |||
@ExpireDate | date | 0..1 | Indicates the ending date. | yyyy-mm-dd | ||
@EffectiveDate | date | 0..1 | Indicates the starting date. | yyyy-mm-dd | ||
@DocIssueLocation | StringLength1to64 | 0..1 | Indicates the location where the document was issued. | |||
@DocID | StringLength1to32 | 0..1 | Unique number assigned by authorities to document. | |||
@DocType | OTA_CodeType DOC | 0..1 | Indicates the type of document (e.g.; Passport, Driver’s License and national ID). | |||
Profile | Customer | CustLoyalty | 0..25 | Optional. This path enables the user to pass specific IDs linked to the guest profile. | ||||
@ProgramID | StringLength1to16 | 0..1 | The ProgramID attribute can be used to indicate the program that is being passed. For instance, we could use it to pass: Frequent Guest, Frequent Traveller and Company ID. | |||
@MembershipID | StringLength1to32 | 0..1 | The membershipID attribute will indicate the actual number. | |||
@RPH | RPH_Type | 0..1 | A reference placeholder for this loyalty membership. | |||
@LoyalLevel | StringLength1to16 | 0..1 | Indicates special privileges in the program assigned to individuals. | |||
@EffectiveDate | date | 1 | Indicates the starting date of the program. | yyyy-mm-dd | ||
@ExpireDate | date | 1 | Indicates the expiration date of the program. | yyyy-mm-dd | ||
@SignupDate | date | 0..1 | Indicates the customer’s sign-up date. | yyyy-mm-dd | ||
@AllianceLoyaltyLevelName | StringLength1to128 | 0..1 | Name of the program including level | |||
@PrimaryLoyaltyIndicator | boolean | 0..1 | When true, indicates this is the primary customer loyalty program, and when false, indicates this is not the primary customer loyalty program. |
| ||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes. If the value=Inherit, specifies data sharing permissions for marketing purposes. |
| ||
@ShareSynchInd | NMTOKEN | 0..1 | Permission for sharing data for synchronization of the information held by other travel service providers. If the value = "Inherit," specifies data sharing permissions for synchronization of the information held by other travel service providers. |
| ||
@Remark | StringLength1to128 | 0..1 | A remark associated with the customer’s loyalty program. onPrem: only in "more communication methods" | |||
@VendorCode | StringLength1to8 | 0..1 | Name of the program including level. | |||
Profile | Customer | CustLoyalty | SubAccountBalance | 0..99 | Used to specify a sub-account and its point balance associated with this loyalty account. | ||||
@Type | StringLength1to16 | 0..1 | Describes the type of sub-account (e.g. miles, points, vouchers, stays). | |||
@Balance | integer | 0..1 | The current balance for this sub-account. | |||
Profile | Customer | EmployerInfo | 0..1 | This path contains information about the employer from the guest’s profile. It is used to pass the full name of the company if it is mentioned in the guest’s profile. | ||||
@CompanyShortName | StringLength1to32 | 0..1 | Identifies the company’s short name if it is mentioned in the guest’s profile | |||
@Department | StringLength1to32 | 0..1 | Identifies the department the guest is working for if it is mentioned in the guest’s profile | |||
Profile | Customer | TPA_Extensions | 0..n | Could be used to pass additional Profile data upon agreement between partners (specific Keys or codes, for instance). | ||||
Profile | Customer | TPA_Extensions | px:UserDefinedFieldExtensions | UserDefinedField | 0..1 | |||||
@Name | StringLength1to32 | 0..1 | UDF name value | |||
@Type | StringLength1to32 | 0..1 | UDF type | |||
Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | _ProfileInfoExtensions | 0..1 | A placeholder in the schema to allow for additional elements and attributes to be included per Trading Partner Agreement (TPA). | |||
Profile | CompanyInfo | 0..1 | Detailed name information for the company. | ||||
Profile | CompanyInfo | CompanyName | 0..1 | Complete name information for the company. | ||||
@CompanyShortName | StringLength1to32 | 0..1 | Identifies the company’s short name. | |||
@Department | StringLength1to32 | 0..1 | The department name or ID with which the company contact is associated. | |||
Profile | CompanyInfo | ContactPerson | 0..1 | Information on a contact person for the customer. | ||||
@Relation | StringLength1to32 | 0..1 | Indicates the type of relationship with the person or company in the profile |
| ||
Profile | CompanyInfo | ContactPerson | PersonName | 0..5 | Detailed name information for the customer. | ||||
Profile | CompanyInfo | ContactPerson | PersonName | NamePrefix | StringLength1to16 | 0..3 | The Salutation for the name. This SHOULD be a value representing an individual (Mr., Mrs., Dr.) and not Mr. and Mrs. | |||
Profile | CompanyInfo | ContactPerson | PersonName | GivenName | StringLength1to64 | 0..5 | Given name, first name, or names. | |||
Profile | CompanyInfo | ContactPerson | PersonName | Surname | StringLength1to64 | 0..1 | Family name | |||
Profile | CompanyInfo | AddressInfo | 0..5 | Detailed information on an address for the company. | ||||
@Type | OTA_CodeType CLT | 1 | A numeric reference to the type of address. Refer to the OTA code lists: Communication Location Type(CLT). | |||
@FormattedInd | boolean | 0..1 | Specifies if the associated data is formatted or not. When true, then it is formatted; when false, then not formatted. |
| ||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the address is the primary for the profile. |
| ||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes. |
| ||
@UseType | OTA_CodeType AUT | 0..1 | Describes the use of the address (e.g. mailing, delivery, billing, etc.). Refer to the OTA Code List: Address Use Type (AUT). | |||
Profile | CompanyInfo | AddressInfo | AddressLine | StringLength1to255 | 0..5 | This path is used to transmit the details for a Company or Travel agency profile. IT is mandatory if a company or travel agency profile is passed. Address line is repeatable up to 5 times. The Type attribute is not needed here as a business address is implied. | |||
Profile | CompanyInfo | AddressInfo | CityName | StringLength1to64 | 0..1 | This element is used to pass the Company or Travel Agency’s City. | |||
Profile | CompanyInfo | AddressInfo | StateProv | 0..1 | This element is used to pass the Company or Travel Agency’s State. | ||||
@StateCode | StateProvCodeType | 0..1 | ||||
Profile | CompanyInfo | AddressInfo | PostalCode | StringLength1to16 | 0..1 | This element is used to pass the Company or Travel Agency’s postal or ZIP code. | |||
Profile | CompanyInfo | AddressInfo | CountryName | 0..1 | This element is used to pass the Company or Travel Agency’s Country. | ||||
@Code | ISO3166 | 0..1 | A 2 character country code as defined in ISO 3166 alpha-2 | |||
Profile | CompanyInfo | TelephoneInfo | 0..n | This element is used to pass the Company or Travel Agency’s phone and numbers. | ||||
@PhoneTechType | OTA_CodeType PTT | 1 | A numeric value represents the type of technology associated with this telephone number. Refer to OTA Code List: Phone Technology Type (PTT). | |||
@PhoneNumber | StringLength1to32 | 1 | Contains the actual number as a string of max 32 characters and it is Mandatory. | |||
@PhoneLocationType | OTA_CodeType PLT | 0..1 | A numeric value represents the type of phone. Refer to the OTA code lists: Phone Location Type (PLT) | |||
@FormattedInd | boolean | 0..1 | As country code and area code is not passed they appear in the PhoneNumber field. The entire number is passed in the PhoneNumber field and FormattedInd is set to NO to indicate that the PhoneNumber field contains the entire phone number without a specific format.
| |||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes. reference to @ShareAllOptOutInd (only possible in OnPrem)
| |||
@Remark | StringLength1to128 | 0..1 | A remark associated with the telephone number. onPrem: Only imported if the email address is shown under "more communication methods" in the guest profile. | |||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the phone number is the primary for the profile. | |||
Profile | CompanyInfo | Email | 0..1 | This path is used to transmit the details for a Company or Travel agency profile. This element is used to pass the Company or Travel Agency’s email. The EmailType attribute is not needed here as it is clearly a business address. | ||||
@EmailType | OTA_CodeType EAT | 0..1 | A numeric value represents the type of email address. Refer to the OTA code lists: Email Address Type (EAT) | |||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes reference to @ShareAllOptOutInd (only possible in OnPrem)
| |||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the email address is the primary for the profile. | |||
@Remark | StringLength1to128 | 0..1 | A remark associated with the email address. OnPrem: Only imported if the email address is shown under "more communication methods" in the guest profile. | |||
Profile | CompanyInfo | URL | 0..n | Information on a URL for the Company or Travel Agencies. | ||||
@ShareMarketInd | YesNoType | 0..1 | Permission for sharing data for marketing purposes referred to @ShareAllOptOutInd
| |||
@DefaultInd | boolean | 0..1 | A boolean value is used to indicate whether the URL is the primary for the profile. | |||
Profile | TPA_Extensions | 0..n | Could be used to pass additional Profile data upon agreement between partners (specific Keys or codes, for instance). | For all non-private Profiles, the TPA Extensions are displayed in the root Element | |||
Profile | TPA_Extensions | px:UserDefinedFieldExtensions | UserDefinedField | 0..1 | Profile User defined filed information. | ||||
@Name | StringLength1to32 | 0..1 | UDF name value | |||
@Type | StringLength1to32 | 0..1 | UDF type | |||
Profile | TPA_Extensions | px:ProfileInfoExtensions | _ProfileInfoExtensions | 0..1 | A placeholder in the schema to allow for additional elements and attributes to be included per Trading Partner Agreement (TPA). | |||
Profile | Comments | 0..1 | A collection of comments. | ||||
Profile | Comments | Comment | 1..n | Comments related to the profile. | ||||
@Name | StringLength1to64 | 0..1 | The value “Customer_Comment” is used for Comments saved in the customer’s profile. The value “Restaurant_Comment” is used for Comments saved in the customer’s profile relevant to the restaurant (On Premise Only) | |||
Profile | Comments | Comment | Text | 0..1 | Formatted text content. Provides text and indicates whether it is formatted or not. | ||||
@TextFormat | PlainText | 0..1 | Indicates the format of text used in the description. | |||
Profile | PrefCollections | 0..1 | A collection of preferences | ||||
Profile | PrefCollections | PrefCollection | 1..n | Aggregation of customer needs | ||||
Profile | PrefCollections | PrefCollection | HotelPref | 1..n | A set of preferences for hotel stay | ||||
Profile | PrefCollections | PrefCollection | HotelPref | BedTypePref | 0..1 | Indicates preferences for the size and features of hotel bed types. | ||||
@BedType | OTA_CodeType BED | 0..1 | Indicates the hotel bed type requested. Refer to OpenTravel Code List Bed Type (BED). | |||
Profile | PrefCollections | PrefCollection | HotelPref | RoomAmenityPref | 0..1 | Indicates preferences for hotel room amenities. | ||||
@RoomAmenity | OTA_CodeType RMA | 0..1 | Identify the types of room amenities offered by the property. Refer to OpenTravel Code List Room Amenity Type (RMA). | |||
Profile | PrefCollections | PrefCollection | HotelPref | PhysChallFeaturePref | 0..1 | Indicates preferences for the type of features required to meet the needs of persons with physical challenges, disabilities, etc. | ||||
@PhysChallFeatureType | OTA_CodeType PHY | 0..1 | Identifies the types of features the hotel offers to service physically challenged guests. Refer to OpenTravel Code List Disability Feature Code (PHY). | |||
Profile | PrefCollections | PrefCollection | HotelPref | PropertyAmenityPref | 0..1 | Indicates preferences for hotel property amenities. | ||||
@PropertyAmenityType | OTA_CodeType HAC | 0..1 | Identifies the amenities offered by the hotel. Refer to OpenTravel Code List Hotel Amenity Code (HAC). | |||
Profile | PrefCollections | PrefCollection | HotelPref | RoomLocationPref | 0..1 | Indicates preferences for hotel room locations. | ||||
@RoomLocationType | OTA_CodeType RLT | 0..1 | Identifies the location of the room within the property. Refer to OpenTravel Code List Room Location Type (RLT). |