예약 수정(APIS 추가) – Galileo uAPI 메뉴얼

UniversalRecordModify

Endpoint : https://apac.universal-api.pp.travelport.com/B2BGateway/connect/uAPI/UniversalRecordService

Overview:

UniversalRecordModify로 발권 전 APIS, 마일리지, 체류지 등의 기타 사항을 등록 합니다.

미주는 APIS 를 입력하지 않고 발권 하면 다음과 같은 에러가 리턴된다.

Host error during ticket issue. ENSURE NAME DOB AND GENDER EXIST IN SSR DOCS FOR KE

SSR Type

DOCS

여권 정보 입력
FreeText=”P/KR/S12345678/GB/12JUN63/M/23OCT14/SMITH/JOHN” Carrier=”XX”

P = Passport (Travel Document Type)
KR = Issuing Country
123456788 = Document Number
GB = Passenger Nationality
12JUN63 = Date of Birth
M = Male gender
23OCT14 = Expiry date of passport (Travel Document Type)
SMITH = Last Name
JOHN = First Name
남자아기 – MI
여자아기 – FI

FOID

KC 항공사 여권번호
SI.P3/SSRFOIDYYHK1/PP12345678

DOCA

1G 주소정보 입력 Host 엔트리
SI.P1/SSRDOCAYYHK1/D/국가/상세주소/도시/주/우편번호
SI.P1/SSRDOCAYYHK1/D/US/1600 SMITH STREET/HOUSTON/TEXAS/25698

기타

VGML : Vegetarian vegan meal
WCHR: Wheelchair – R for Ramp (Passenger can ascend/descend steps and make own way to/from cabin seat but requires wheelchair for distance to/from aircraft)

Version=”숫자”

중요 : Version=”#” 값은 반드시 UniversalRecordRetrieveRsp 값에서 받고 UniversalRecordModifyReq에 넣고 전송시 UniversalRecordRetrieveRsp Version (증가된) 값 이 다시옵니다.
연속으로 UniversalRecordModifyReq 전송시 UniversalRecordRetrieveRsp 에서 온 Version 값으로 전송 합니다.

* 잘못 넣으면 에러메시지 : Universal record is being updated by another user or wrong version retrieved. Please retrieve the reservation again and try again. UR version is 1

오픈조 여정일 경우

<com:ContinuityCheckOverride>yes</com:ContinuityCheckOverride>
모든 여정에 넣어도 상관없다.

Segment continuity validation failed.

탑승객 정보 입력 예제


<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
	<SOAP:Body>
	<univ:UniversalRecordModifyReq xmlns:com="http://www.travelport.com/schema/common_v50_0" xmlns:univ="http://www.travelport.com/schema/universal_v50_0" 
                                       TargetBranch="P******" TraceId="2021001819111212" Version="0" ReturnRecord="true">
		<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>
                <com:ContinuityCheckOverride>yes</com:ContinuityCheckOverride>
		<univ:RecordIdentifier UniversalLocatorCode="A6Z2MF" ProviderLocatorCode="DL5BFI" ProviderCode="1G"/>
		<univ:UniversalModifyCmd Key="1"> <!-- * 다수명령어 전송 가능 -->
		<univ:AirAdd ReservationLocatorCode="T80SEN" BookingTravelerRef="YVFVaUpuVVFRYmFhRHIyUA==">
			<com:SSR Type="VGML" SegmentRef="kuNT0b7Q2BKAv5OpBAAAAA==" Carrier="KL"/>
			<com:SSR Type="WCHR" SegmentRef="kuNT0b7Q2BKAv5OpBAAAAA==" Carrier="KL"/>
			<com:SSR Type="DOCS" Carrier="KL" FreeText="P/KR/S12345678/GB/20JUL76/M/01JAN16/SMITH/TOM"/>
			<com:SSR Type="DOCA" Carrier="KL" FreeText="D/US/1600 SMITH STREET/HOUSTON/TEXAS/25698"/>
			<com:LoyaltyCard SupplierType="Air" CardNumber="123456" SupplierCode="KE"/>
			<com:LoyaltyCard SupplierType="Air" CardNumber="999999" SupplierCode="UA"/>
		</univ:AirAdd>
		</univ:UniversalModifyCmd>
	</univ:UniversalRecordModifyReq>
	</SOAP:Body>
</SOAP:Envelope>

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP:Body>

