Fare_InformativePricingWithoutPNR

PNR 없이 특정 운임을 확정 조회하고 uniqueOfferReference를 발급받는 API 용어집입니다. FBA(Fare Basis Assignment) 옵션을 사용한 운임 기저 지정 가격 조회도 이 API를 통해 수행합니다.

이 API는 WBS Integration Flow의 가격 조회 및 규정 확인 단계 Step 4 및 **후속 처리 단계 Step 16 (FBA)**에 해당합니다.

1. 개요

Amadeus GDS가 제공하는 PNR 없이 여정의 운임을 확정 가격 조회하는 API. 항공사, 서비스 공급자 및 거래 파트너가 발권 목적으로 여정의 가격을 요청할 수 있다. 응답으로 uniqueOfferReference를 발급받아 후속 발권/규정 조회에 활용한다.

[Query: 가격 조회 요청]
  승객 정보, 여정(구간별 항공편), Pricing Option
       │
       ▼
  Amadeus Fare Engine
       │
       ▼
[Reply: 가격 조회 결과]
  mainGroup
  ├─ generalIndicators: SITI/SOTO 등 Pricing Indicator
  ├─ pricingGroupLevelGroup × N (Fare Group별)
  │   ├─ numberOfPax: 해당 그룹 승객 수
  │   ├─ fareInfoGroup: 운임 상세
  │   │   ├─ emptySegment: PTC 정보
  │   │   ├─ pricingIndicators: Ticket Designator, NVA/NVB
  │   │   ├─ fareAmount: 운임 금액
  │   │   ├─ textData: Fare Calculation Line
  │   │   └─ offerReferences: uniqueOfferReference
  │   ├─ surchargesGroup: 세금/패널티/PFC
  │   ├─ corporateGroup: Corporate Fare 정보
  │   ├─ negoFareGroup: Negotiated Fare 정보
  │   └─ segmentLevelGroup × N (구간별)
  │       ├─ segmentInformation: 날짜/항공사/구간
  │       ├─ additionalInformation: Ticket Designator, NVA/NVB
  │       ├─ fareBasis: Fare Basis, Transportation Class
  │       ├─ cabinGroup: 캐빈/클래스 정보
  │       ├─ baggageAllowance: 수하물 허용량
  │       └─ fareComponentDetailsGroup: Fare Component 상세
  ├─ carrierFeeGroup: OB/OC Fee 내역
  └─ fareComponentDetailsGroup: Fare Component/Bound 상세

Query / Reply 구조

구분	메시지	설명
Query	`Fare_InformativePricingWithoutPNR 18.1.1A`	여정 + 승객 + Pricing Option을 포함한 가격 조회 요청
Reply	`Fare_InformativePricingWithoutPNRReply 18.1.1A`	운임 확정 결과 + Offer Reference 반환

항목	내용
API 명	`Fare_InformativePricingWithoutPNR`
플로우 단계	Step 4 — 가격 조회 및 규정 확인 / Step 16 — FBA 옵션
목적	운임 확정 조회 + Offer ID 발급, FBA 옵션으로 특정 Fare Basis 지정 가격 산출
이전 단계	Fare_InformativeBestPricingWithoutPNR
다음 단계	Fare_CheckRules

2. Query 주요 구조 (가격 조회 요청)

passengersGroup

승객 정보를 정의하는 구조. 최대 198개 그룹까지 지정 가능.

필드	구조	St	Rep	설명
`segmentRepetitionControl`	Segment repetition control	M	1	그룹 내 승객 수 및 Group Tattoo
`travellersID`	Specific traveller details	C	1	LCC 가격 조회 시 항공사가 제공하는 승객 Tattoo. FSC에는 사용하지 않음
`discountPtc`	Fare information	C	1	PTC (Passenger Type Code) 지정

segmentGroup

여정 구간 정보를 정의하는 구조. 최대 99개 구간까지 지정 가능.

