EPS_EXT_ProfileUpdate (XML)

機能概要サンプルドキュメント開発時のご注意

API情報

当該機能は、Profileデータを更新する機能を搭載しているAPIです。

当該機能に対応しているデータは以下の２種類です。
Profile：
旅行会社や企業で取り扱っている顧客情報(旅客氏名、連絡先、SSR等)を、
あらかじめデータベースに登録することで、Profileとして一元管理することが可能です。

Filter ：
Profileに登録したデータのうち、PNRへ反映する項目をあらかじめ定義することが可能です。

Service Action Code	：EPS_EXT_ProfileUpdateRQ
最新バージョン	：6.42.0
プロトコル	：XML

更新履歴

EPS_EXT_ProfileUpdateRQ v6.42.0 on January 24, 2022

Version 6.42.0をリリースいたしました。

リクエストサンプル

> リクエストサンプル*Profile更新(全更新)

Profile全更新

Profileの全更新について
Sabre_OTA_ProfileUpdateRQ>ProfileInfo>Profile タグを利用してProfileデータを更新する場合は、更新箇所だけでなく既に登録済みのアイテムも併せて送信する必要があります。
登録済みのアイテムを送信しなかった場合、当該アイテムは削除されますので、ご注意ください。

 選択<Sabre_OTA_ProfileUpdateRQ Version="6.42.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sabre.com/eps/schemas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sabre.com/eps/schemas
..\schemaswsdl\Sabre_OTA_ProfileUpdateRQ.xsd" IgnoreTimeStampCheck="Y">
	<ProfileInfo>
		<Profile CreateDateTime="2021-02-10T07:33:01.465Z" UpdateDateTime="2021-02-10T07:33:01.465Z" PrimaryLanguageIDCode="EN-US">
			<TPA_Identity DomainID="XXXX" ProfileStatusCode="AC" ProfileTypeCode="TVL" UniqueID="987654321" ClientCode="TN" ClientContextCode="IFN" ProfileName="TVL PROFILE" ProfileNameModifyIndicator="Y" />
			<Traveler>
				<Customer BirthDate="1999-12-31" GenderCode="M" >
					<PersonName LanguageIDCode="EN-US" OrderSequenceNo="1">
						<NamePrefix>MR</NamePrefix>
						<GivenName>TARO</GivenName>
						<MiddleName>MID</MiddleName>
						<SurName>YAMADA</SurName>
					</PersonName>
					<Telephone LocationTypeCode="AGY" InformationText="/ABC1/TANAKA" PNRTelephoneTagIndicator="Y" OrderSequenceNo="1">
						<FullPhoneNumber>0120-111-222</FullPhoneNumber>
					</Telephone>
					<Email EmailTypeCode="BUS" EmailAddress="tvl1@mail.com" OrderSequenceNo="1" />
					<Address LocationTypeCode="BUS" OrderSequenceNo="1">
						<AddressLine>TOKYO</AddressLine>
					</Address>
					<PaymentForm TripTypeCode="AZ" ServiceUsageTypeCode="AL" OrderSequenceNo="1">
						<PaymentCard BankCardVendorCode="AX" CardNumber="123456789" CCViewAccess="N" ExpireDate="012021" >
							<CardHolderName>
								<CardHolderFullName>TARO YAMADA</CardHolderFullName>
							</CardHolderName>
						</PaymentCard>
					</PaymentForm>
					<Document DocID="TH1234567" DocTypeCode="PSPT" BirthDate="1999-12-31" ExpireDate="2020-12-31" BirthCountryCode="UA" DocHolderNationalityCode="JP" OrderSequenceNo="1" IsUsedForSecureFlightRules="Y">
						<DocHolder>
							<NamePrefix>MR</NamePrefix>
							<SurName>YAMADA</SurName>
							<GivenName>TARO</GivenName>
							<MiddleName>MID</MiddleName>
						</DocHolder>
					</Document>
					<CustLoyalty VendorTypeCode="AL" VendorCode="NH" MembershipID="111111" OrderSequenceNo="1" />
				</Customer>
				<TPA_Extensions>
					<Remark Text="6YAMADA" TypeCode="OT" CategoryCode="PNR" OrderSequenceNo="1" />
					<CustomerReferenceInfo BranchID="123" ReferenceID="456" DisplaySequenceNo="3" OrderSequenceNo="1" />
					<AssociatedProfiles AssocUniqueID="123456789" AssocProfileTypeCode="CRP" AssocProfileName="CRP PROFILE" DomainID="XXXX" ClientCode="TN" ClientContextCode="IFN" ProfileRelationTypeCode="AL" CreditBankIndicator="N" AssocFiltersInd="N" />
					<AssociatedFilters ClientCode="TN" ClientContextCode="IFN" DomainID="XXXX" FilterID="12312312" FilterName="PROFILE FILTER" OrderSequenceNo="1" />
				</TPA_Extensions>
			</Traveler>
		</Profile>
	</ProfileInfo>
</Sabre_OTA_ProfileUpdateRQ>

レスポンスサンプル(Profile全更新)

レスポンスのバージョン情報について
レスポンスデータに含まれるバージョン情報(Version="X.XX")は、最新バージョンの数字が返却されます。

 選択<Sabre_OTA_ProfileUpdateRS xmlns="http://www.sabre.com/eps/schemas" TimeStamp="2021-02-10T08:12:50.538Z" Version="6.62" CreateDateTime="2021-02-10T07:33:01.465Z" UpdateDateTime="2021-02-10T08:12:50.538Z">
  <ResponseMessage>
    <Success />
  </ResponseMessage>
  <Profile ClientCode="TN" ClientContextCode="IFN" UniqueID="987654321" ProfileTypeCode="TVL" ProfileName="TVL PROFILE" ProfileNameModifyIndicator="Y" DomainID="XXXX" ProfileStatusCode="AC" />
