Remark : Branded Fare (multi) Price 하는 옵션
- Lowfare : 기존 ReturnUpsellFare=’true’ 로 요금선택으로 simple 하게 사용, 선택할수 있는 요금 1개 더해짐
- Price : Branded Fare 로 멀티 선택 하게 사용

Branded Fare는 항공사에서 운영하고 있는 상품이나 서비스를 항공 운임과 함께 패키지로 제공하여 타 항공사와 차별화를 추구하는 번들 운임입니다.
단순히 최저가 요금이 아닌 유료 좌석, 추가 항공 마일리지, 추가 수하물, 라운지 이용, 리무진 서비스 등 다양한 혜택을 함께 제공함으로써 여행자의 선택의 폭을 넓혀줍니다.

참조 : https://support.travelport.com/webhelp/uapi/Content/Air/Rich_Content_Branding/BrandedFares.htm
ATPCO Brand Code : https://www.atpco.net/sites/atpco-public/files/all_pdfs/Opt_Scvs_Industry_Sub_Codes_Online_C.pdf
옵션들 사용법 : Travelport Universal API – Universal API: Low Fare Shopping Modifiers
Upsell 옵션은 여행 업체나 항공사가 고객에게 여행에 더 많은 가치를 제공하거나 업그레이드된 서비스를 판매하는 방법 중 하나입니다. 이는 고객이 예약을 할 때 추가 비용을 지불하여 좀 더 편안하거나 특별한 여행 경험을 얻을 수 있도록 하는 것입니다.
Travelport Low Fare Search에서 Upsell 옵션은 일반적으로 다음과 같은 것들을 포함할 수 있습니다:
- 좌석 업그레이드: 고객이 경제석에서 비즈니스클래스나 프리미엄 이코노미 등으로 업그레이드할 수 있도록 하는 옵션입니다.
- 추가 수하물: 고객이 추가 수하물을 구매하여 무거운 짐을 운반할 수 있도록 하는 옵션입니다.
- 라운지 액세스: 고객이 공항 라운지에 입장하여 대기 시간을 편안하게 보낼 수 있도록 하는 옵션입니다.
- 식사 옵션: 항공사가 고객에게 항공기 내에서 특별한 식사를 제공하거나 미리 주문할 수 있도록 하는 옵션입니다.
- 선좌석 예약: 고객이 원하는 좌석을 미리 예약할 수 있도록 하는 옵션입니다.
Upsell 옵션은 여행 업체에 추가 수익을 창출하고 고객에게 더 나은 여행 경험을 제공하는데 도움을 줄 수 있습니다. Travelport Low Fare Search는 이러한 옵션을 통합하여 고객이 항공권 예약 시 추가 서비스를 선택할 수 있도록 지원합니다.
ICN-ALA (KC) ECONOMY (같은클래스 V) FareBasis VEE1MKC 가 한단계 높은 운임(ECONOMY PLUS) FareBasis VFF 도 나오게 하기(ECONOMY PLUS)
: LBR 노무자 요금중 수화물 2개인 요금이 나오게 하려면 ReturnUpsellFare=”true” 를 준다.
Upgrade to PLUS for a fully flexible fare option with increased checked baggage allowance.
Your PLUS fare includes:
• 2 pieces of free checked luggage (up to 23 KG each)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 |
<!-- 가독성을 높이기 위해 모든 네임스페이스를 위로 올림 --> <soapenv:Envelope xmlns:air="http://www.travelport.com/schema/air_v50_0" xmlns:com="http://www.travelport.com/schema/common_v50_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Header/> <soapenv:Body> <!-- TraceId : 로그 추적번호년도일시간초단위로 하면 추적에 도움 --> <!-- SolutionResult *false 요금기준으로 리턴 / true:여정기준으로 리턴 --> <!-- AuthorizedBy : 사용자 name --> <air:LowFareSearchReq TraceId="20220301102313" TargetBranch="P*******" ReturnUpsellFare="true" SolutionResult="true" AuthorizedBy="user" > <com:BillingPointOfSaleInfo OriginApplication="UAPI" /> <!-- 조회레그 왕복/다구간은 SearchAirLeg 6개까지 지원 --> <air:SearchAirLeg> <air:SearchOrigin> <com:CityOrAirport Code="SEL"/> <!-- 출발도시(공항) --> </air:SearchOrigin> <air:SearchDestination> <com:CityOrAirport Code="ALA"/> <!-- 도착도시(공항) --> </air:SearchDestination> <air:SearchDepTime PreferredTime="2020-11-16"/> </air:SearchAirLeg> <air:SearchAirLeg> <air:SearchOrigin> <com:CityOrAirport Code="ALA"/> <!-- 출발도시(공항) --> </air:SearchOrigin> <air:SearchDestination> <com:CityOrAirport Code="SEL"/> <!-- 도착도시(공항) --> </air:SearchDestination> <air:SearchDepTime PreferredTime="2020-11-26"/> </air:SearchAirLeg> <air:AirSearchModifiers> <air:PreferredProviders> <com:Provider Code="1G"/> <!-- 갈릴레오인 경우 1G --> </air:PreferredProviders> <!-- PreferredCarriers:선호항공사조회/ PermittedCarriers:허용항공사 조회/ ProhibitedCarriers:제외항공사조회 --> <!-- 위 항목 하나만 가능 --> <!-- interlineCon 협정항공사 / OnlineCon 단일항공사 / StopDirects 중간경유 / NonStopDirects 직항 --> <!-- 항공사 마다 요금이 잘 나오는 옵션이 다르기 옵션컨크롤이 중요 --> <air:PermittedCarriers> <com:Carrier Code="KC"/> </air:PermittedCarriers> <air:FlightType DoubleInterlineCon="false" SingleInterlineCon="false" TripleOnlineCon="false" DoubleOnlineCon="false" SingleOnlineCon="false" StopDirects="true" NonStopDirects="true"/> </air:AirSearchModifiers> <!-- 탑승객 --> <com:SearchPassenger Code="LBR"/> <!--com:SearchPassenger Code="ADT"/--> <!-- 요금 종류 --> <air:AirPricingModifiers ETicketability="Required" FaresIndicator="AllFares"> <air:AccountCodes> <com:AccountCode ProviderCode="1G" Code="KRE1"/> </air:AccountCodes> </air:AirPricingModifiers> </air:LowFareSearchReq> </soapenv:Body> </soapenv:Envelope> |
AirPrice Req
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 |
<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP:Body> <air:AirPriceReq xmlns:air="http://www.travelport.com/schema/air_v52_0" xmlns:com="http://www.travelport.com/schema/common_v52_0" TargetBranch="P3021757"> <com:BillingPointOfSaleInfo OriginApplication="UAPI" /> <air:AirItinerary> <air:AirSegment ArrivalTime="2024-07-11T16:35:00.000" Carrier="MH" DepartureTime="2024-07-11T11:00:00.000" Destination="KUL" ETicketability="Required" FlightNumber="67" Group="0" Key="OTg3NjU0MzIxMDU0MzIxMA==" OptionalServicesIndicator="false" Origin="ICN" ProviderCode="1G"> <air:Connection SegmentIndex="0" /> </air:AirSegment> <air:AirSegment ArrivalTime="2024-07-12T16:20:00.000" Carrier="MH" DepartureTime="2024-07-12T15:05:00.000" Destination="BKK" ETicketability="Required" FlightNumber="782" Group="0" Key="OTg3NjU0MzIxMDU0MzIxMQ==" OptionalServicesIndicator="false" Origin="KUL" ProviderCode="1G" /> <air:AirSegment ArrivalTime="2024-07-18T19:50:00.000" Carrier="MH" DepartureTime="2024-07-18T16:40:00.000" Destination="KUL" ETicketability="Required" FlightNumber="5863" Group="1" Key="OTg3NjU0MzIxMDU0MzIxMg==" OptionalServicesIndicator="false" Origin="BKK" ProviderCode="1G"> <air:CodeshareInfo OperatingCarrier="TG" /> <air:Connection SegmentIndex="2" /> </air:AirSegment> <air:AirSegment ArrivalTime="2024-07-19T06:50:00.000" Carrier="MH" DepartureTime="2024-07-18T23:10:00.000" Destination="ICN" ETicketability="Required" FlightNumber="5620" Group="1" Key="OTg3NjU0MzIxMDU0MzIxMw==" OptionalServicesIndicator="false" Origin="KUL" ProviderCode="1G"> <air:CodeshareInfo OperatingCarrier="KE" /> </air:AirSegment> </air:AirItinerary> <air:AirPricingModifiers FaresIndicator="AllFares" InventoryRequestType="Basic" PlatingCarrier="MH"> <air:BrandModifiers> <air:FareFamilyDisplay ModifierType="FareFamily" /> </air:BrandModifiers> </air:AirPricingModifiers> <com:SearchPassenger Code="ADT" Key="1" /> <com:SearchPassenger Age="9" Code="CNN" Key="2" /> <com:SearchPassenger Code="INF" Key="3" /> <air:AirPricingCommand> <air:AirSegmentPricingModifiers AirSegmentRef="OTg3NjU0MzIxMDU0MzIxMA=="> <!--air:PermittedBookingCodes> <air:BookingCode Code="S"/> </air:PermittedBookingCodes--> </air:AirSegmentPricingModifiers> <air:AirSegmentPricingModifiers AirSegmentRef="OTg3NjU0MzIxMDU0MzIxMQ=="> <!--air:PermittedBookingCodes> <air:BookingCode Code="S" /> </air:PermittedBookingCodes--> </air:AirSegmentPricingModifiers> <air:AirSegmentPricingModifiers AirSegmentRef="OTg3NjU0MzIxMDU0MzIxMg=="> <!--air:PermittedBookingCodes> <air:BookingCode Code="Q" /> </air:PermittedBookingCodes--> </air:AirSegmentPricingModifiers> <air:AirSegmentPricingModifiers AirSegmentRef="OTg3NjU0MzIxMDU0MzIxMw=="> <!--air:PermittedBookingCodes> <air:BookingCode Code="Q" /> </air:PermittedBookingCodes--> </air:AirSegmentPricingModifiers> </air:AirPricingCommand> </air:AirPriceReq> </SOAP:Body> </SOAP:Envelope> |
AirPriceRsp / Html
여정별 F/B