필드	구조	St	Rep	설명
`segmentInformation`	Travel product information	M	1	항공사, 편명, 출발지/도착지, 날짜 등 구간 상세
`additionnalSegmentDetails`	Additional product details	C	1	기술 착륙(Tech Stop) 정보. 현재 deprecated
`inventory`	Product information	C	1	편 재고 정보 (개방 클래스, 잔여 좌석 수)

segmentInformation 하위 필드

필드	설명
`flightDate.departureDate`	출발일
`flightDate.departureTime`	출발 시간
`flightDate.arrivalDate`	도착일
`flightDate.arrivalTime`	도착 시간
`boardPointDetails.trueLocationId`	출발 공항 코드 (IATA 3자리)
`offpointDetails.trueLocationId`	도착 공항 코드
`companyDetails.marketingCompany`	마케팅 항공사 코드
`companyDetails.operatingCompany`	운항 항공사 코드
`flightIdentification.flightNumber`	편명 번호
`flightIdentification.bookingClass`	예약 클래스 (RBD)

pricingOptionGroup

운임 조회 옵션을 설정하는 구조. 최대 999개 옵션까지 지정 가능. FBA, RLO, 통화 지정, PTC 등 다양한 가격 산출 제어를 수행한다.

필드	구조	St	Rep	설명
`pricingOptionKey`	Coded pricing option key	M	1	Pricing Option 키 코드 (Attribute Key)
`optionDetail`	Attribute	C	1	옵션 상세 값 (name, value)
`carrierInformation`	Transport identifier	C	1	항공사 지정
`currency`	Currencies	C	1	통화 지정
`penDisInformation`	Discount and penalty information	C	1	할인/패널티 정보
`monetaryInformation`	Monetary information	C	1	금액 정보
`taxInformation`	Duty/tax/fee details	C	99	세금 정보
`dateInformation`	Structured date time information	C	2	날짜 정보 (과거 가격 조회 등)
`frequentFlyerInformation`	Frequent traveller identification code	C	1	상용고객 마일리지 정보
`formOfPaymentInformation`	Form of payment	C	1	결제 수단 정보
`locationInformation`	Place/location identification	C	1	지점 정보 (POS, POT 등)
`paxSegTstReference`	Reference information	C	1	승객/구간/TST 참조

3. Pricing Option Key (Attribute Key) 코드셋

가격 조회 동작을 제어하는 핵심 옵션 키. pricingOptionKey.pricingOptionKey 필드에 사용한다.

운임 유형 지정

코드	설명
RP	Published Fares — 공시 운임
RU	Unifares — 통합 운임
RC	Corporate negotiated fares — 기업 계약 운임
RW	Corporate Unifares — 기업 통합 운임
RN	Negotiated fare — 협정 운임
RLI	Return List of fare — 적용 가능한 운임 목록 반환
RLO	Return Lowest possible fare — 최저 운임 반환

FBA (Fare Basis Assignment) 관련

코드	설명
FBA	Fare BAsis simple override — Fare Basis 단순 지정
FBL	Fare Basis force override — Fare Basis 강제 지정
FBP	Force Break Point — 강제 구간 분리점 지정

통화 / 금액 제어

코드	설명
FCO	Fare Currency Override — 운임 통화 강제 지정
FCS	Fare Currency Selection — 운임 통화 선택
MBT	Fare amount override with M/BT — M/BT 기준 운임 금액 재정의
MIT	Fare amount override with M/IT — M/IT 기준 운임 금액 재정의

세금 / 수수료 제어

코드	설명
AC	Add Country taxes — 국가 세금 추가
AT	Add Tax — 세금 추가
ET	Exempt Taxes — 세금 면제
WC	Withhold Country taxes — 국가 세금 보류
WT	Withhold Tax — 세금 보류
WQ	Withhold Q surcharges — Q 서차지 보류
NF	No ticketing Fee — 발권 수수료 없음
OBF	OB Fees (include and/or exclude) — OB 수수료 포함/제외