<univ:UniversalRecordModifyReq xmlns:com="http://www.travelport.com/schema/common_v50_0" xmlns:univ="http://www.travelport.com/schema/universal_v50_0"

TargetBranch="P******" TraceId="2021001819111212" Version="0" ReturnRecord="true">

<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>

<com:ContinuityCheckOverride>yes</com:ContinuityCheckOverride>

<univ:RecordIdentifier UniversalLocatorCode="A6Z2MF" ProviderLocatorCode="DL5BFI" ProviderCode="1G"/>

<univ:UniversalModifyCmd Key="1">

<univ:AirAdd ReservationLocatorCode="T80SEN" BookingTravelerRef="YVFVaUpuVVFRYmFhRHIyUA==">

<com:SSR Type="VGML" SegmentRef="kuNT0b7Q2BKAv5OpBAAAAA==" Carrier="KL"/>

<com:SSR Type="WCHR" SegmentRef="kuNT0b7Q2BKAv5OpBAAAAA==" Carrier="KL"/>

<com:SSR Type="DOCS" Carrier="KL" FreeText="P/KR/S12345678/GB/20JUL76/M/01JAN16/SMITH/TOM"/>

<com:SSR Type="DOCA" Carrier="KL" FreeText="D/US/1600 SMITH STREET/HOUSTON/TEXAS/25698"/>

<com:LoyaltyCard SupplierType="Air" CardNumber="123456" SupplierCode="KE"/>

<com:LoyaltyCard SupplierType="Air" CardNumber="999999" SupplierCode="UA"/>

</univ:AirAdd>

</univ:UniversalModifyCmd>

</univ:UniversalRecordModifyReq>

</SOAP:Body>

</SOAP:Envelope>

FOID 예제


<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
	<SOAP:Body>
	<univ:UniversalRecordModifyReq xmlns:com="http://www.travelport.com/schema/common_v50_0" xmlns:univ="http://www.travelport.com/schema/universal_v50_0" 
                                       TargetBranch="P3021757" TraceId="2021001819111212" Version="0" ReturnRecord="true">
		<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>
                 <com:ContinuityCheckOverride>yes</com:ContinuityCheckOverride>
		<univ:RecordIdentifier UniversalLocatorCode="I6ZMUZ" ProviderLocatorCode="F1TXTZ" ProviderCode="1G"/>
		<univ:UniversalModifyCmd Key="1">
		<univ:AirAdd ReservationLocatorCode="I6ZMV7" BookingTravelerRef="uF34LmIynDKAjs/JxLAAAA==">
			<com:SSR Type="FOID" Carrier="KC" FreeText="PP12345678"/>
		</univ:AirAdd>
		</univ:UniversalModifyCmd>
	</univ:UniversalRecordModifyReq>
	</SOAP:Body>
</SOAP:Envelope>

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP:Body>

<univ:UniversalRecordModifyReq xmlns:com="http://www.travelport.com/schema/common_v50_0" xmlns:univ="http://www.travelport.com/schema/universal_v50_0"

TargetBranch="P3021757" TraceId="2021001819111212" Version="0" ReturnRecord="true">

<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>

<com:ContinuityCheckOverride>yes</com:ContinuityCheckOverride>

<univ:RecordIdentifier UniversalLocatorCode="I6ZMUZ" ProviderLocatorCode="F1TXTZ" ProviderCode="1G"/>

<univ:UniversalModifyCmd Key="1">

<univ:AirAdd ReservationLocatorCode="I6ZMV7" BookingTravelerRef="uF34LmIynDKAjs/JxLAAAA==">

<com:SSR Type="FOID" Carrier="KC" FreeText="PP12345678"/>

</univ:AirAdd>

</univ:UniversalModifyCmd>

</univ:UniversalRecordModifyReq>

</SOAP:Body>

</SOAP:Envelope>