ATPCO Brand Code
ATPCO Brand Code : https://www.atpco.net/sites/atpco-public/files/all_pdfs/Opt_Scvs_Industry_Sub_Codes_Online_C.pdf

SmartPoint

대한항공 Brand 운임

:: 비고 ::
BrandTier Value
Lite : 0001
Basic : 0002
Flex : 0003
Business Basic : 0004
Business Flex : 0005
Business Comport : 0007
Business Elite : 0008
실전 : 다음 일정의 출발 BASIC + 리턴 BUSINESS FLEX 로 예약하기

1.Family Price Req
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:air="http://www.travelport.com/schema/air_v52_0" xmlns:com="http://www.travelport.com/schema/common_v52_0"> <soapenv:Header /> <soapenv:Body> <air:AirPriceReq TargetBranch="P******" TraceId="202406100936_51_082" AuthorizedBy="GALILEODEVLIVE"> <com:BillingPointOfSaleInfo OriginApplication="UAPI" /> <air:AirItinerary> <air:AirSegment ProviderCode="1G" Key="A1KtL/m3nDKAwZ0KuiAAAA==" Group="0" Carrier="MH" FlightNumber="67" Origin="ICN" Destination="KUL" DepartureTime="2024-07-05T11:00:00.000+09:00" ArrivalTime="2024-07-05T16:35:00.000+08:00" FlightTime="395" Distance="2877" ETicketability="Yes" Equipment="333" ChangeOfPlane="false" ParticipantLevel="Secure Sell" LinkAvailability="true" PolledAvailabilityOption="Cached status used. Polled avail exists" OptionalServicesIndicator="false" AvailabilitySource="P" AvailabilityDisplayType="Fare Shop/Optimal Shop" /> <air:AirSegment ProviderCode="1G" Key="A1KtL/m3nDKAyZ0KuiAAAA==" Group="1" Carrier="MH" FlightNumber="38" Origin="KUL" Destination="ICN" DepartureTime="2024-07-10T14:50:00.000+08:00" ArrivalTime="2024-07-10T22:30:00.000+09:00" FlightTime="400" Distance="2877" ETicketability="Yes" Equipment="333" ChangeOfPlane="false" ParticipantLevel="Secure Sell" LinkAvailability="true" PolledAvailabilityOption="Cached status used. Polled avail exists" OptionalServicesIndicator="false" AvailabilitySource="P" AvailabilityDisplayType="Fare Shop/Optimal Shop" /> </air:AirItinerary> <air:AirPricingModifiers AccountCodeFaresOnly="false" InventoryRequestType="DirectAccess" FaresIndicator="AllFares" PlatingCarrier="MH"> <air:BrandModifiers> <air:FareFamilyDisplay ModifierType="FareFamily" /> </air:BrandModifiers> </air:AirPricingModifiers> <com:SearchPassenger BookingTravelerRef="ADT01" Code="ADT" /> <air:AirPricingCommand> <air:AirSegmentPricingModifiers AirSegmentRef="A1KtL/m3nDKAwZ0KuiAAAA=="/> <air:AirSegmentPricingModifiers AirSegmentRef="A1KtL/m3nDKAyZ0KuiAAAA=="/> </air:AirPricingCommand> </air:AirPriceReq> </soapenv:Body> </soapenv:Envelope> |
2. Family Price Rsp