가격 산출 제어

코드	설명
CC	Controlling Carrier Override — 관할 항공사 재정의
VC	Validating Carrier — 발권 항공사 지정
POS	Point Of Sale — 판매 지점 지정
POT	Point Of Ticketing override — 발권 지점 재정의
PTA	Point of Turnaround — 회항 지점 지정
DAT	past DATe pricing — 과거 날짜 기준 가격 조회
DO	booking Date Override — 예약 날짜 재정의
IP	Instant Pricing — 즉시 가격 조회
NBP	No BreakPoint — 구간 분리점 없음
CON	Connection — 환승 지정
STO	Stopover — 도중 체류 지정
GRI	Global Route Indicator — 글로벌 경유 지표

기타

코드	설명
PAX	Passenger discount/PTC — 승객 할인/PTC 지정
PTC	PTC only — PTC만 지정
PFF	Pricing by Fare Family — Fare Family 기준 가격 산출
PL	Pricing Logic — 가격 산출 로직
AWD	AWarD — 마일리지 보상 운임
BND	Bound Input — Bound 입력
DIA	Diagnostic Tool — 진단 도구
FOP	Form Of Payment — 결제 수단
MA	Mileage Accrual — 마일리지 적립
MC	Miles and Cash (Pricing by Points) — 마일리지+현금 혼합 결제
NOP	No Option — 옵션 없음
PRM	expanded PaRaMeters — 확장 파라미터
PSR	PSR — PSR
TKT	Ticket Type — 항공권 유형
ZAP	ZAP-off — ZAP 해제

4. Reply 주요 구조 (가격 조회 결과)

messageDetails

메시지 처리 결과를 담는 구조. 요청이 정상 수행되었는지 여부를 확인한다.

필드	구조	St	Rep	설명
`messageDetails`	Message action details	M	1	메시지 일반 정보, 요청 성공/실패 여부
`errorGroup`	Group	C	1	오류 발생 시 오류 코드 및 설명

mainGroup

응답의 핵심 구조. 모든 가격 조회 결과 데이터를 포함한다.

필드	구조	St	Rep	설명
`dummySegment`	Dummy segment	M	1	구분자 (의미 없음)
`convertionRate`	Conversion rate	C	1	통화 환율 정보
`generalIndicators`	Pricing/ticketing details	M	1	SITI, SOTO 등 Pricing Indicator 및 International 플래그
`pricingGroupLevelGroup`	Group	M*	99	Fare Group별 가격 상세
`carrierFeeGroup`	Group	C	9	Carrier Fee(OB/OC) 내역
`fareComponentDetailsGroup`	Group	C	99	Fare Component/Bound 수준 상세

generalIndicators (Pricing Indicator)

가격 조회의 글로벌 속성을 나타내는 지표. SITI/SOTO 구분, International 여부 등을 포함한다.

필드	설명
`priceTicketDetails.indicators`	가격 유형 한정자 (Price type qualifier)
`priceTariffType`	운임 유형 코드

priceTariffType 주요 값

코드	설명
P	PRIVATE — 비공개 운임
A	ATAF
I	IATA
M	NEGO — 협정 운임
N	DDF (Negotiated)
U	DDF CORP — DDF 기업 운임
D	TOUR — 관광 운임
T	DDF INC TOUR — DDF 포함 관광
K	DDF BULK TOUR — DDF 대량 관광
L	OVERRIDE
O	OVERRIDE

5. pricingGroupLevelGroup (Fare Group 상세)

승객 유형(PTC)별 운임 상세 정보를 포함하는 그룹. 최대 99개.