<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP:Body>
      <universal:UniversalRecordModifyRsp TraceId="2021001819111212" TransactionId="B0D1A2F30A0E7C7A68A5B6481E69FFD6" ResponseTime="948" xmlns:universal="http://www.travelport.com/schema/universal_v50_0" xmlns:common_v50_0="http://www.travelport.com/schema/common_v50_0" xmlns:air="http://www.travelport.com/schema/air_v50_0">
         <common_v50_0:ResponseMessage Code="0" Type="Warning" ProviderCode="1G">NO FARES</common_v50_0:ResponseMessage>
         <common_v50_0:ResponseMessage Code="0" Type="Info">Universal record successfully modified.</common_v50_0:ResponseMessage>
         <universal:UniversalRecord LocatorCode="I6ZMUZ" Version="2" Status="Active">
            <common_v50_0:BookingTraveler Key="uF34LmIynDKAjs/JxLAAAA==" TravelerType="ADT" DOB="1980-12-12" Gender="M">
               <common_v50_0:BookingTravelerName Prefix="MR" First="SCHEOL" Last="HEO"/>
               <common_v50_0:PhoneNumber Key="uF34LmIynDKAks/JxLAAAA==" Type="None" Location="SEL" Number="0102525****" Text="CLIENT CONNECT">
                  <common_v50_0:ProviderReservationInfoRef Key="uF34LmIynDKAPjCKxLAAAA=="/>
               </common_v50_0:PhoneNumber>
            </common_v50_0:BookingTraveler>
            <common_v50_0:OSI Key="uF34LmIynDKAls/JxLAAAA==" Carrier="KC" Text="CTCM SEL 0102525****" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA=="/>
            <common_v50_0:ActionStatus Key="uF34LmIynDKAms/JxLAAAA==" Type="ACTIVE" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" ProviderCode="1G"/>
            <universal:ProviderReservationInfo Key="uF34LmIynDKAPjCKxLAAAA==" ProviderCode="1G" LocatorCode="F1TXTZ" CreateDate="2021-05-28T02:16:47.350+00:00" ModifiedDate="2021-05-28T02:33:20.279+00:00" HostCreateDate="2021-05-28" OwningPCC="7B0L"/>
            <air:AirReservation LocatorCode="I6ZMV7" CreateDate="2021-05-28T02:16:47.030+00:00" ModifiedDate="2021-05-28T02:33:20.279+00:00">
               <common_v50_0:SupplierLocator SupplierCode="KC" SupplierLocatorCode="5EWJ4O" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" CreateDateTime="2021-05-28T02:16:00.000+00:00"/>
               <common_v50_0:BookingTravelerRef Key="uF34LmIynDKAjs/JxLAAAA=="/>
               <common_v50_0:ProviderReservationInfoRef Key="uF34LmIynDKAPjCKxLAAAA=="/>
               <air:AirSegment Key="uF34LmIynDKAhs/JxLAAAA==" Group="0" Carrier="KC" CabinClass="Economy" FlightNumber="910" ProviderCode="1G" Origin="ICN" Destination="ALA" DepartureTime="2021-06-29T02:00:00.000+09:00" ArrivalTime="2021-06-29T05:50:00.000+06:00" TravelTime="410" ClassOfService="Y" ETicketability="Yes" Equipment="32Q" Status="HK" ChangeOfPlane="false" GuaranteedPaymentCarrier="No" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" TravelOrder="1" ProviderSegmentOrder="1" OptionalServicesIndicator="false">
                  <air:FlightDetails Key="uF34LmIynDKARjCKxLAAAA==" Origin="ICN" Destination="ALA" DepartureTime="2021-06-29T02:00:00.000+09:00" ArrivalTime="2021-06-29T05:50:00.000+06:00" FlightTime="410" TravelTime="410" Equipment="32Q" OriginTerminal="1" AutomatedCheckin="false"/>
                  <common_v50_0:SellMessage>DEPARTS ICN TERMINAL 1</common_v50_0:SellMessage>
                  <common_v50_0:SellMessage>ADD ADVANCE PASSENGER INFORMATION SSRS DOCA/DOCO/DOCS</common_v50_0:SellMessage>
                  <common_v50_0:SellMessage>PERSONAL DATA WHICH IS PROVIDED TO US IN CONNECTION</common_v50_0:SellMessage>
                  <common_v50_0:SellMessage>WITH YOUR TRAVEL MAY BE PASSED TO GOVERNMENT AUTHORITIES</common_v50_0:SellMessage>
                  <common_v50_0:SellMessage>FOR BORDER CONTROL AND AVIATION SECURITY PURPOSES</common_v50_0:SellMessage>
               </air:AirSegment>
            </air:AirReservation>
            <common_v50_0:GeneralRemark Key="lSy0Lm6xnDKApwQpxLAAAA==" Category="Vendor" TypeInGds="Vendor" SupplierType="Air" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" SupplierCode="1A" Direction="Incoming" CreateDate="2021-05-28T02:16:00.000+00:00" ElStat="A">
               <common_v50_0:RemarkData>ADTK1GTOKC BY 04JUN 1116 SEL TIME ZONE OTHERWISE WILL BE XLD</common_v50_0:RemarkData>
            </common_v50_0:GeneralRemark>
            <common_v50_0:AgencyInfo>
               <common_v50_0:AgentAction ActionType="Created" AgentCode="uAPI7843645375-ac0ffeb9" BranchCode="P3021757" AgencyCode="S2626616" EventTime="2021-05-28T02:16:45.272+00:00"/>
               <common_v50_0:AgentAction ActionType="Modified" AgentCode="uAPI7843645375-ac0ffeb9" BranchCode="P3021757" AgencyCode="S2626616" EventTime="2021-05-28T02:33:20.279+00:00"/>
            </common_v50_0:AgencyInfo>
            <common_v50_0:AgencyContactInfo>
               <common_v50_0:PhoneNumber Key="uF34LmIynDKAUjCKxLAAAA==" Type="Agency" Location="SEL" CountryCode="82" Number="02777****" Text="Galileo">
                  <common_v50_0:ProviderReservationInfoRef Key="uF34LmIynDKAPjCKxLAAAA=="/>
               </common_v50_0:PhoneNumber>
            </common_v50_0:AgencyContactInfo>
            <common_v50_0:SSR Key="lSy0Lm6xnDKAexQpxLAAAA==" Status="HK" Type="FOID" FreeText="/PP12345678-1HEO/SCHEOLMR" Carrier="KC" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" ElStat="A"/>
         </universal:UniversalRecord>
      </universal:UniversalRecordModifyRsp>
   </SOAP:Body>