</Sabre_OTA_ProfileUpdateRS>

> リクエストサンプル*Profile更新(部分更新)

Profile部分更新

Profileの部分更新について
Sabre_OTA_ProfileUpdateRQ>ProfileInfo>PartialUpdates タグを利用することでProfileデータを部分的に更新
(削除、追加、変更)することが可能です。部分的に更新可能な項目はリクエストタグ定義書をご参照ください。

・Sabre_OTA_ProfileUpdateRQ>ProfileInfo>Delete    :   部分的に削除する項目を設定
・Sabre_OTA_ProfileUpdateRQ>ProfileInfo>Add         :   部分的に追加する項目を設定
・Sabre_OTA_ProfileUpdateRQ>ProfileInfo>Modify   :   部分的に変更する項目を設定

 選択<Sabre_OTA_ProfileUpdateRQ Version="6.42.0" TimeStamp="2019-09-17T14:47:17.000Z" xsi:schemaLocation="http://www.sabre.com/eps/schemas \schemas\Sabre_OTA_ProfileUpdateRQ.xsd" xmlns="http://www.sabre.com/eps/schemas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ProfileInfo>
    <PartialUpdates>
      <TPA_Identity ClientCode="TN" ClientContextCode="IFN" UniqueID="123456789" ProfileTypeCode="TVL" DomainID="XXXX" />
      <Delete>
        <DeleteSubtree child="/Profile/Traveler/Customer/Email">
          <MatchSubtree>
            <Traveler>
              <Email EmailTypeCode="BUS" EmailAddress="tvl1@mail.com" OrderSequenceNo="1" />
            </Traveler>
          </MatchSubtree>
        </DeleteSubtree>
      </Delete>
      <Add>
        <AddSubtree child="/Profile/Traveler/Customer/Telephone">
          <NewSubtree>
            <Traveler>
              <Telephone LocationTypeCode="AGY" InformationText="/ABC" PNRTelephoneTagIndicator="Y" OrderSequenceNo="1">
                <FullPhoneNumber>0120-111-222</FullPhoneNumber>
              </Telephone>
            </Traveler>
          </NewSubtree>
        </AddSubtree>
      </Add>
      <Modify>
        <ModifySubtree child="/Profile/Traveler/Customer/CustLoyalty">
          <MatchSubtree>
            <Traveler>
              <CustLoyalty VendorTypeCode="AL" VendorCode="NH" MembershipID="111111" OrderSequenceNo="2" />
            </Traveler>
          </MatchSubtree>
          <NewSubtree>
            <Traveler>
              <CustLoyalty VendorTypeCode="AL" VendorCode="AA" MembershipID="222222" OrderSequenceNo="2" />
            </Traveler>
          </NewSubtree>
        </ModifySubtree>
      </Modify>
    </PartialUpdates>
  </ProfileInfo>
</Sabre_OTA_ProfileUpdateRQ>

レスポンスサンプル(Profile部分更新)

レスポンスのバージョン情報について
レスポンスデータに含まれるバージョン情報(Version="X.XX")は、最新バージョンの数字が返却されます。

 選択<Sabre_OTA_ProfileUpdateRS xmlns="http://www.sabre.com/eps/schemas" TimeStamp="2021-02-16T09:49:02.561Z" Version="6.62" CreateDateTime="2021-02-08T02:54:40.613Z" UpdateDateTime="2021-02-16T09:49:02.561Z">
  <ResponseMessage>
    <Success />
  </ResponseMessage>
  <Profile ClientCode="TN" ClientContextCode="IFN" UniqueID="123456789" ProfileTypeCode="TVL" ProfileName="Template Profile" DomainID="XXXX" />
</Sabre_OTA_ProfileUpdateRS>

XMLタグ定義書

リクエスト　　(2022/01/24更新)

ダウンロード
レスポンス　　(2022/01/24更新)

ダウンロード

XMLスキーマ

【注意点】
各種XMLスキーマは、Sabre社提供のオリジナル版となるため、「XMLタグ定義書」の記載上、
利用不可の情報が含まれております。
スキーマを利用してアプリケーションを構築される場合の各タグの利用可否は、
必ず「XMLタグ定義書」にてご確認ください。

※弊社にて「XMLタグ定義書」を作成する際、各タグの利用可否確認を行っております

リクエストスキーマ

ダウンロード
レスポンススキーマ

ダウンロード

「Profile共通スキーマ」は、INFINI Developer Centerでご案内している全てのProfile APIで同一の内容が含まれており、共通してご利用いただけます。

Profile共通スキーマ

ダウンロード

注意事項

INFINI LINX PLUSの「Profile」GUIと併用してご利用いただく場合は、 ClientCode="TN" ClientContextCode="IFN" を必ずご指定ください。

リクエストサンプル
   <Sabre_OTA_ProfileUpdateRQ Version="6.42.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sabre.com/eps/schemas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sabre.com/eps/schemas ..\schemaswsdl\Sabre_OTA_ProfileUpdateRQ.xsd" IgnoreTimeStampCheck="Y">
      <ProfileInfo>
         <Profile CreateDateTime="2021-02-10T07:33:01.465Z" UpdateDateTime="2021-02-10T07:33:01.465Z" PrimaryLanguageIDCode="EN-US">
            <TPA_Identity DomainID="XXXX" ProfileStatusCode="AC" ProfileTypeCode="TVL" UniqueID="987654321" ClientCode="TN" ClientContextCode="IFN" ProfileName="TVL PROFILE" ProfileNameModifyIndicator="Y" />
            <Traveler> ... </Traveler>
         </Profile>
      </ProfileInfo>
   </Sabre_OTA_ProfileUpdateRQ>