필드	구조	St	Rep	설명
`numberOfPax`	Segment repetition control	M	1	해당 Fare Group의 승객 수
`passengersID`	Specific traveller details	C	99	승객 ID (요청과 동일)
`fareInfoGroup`	Group	M*	1	운임 정보 상세
`surchargesGroup`	Group	C	1	세금/패널티/PFC
`corporateGroup`	Group	C	99	Corporate Fare 정보
`negoFareGroup`	Group	C	99	Negotiated Fare 정보
`segmentLevelGroup`	Group	C	99	구간별 운임 상세
`structuredFareCalcGroup`	Group	C	1	구조화된 Fare Calculation (미구현)
`carrierFeeGroup`	Group	C	9	Carrier Fee 내역
`fareComponentDetailsGroup`	Group	C	99	Fare Component/Bound 수준 상세

6. fareInfoGroup (운임 정보)

Fare Group 내 운임 핵심 정보.

필드	구조	St	Rep	설명
`emptySegment`	Fare information	M	1	PTC, Fare Indicator 등 운임 기본 정보
`pricingIndicators`	Pricing/ticketing details	C	1	Ticket Designator, NVA date, NVB date
`fareAmount`	Monetary information	C	1	운임 금액 (Base Fare, Equivalent, Total 등)
`textData`	Interactive free text	C	99	Fare Calculation Line, Mileage 계산선, Endorsement 정보
`offerReferences`	Group	C	1	Offer Reference — `uniqueOfferReference` 포함

fareAmount — typeQualifier 주요 값

monetaryDetails.typeQualifier 필드에 사용되는 금액 유형 코드.

코드	설명
B	Base — 기본 운임
C	Net Base Fare — 순 기본 운임
D	Total Base Fare (전체 승객)
E	Public Equivalent Fare — 공시 환산 운임
F	Public Base Fare — 공시 기본 운임
G	Grand Total Fare (전체 승객)
H	Total Tax Fare (전체 승객)
M	Maximum Penalty amount — 최대 패널티 금액
N	Net Equivalent Fare — 순 환산 운임
P	Payment — 결제 금액
Q	Previous Quoted Base Fare — 이전 견적 기본 운임
R	In House fare type/Corporate contract/Negotiated Fare 참조 금액
S	Point of Sale — 판매 지점
T	Tax — 세금

7. offerReferences 및 uniqueOfferReference

offerReferences
├─ offerIdentifier
│   ├─ reference     : 참조 번호 (an..6)
│   ├─ offerId       : Offer 식별자 (an..35)
│   └─ uniqueOfferReference : 고유 Offer 참조 (an..60)  ★ 핵심
└─ references        : 승객/구간 Tattoo 참조 (최대 99)
    ├─ type           : 참조 한정자 (Passenger/Segment)
    └─ value          : 참조 번호

uniqueOfferReference는 이 API의 핵심 출력값으로, 후속 단계인 Fare_CheckRules, Air_SellFromRecommendation 등에서 해당 운임을 식별하는 데 사용한다. WBS 플로우에서 Step 4에서 발급되어 이후 단계로 전달된다.

8. surchargesGroup (세금/패널티/PFC)

필드	구조	St	Rep	설명
`taxesAmount`	Tax details	M	1	세금 관련 데이터
`penaltiesAmount`	Discount and penalty information	C	1	패널티 관련 정보 (금액, 비율, 통화)
`pfcAmount`	Monetary information	C	5	Passenger Facility Charges (PFC)

9. segmentLevelGroup (구간별 운임 상세)

**개별 구간(Segment)**의 운임, Fare Basis, 캐빈, 수하물 정보를 포함.

필드	구조	St	Rep	설명
`segmentInformation`	Travel product information	M	1	구간 정보 (날짜, 항공사, 출발/도착)
`additionalInformation`	Pricing/ticketing details	C	1	Ticket Designator, NVA date, NVB date
`fareBasis`	Fare qualifier details	C	1	Transportation Class, Fare Basis, Fare by Rule 플래그
`cabinGroup`	Group	C	99	캐빈/클래스 정보 (서비스 등급별)
`baggageAllowance`	Excess baggage details	C	1	수하물 허용량
`ptcSegment`	Number of units	C	1	이 구간에 적용된 PTC
`couponInformation`	Quantity	C	1	국내선 쿠폰 값 / TPM

