Channel ID – Galileo uAPI 메뉴얼

Overview : 여행사 에 맞는 SCC 세팅된 스케쥴 요금을 노출 및 예약할 수 있다.

Channel ID를 사용하는 주된 이유는 여행 관리 프로세스를 개인화하고 최적화하기 위함입니다. 이는 여행사나 기업이 특정 여행 정책과 규칙을 더 세밀하게 적용하고 관리할 수 있게 해줍니다. Channel ID의 사용은 다음과 같은 여러 이점을 제공합니다:

맞춤화된 여행 정책 적용: Channel ID를 사용하면 여행 정책을 특정 그룹이나 개인에 맞게 맞춤 설정할 수 있습니다. 예를 들어, 경영진에게는 더 유연한 여행 규칙을 적용할 수 있으며, 다른 직원에게는 더 엄격한 예산 관리 규칙을 적용할 수 있습니다.
효율적인 여행 비용 관리: 여행 비용을 관리하는 데 있어서, Channel ID는 특정 여행 규칙과 예산 제한을 설정함으로써 비용 효율성을 높일 수 있습니다. 각 그룹이나 개인에 맞는 여행 옵션을 제공함으로써 불필요한 지출을 줄일 수 있습니다.
개선된 여행 경험: Channel ID를 통해 여행자의 선호도와 필요에 맞는 여행 옵션을 제공함으로써, 여행 경험을 개선할 수 있습니다. 이는 여행자 만족도를 높이고, 장기적으로는 충성도 있는 고객을 유지하는 데 기여할 수 있습니다.
효과적인 데이터 관리 및 분석: Channel ID를 활용하면 여행 데이터를 더 세밀하게 분류하고 분석할 수 있습니다. 이를 통해 여행 패턴을 파악하고, 비용 절감 기회를 식별하며, 여행 정책의 효과를 평가할 수 있습니다.
유연한 정책 조정: 시장 변화나 조직 내 변화에 따라 여행 정책을 신속하게 조정할 필요가 있을 때, Channel ID를 사용하면 각 그룹이나 개인별로 정책을 쉽게 업데이트하고 적용할 수 있습니다.

Channel ID의 이러한 이점은 조직이 여행 관리를 더 효과적으로 수행하게 하며, 여행자의 요구에 맞춘 서비스를 제공하면서 동시에 여행 관련 비용을 효율적으로 관리할 수 있게 합니다.

LowFareSearchReq 에서 사용


  <air:AirPricingModifiers AccountCodeFaresOnly="false" ETicketability="Required" FaresIndicator="AllFares" ChannelId="HYUN">

<air:AirPricingModifiers AccountCodeFaresOnly="false" ETicketability="Required" FaresIndicator="AllFares" ChannelId="HYUN">

AirPriceReq


            <ns2:AirPricingModifiers FaresIndicator="AllFares" InventoryRequestType="DirectAccess"
                                     ReturnServices="false" ChannelId="HYUN"/>

<ns2:AirPricingModifiers FaresIndicator="AllFares" InventoryRequestType="DirectAccess"

ReturnServices="false" ChannelId="HYUN"/>

UniversalRecordModifyReq : ReAirprice


주의) HostToken 을 따로 보낸다.

