Seitenhistorie

Element | Attribute	Type	Num	Description +  Content	Comments outbound	pAir	OnPrem	ProfileInfo | UniqueID	1..99	Identifies the profile to be modified together with the owner of the profile or an ID provided by the client.			@ID	StringLength1to32	1	The ID will transfer the HotelID and needs to be agreed by the trading partners and remain the same throughout the messages.
@ID_Context	StringLength1to32	1	Used to identify where the ID comes from.	"protelIO"
@Type	OTA_CodeType UIT	1	A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT)

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117810178" target="_blank">Unique ID Type (UIT)</a>

The travel sector the company is associated with, such as air, car and hotel. Refer to OpenTravel Code List Travel Sector (TVS). 

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117825146" target="_blank">Travel Sector (TVS)</a>

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117825146" target="_blank">Travel Sector (TVS)</a>

• "io.protel.onpremise"
• "io.protel.air"

ProfileInfo | Profile

1

Root element for profile content

@ProfileType

1

Numeric reference to the type of profile such as guest, company, agent etc. Refer to the OTA Code Lists: Profile Type (PRT)

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117818430" target="_blank">Profile Type (PRT)</a>

@StatusCode

1

Numeric reference to the status of a profile. Refer to the OTA Code Lists: Profile Status (PST).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117818434" target="_blank">Profile Status (PST)</a>

@RPH

0..1

This is a unique reference used as an index for this profile in a reservation.

@ShareAllOptOutInd

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.

• "Yes"
• "No"

@CreateDateTime

0..1

Timestamp of the creation.

@CreatorID

0..1

Identifies the profile creator. The creator could be a software system identifier or an identifier of an employee responsible for the creation.

ProfileInfo | Profile | Customer

0..1

Contains basic data on the customer’s identity, location, relationships, finances, memberships, etc.

@VIP_Indicator

0..1

A boolean value used to flag a very important person.

• "true"

• "true"

@CustomerValue

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

0..1

The customer’s birthday information.
yyyy-mm-dd

@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

0..1

A string value representing a customer’s gender.
Note: The values are case-sensitive!

• Male
• Female
• Unknown

• Male
• Female
• Unknown

ProfileInfo | Profile | Customer | PersonName

0..5

Detailed name information for the customer.

ProfileInfo | Profile | Customer | PersonName | Surname

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.

ProfileInfo | Profile | Customer | PersonName | NamePrefix

0..3

This field would be used to pass the guest’s NamePrefix (e.g. salutation).

ProfileInfo | Profile | Customer | PersonName | GivenName

0..5

This field would be used to pass the guest’s GivenName.

ProfileInfo | Profile | Customer | PersonName | MiddleName

0..3

The second given name of the person name.

ProfileInfo | Profile | Customer | Telephone

0..99

Information on a telephone number for the customer.

@PhoneTechType

1

A numeric value represents the type of technology associated with this telephone number. Refer to OTA Code List: Phone Technology Type (PTT).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817961" target="_blank">Phone Technology Type (PTT)</a>

@PhoneNumber

1

Contains the actual number as a string of max 32 characters and it is Mandatory.

@PhoneLocationType

0..1

A numeric value represents the type of the phone. Refer to the OTA code lists: Phone Location Type (PLT)

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817958" target="_blank">Phone Location Type (PLT)</a>

@FormattedInd

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.

• "true"
• "false"

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes.

reference to @ShareAllOptOutInd (only possible in OnPrem) 

• "Yes"
• "No"

@Remark

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

0..1

A boolean value is used to indicate whether the phone number is the primary for the profile.

• "true"
• "false"

ProfileInfo | 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

0..1

A numeric value representing the type of email address. Refer to the OTA code lists: Email Address Type (EAT)

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817963" target="_blank">Email Address Type (EAT)</a>

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes

reference to @ShareAllOptOutInd (only possible in OnPrem)

• "Yes"
• "No"

@DefaultInd