fareBasis 하위 필드

필드	설명
`fareBasisDetails.rateTariffClass`	Fare Basis Code (예: YOWKR, HLE3M)
`fareBasisDetails.otherRateTariffClass`	Ticket Designator

cabinGroup 하위 필드

필드	구조	설명
`cabinSegment`	Product information	캐빈 정보 — `bookingClassDetails.designator`에 RBD 포함
`baggageAllowance`	Excess baggage details	해당 캐빈의 수하물 허용량

10. fareComponentDetailsGroup (Fare Component 상세)

Fare Component 또는 Bound 수준의 상세 정보. Reply의 최상위 및 pricingGroupLevelGroup 내부에 모두 존재할 수 있다.

필드	구조	St	Rep	설명
`fareComponentID`	Item number	M	1	Fare Component 번호 (FC) 또는 Bound 번호 (BND)
`marketFareComponent`	Travel product information	C	1	시장 정보 (출발/도착 도시)
`monetaryInformation`	Monetary information	C	1	Fare Component별 금액
`componentClassInfo`	Pricing or ticketing subsequent	C	1	Fare Basis Code, Ticket Designator
`fareQualifiersDetail`	Fare qualifier details	C	1	Fare Qualifier 상세
`fareFamilyDetails`	Fare family	C	1	Fare Family 이름 및 계층
`fareFamilyOwner`	Transport identifier	C	1	Fare Family 소유 항공사
`couponDetailsGroup`	Group	M	99	Coupon 상세 (구간별)

fareComponentID — Item Number Type

코드	설명
FC	Fare Component — 운임 구성 요소
BND	Bound — 여정 방향 단위

fareFamilyDetails 하위 필드

필드	형식	설명
`fareFamilyname`	an..30	Fare Family 단축 이름 (예: LIGHT, STANDARD, FLEX)
`hierarchy`	n..4	Fare Family 내 계층 순서 (높을수록 상위 상품)
`commercialFamilyDetails.commercialFamily`	an..30	상업용 Fare Family 이름 (최대 20개)

11. carrierFeeGroup (Carrier Fee — OB/OC)

항공사 수수료(OB/OC Fee)의 상세 내역. 공항/정부 수수료가 아닌 항공사 자체 수수료를 항공권 수익과 별도로 추적한다.

필드	구조	St	Rep	설명
`feeType`	Selection details	M	1	수수료 성격 (OB, OC 등)
`feeDetails`	Group	C	99	개별 수수료 상세

feeDetails 하위 필드

필드	설명
`feeInfo`	수수료 정보
`feeAmounts`	수수료 금액 (세금 포함/미포함, 총 세금)
`feeTaxes`	이 수수료에 관련된 세금 (최대 99)
`feeDescription`	수수료 속성 (상업적 설명 등)

12. corporateGroup / negoFareGroup (기업/협정 운임)

corporateGroup

필드	구조	설명
`corporateData`	Fare calculation code details	Corporate Fare 유형, 계약 번호, 회사명

negoFareGroup

필드	구조	설명
`negoFareIndicators`	Pricing/ticketing subsequent	협정 운임 지표
`extNegoFareIndicators`	Fare qualifier details	확장 협정 운임 한정자
`negoFareAmount`	Discount and penalty information	협정 운임 금액
`negoFareText`	Interactive free text	발권 시 Fare/Total 박스에 인쇄할 내용

13. convertionRate (환율 정보)

통화 환산율 정보.

필드	형식	Codeset	설명
`conversionType`	an..3	9875 IA 02.2.153	환산 유형 코드
`currency`	an..3	6345 IA 02.2.2034	통화 코드 (ISO)
`rateType`	an..3	5419 IA 02.2.164	환율 유형 한정자
`pricingAmount`	n..18	-	가격 산출 금액
`convertedValueAmount`	n..18	-	환산 후 금액
`dutyTaxFeeType`	an..3	5153 IA 02.2.335	세금 유형