주의) HostToken 을 따로 보낸다.


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header/>
    <soapenv:Body>
        <ns2:UniversalRecordModifyReq ReturnRecord="true" Version="12" RetrieveProviderReservationDetails="true"
                                      TraceId="testNuuaTraceId" TargetBranch="P*******"
                                      xmlns="http://www.travelport.com/schema/common_v51_0"
                                      xmlns:ns6="http://www.travelport.com/schema/passive_v51_0"
                                      xmlns:ns5="http://www.travelport.com/schema/hotel_v51_0"
                                      xmlns:ns8="http://www.travelport.com/schema/rail_v51_0"
                                      xmlns:ns7="http://www.travelport.com/schema/cruise_v51_0"
                                      xmlns:ns2="http://www.travelport.com/schema/universal_v51_0"
                                      xmlns:ns4="http://www.travelport.com/schema/air_v51_0"
                                      xmlns:ns3="http://www.travelport.com/schema/vehicle_v51_0">
            <BillingPointOfSaleInfo OriginApplication="UAPI"/>
            <ContinuityCheckOverride>Yes</ContinuityCheckOverride>
            <ns2:RecordIdentifier UniversalLocatorCode="GMLJ01" ProviderCode="1G" ProviderLocatorCode="70R3TN"/>


            <ns2:UniversalModifyCmd Key="2">
                <ns2:AirAdd ReservationLocatorCode="GMLP32">
                    <ns4:AirPricingInfo Key="3kWHM2WDuDKA4r4dkgAAAA==" IncludesVAT="false"
                                        LatestTicketingTime="2024-02-26T23:59:00.000+09:00" PricingMethod="Guaranteed"
                                        ETicketability="Yes" PlatingCarrier="HY" ProviderCode="1G"
                                        TotalPrice="KRW488800" BasePrice="KRW331800" ApproximateTotalPrice="KRW488800"
                                        ApproximateBasePrice="KRW331800" Taxes="KRW157000" ApproximateTaxes="KRW157000">
                        <ns4:FareInfo Key="3kWHM2WDuDKA8r4dkgAAAA==" FareBasis="UPR6MOW" PassengerTypeCode="ADT"
                                      Origin="ICN" Destination="TAS" EffectiveDate="2024-02-19T15:21:00.000+09:00"
                                      DepartureDate="2024-07-15" Amount="KRW331800" NegotiatedFare="false"
                                      NotValidBefore="2024-07-15" NotValidAfter="2024-07-15" TaxAmount="KRW157000">
                            <Endorsement Value="HY ONLY"/>
                            <ns4:FareRuleKey FareInfoRef="3kWHM2WDuDKA8r4dkgAAAA==" ProviderCode="1G">
                                6UUVoSldxwgto6DPoFjnEMbKj3F8T9EyxsqPcXxP0TLGyo9xfE/RMsuWFfXVd1OAly5qxZ3qLwOXLmrFneovA5cuasWd6i8Dly5qxZ3qLwOXLmrFneovA7IWZnYZo7c7xWa1uaqI55k3aSkvhp2ybU+dug8MOP/zkHlRbUOEtEvAyGqh8JIaqByJOWJl8yBUewGs0X+BRjjV6xXgh71dJ2LgFn3B9sPdSU8gecfbWEnMU535bvD9TC7+MNplX1FI3cnL5vsnDZh9oPz8Mrs5/0PFc7ZmQhP+mpBH9wehGMHzZTj9vGWa+ZB5UW1DhLRL/AFKEXb03hK/he9va7VDH7+F729rtUMfv4Xvb2u1Qx+/he9va7VDHxDGJun84l6GmjYuszn207WOnxkQ2WPPHvaVUAnec78/Ec5kGShczzb88ZYISr4I99JqdgwLBUGVm/Hr8l2o6Es=
                             </ns4:FareRuleKey>
                        </ns4:FareInfo>
                        <ns4:BookingInfo BookingCode="U" CabinClass="Economy" FareInfoRef="3kWHM2WDuDKA8r4dkgAAAA=="
                                         SegmentRef="aRvFM2zCuDKAV5TT2gAAAA==" HostTokenRef="3kWHM2WDuDKA3r4dkgAAAA=="/>
                        <ns4:TaxInfo Key="3kWHM2WDuDKA5r4dkgAAAA==" Category="BP" Amount="KRW28000"/>
                        <ns4:TaxInfo Key="3kWHM2WDuDKA6r4dkgAAAA==" Category="YQ" Amount="KRW116100"/>
                        <ns4:TaxInfo Key="3kWHM2WDuDKA7r4dkgAAAA==" Category="YR" Amount="KRW12900"/>
                        <ns4:FareCalc>SEL HY TAS 252.35UPR6MOW NUC252.35END ROE1314.80676</ns4:FareCalc>
                        <ns4:PassengerType Code="ADT" BookingTravelerRef="SkTAM2B3nDKA0M95qgAAAA==" />
                        
                        <ns4:AirPricingModifiers ChannelId="HYUN" FaresIndicator="AllFares" InventoryRequestType="Basic"/>
                        <ns4:BaggageAllowances>
                            <ns4:BaggageAllowanceInfo TravelerType="ADT" Origin="ICN" Destination="TAS" Carrier="HY">
                                <ns4:URLInfo>
                                    <ns4:URL>VIEWTRIP.TRAVELPORT.COM/BAGGAGEPOLICY/HY</ns4:URL>
                                </ns4:URLInfo>
                                <ns4:TextInfo>
                                    <ns4:Text>2P</ns4:Text>
                                    <ns4:Text>BAGGAGE DISCOUNTS MAY APPLY BASED ON FREQUENT FLYER STATUS/ ONLINE
                                        CHECKIN/FORM OF PAYMENT/MILITARY/ETC.
                                    </ns4:Text>
                                </ns4:TextInfo>
                                <ns4:BagDetails ApplicableBags="1stChecked" BasePrice="KRW0" ApproximateBasePrice="KRW0"
                                                TotalPrice="KRW0" ApproximateTotalPrice="KRW0">
                                    <ns4:BaggageRestriction>
                                        <ns4:TextInfo>
                                            <ns4:Text>UPTO50LB/23KG AND UPTO62LI/158LCM</ns4:Text>
                                        </ns4:TextInfo>
                                    </ns4:BaggageRestriction>
                                </ns4:BagDetails>
                                <ns4:BagDetails ApplicableBags="2ndChecked" BasePrice="KRW0" ApproximateBasePrice="KRW0"
                                                TotalPrice="KRW0" ApproximateTotalPrice="KRW0">
                                    <ns4:BaggageRestriction>
                                        <ns4:TextInfo>
                                            <ns4:Text>UPTO50LB/23KG AND UPTO62LI/158LCM</ns4:Text>
                                        </ns4:TextInfo>
                                    </ns4:BaggageRestriction>
                                </ns4:BagDetails>
                            </ns4:BaggageAllowanceInfo>
                            <ns4:CarryOnAllowanceInfo Origin="ICN" Destination="TAS" Carrier="HY">
                                <ns4:TextInfo>
                                    <ns4:Text>1P</ns4:Text>
                                </ns4:TextInfo>
                                <ns4:CarryOnDetails ApplicableCarryOnBags="1" BasePrice="KRW0"
                                                    ApproximateBasePrice="KRW0" TotalPrice="KRW0"
                                                    ApproximateTotalPrice="KRW0">
                                    <ns4:BaggageRestriction>
                                        <ns4:TextInfo>
                                            <ns4:Text>UPTO18LB/8KG AND UPTO45LI/115LCM</ns4:Text>
                                        </ns4:TextInfo>
                                    </ns4:BaggageRestriction>
                                </ns4:CarryOnDetails>
                            </ns4:CarryOnAllowanceInfo>
                        </ns4:BaggageAllowances>
                    </ns4:AirPricingInfo>
                   
                </ns2:AirAdd>
            </ns2:UniversalModifyCmd>
			
           <ns2:UniversalModifyCmd Key="3">
                <ns2:AirAdd ReservationLocatorCode="GMLP32">
                    <HostToken Key="3kWHM2WDuDKA3r4dkgAAAA==">GFB10101ADT00  01UPR6MOW                               010001#GFB200010101NADTV3008HYPR0030000199DD#GFMCXPF008NHYPR HY ADTUPR6MOW</HostToken>
                </ns2:AirAdd>
            </ns2:UniversalModifyCmd>
			
        </ns2:UniversalRecordModifyReq>
    </soapenv:Body>