0..1

A boolean value 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".

• "true"
• "false"

@Remark

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.

Permission for sharing data for marketing purposes reference to @ShareAllOptOutInd

• "Yes"
• "No"

• "true"
• "false"

ProfileInfo | 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

1

A numeric reference to the type of address. Refer to the OTA code lists: Communication Location Type(CLT).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817965" target="_blank">Communication Location Type (CLT)</a>

@FormattedInd

0..1

Specifies if the associated data is formatted or not. When true, then it is formatted; when false, then not formatted.

• "true"
• "false"

@DefaultInd

0..1

A boolean value is used to indicate whether the address is the primary for the profile.

• "true"
• "false"

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes.

• "Yes"
• "No"

@UseType

0..1

Describes the use of the address (e.g. mailing, delivery, billing, etc.). Refer to the OTA Code List: Address Use Type (AUT).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817967" target="_blank">Address Use Type (AUT)</a>

ProfileInfo | Profile | Customer | Address | AddressLine

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.

ProfileInfo | Profile | Customer | Address | CityName

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).

ProfileInfo | 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).

0..1

ProfileInfo | Profile | Customer | Address | PostalCode

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.

ProfileInfo | 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

0..1

A 2 character country code as defined in ISO 3166 alpha-2

ProfileInfo | Profile | Customer | CitizenCountryName

0..3

Name of the (self-professed) country that is claimed for citizenship.

@Code

0..1

A 2 character country code as defined in ISO 3166 alpha-2

@DefaultInd

0..1

When true, indicates a default value should be used.

• "true"
• "false"

ProfileInfo | Profile | Customer | Document

0..99

Detailed document information for the customer (e.g.; driver license, passport, visa).

@DocIssueCountry

0..1

Country where the document was issued.

@ExpireDate

0..1

Indicates the ending date.
yyyy-mm-dd

@EffectiveDate

0..1

Indicates the starting date.
yyyy-mm-dd

@DocIssueLocation

0..1

Indicates the location where the document was issued.

@DocID

0..1

Unique number assigned by authorities to document.

@DocType

0..1

Indicates the type of document (e.g.; Passport, Driver’s License and national ID).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117820374" target="_blank">Document Type (DOC)</a>

ProfileInfo | Profile | Customer | CustLoyalty

0..25

Optional. This path enables the user to pass specific IDs linked to the guest profile.

@ProgramID

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

0..1

The membershipID attribute will indicate the actual number.

@RPH

0..1

A reference placeholder for this loyalty membership.

@LoyalLevel

0..1

Indicates special privileges in program assigned to individual.

@EffectiveDate

1

Indicates the starting date of the program.

@ExpireDate

1

Indicates the expiration date of the program.

@SignupDate

0..1

Indicates the customer’s sign-up date.

@AllianceLoyaltyLevelName

0..1

Name of the program including level

@PrimaryLoyaltyIndicator

0..1

When true, indicates this is the primary customer loyalty program and when false, indicates this is not the primary customer loyalty program.

• "true"
• "false"

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes. If the value=Inherit, specifies data sharing permissions for marketing purposes.

• "Yes"
• "No"

@ShareSynchInd

0..1

Permission for sharing data for synchronisation of information held by other travel service providers. If the value = "Inherit," specifies data sharing permissions for synchronisation of information held by other travel service providers.

• "Yes"
• "No"

@Remark

0..1

A remark associated with the customer’s loyalty program.

onPrem:  only in "more communication mehtods"

@VendorCode

0..1

Name of the program including level.

ProfileInfo | Profile | Customer | CustLoyalty | SubAccountBalance

0..99

Used to specify a sub-account and its point balance associated with this loyalty account.

@Type

0..1

 Describes the type of sub account (e.g. miles, points, vouchers, stays).

@Balance

0..1

The current balance for this sub account.

ProfileInfo | 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

0..1

Identifies the company’s short name if it is mentioned in the guest’s profile