Conversion Type 주요 값 (9875 IA 02.2.153)

코드	설명
700	Fares — 운임
701	Not rounded / truncated
702	City — 도시
703	Country — 국가
704	Equivalent fare — 환산 운임
705	Origin of travel — 여행 출발지
B	Base — 기본
E	Public Equivalent Fare
F	Public Base Fare
T	Tax — 세금

14. Grouped Structure 참조

COUPONDETAILSTYPE

쿠폰(구간) 상세 정보.

필드	구조	설명
`productId`	Reference information	쿠폰 식별 Tattoo + 유형
`flightConnectionType`	Travel product information	편 접속 유형
`couponTaxDetailsGroup`	Group (x99)	쿠폰별 세금 상세

FARECOMPONENTDTLSTYPE

Fare Component 상세 유형.

필드	구조	설명
`fareComponentID`	Item number	FC/BND 식별 번호
`marketFareComponent`	Travel product information	시장 정보 (출발/도착)
`monetaryInformation`	Monetary information	금액 정보
`componentClassInfo`	Pricing or ticketing subsequent	클래스 정보
`fareQualifiersDetail`	Fare qualifier details	운임 한정자
`fareFamilyDetails`	Fare family	Fare Family 정보
`fareFamilyOwner`	Transport identifier	Fare Family 소유 항공사
`couponDetailsGroup`	Group (x99)	쿠폰 상세

OFFERREFERENCESTYPE

Offer 참조 유형.

필드	구조	설명
`offerIdentifier`	Offer	Offer 식별자 (`uniqueOfferReference` 포함)
`references`	Reference information (x99)	승객/구간 Tattoo 참조

ERRORGROUPTYPE

오류 그룹 유형.

필드	구조	설명
`errorOrWarningCodeDetails`	Application error information	오류/경고 코드 상세
`errorWarningDescription`	Free text information	오류/경고 설명 텍스트

15. 주요 Codeset 테이블

Allowance or charge qualifier (5463 IA 02.2.237)

수하물 허용 단위.

값	설명
700	Kilos (킬로그램)
701	Pounds (파운드)
702	Nil (없음)
C	Special Charge (특별 요금)
N	Number of pieces (개수)
S	Size (크기)
V	Value (가치)
W	Weight (무게)

Article availability (7011 IA 02.2.246 / 02.2.247)

좌석 가용 상태.

값	설명
AVL	Available — 예약 가능
A	Quota sell limit as agreed
C	Closed — 마감
L	Waitlist only — 대기자 명단만
N	Near to sell — 판매 임박
R	Request only — 요청만 가능
X	Closed to arrival — 도착 마감
Z	All status — 전체 상태
70A	Suppress from display — 표시 억제
70B	Class cancelled — 클래스 취소
70C	Class closed on limit sales level

Duty/tax/fee category (5305 IA 02.2.385)

세금 카테고리.

값	설명
700	Additional collection (ET 교환/재발행 신규 세금)
701	Paid (ET 교환/재발행 기납부 세금)
702	Current — 현재
703	Total PFC (전체 승객 시설 사용료)
704	Total taxes — 총 세금
705	Refundable — 환불 가능
706	VAT Penalty taxes
707	VAT Residual value taxes
D	Include departure taxes only — 출발 세금만
E	Tax exempt — 세금 면제
I	Taxes included — 세금 포함
N	Taxes not applicable — 세금 미적용
Q	Exempt security surcharge — 보안 서차지 면제
T	Domestic tax not applicable — 국내 세금 미적용

Fare classification type (9878 IA 02.2.438)

값	설명
NTF	Non Ticketable Fare — 발권 불가 운임

Data indicator (9988 IA 02.2.1204)

데이터 지표.