</soapenv:Envelope>

100

101

102

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

<soapenv:Header/>

<soapenv:Body>

<ns2:UniversalRecordModifyReq ReturnRecord="true" Version="12" RetrieveProviderReservationDetails="true"

TraceId="testNuuaTraceId" TargetBranch="P*******"

xmlns="http://www.travelport.com/schema/common_v51_0"

xmlns:ns6="http://www.travelport.com/schema/passive_v51_0"

xmlns:ns5="http://www.travelport.com/schema/hotel_v51_0"

xmlns:ns8="http://www.travelport.com/schema/rail_v51_0"

xmlns:ns7="http://www.travelport.com/schema/cruise_v51_0"

xmlns:ns2="http://www.travelport.com/schema/universal_v51_0"

xmlns:ns4="http://www.travelport.com/schema/air_v51_0"

xmlns:ns3="http://www.travelport.com/schema/vehicle_v51_0">

<ns2:RecordIdentifier UniversalLocatorCode="GMLJ01" ProviderCode="1G" ProviderLocatorCode="70R3TN"/>

<ns2:UniversalModifyCmd Key="2">

<ns2:AirAdd ReservationLocatorCode="GMLP32">

<ns4:AirPricingInfo Key="3kWHM2WDuDKA4r4dkgAAAA==" IncludesVAT="false"

LatestTicketingTime="2024-02-26T23:59:00.000+09:00" PricingMethod="Guaranteed"

ETicketability="Yes" PlatingCarrier="HY" ProviderCode="1G"

TotalPrice="KRW488800" BasePrice="KRW331800" ApproximateTotalPrice="KRW488800"

ApproximateBasePrice="KRW331800" Taxes="KRW157000" ApproximateTaxes="KRW157000">

<ns4:FareInfo Key="3kWHM2WDuDKA8r4dkgAAAA==" FareBasis="UPR6MOW" PassengerTypeCode="ADT"

Origin="ICN" Destination="TAS" EffectiveDate="2024-02-19T15:21:00.000+09:00"