</SOAP:Envelope>

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP:Body>

<universal:UniversalRecordModifyRsp TraceId="2021001819111212" TransactionId="B0D1A2F30A0E7C7A68A5B6481E69FFD6" ResponseTime="948" xmlns:universal="http://www.travelport.com/schema/universal_v50_0" xmlns:common_v50_0="http://www.travelport.com/schema/common_v50_0" xmlns:air="http://www.travelport.com/schema/air_v50_0">

<common_v50_0:ResponseMessage Code="0" Type="Warning" ProviderCode="1G">NO FARES</common_v50_0:ResponseMessage>

<common_v50_0:ResponseMessage Code="0" Type="Info">Universal record successfully modified.</common_v50_0:ResponseMessage>

<universal:UniversalRecord LocatorCode="I6ZMUZ" Version="2" Status="Active">

<common_v50_0:BookingTraveler Key="uF34LmIynDKAjs/JxLAAAA==" TravelerType="ADT" DOB="1980-12-12" Gender="M">

<common_v50_0:BookingTravelerName Prefix="MR" First="SCHEOL" Last="HEO"/>

<common_v50_0:PhoneNumber Key="uF34LmIynDKAks/JxLAAAA==" Type="None" Location="SEL" Number="0102525****" Text="CLIENT CONNECT">

<common_v50_0:ProviderReservationInfoRef Key="uF34LmIynDKAPjCKxLAAAA=="/>

</common_v50_0:PhoneNumber>

</common_v50_0:BookingTraveler>

<common_v50_0:OSI Key="uF34LmIynDKAls/JxLAAAA==" Carrier="KC" Text="CTCM SEL 0102525****" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA=="/>

<common_v50_0:ActionStatus Key="uF34LmIynDKAms/JxLAAAA==" Type="ACTIVE" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" ProviderCode="1G"/>

<universal:ProviderReservationInfo Key="uF34LmIynDKAPjCKxLAAAA==" ProviderCode="1G" LocatorCode="F1TXTZ" CreateDate="2021-05-28T02:16:47.350+00:00" ModifiedDate="2021-05-28T02:33:20.279+00:00" HostCreateDate="2021-05-28" OwningPCC="7B0L"/>

<air:AirReservation LocatorCode="I6ZMV7" CreateDate="2021-05-28T02:16:47.030+00:00" ModifiedDate="2021-05-28T02:33:20.279+00:00">

<common_v50_0:SupplierLocator SupplierCode="KC" SupplierLocatorCode="5EWJ4O" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" CreateDateTime="2021-05-28T02:16:00.000+00:00"/>

<common_v50_0:BookingTravelerRef Key="uF34LmIynDKAjs/JxLAAAA=="/>