3. Brand Price Req
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:air="http://www.travelport.com/schema/air_v52_0" xmlns:com="http://www.travelport.com/schema/common_v52_0"> <soapenv:Header /> <soapenv:Body> <air:AirPriceReq TargetBranch="P*******" TraceId="202406101455_35_799" AuthorizedBy="GALILEODEVLIVE"> <com:BillingPointOfSaleInfo OriginApplication="UAPI" /> <air:AirItinerary> <air:AirSegment ProviderCode="1G" Key="UIyuL/pAuDKANazZYjAAAA==" Group="0" Carrier="MH" FlightNumber="67" Origin="ICN" Destination="KUL" DepartureTime="2024-07-05T11:00:00.000+09:00" ArrivalTime="2024-07-05T16:35:00.000+08:00" FlightTime="395" Distance="2877" ETicketability="Yes" Equipment="333" ChangeOfPlane="false" ParticipantLevel="Secure Sell" LinkAvailability="true" PolledAvailabilityOption="Cached status used. Polled avail exists" OptionalServicesIndicator="false" AvailabilitySource="P" AvailabilityDisplayType="Fare Shop/Optimal Shop" /> <air:AirSegment ProviderCode="1G" Key="UIyuL/pAuDKAPazZYjAAAA==" Group="1" Carrier="MH" FlightNumber="38" Origin="KUL" Destination="ICN" DepartureTime="2024-07-10T14:50:00.000+08:00" ArrivalTime="2024-07-10T22:30:00.000+09:00" FlightTime="400" Distance="2877" ETicketability="Yes" Equipment="333" ChangeOfPlane="false" ParticipantLevel="Secure Sell" LinkAvailability="true" PolledAvailabilityOption="Cached status used. Polled avail exists" OptionalServicesIndicator="false" AvailabilitySource="P" AvailabilityDisplayType="Fare Shop/Optimal Shop" /> </air:AirItinerary> <air:AirPricingModifiers AccountCodeFaresOnly="false" InventoryRequestType="DirectAccess" FaresIndicator="AllFares" PlatingCarrier="MH"> <air:BrandModifiers /> </air:AirPricingModifiers> <com:SearchPassenger BookingTravelerRef="ADT01" Code="ADT" /> <air:AirPricingCommand> <air:AirSegmentPricingModifiers AirSegmentRef="UIyuL/pAuDKANazZYjAAAA==" BrandTier="0002" /> <air:AirSegmentPricingModifiers AirSegmentRef="UIyuL/pAuDKAPazZYjAAAA==" BrandTier="0005" /> </air:AirPricingCommand> </air:AirPriceReq> </soapenv:Body> </soapenv:Envelope> |
4. Brand Price Rsp