값	설명
DOM	Domestic — 국내선
INT	International — 국제선
LOC	Local — 지역
ECA	Economic area — 경제 구역
SCH	International - Schengen zone
STP	Technical Stopover — 기술 착륙
EMP	Empty — 빈 값
NOT	Not displayable — 표시 불가
AFT	After take-off — 이륙 후
BEF	Before take-off — 이륙 전

16. Reply 구조 ASCII 다이어그램

Fare_InformativePricingWithoutPNRReply
│
├─ messageDetails [M×1]
│   └─ businessFunction / messageFunction / responseType
│
├─ errorGroup [C×1]
│   ├─ errorOrWarningCodeDetails
│   └─ errorWarningDescription
│
└─ mainGroup [C×1]
    ├─ dummySegment [M×1]
    ├─ convertionRate [C×1]
    │   └─ conversionType / currency / rateType / pricingAmount
    │
    ├─ generalIndicatorsGroup [C×1]
    │   └─ generalIndicators [M×1]
    │       └─ indicators / priceTariffType (SITI/SOTO)
    │
    ├─ pricingGroupLevelGroup [M*×99]  ← PTC별 운임 그룹
    │   ├─ numberOfPax [M×1]
    │   ├─ passengersID [C×99]
    │   │
    │   ├─ fareInfoGroup [M*×1]
    │   │   ├─ emptySegment: PTC / fareCategory
    │   │   ├─ pricingIndicators: Ticket Designator, NVA/NVB
    │   │   ├─ fareAmount: Base(B) / Equiv(E) / Total(G) / Tax(T)
    │   │   ├─ textData: Fare Calc Line, Endorsement
    │   │   └─ offerReferences ★
    │   │       ├─ offerIdentifier
    │   │       │   └─ uniqueOfferReference  ← 핵심 출력
    │   │       └─ references (pax/seg tattoo)
    │   │
    │   ├─ surchargesGroup [C×1]
    │   │   ├─ taxesAmount
    │   │   ├─ penaltiesAmount
    │   │   └─ pfcAmount
    │   │
    │   ├─ corporateGroup [C×99]
    │   ├─ negoFareGroup [C×99]
    │   │
    │   ├─ segmentLevelGroup [C×99]  ← 구간별
    │   │   ├─ segmentInformation: 날짜/항공사/구간
    │   │   ├─ additionalInformation: NVA/NVB
    │   │   ├─ fareBasis: Fare Basis Code ★
    │   │   ├─ cabinGroup [C×99]
    │   │   │   ├─ cabinSegment: RBD / Cabin
    │   │   │   └─ baggageAllowance
    │   │   ├─ ptcSegment
    │   │   └─ couponInformation
    │   │
    │   ├─ carrierFeeGroup [C×9]
    │   │   ├─ feeType: OB / OC
    │   │   └─ feeDetails [C×99]
    │   │       ├─ feeInfo / feeAmounts / feeTaxes
    │   │       └─ feeDescription
    │   │
    │   └─ fareComponentDetailsGroup [C×99]  ← FC/BND별
    │       ├─ fareComponentID: FC or BND
    │       ├─ marketFareComponent: 시장 구간
    │       ├─ monetaryInformation: FC별 금액
    │       ├─ componentClassInfo: Fare Basis
    │       ├─ fareFamilyDetails ★
    │       │   ├─ fareFamilyname
    │       │   ├─ hierarchy
    │       │   └─ commercialFamilyDetails
    │       ├─ fareFamilyOwner
    │       └─ couponDetailsGroup [M×99]
    │
    └─ fareComponentDetailsGroup [C×99] (최상위)

17. FBA (Fare Basis Assignment) 사용법

FBA 옵션은 특정 Fare Basis를 강제 지정하여 가격을 조회할 때 사용한다. WBS 플로우의 Step 16에 해당한다.

FBA 조회 흐름:

1. Fare_InformativeBestPricingWithoutPNR (Step 3)
   → 최저가 검색, 가능한 Fare Basis 목록 확인