<common_v50_0:ProviderReservationInfoRef Key="uF34LmIynDKAPjCKxLAAAA=="/>

<air:AirSegment Key="uF34LmIynDKAhs/JxLAAAA==" Group="0" Carrier="KC" CabinClass="Economy" FlightNumber="910" ProviderCode="1G" Origin="ICN" Destination="ALA" DepartureTime="2021-06-29T02:00:00.000+09:00" ArrivalTime="2021-06-29T05:50:00.000+06:00" TravelTime="410" ClassOfService="Y" ETicketability="Yes" Equipment="32Q" Status="HK" ChangeOfPlane="false" GuaranteedPaymentCarrier="No" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" TravelOrder="1" ProviderSegmentOrder="1" OptionalServicesIndicator="false">

<air:FlightDetails Key="uF34LmIynDKARjCKxLAAAA==" Origin="ICN" Destination="ALA" DepartureTime="2021-06-29T02:00:00.000+09:00" ArrivalTime="2021-06-29T05:50:00.000+06:00" FlightTime="410" TravelTime="410" Equipment="32Q" OriginTerminal="1" AutomatedCheckin="false"/>

<common_v50_0:SellMessage>DEPARTS ICN TERMINAL 1</common_v50_0:SellMessage>

<common_v50_0:SellMessage>ADD ADVANCE PASSENGER INFORMATION SSRS DOCA/DOCO/DOCS</common_v50_0:SellMessage>

<common_v50_0:SellMessage>PERSONAL DATA WHICH IS PROVIDED TO US IN CONNECTION</common_v50_0:SellMessage>

<common_v50_0:SellMessage>WITH YOUR TRAVEL MAY BE PASSED TO GOVERNMENT AUTHORITIES</common_v50_0:SellMessage>

<common_v50_0:SellMessage>FOR BORDER CONTROL AND AVIATION SECURITY PURPOSES</common_v50_0:SellMessage>

</air:AirSegment>

</air:AirReservation>

<common_v50_0:GeneralRemark Key="lSy0Lm6xnDKApwQpxLAAAA==" Category="Vendor" TypeInGds="Vendor" SupplierType="Air" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" SupplierCode="1A" Direction="Incoming" CreateDate="2021-05-28T02:16:00.000+00:00" ElStat="A">

<common_v50_0:RemarkData>ADTK1GTOKC BY 04JUN 1116 SEL TIME ZONE OTHERWISE WILL BE XLD</common_v50_0:RemarkData>

</common_v50_0:GeneralRemark>

<common_v50_0:AgencyInfo>

<common_v50_0:AgentAction ActionType="Created" AgentCode="uAPI7843645375-ac0ffeb9" BranchCode="P3021757" AgencyCode="S2626616" EventTime="2021-05-28T02:16:45.272+00:00"/>

<common_v50_0:AgentAction ActionType="Modified" AgentCode="uAPI7843645375-ac0ffeb9" BranchCode="P3021757" AgencyCode="S2626616" EventTime="2021-05-28T02:33:20.279+00:00"/>

</common_v50_0:AgencyInfo>

<common_v50_0:AgencyContactInfo>

<common_v50_0:PhoneNumber Key="uF34LmIynDKAUjCKxLAAAA==" Type="Agency" Location="SEL" CountryCode="82" Number="02777****" Text="Galileo">

<common_v50_0:ProviderReservationInfoRef Key="uF34LmIynDKAPjCKxLAAAA=="/>

</common_v50_0:PhoneNumber>

</common_v50_0:AgencyContactInfo>

<common_v50_0:SSR Key="lSy0Lm6xnDKAexQpxLAAAA==" Status="HK" Type="FOID" FreeText="/PP12345678-1HEO/SCHEOLMR" Carrier="KC" ProviderReservationInfoRef="uF34LmIynDKAPjCKxLAAAA==" ElStat="A"/>

</universal:UniversalRecord>

</universal:UniversalRecordModifyRsp>

</SOAP:Body>

</SOAP:Envelope>


** OTHER SUPPLEMENTARY INFORMATION **
CARRIER RELATED
  1. KC  CTCM SEL 0102525****
  2. SSRFOIDKC HK  1 /PP12345678-1HEO/SCHEOLMR

** OTHER SUPPLEMENTARY INFORMATION **

CARRIER RELATED

1. KC CTCM SEL 0102525****

2. SSRFOIDKC HK 1 /PP12345678-1HEO/SCHEOLMR