Amadeus Fare_GetFareRules API(버전 10.1)의 기술 용어를 정리한 문서입니다. 항공권의 운임 규정(Fare Rule)을 Category별로 조회하는 API로, 변경·환불 조건, 최소/최대 체류기간, 사전구매 기한, 시즌 제한 등의 규정 텍스트를 반환합니다.
1. 개요 Fare_GetFareRules 는 특정 운임(Fare)에 적용되는 ATPCO Rule Category별 규정 전문을 조회하는 Amadeus API입니다.
Query : 운임 식별 정보(항공사, Fare Basis, 구간 등)와 조회할 Category 번호를 지정Reply : Category별 규정 텍스트(fareRuleText)와 Coded Attribute(Mini Rules)를 반환
발권 전 환불·변경 규정 확인, 운임 규정 전문 표시, Mini Rules(coded attributes) 조회에 활용됩니다. Master Pricer 검색 결과의 운임에 대해 상세 규정을 조회할 때 주로 사용합니다.
ATPCO(Airline Tariff Publishing Company)가 표준화한 운임 규정 분류 체계입니다. 항공사들은 각 Category 번호에 해당하는 규정을 ATPCO에 신고하며, GDS는 이를 조회하여 여행사에 제공합니다.
2. Query 구조 (요청) 최상위 요청 구조 엔티티 구조명 필수 반복 설명 msgTypeMessage action details M 1 메시지 기능 한정자 availCabinConfProduct information C 1 예약 클래스(RBD) 또는 캐빈 정보 conversionRateConversion rate C 1 통화 환산 관련 정보 pricingTickInfoPricing/ticketing details C 1 발권 옵션 및 날짜 정보 multiCorporateCorporate number/name C 1 법인 계약 번호/이름 corporateInfoCorporate fare information C 1 법인 운임 정보 monetaryInfoMonetary information C 1 금액 정보 itemNumberItem number C 1 항목 번호 dateOfFlightDate and time information C 1 항공편 날짜 flightQualificationFare qualifier details C 99 운임 한정 조건 transportInformationGroup C 99 항공편 정보 그룹 tripDescriptionGroup C 99 여정 정보 그룹 pricingInfoGroup C 9 가격 정보 그룹
운임 조회 대상 항공편을 지정합니다.
엔티티 구조명 필수 설명 transportServiceTransport identifier M 항공사 코드 및 편명 availCabinConfProduct information C 예약 클래스 routingInfoRouting information C 경유지 정보 selectionDetailSelection details C 선택 조건
tripDescription 그룹 여정의 출발지·도착지 정보를 담습니다.
엔티티 구조명 필수 설명 origDestOrigin and destination details M 출발지·도착지 dateFlightMovementDate and time information C 항공편 일자 routingGroup C 구간별 경로 그룹 (최대 99회 반복)
fare 그룹 조회 대상 운임을 특정합니다.
엔티티 구조명 필수 설명 detailsOfFareFare information M 운임 상세 정보 fareQualificationDetailsFare qualifier details C 운임 한정 상세 (최대 99회) fareRuleGroup C 규정 그룹
fareRule 그룹 조회할 Rule Category를 지정합니다.
엔티티 구조명 필수 설명 tarifFareRuleFare rules information M 항공사 코드, Category 번호 지정 travellerIdentificationReference information C 여행자 참조 번호 travellerDateDate and time information C 여행자 관련 날짜 locationInfoLocation details C 도시·공항·국가 코드
3. Reply 구조 (응답) 최상위 응답 구조 엔티티 구조명 필수 반복 설명 transactionTypeMessage action details M 1 처리 결과 유형 statusInfoStatus details C 1 메시지 처리 상태 fareRouteInfoFare route information C 1 운임 경로 정보 infoTextInteractive free text C 999 안내 텍스트 errorInfoGroup C 1 오류 정보 그룹 tariffInfoGroup C 999 운임 규정 정보 그룹 (핵심) flightDetailsGroup C 999 항공편 상세 정보 그룹
errorInfo 그룹 엔티티 구조명 필수 설명 rejectErrorCodeApplication error information M 애플리케이션 오류 코드 errorFreeTextInteractive free text C 오류 관련 자유 텍스트
tariffInfo 그룹 (핵심) 운임별 규정 정보를 담는 핵심 그룹입니다. 최대 999회 반복됩니다.
엔티티 구조명 필수 반복 설명 fareRuleInfoFare rules information M 1 운임 규정 식별 정보 (항공사, Category 코드, Rule 번호) fareRuleTextInteractive free text C 999 Category별 규정 전문 텍스트 codedAttributesInfoCoded attribute C 1 코드화된 규정 요약 (Mini Rules)
flightDetails 그룹 항공편별 통화·날짜·운임 상세 정보입니다.
엔티티 구조명 필수 반복 설명 nbOfSegmentsSegment repetition control M 1 구간 수 selectedPartInfoSelection details C 1 정보 유형 지정 amountConversionConversion rate C 1 통화 환산 정보 quantityValueQuantity C 1 수량 정보 pricingAndDateInfoPricing/ticketing details C 1 발권 일자 및 옵션 qualificationFareDetailsFare qualifier details C 99 운임 한정 조건 transportServiceTransport identifier C 4 항공편 정보 flightErrorCodeInteractive free text C 999 항공편 관련 오류 productInfoGroup C 99 예약 클래스 정보 priceInfoGroup C 99 금액·세금 정보 fareTypeInfoGroup C 99 운임 유형 정보
4. 주요 데이터 구조 fareRuleInfo 및 tarifFareRule에서 사용됩니다. 조회할 운임 규정의 식별자를 담습니다.필드 형식 설명 tariffClassIdan..9 운임 Tariff 번호 (예: 70) companyDetails.marketingCompanyan..3 마케팅 항공사 코드 (예: KE, OZ) companyDetails.operatingcompanyan..3 실제 운항 항공사 코드 companyDetails.otherCompanyan..3 기타 항공사 코드 ruleSectionId / ruleCategoryCodean..7 Rule Category 코드 → Rule Category 코드 참조 ruleNumberan..9 규정 번호
4-2. Coded Attribute (코드화된 규정 요약) codedAttributesInfo에서 반환되는 Mini Rules 정보입니다. 규정 전문 대신 구조화된 코드로 핵심 조건을 제공합니다.필드 형식 설명 attributeTypean..5 속성 유형 코드 → Attribute Type 코드 참조 attributeDescriptionan..60 속성 설명 값
Mini Rules (codedAttributesInfo): 핵심 규정 조건만 코드화하여 반환. 빠른 표시에 적합Full Rules (fareRuleText): ATPCO에 등록된 규정 원문 전체 텍스트. 상세 확인 시 사용 4-3. Fare Qualifier Details (운임 한정 조건) 운임의 특성과 조건을 지정합니다.
필드 형식 설명 fareCategoriesan..3 Global Direction 코드 (예: 7AT=대서양, 7PA=태평양) → Global Direction 코드 참조 fareType1 / fareType2 / fareType3an..20 요청 유형 및 파라미터 fareDetails.qualifieran..3 승객 유형 코드 (PTC). 예: ADT, CHD, INF fareDetails.raten..8 할인율 (%) fareDetails.fareCategoryan..3 운임 분류 유형 additionalFareDetails.rateClassan..35 Fare Basis 코드. 예: YLOWKR, QOWUS additionalFareDetails.commodityCategoryan..18 Ticket Designator additionalFareDetails.pricingGroupan..35 가격 산정 그룹 fareOptionDetails.fareQualifieran..3 운임 한정자 코드 (위약금 등) fareOptionDetails.amountn..18 위약금 금액 fareOptionDetails.percentagen..8 위약금 비율 (%)
운임이 적용되는 경로와 유효기간 정보입니다.
필드 형식 설명 dayOfWeekan..7 운임 적용 요일 (7자리, 예: 1234567=매일) fareQualifieran..3 운임 한정자 (예: RT=Round Trip, OW=One Way) identificationNumberan..35 라우팅 번호 validityPeriod.firstDaten..6 운임 발효일 (ddMMyy) validityPeriod.secondDaten..6 운임 종료일 (ddMMyy)
4-5. Pricing/Ticketing Details (발권 옵션) 필드 형식 설명 priceTicketDetails.indicatorsan..3 가격 유형 한정자 코드 → Price Type Qualifier 코드 참조 productDateTimeDetails.ticketingDaten6 발권 날짜 (ddMMyy) locationDetails.cityan3..5 발권 도시 코드 locationDetails.countryan..3 발권 국가 코드 idNumberan..35 식별 번호
4-6. Transport Identifier (항공편 식별) 필드 형식 설명 companyIdentification.marketingCompanyan..3 마케팅 항공사 코드 companyIdentification.operatingcompanyan..3 실제 운항 항공사 코드 companyIdentification.otherCompanyan..3 기타 항공사 코드 productIdentificationDetails.flightNumberan..4 편명 번호 productIdentificationDetails.operationalSuffixa1 편명 접미사
필드 형식 설명 routingDetails.stationa3..5 경유지 또는 출발 공항 코드 routingDetails.otherStationa3..5 도착 공항 코드 routingDetails.qualifieran..3 지점 유형 또는 Via 표시자
필드 형식 설명 monetaryDetails.typeQualifieran..3 금액 유형 한정자 monetaryDetails.amountan..12 세금·수수료 금액 monetaryDetails.currencyan..3 통화 코드 (ISO 4217) otherMonetaryDetails.typeQualifieran..3 추가 금액 유형 (XF=PFC, ZP=세금 등)
4-9. Conversion Rate (환율 정보) 필드 형식 설명 conversionRateDetails.conversionTypean..3 환산 유형 코드 conversionRateDetails.currencyan..3 통화 코드 conversionRateDetails.rateTypean..3 환율 유형 conversionRateDetails.pricingAmountn..18 원래 금액 conversionRateDetails.convertedValueAmountn..18 환산된 금액
필드 형식 설명 corporateId.corporateQualifieran..3 법인 운임 유형 한정자 corporateId.identityan..35 법인 계약 번호 또는 이름
4-11. Status Details (상태 정보) 응답 처리 상태를 나타냅니다.
필드 형식 설명 statusDetails.indicatoran..3 상태 표시자 코드 otherDetails.indicatoran..3 추가 상태 표시자 코드
4-12. Interactive Free Text (자유 텍스트) fareRuleText와 infoText에 사용됩니다.필드 형식 설명 freeTextQualification.textSubjectQualifieran..3 텍스트 주제 한정자 → Text Subject Qualifier 코드 참조 freeTextQualification.informationTypean..4 정보 유형 코드 freeTextan..70 규정 텍스트 (최대 999줄)
4-13. Segment Repetition Control (구간 반복 제어) 필드 형식 설명 segmentControlDetails.quantityn..15 수량 segmentControlDetails.numberOfUnitsn..15 단위 수 segmentControlDetails.totalNumberOfItemsn..15 총 항목 수
5. 주요 코드셋 Rule Category 코드 ATPCO에서 정의한 운임 규정 Category 분류입니다. ruleSectionId 및 ruleCategoryCode 필드에 괄호 포함 형식((5))으로 사용됩니다.
Category 설명 (1)Eligibility (자격 조건) (2)Day/Time (요일/시간 제한) (3)Seasonability (시즌 적용) (4)Flight Application (적용 항공편) (5)Advance Purchase (사전 구매 기한) (6)Minimum Stay (최소 체류기간) (7)Maximum Stay (최대 체류기간) (8)Stopovers (경유 조건) (9)Transfer (환승 조건) (10)Combinations (운임 결합 조건) (11)Blackout dates (블랙아웃 날짜) (12)Surcharge (할증 요금) (13)Accompanied Travel (동반 여행) (14)Travel restrictions (여행 제한) (15)Sales restrictions (판매 제한) (16)Penalties (위약금·환불 규정) (17)Higher intermediate point (높은 중간 지점) (18)Ticket endorsement (발권 배서) (19)Children discount (소아 할인) (20)Tour conductor discount (인솔자 할인) (21)Agent discount (대리점 할인) (22)All other discounts (기타 할인) (23)Miscellaneous Provisions (기타 규정) (25)Fare by Rule (규정 기반 운임) (26)Group (단체 조건) (27)Tours (투어 조건) (28)Visit an other country (타국 방문 조건) (29)Deposit (보증금) (31)Reissue / Voluntary changes (재발행·자발적 변경) (35)Nego (협상 운임) (50)Rule application (규정 적용) 700All Paragraphs (전체 Category 조회)
Cat 5 (Advance Purchase): 사전 구매 기한. 예: “출발 21일 전까지 구매 필수”Cat 6 (Minimum Stay): 최소 체류기간. 예: “현지 일요일 이후 귀국 가능”Cat 7 (Maximum Stay): 최대 체류기간. 예: “출발 후 1년 이내 귀국”Cat 16 (Penalties): 취소·변경 위약금. 예: “출발 전 취소 시 50% 위약금”Cat 31 (Reissue): 자발적 변경 조건. Cat 16와 함께 확인 필요 Attribute Type 코드 (Mini Rules) codedAttributesInfo.attributeType에서 사용됩니다. 각 Category의 핵심 조건을 코드화합니다.Cat 4 - Flight Application (적용 항공편) 코드 설명 AABetweenAnd 표시자 ABBetweenAnd 쌍의 수 ACBetween 첫 번째 지점 ADBetween 두 번째 지점 AEAnd 첫 번째 지점 AFAnd 두 번째 지점 AGVia 표시자 AIVia 경유지 목록 AMFlight 표시자 AO적용 항공편 목록
Cat 5 - Advance Purchase (사전 구매) 코드 설명 BA예약 허용 여부 BB예약 최초 가능 숫자 BC예약 최초 가능 기준 요일 BD예약 최초 가능 기간 BE예약 최초 가능 단위 BF예약 최후 가능 숫자 BJ발권 사전 기한 숫자 BK발권 사전 기한 기준 요일 BL발권 사전 기한 기간 BM발권 사전 기한 단위 BN구매 사전 기간 BO구매 사전 단위
Cat 2 - Day/Time (요일/시간) 코드 설명 CA여행 허용 여부 CB적용 요일 CC귀국편 여행 허용 여부 CD귀국편 적용 요일 CE출국편 여행 허용 여부 CF출국편 적용 요일 CAT재발행 유형 (Cat 31/32 등)
Cat 3 - Seasonability (시즌) 코드 설명 DA시즌 날짜 쌍의 수 DB시즌 시작일 DC시즌 종료일
Cat 14 - Travel Restrictions (여행 제한) 코드 설명 EA여행 날짜 쌍의 수 EB여행 시작일 EC여행 종료일
Cat 6 - Minimum Stay (최소 체류) 코드 설명 FA최소 체류 숫자 FB최소 체류 기준 요일 FC최소 체류 기간 FD최소 체류 단위 FE최소 체류 기준일 FF빠른/늦은 시점 표시자
Cat 7 - Maximum Stay (최대 체류) 코드 설명 GA최대 체류 숫자 GB최대 체류 기준 요일 GC최대 체류 기간 GD최대 체류 단위 GE최대 체류 기준일 GF빠른/늦은 시점 표시자
Cat 8 - Stopovers (경유) 코드 설명 HA최대 경유 횟수 HB출국편 최대 경유 횟수 HC귀국편 최대 경유 횟수
Cat 9 - Transfers (환승) 코드 설명 IA최대 환승 횟수 IB출국편 최대 환승 횟수 IC귀국편 최대 환승 횟수
Cat 19 - Children’s Discount (소아 할인) 코드 설명 JA할인 수 JB승객 유형 코드(PTC) JC최소 나이 JD최대 나이 JE할인율 (%) JF할인 금액 JG통화 코드
Cat 11 - Blackout Dates (블랙아웃) 코드 설명 KA블랙아웃 날짜 쌍의 수 KB블랙아웃 시작일 KC블랙아웃 종료일
Cat 16 - Penalties (위약금) 코드 설명 LA위약금 적용 시점 LB위약금 비율 (%) LC위약금 첫 번째 금액 LD위약금 첫 번째 통화 LE위약금 두 번째 금액 LF위약금 두 번째 통화 LG높은 금액 적용 표시자
Cat 31 - Voluntary Changes (자발적 변경) 코드 설명 MA여정 변경 가능 여부 MBPricing Unit 변경 가능 여부 MCFare Component 변경 가능 여부 MD변경 수수료 첫 번째 금액 ME변경 수수료 첫 번째 통화 MF변경 수수료 두 번째 금액 MG변경 수수료 두 번째 통화 MH수수료 비율 (%) MI높은 금액 적용 표시자 MJ서비스 유형 MK환불 형태
Message Function 코드 msgType.messageFunctionDetails.messageFunction 필드에서 사용됩니다.코드 설명 711Fare Display by City Pair (구간별 운임 표시) 712Display Specific Fare Rules (특정 운임 규정 표시) 713Display Fare Routing Information (운임 경로 정보 표시) 714City Text Information (도시 텍스트 정보) 715Fare Mileage Display (운임 마일리지 표시) 716Secondary Mileage Display (보조 마일리지 표시) 717Mileage Calculation (마일리지 계산) 718MPM surcharge display (최대 허용 마일리지 할증 표시) 719Passenger Facilities Charge (공항 시설 이용료) 723Fare Tax Break Down (운임 세금 분류) 724Reservation Booking Designator Display (RBD 표시) 725Fare Construction Display (운임 구성 표시) 194Fare Quote Ladder (운임 견적 비교)
Global Direction 코드 fareCategories 필드에서 사용됩니다. 운임이 적용되는 전 세계 방향성을 나타냅니다.코드 설명 7ATAT - 대서양 경유 (TC2/3 ↔ TC1) 7PAPA - 태평양 경유 (TC2/3 ↔ TC1) 7APAP - 대서양·태평양 경유 (TC2 ↔ TC3) 7EHEH - 동반구 내 (TC2 & TC3, PO·TS 제외) 7WHWH - 서반구 내 (TC1) 7DODO - 국내선 7CTCT - 환승 여행 (원점 복귀, 대서양·태평양 이외) 7RWRW - 세계일주 (대서양·태평양 경유) 7CACA - 캐나다 국내선 7USUS - 미국 국내선 7TBTB - 접경 구간 7TSTS - 시베리아 경유 (TC2 ↔ TC3) 7POPO - 극지 경유 (TC2 ↔ TC3) 7EUEU - 유럽 경유 7MEME - 중동 경유 7AFAF - 아프리카 경유
Fare Qualifier (운임 한정자) 주요 코드 fareRouteInfo.fareQualifierDetails.fareQualifier 필드에서 사용됩니다.코드 설명 700Add-on origin (가산 출발지 운임) 701Add-on destination (가산 목적지 운임) 702Advances purchase period (사전 구매 기간) 705(Base) fares without taxes (세전 기본 운임) 706(Base) fares with partial taxes (일부 세금 포함 운임) 707(Base) fares with taxes included (세금 포함 운임) 708Blackout (블랙아웃 적용) 709Cancellation fee details (취소 수수료 상세) 70ABase (기본 운임) 70BTotal (총 운임) 70CNo seasonal or blackout restrictions (시즌·블랙아웃 제한 없음) 70DRule provisions vary by travel date (여행 날짜에 따라 규정 상이) 719Fare Cannot be used for Pricing (가격 산정 불가 운임) 724Fare is mileage based (마일리지 기반 운임) 725Fare is routing based (경로 기반 운임) 729Fares with a fixed penalty (고정 위약금 운임) 730Fares with no penalties (위약금 없는 운임) 731Fares with penalties (위약금 있는 운임) 732Fares with no advance purchase restrictions (사전 구매 제한 없음) 736Indicates fare is refundable (환불 가능 운임) 737Indicates no refund restriction (환불 제한 없음) 738Indicates no cancellation rules are held (취소 규정 없음) 740Indicates percentage of the fare that is non-refundable (비환불 비율) 741Indicates the fare is non-refundable (비환불 운임) 742Indicates the rule should be consulted (규정 확인 필요) 797Penalties applies (위약금 적용됨) 798Subject to cancellation/change penalty (취소·변경 위약금 대상) 799Tickets are non-refundable before departure (출발 전 환불 불가)
Price Type Qualifier 코드 pricingTickInfo.indicators 필드에서 사용됩니다.코드 설명 RPPublished fares (공시 운임) RNAmadeus Nego Fares (아마데우스 협상 운임) RUUnifares (통합 운임) 700Present credit card indicator (신용카드 제시 표시) 701Fare basis in fare calculation (운임 계산에서 Fare Basis 사용) 702Currency override (통화 강제 지정) 705No advance purchase (사전 구매 없이 조회) 706No maximum and minimum stay fares (최대·최소 체류 제한 없음) 707No minimum stay fares (최소 체류 제한 없음) 708No maximum stay fares (최대 체류 제한 없음) 709No penalty fares (위약금 없는 운임만 조회) 713Refundable fares (환불 가능 운임만 조회) 719Minimum stay (최소 체류 조건 포함 조회) 720Maximum stay (최대 체류 조건 포함 조회) 721Advance purchase (사전 구매 조건 포함 조회) 725Unsalable Fare (판매 불가 운임) DDomestic itinerary (국내 여정) IInternational itinerary (국제 여정) NRNon refundable (환불 불가)
Text Subject Qualifier 코드 freeTextQualification.textSubjectQualifier 필드에서 사용됩니다.코드 설명 3Fare rule text (운임 규정 텍스트) 4Fare routing (운임 경로 텍스트) 6Mileage information (마일리지 정보)
Application Error 코드 (주요) errorInfo.rejectErrorCode.errorDetails.errorCode 필드에서 사용됩니다.코드 설명 1Invalid date (유효하지 않은 날짜) 100Invalid Place of Departure Code (출발지 코드 오류) 101Invalid Place of Destination Code (목적지 코드 오류) 102Invalid Departure Date (출발일 오류) 104Invalid Reservation Booking Designator (RBD 오류) 107Invalid Airline Designator (항공사 코드 오류) 109Invalid Country Code (국가 코드 오류) 114Invalid Flight Number (편명 오류) 118System Unable to Process (시스템 처리 불가) 130Invalid Origin and Destination Pair (출발지·목적지 쌍 오류)
6. Fare Rule 조회 흐름 운임 규정 조회의 일반적인 흐름입니다.
1. Master Pricer 검색 → 운임 정보(Fare Basis, 항공사, 구간) 확인 2. Fare_GetFareRules Query 구성 - transportInformation: 항공사 코드, 편명 - tripDescription: 출발지·목적지·날짜 - fare.detailsOfFare: Fare Basis 코드 - fareRule.tarifFareRule: 조회할 Category 번호 지정 3. Reply 처리 - tariffInfo 반복: 각 Category별 규정 확인 - fareRuleText: 규정 전문 텍스트 표시 - codedAttributesInfo: Mini Rules 코드 파싱
ruleSectionId에 700(All Paragraphs)을 지정하면 모든 Category 규정을 한 번에 조회합니다. 응답이 매우 클 수 있으므로 필요한 Category만 지정하는 것을 권장합니다.
7. 약어 모음 약어 풀네임 설명 AP Advance Purchase 사전 구매 기한 (Cat 5) ATPCO Airline Tariff Publishing Company 항공 운임 출판 회사. 운임 규정의 표준화를 담당 Cat Category ATPCO 규정 분류 번호 EH Eastern Hemisphere 동반구 (TC2 + TC3) Fare Basis Fare Basis Code 운임 기저 코드. 운임을 고유하게 식별하는 코드 (예: YLOWKR) FBC Fare Basis Code Fare Basis의 약어 GDS Global Distribution System 글로벌 항공 예약 시스템 GI Global Indicator 전 세계 방향성 코드 (예: AT, PA) MPM Maximum Permitted Mileage 최대 허용 마일리지 NUC Neutral Unit of Construction 운임 구성 중립 단위 (통화 중립 운임 계산 단위) ODI Origin and Destination Information 출발지·목적지 정보 OW One Way 편도 PFC Passenger Facility Charge 공항 시설 이용료 PTC Passenger Type Code 승객 유형 코드 (ADT=성인, CHD=소아, INF=유아) RBD Reservation Booking Designator 예약 등급 지시자 (예약 클래스 코드) RT Round Trip 왕복 TC1 Traffic Conference Area 1 IATA 지역 1 (아메리카) TC2 Traffic Conference Area 2 IATA 지역 2 (유럽·아프리카·중동) TC3 Traffic Conference Area 3 IATA 지역 3 (아시아·태평양) WH Western Hemisphere 서반구 (TC1)
Master Pricer Travelboard Search