2. Fare_InformativePricingWithoutPNR + FBA (Step 16)
   → pricingOptionGroup에 FBA 키 지정
   → optionDetail.attributeType = Fare Basis Code
   → 특정 Fare Basis로 가격 확정

3. Fare_CheckRules (Step 4 연속)
   → uniqueOfferReference로 규정 조회

FBA vs FBL 차이

옵션	설명
FBA	Fare BAsis simple override — 시스템이 해당 Fare Basis를 우선 사용하되, 불가능하면 대체 운임 적용
FBL	Fare Basis force override — 해당 Fare Basis를 강제 적용. 불가능하면 오류 반환

18. RLO (Return Lowest possible fare)

RLO 옵션을 지정하면 시스템이 입력된 여정에 대해 가능한 최저 운임을 반환한다. RLI(Return List of fare)와 함께 사용하면 적용 가능한 운임 목록도 함께 반환받을 수 있다.

pricingOptionGroup:
  pricingOptionKey = "RLO"
  → 최저 가능 운임으로 가격 산출

19. 메시지 구조 용어

용어	설명
Entity	메시지 내 데이터 항목의 참조 이름
Structure	Entity의 정식 명칭과 참조 번호
Rep (Repetitions)	상위 구조 내에서의 반복 횟수
St (Status)	필수 여부. M=Mandatory, C=Conditional, M*=구현 시 필수
Fmt (Format)	데이터 형식
Grouped Structure	하위 구조를 포함하는 복합 구조 (계층)
Simple Structure	데이터 요소만 포함하는 단순 구조
Codeset	코드화된 항목의 가능한 값 목록

데이터 형식 표기법

표기	의미	예시
`a3`	고정 3자리 문자	`ICN`
`n6`	고정 6자리 숫자	`150326` (날짜)
`an..35`	가변 영숫자 최대 35자리	`HONG/GILDONG MR`
`n..18`	가변 숫자 최대 18자리	`528400` (금액)
`n1`	고정 1자리 숫자	`0` (날짜 변동)

약어 모음

약어	정식 명칭	설명
FBA	Fare Basis Assignment	Fare Basis 지정 가격 조회 옵션
FBL	Fare Basis force override (Label)	Fare Basis 강제 지정
FBP	Force Break Point	강제 구간 분리점
FC	Fare Component	운임 구성 요소
BND	Bound	여정 방향 단위 (Outbound/Inbound)
RLO	Return Lowest possible fare	최저 운임 반환 옵션
RLI	Return List of fare	운임 목록 반환 옵션
PTC	Passenger Type Code	승객 유형 코드
RBD	Reservation Booking Designator	예약 클래스
NVA	Not Valid After	유효 종료일
NVB	Not Valid Before	유효 시작일
SITI	Sold Inside, Ticketed Inside	국내 판매 및 국내 발권
SOTO	Sold Outside, Ticketed Outside	국외 판매 및 국외 발권
OB	Ticketing Fee (OB Fee)	발권 수수료
OC	Optional Carrier Fee	선택적 항공사 수수료
PFC	Passenger Facility Charge	승객 시설 사용료
TPM	Ticketed Point Mileage	발권 지점 간 마일리지
NUC	Neutral Unit of Construction	중립 환산 단위 (통화 코드 777)
TST	Transitional Stored Ticket	임시 저장 항공권
FOP	Form of Payment	결제 수단
POS	Point of Sale	판매 지점
POT	Point of Ticketing	발권 지점
GRI	Global Route Indicator	글로벌 경유 지표
FSC	Full Service Carrier	풀서비스 항공사
LCC	Low Cost Carrier	저비용 항공사

개요

Step 1-2: 검색

Step 3-6: 가격 조회 및 규정

Step 7-9: 예약 생성

Step 10-12: 발권

Step 13-15: 후속 처리

보조 API

​1. 개요