5. AirCreate 결과
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
B0L - GALILEO KR TEST SEL 82HLGS/WS SELOU 7B0LGWS AG 99999992 10JUN 1.1HONG/GILNAM MR 1 . MH 67 O 05JUL ICNKUL HK1 1100 1635 O* E FR 2 . MH 38 C 10JUL KULICN HK1 1450 2230 O* E WE FQ1 - S1-2 AP G 10JUN24 WS/AG FQP1/S1-*7B0L*:BF0002.2-*7B0L*:BF0005/ET/:C/:P <<------------------------------출발 BASIC + 리턴 BUSINESS FLEX 로 예약 P1 HONG/GILNAM MR ADT G 10JUN24 * KRW 1496700 SEL MH KUL 176.25OLTBXKR MH SEL 826.20CBZ1YKR NUC1002.45END RO E1361.64901 FARE KRW1365000 TAX 28000BP TAX 43700G1 TAX 300H8 TAX 21300MY TAX 38400YQ TOT KRW1496700 ***ADDITIONAL FEES MAY APPLY*SEE>FO1· S1 FB-OLTBXKR B-20K NB-05JUL NA-05JUL S2 FB-CBZ1YKR B-50K NB-10JUL NA-10JUL NONEND-SUBJ TO PENALTY LAST DATE TO PURCHASE TICKET: 10JUN24 SUBTOTAL KRW 1496700 TOTAL FEES 0 GRAND TOTAL 1496700 <<VIEW BRAND DETAILS>> T P1/S1-2/CMH/ET/TA7B0L |
- Host Token: AirPrice 응답에서 반환된 정확한 요금을 예약 트랜잭션에서 유지합니다.
- Brand Tier: 예약 트랜잭션에서 요금을 다시 산정하여 원하는 브랜드 내 최적의 요금을 제공합니다.
주의 사항
- 가격 산정 요청에서 Brand Tier와 Fare Host Token을 동시에 보낼 경우, Brand Tier가 적용되고 Host Token은 무시되며, 이에 대한 경고 메시지가 반환됩니다: “The fare HostToken has been ignored. The BrandTier has been applied.”
- 가격 응답에서 Brand Tier와 Fare Host Token이 모두 반환될 수 있으며, 이를 Air Booking 또는 Universal Record Modify 요청에 그대로 복사하여 붙여넣으면 Host Token이 무시됩니다.
- Host Token을 Brand Tier 대신 사용하려면, Universal.xsd v43.0 이상에서 Brand Tier를 제거해야 합니다.