@Department

0..1

Identifies the department the guest is working for if it is mentioned in the guest’s profile

ProfileInfo | Profile | Customer | TPA_Extensions

0..n

Could be used to pass additional Profile data upon agreement between partners (specific Keys or codes, for instance).

ProfileInfo | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions

0..1

<a href="https://confluence.protel.net/display/PIODOC/_ProfileInfoExtensions" target="_blank">_ProfileInfoExtensions</a>

Profile | CompanyInfo

0..1

Detailed name information for the company.

Profile | CompanyInfo | CompanyName

0..1

Complete name information for the company.

@CompanyShortName

0..1

Identifies the company’s short name.

@Department

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.

Indicates the type of relationship with the person or company in the profile

• Booker (Person who is responsable for the Reservation)
• InvoiceRecipient (Person who is responsable for the Invoice)

Profile | CompanyInfo | ContactPerson | PersonName

0..5

Detailed name information for the customer.

Profile | CompanyInfo | ContactPerson | PersonName | NamePrefix

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

0..5

Given name, first name, or names.

Profile | CompanyInfo | ContactPerson | PersonName | Surname

0..1

Family name

@Type

1

A numeric reference to the type of address. Refer to the OTA code lists: Communication Location Type(CLT).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817965" target="_blank">Communication Location Type (CLT)</a>

@FormattedInd

0..1

Specifies if the associated data is formatted or not. When true, then it is formatted; when false, then not formatted.

• "true"
• "false"

@DefaultInd

0..1

A boolean value is used to indicate whether the address is the primary for the profile.

• "true"
• "false

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes.

• "Yes"
• "No"

@UseType

0..1

Describes the use of the address (e.g. mailing, delivery, billing, etc.). Refer to the OTA Code List: Address Use Type (AUT).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817967" target="_blank">Address Use Type (AUT)</a>

Profile | CompanyInfo | AddressInfo | AddressLine

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

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.

Profile | CompanyInfo | AddressInfo | PostalCode

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

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

1

A numeric value represents the type of technology associated with this telephone number. Refer to OTA Code List: Phone Technology Type (PTT).

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817961" target="_blank">Phone Technology Type (PTT)</a>

@PhoneNumber

1

Contains the actual number as a string of max 32 characters and it is Mandatory.

@PhoneLocationType

0..1

A numeric value represents the type of the phone. Refer to the OTA code lists: Phone Location Type (PLT)

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817958" target="_blank">Phone Location Type (PLT)</a>

@FormattedInd

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.

• "true"
• "false"

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes.

reference to @ShareAllOptOutInd (only possible in OnPrem) 

• "true"
• "false"

@Remark

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

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

0..1

A numeric value representing the type of email address. Refer to the OTA code lists: Email Address Type (EAT)

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117817963" target="_blank">Email Address Type (EAT)</a>

@ShareMarketInd

0..1

Permission for sharing data for marketing purposes

reference to @ShareAllOptOutInd (only possible in OnPrem)

• "Yes"
• "No"

@DefaultInd

0..1

A boolean value is used to indicate whether the email address is the primary for the profile.

@Remark

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.

Permission for sharing data for marketing purposes referred to @ShareAllOptOutInd

• "Yes"
• "No"

0..n

Profile | TPA_Extensions | px:ProfileInfoExtensions

0..1

<a href="https://confluence.protel.net/display/PIODOC/_ProfileInfoExtensions" target="_blank">_ProfileInfoExtensions</a>

Indicates the format of text used in the description.

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117820381" target="_blank">Bed Type (BED)</a>

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117819035" target="_blank">Room Amenity Type (RMA)</a>

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117820383" target="_blank">Disability Feature Code (PHY)</a>

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117820385" target="_blank">Hotel Amenity Code (HAC)</a>

<a href="https://confluence.protel.net/pages/viewpage.action?pageId=117820389" target="_blank">Room Location Type (RLT)</a>