DepartureDate="2024-07-15" Amount="KRW331800" NegotiatedFare="false"

NotValidBefore="2024-07-15" NotValidAfter="2024-07-15" TaxAmount="KRW157000">

<ns4:FareRuleKey FareInfoRef="3kWHM2WDuDKA8r4dkgAAAA==" ProviderCode="1G">

6UUVoSldxwgto6DPoFjnEMbKj3F8T9EyxsqPcXxP0TLGyo9xfE/RMsuWFfXVd1OAly5qxZ3qLwOXLmrFneovA5cuasWd6i8Dly5qxZ3qLwOXLmrFneovA7IWZnYZo7c7xWa1uaqI55k3aSkvhp2ybU+dug8MOP/zkHlRbUOEtEvAyGqh8JIaqByJOWJl8yBUewGs0X+BRjjV6xXgh71dJ2LgFn3B9sPdSU8gecfbWEnMU535bvD9TC7+MNplX1FI3cnL5vsnDZh9oPz8Mrs5/0PFc7ZmQhP+mpBH9wehGMHzZTj9vGWa+ZB5UW1DhLRL/AFKEXb03hK/he9va7VDH7+F729rtUMfv4Xvb2u1Qx+/he9va7VDHxDGJun84l6GmjYuszn207WOnxkQ2WPPHvaVUAnec78/Ec5kGShczzb88ZYISr4I99JqdgwLBUGVm/Hr8l2o6Es=

</ns4:FareRuleKey>

</ns4:FareInfo>

<ns4:BookingInfo BookingCode="U" CabinClass="Economy" FareInfoRef="3kWHM2WDuDKA8r4dkgAAAA=="

SegmentRef="aRvFM2zCuDKAV5TT2gAAAA==" HostTokenRef="3kWHM2WDuDKA3r4dkgAAAA=="/>

<ns4:TaxInfo Key="3kWHM2WDuDKA5r4dkgAAAA==" Category="BP" Amount="KRW28000"/>

<ns4:TaxInfo Key="3kWHM2WDuDKA6r4dkgAAAA==" Category="YQ" Amount="KRW116100"/>

<ns4:TaxInfo Key="3kWHM2WDuDKA7r4dkgAAAA==" Category="YR" Amount="KRW12900"/>

<ns4:FareCalc>SEL HY TAS 252.35UPR6MOW NUC252.35END ROE1314.80676</ns4:FareCalc>

<ns4:PassengerType Code="ADT" BookingTravelerRef="SkTAM2B3nDKA0M95qgAAAA==" />

<ns4:AirPricingModifiers ChannelId="HYUN" FaresIndicator="AllFares" InventoryRequestType="Basic"/>

<ns4:BaggageAllowances>

<ns4:BaggageAllowanceInfo TravelerType="ADT" Origin="ICN" Destination="TAS" Carrier="HY">

<ns4:URLInfo>

<ns4:URL>VIEWTRIP.TRAVELPORT.COM/BAGGAGEPOLICY/HY</ns4:URL>

</ns4:URLInfo>

<ns4:TextInfo>

<ns4:Text>2P</ns4:Text>

<ns4:Text>BAGGAGE DISCOUNTS MAY APPLY BASED ON FREQUENT FLYER STATUS/ ONLINE

CHECKIN/FORM OF PAYMENT/MILITARY/ETC.

</ns4:Text>

</ns4:TextInfo>

<ns4:BagDetails ApplicableBags="1stChecked" BasePrice="KRW0" ApproximateBasePrice="KRW0"

TotalPrice="KRW0" ApproximateTotalPrice="KRW0">

<ns4:BaggageRestriction>

<ns4:TextInfo>

<ns4:Text>UPTO50LB/23KG AND UPTO62LI/158LCM</ns4:Text>

</ns4:TextInfo>

</ns4:BaggageRestriction>

</ns4:BagDetails>

<ns4:BagDetails ApplicableBags="2ndChecked" BasePrice="KRW0" ApproximateBasePrice="KRW0"

TotalPrice="KRW0" ApproximateTotalPrice="KRW0">

<ns4:BaggageRestriction>

<ns4:TextInfo>

<ns4:Text>UPTO50LB/23KG AND UPTO62LI/158LCM</ns4:Text>

</ns4:TextInfo>

</ns4:BaggageRestriction>

</ns4:BagDetails>

</ns4:BaggageAllowanceInfo>

<ns4:CarryOnAllowanceInfo Origin="ICN" Destination="TAS" Carrier="HY">

<ns4:TextInfo>

<ns4:Text>1P</ns4:Text>

</ns4:TextInfo>

<ns4:CarryOnDetails ApplicableCarryOnBags="1" BasePrice="KRW0"

ApproximateBasePrice="KRW0" TotalPrice="KRW0"

ApproximateTotalPrice="KRW0">

<ns4:BaggageRestriction>

<ns4:TextInfo>

<ns4:Text>UPTO18LB/8KG AND UPTO45LI/115LCM</ns4:Text>

</ns4:TextInfo>

</ns4:BaggageRestriction>

</ns4:CarryOnDetails>

</ns4:CarryOnAllowanceInfo>

</ns4:BaggageAllowances>

</ns4:AirPricingInfo>

</ns2:AirAdd>

</ns2:UniversalModifyCmd>

<ns2:UniversalModifyCmd Key="3">

<ns2:AirAdd ReservationLocatorCode="GMLP32">

<HostToken Key="3kWHM2WDuDKA3r4dkgAAAA==">GFB10101ADT00 01UPR6MOW 010001#GFB200010101NADTV3008HYPR0030000199DD#GFMCXPF008NHYPR HY ADTUPR6MOW</HostToken>

</ns2:AirAdd>

</ns2:UniversalModifyCmd>

</ns2:UniversalRecordModifyReq>

</soapenv:Body>

</soapenv:Envelope>

문서 링크

https://support.travelport.com/webhelp/uapi/Content/Release_Notes/Release_Notes__16_3.htm

Previously, when a carrier offered Rich Content and Branding for multiple brands within a fare family that has the same class of service and/or fare basis code, the brand could not be priced with the higher fare. The lowest fare brand was returned instead of the higher upsell fare.

With this enhancement, a brand with a higher fare can be requested by sending one or more host tokens in the price, book, and modify requests. Send the UniversalRecordModifyReq with UniversalModifyCmd/AirAdd/AirPricingInfo and UniversalModifyCmd/AirAdd/HostToken. The AirPricingInfo will have one or more BookingInfo that references a HostToken.

The HostTokenRef is validated to ensure a matching HostToken @Key.

Errors

When an AirCreateReservationReq is sent with AirPricingSolution/AirPricingInfo/BookingInfo @HostTokenRef but without AirPricingSolution/HostToken, an error is returned: The following attribute is missing in the AirCreateReservationReq: AirPricingSolution/HostToken.
When UniversalRecordModifyReq AirAdd is sent with AirPricingSolution/AirPricingInfo/BookingInfo @HostTokenRef but without AirPricingSolution/HostToken, an error is returned: The following attribute is missing in the UniversalRecordModifyReq: AirPricingSolution/HostToken.
When AirCreateReservationReq or UniversalRecordModifyReq AirAdd is sent with AirPricingSolution/AirPricingInfo/BookingInfo @HostTokenRef and AirPricingSolution/HostToken, but there is a no match between the @HostTokenRef and HostToken @Key, an error is returned: Key reference not found for HostToken with key reference [BookingInfo @HostTokenRef value] inside BookingInfo.
When AirCreateReservationReq or UniversalRecordModifyReq AirAdd is sent with AirPricingSolution/HostToken but without AirPricingSolution/AirPricingInfo/BookingInfo @HostTokenRef, an error is returned: The following attribute is missing: AirPricingSolution/AirPricingInfo/BookingInfo @HostTokenRef.

이 설명은 항공사가 동일한 서비스 클래스 및/또는 요금 기준 코드를 가진 요금 가족 내에서 여러 브랜드에 대해 풍부한 콘텐츠와 브랜딩을 제공할 때 발생하는 특정 문제와 이를 해결하기 위한 개선 사항에 관한 것입니다. 과거에는 요금이 같을 경우 더 높은 요금의 브랜드를 가격에 반영할 수 없었으며, 대신 가장 낮은 요금의 브랜드가 반환되었습니다. 이는 더 높은 업셀 요금으로의 가격 책정이 불가능했음을 의미합니다.

개선 사항으로, 더 높은 요금의 브랜드를 요청하기 위해 가격 책정, 예약, 수정 요청에 하나 이상의 호스트 토큰을 전송할 수 있습니다. 이를 위해 UniversalRecordModifyReq에 UniversalModifyCmd/AirAdd/AirPricingInfo 및 UniversalModifyCmd/AirAdd/HostToken을 포함하여 전송합니다. AirPricingInfo는 HostToken을 참조하는 하나 이상의 BookingInfo를 포함할 것입니다.

HostTokenRef는 HostToken @Key와 일치하는지 확인하기 위해 검증됩니다.