SalesReports_DisplayQueryReport

Amadeus의 판매 실적 보고서 조회 API인 SalesReports_DisplayQueryReport의 기술 용어를 정리한 문서입니다.

1. 개요

Amadeus GDS가 제공하는 일별 판매 실적 보고서(Sales Report) 조회 API. 특정 날짜 또는 기간의 오피스별 판매 실적(발권, 환불, 교환 등)을 조회하며, AlternativeCurrency(외화 기준)와 DFC(현지 통화 기준) 두 가지 모드를 지원한다.

[Query: 보고서 조회 요청]
  날짜, 오피스, 통화, 거래 유형, 문서 유형 등
       |
       v
  Amadeus Sales Report Engine
       |
       v
[Reply: 보고서 조회 결과]
  queryReportDataDetails
  +-- currencyInfo: 통화 정보
  +-- dateDetails: 시스템 날짜 / 요청 날짜
  +-- queryReportDataOfficeGroup x N (오피스별)
  |   +-- requestorAgencyDetails: 요청 대리점 정보
  |   +-- documentData x 9999 (문서별)
  |       +-- sequenceIdentification: 문서 순번
  |       +-- validatingCarrierDetails: 확인 항공사
  |       +-- documentNumber: 항공권/문서 번호
  |       +-- orderID / orderItemID: 주문 참조
  |       +-- documentDetails: 문서 상세 (Rail 등)
  |       +-- monetaryInformation: 금액 정보
  |       +-- bookingAgent: 예약 에이전트
  |       +-- transactionDataDetails: 거래 코드/유형
  |       +-- fopDetails: 결제 수단 (FOP)
  |       +-- passengerName: 승객명
  |       +-- enhancedPaxInfoCriteria: 승객 상세
  |       +-- statusDetails: 상태 정보
  |       +-- reservationInformation: PNR 참조
  |       +-- pricingIndicator: 가격 지표
  |       +-- agentDetails: 에이전트 상세
  +-- actionDetails: 스크롤 처리 정보
  +-- salesPeriodDetails: 보고서 기간 (From/To)

이 API는 WBS Integration Flow의 후속 처리 단계 Step 13 (AlternativeCurrency) 및 **Step 14 (DFC)**에 해당합니다.

Query / Reply 구조

구분	메시지	설명
Query	`SalesReports_DisplayQueryReport` 22.2.1A	보고서 조회 조건 입력 (요청)
Reply	`SalesReports_DisplayQueryReportReply` 22.2.1A	보고서 데이터 반환 (응답)

2. AlternativeCurrency vs DFC

두 모드의 핵심 차이는 Query 메시지에 currencyInfo 블록의 포함 여부이다.

구분	AlternativeCurrency (Step 13)	DFC (Step 14)
`currencyInfo` 블록	포함 (통화 코드 지정)	미포함
응답 통화	요청한 대체 통화 (USD 등)	오피스 기본 통화 (ARS 등)
활용	외화 기준 정산, 본사 통합 보고	현지 통화 일일 정산
`currencyQualifier`	`3` (Target currency)	미사용

AlternativeCurrency 요청 시:
  currencyInfo
  +-- currencyDetails
      +-- currencyQualifier = "3"   (Target currency)
      +-- currencyIsoCode  = "USD"  (원하는 통화)

DFC 요청 시:
  currencyInfo 블록 자체를 생략
  --> 응답이 오피스 기본 통화(Default Filing Currency)로 반환

3. Query 주요 구조 (조회 요청)

actionDetails (Action Details)

스크롤(페이지네이션) 처리에 사용되는 구조. 대량 보고서 조회 시 반복 호출에 활용한다.

필드	설명
`numberOfItemsDetails.numberOfItems`	요청할 행(row) 수
`lastItemsDetails.lastItemIdentifier`	이전 응답의 마지막 키 (티켓 번호 또는 보고서 번호)

agentUserDetails (User Identification)

특정 에이전트 또는 사용자를 대상으로 보고서를 조회할 때 사용하는 구조.

필드	Fmt	설명
`originatorId`	an..9	에이전트 사인 (Numeric Sine + Initials + Duty Code). 예: `0001XVSU`
`originatorTypeCode`	an1	정보 유형. `O` = Original User ID
`originator`	an..99	에이전트 Long Login 또는 LSS Login

dateDetails (Structured Date Time Information)

보고서 조회 대상 날짜를 지정하는 구조.

필드	Fmt	설명
`businessSemantic`	an..3	날짜 의미 한정자
`year`	n4	년도
`month`	n..2	월 (1부터 시작)
`day`	n..2	일 (1부터 시작)

businessSemantic (날짜 의미 한정자)

코드	설명
C	Current date, 현재 날짜
D	Sales report closure date, 판매 보고서 마감일
I	Issuance date, 발권일
R	Refunding date, 환불일
S	Specific date, 특정 날짜 지정

currencyInfo (Currencies)

대체 통화(AlternativeCurrency) 모드에서 보고서의 응답 통화를 지정하는 구조.

필드	Fmt	설명
`currencyQualifier`	an..3	통화 용도 한정자
`currencyIsoCode`	an..3	ISO 통화 코드 (KRW, USD, EUR 등)

currencyQualifier (통화 용도)

코드	설명
2	Reference currency, 기준 통화
3	Target currency, 대상 통화 (변환 후 통화)

agencyDetails (Additional Business Source Information)

보고서 조회 대상 오피스/대리점을 지정하는 구조.

필드	Fmt	설명
`sourceQualifier1`	an..3	소스 한정자: 보고 오피스 유형
`sourceQualifier2`	an..3	동일 IATA 번호 공유 대리점 전체 여부
`originatorId`	n..9	대리점 IATA 번호
`inHouseIdentification1`	an..9	대리점 오피스 ID

sourceQualifier (소스 한정자)

코드	설명
REP	Reporting office, 보고 오피스
STP	STP office, 위성 발권 오피스
TDO	TDO office, 티켓 배달 오피스

stockProviderDetails (Company Information)

Stock Provider(재고 제공자) 정보를 지정하는 구조. 산업 분야와 회사 코드를 포함한다.

필드	Fmt	설명
`travelSector`	an..3	산업 분야 코드
`companyCodeContext`	an..3	코드 관할 기관
`companyCode`	an..35	회사 코드
`companyName`	an..35	회사명
`accessLevel`	an..3	Non-Air 회사 접근 레벨

travelSector (산업 분야)

코드	설명
AIR	Air, 항공
CAR	Car, 렌터카
CRU	Cruise, 크루즈
HTL	Hotel, 호텔
INS	Insurance, 보험
RAI	Rail, 철도

accessLevel (Non-Air 접근 레벨)

코드	설명
CA	Complete Access, 전체 접근
CP	Complete Access Plus, 전체 접근 확장
DY	Dynamic Access, 동적 접근
SA	Standard Access, 표준 접근

distributionMethod (Method)

문서 생성에 사용된 시스템(배포 채널)을 식별하는 구조.

필드	Fmt	설명
`methodCode`	an..3	배포 방법 코드. 예: ACCP(Amadeus Convergence Content Platform), O(Pyton flight platform), L(Light ticketing carrier), A(ATAC)

salesPeriodDetails (Structured Period Information)

보고서 조회 기간(From/To)을 지정하는 구조.

필드	Fmt	설명
`beginDateTime.year`	n4	시작 년도
`beginDateTime.month`	n..2	시작 월
`beginDateTime.day`	n..2	시작 일
`endDateTime.year`	n4	종료 년도
`endDateTime.month`	n..2	종료 월
`endDateTime.day`	n..2	종료 일

transactionData (Transaction Information for Ticketing)

보고서에 포함할 거래 유형과 거래 코드를 필터링하는 구조. 최대 2회 반복 가능.

필드	Fmt	설명
`code`	an..4	거래 코드 (Transaction Code)
`type`	an..4	거래 유형 (Transaction Type)
`issueIndicator`	an1	발급 지표. `O`=원본, `C`=현행

formOfPaymentDetails (Form of Payment)

결제 수단(FOP)으로 보고서를 필터링하는 구조.

필드	Fmt	설명
`type`	an..10	결제 수단 유형 코드
`vendorCode`	an..2	신용카드 벤더 코드

validatingCarrierDetails (Transport Identifier)

확인 항공사(Validating Carrier)로 보고서를 필터링하는 구조.

필드	Fmt	설명
`marketingCompany`	an..3	확인 항공사 코드 (2자리 IATA 코드)

requestOption (Selection Details)

보고서 조회 범위를 설정하는 옵션 구조.

필드	Fmt	설명
`option`	an..3	주 옵션 (필수)
`otherSelectionDetails.option`	an..3	추가 옵션 (최대 98개)

option (SOF 옵션)

코드	설명
SOF	All agents of the office, 오피스 내 전체 에이전트
SAN	All offices sharing the same IATA number, 동일 IATA 번호 전체 오피스
STP	Satellite ticket office, 위성 발권 오피스
TDO	Ticket delivery office, 티켓 배달 오피스
BNR	By net remit qualifier, 순수 정산 기준

salesIndicator (Status Details)

판매 보고서 상태/유형 필터를 지정하는 구조. 최대 9회 반복 가능.

필드	Fmt	설명
`indicator`	an..3	상태 한정자 (His=Historical, Crt=Current)
`action`	an..3	보고서 소스 필터
`type`	an..3	판매 보고서 마감 유형
`description`	an..70	연관 테이프 번호 (자유 텍스트)

action (보고서 소스 필터 — 1229 IA 02.2.8373)

코드	설명
ALL	All NDCX sales reported and non reported, NDCX 전체 판매
AUT	Automated pricing, 자동 가격 산정
MAN	Manual pricing, 수동 가격 산정

action (보고서 소스 필터 — 1229 1A 02.2.2104)

코드	설명
AL	Airline, 항공사
ARC	ARC
BSP	BSP

fromSequenceDocumentNumber (Item Number)

보고서 정렬 기준이 되는 시퀀스 또는 문서 번호를 지정하는 구조.

필드	Fmt	설명
`number`	an..6	시퀀스 번호 (6자리 이하) 또는 문서 번호 (7~10자리)
`type`	an..3	번호 유형

type (번호 유형)

코드	설명
D	Document number, 문서 번호
S	Sequence number, 시퀀스 번호

reservationInformation (Reservation Control Information)

PNR 또는 철도 Provider Reference로 보고서를 필터링하는 구조. 최대 9회 반복 가능.

필드	Fmt	설명
`companyId`	an..35	항공사/공급자 코드
`controlNumber`	an..20	예약 번호 (PNR Record Locator)

attributeInfo (Coded Attribute)

클라이언트 ID 등 속성으로 보고서를 필터링하는 구조.

필드	Fmt	설명
`attributeType`	an..5	속성 유형 코드
`attributeDescription`	an..256	속성 값

attributeType (속성 유형 — 950K 1A 02.1.859)

코드	설명
CLC	Client code, 클라이언트 코드
FCA	Fare calculation, 운임 계산

4. Reply 주요 구조 (조회 응답)

errorGroup (Error Group)

오류 발생 시 반환되는 그룹 구조.

필드	설명
`errorOrWarningCodeDetails.errorCode`	오류/경고 코드
`errorOrWarningCodeDetails.errorCategory`	코드 목록 한정자 (EC=Error, WEC=Warning)
`errorWarningDescription.freeText`	오류/경고 상세 텍스트

queryReportDataDetails (보고서 데이터)

보고서 전체 데이터를 담는 최상위 그룹 구조.

필드	St	Rep	설명
`currencyInfo`	M	1	보고서 통화 정보
`stockProviderDetails`	C	1	Stock Provider 산업 분야 및 코드
`dateDetails`	M	2	시스템 날짜 및 요청 날짜
`queryReportDataOfficeGroup`	M	9	오피스별 문서 순잔액 그룹

queryReportDataOfficeGroup (오피스별 그룹)

오피스 단위로 문서 목록을 묶는 그룹 구조.

필드	St	Rep	설명
`requestorAgencyDetails`	M	1	요청 대리점 정보 (오피스 ID, IATA 번호)
`documentData`	M	9999	개별 문서(거래) 데이터

documentData (문서 데이터)

개별 문서(항공권, EMD, 환불 등)에 대한 상세 정보를 담는 구조. 보고서당 최대 9999건 반복.

필드	St	Rep	설명
`sequenceIdentification`	M	1	보고서 내 문서 순번
`validatingCarrierDetails`	C	1	확인 항공사
`documentNumber`	M	1	항공권/문서 번호 및 항공사 코드
`orderID`	C	1	주문 식별 참조 (TKT별 고유)
`orderItemID`	C	99	주문 항목 식별 참조 (OrderID 내 반복)
`documentDetails`	C	1	Rail 등 특수 문서 번호
`monetaryInformation`	M	1	금액 정보 (운임, 세금, 수수료 등)
`bookingAgent`	M	2	예약 에이전트 사인
`bookingAgentOtherUserDetails`	C	5	에이전트 Short Login(SLG) / Full Name(AGN)
`transactionDataDetails`	M	1	거래 코드 및 거래 유형
`fopDetails`	M	1	결제 수단(FOP) 그룹
`passengerName`	C	1	승객명
`enhancedPaxInfoCriteria`	C	1	승객 상세 (PTC, 유아 여부 등)
`statusDetails`	C	1	문서 상태 정보
`reservationInformation`	C	9	PNR / Provider Reference
`pricingIndicator`	C	1	가격 지표 (자동/수동)
`agentDetails`	C	2	문서 관련 에이전트/사용자
`agentOtherUserDetails`	C	5	에이전트 SLG/AGN
`actionDetails`	C	1	스크롤 처리 정보
`salesPeriodDetails`	C	1	보고서 기간 (From/To)

5. 거래 코드 (Transaction Code)

transactionDataDetails.code 필드에 사용되는 코드. 보고서 내 각 문서의 거래 성격을 나타낸다.

발권 관련

코드	설명
TKTA	Ticket Agent, 에이전트 발권
TKTB	Ticket Bulk, 대량 발권
TKTM	Ticket Manual, 수동 발권
TKTT	Ticket Transitional Automated, 자동 과도기 발권

취소/환불 관련

코드	설명
CANR	Cancellation Refund, 취소 환불
CANX	Cancellation, 취소
CANN	Cancellation Non-refundable, 환불 불가 취소
RFND	Refund, 환불
RENM	Reissue Non-Manual, 비수동 재발행
RENA	Reissue Non-Automated, 비자동 재발행

교환/재발행 관련

코드	설명
MCOA	MCO Agent, 에이전트 MCO
MCOM	MCO Manual, 수동 MCO
PTAM	PTA Manual, 수동 PTA
TORM	Tour Order Manual, 수동 투어 오더

기타

코드	설명
ACMR	Agency Credit Memo Refund, 대리점 대변 메모 환불
ADMA	Agency Debit Memo Agent, 대리점 차변 메모
ACMA	Agency Credit Memo Agent, 대리점 대변 메모
MDnn	Miscellaneous Document (nn = 번호)
MPnn	Miscellaneous Payment (nn = 번호)
XSBA	Exchange Sale Bulk Agent
XSBM	Exchange Sale Bulk Manual
SSAC	Sales Summary Agent, 판매 요약
SSAD	Sales Summary Agent Debit, 판매 요약 차변
TAAD	Transaction Agent Automated Debit
RCSM	Reissue Credit Sale Manual
BPAS	Boarding Pass
PSCN	Post-sale Commission Notice
VSCN	Void Sales Commission Notice
RSCN	Refund Sales Commission Notice
TASF	Ticketing Agent Service Fee

6. 거래 유형 (Transaction Type)

transactionDataDetails.type 필드에 사용되는 코드. 거래의 대분류 유형을 나타낸다.

코드	설명
SALE	Sale, 판매
INVT	Inventory, 재고
REFD	Refund, 환불
ADJA	Adjustment Agent, 에이전트 조정
ADJP	Adjustment Provider, 공급자 조정
AUTS	Automated Sale, 자동 판매
CCAS	Credit Card Adjustment Sale
CCCS	Credit Card Cancellation Sale
MANS	Manual Sale, 수동 판매
VOID	Void, 무효 처리

7. 금액 정보 (Monetary Information)

monetaryInformation 구조는 문서의 각종 금액을 담는다. monetaryDetails와 otherMonetaryDetails로 구성된다.

monetaryDetails (주 금액)

필드	Fmt	설명
`typeQualifier`	an..3	금액 유형 한정자
`amount`	an..35	금액
`currency`	an..3	통화 코드 (ISO)

otherMonetaryDetails (기타 금액, 최대 19회 반복)

monetaryDetails와 동일 구조로, 추가 금액 항목을 전달한다.

typeQualifier 주요 값 (5025 IA 02.2.1570)

코드	설명
B	Base fare, 기본 운임
E	Equivalent fare, 환산 운임
F	Commission amount, 수수료
H	Net fare amount, 순 운임
I	Transaction total amount, 거래 총액
M	Ticket total amount, 항공권 총액
T	Ticket document amount (base, tax, fee), 문서 금액
TTX	Total taxes amount, 세금 총액
712	Total fare amount, 운임 총액
713	Total amount of all surcharges, 전체 서차지 총액
714	Refund amount, 환불 금액
715	Fare difference amount, 운임 차액
A	Additional collection amount, 추가 징수 금액
AGT	Agent amount (market specific), 에이전트 금액
C	Additional collection total, 추가 징수 합계
OB	Total carrier fees, 항공사 수수료 합계
SEL	Selling fare amount, 판매 운임

FOP 연관 금액 (5025 IA 02.2.598)

코드	설명
FP	Form of payment amount, 결제 수단 금액
M	Ticket total amount, 항공권 총액
T	Ticket document amount (base, tax, fee), 문서 금액

8. 결제 수단 (Form of Payment)

fopDetails 그룹 구조 내에서 결제 수단 정보를 전달한다.

fopDescription (결제 수단 상세)

필드	Fmt	설명
`type`	an..10	결제 수단 유형 코드
`indicator`	an..3	결제 수단 지표
`amount`	n..18	결제 금액
`vendorCode`	an..35	신용카드 회사 코드 (VI, CA, AX 등)
`creditCardNumber`	an..35	신용카드 번호
`expiryDate`	an..35	신용카드 만료일
`approvalCode`	an..17	승인 코드
`sourceOfApproval`	an..3	승인 소스 (F=CRS Floor limit, M=Manual)

type (결제 수단 유형 코드)

코드	설명
CA	Cash, 현금
CC	Credit Card, 신용카드
CK	Check, 수표
AGT	Agent (이전 발행 문서 교환/대리)
GR	Government transportation request, 정부 운송 요청
MS	Miscellaneous, 기타
NR	Non-refundable (refund restricted), 환불 제한
PT	Prepaid Ticket Advice (PTA), 선납 발권 안내
SGR	Single government transportation request, 단일 정부 운송 요청
UN	United Nations Transportation Request, UN 운송 요청

indicator (FOP 지표 — 9988 IA 02.2.875)

코드	설명
2	Old, 이전
3	New, 신규
4	In connection with, 연관
5	Original issue form of payment, 원본 발행 결제 수단

9. 문서 번호 및 상태

documentNumber (Ticket Number Details)

항공권/문서의 논리적 번호와 항공사 코드를 포함하는 구조.

필드	Fmt	설명
`number`	an..35	문서 번호
`numberOfBooklets`	n..15	결합 발권(Conjunctive) 시 총 항공권 수
`status`	an..3	문서 확인 상태

status (문서 상태 — 4405 IA 02.2.9497)

보고서 내 문서가 확인되었는지 여부.

documentDetails (Document Information Details)

Rail 등 특수 문서의 번호를 전달하는 구조.

필드	Fmt	설명
`number`	an..35	문서 번호
`status`	an..3	문서 참조 유형
`processDetails`	—	처리 상세 (최대 10회)

status (문서 참조 유형 — 4405 IA 02.2.15664)

코드	설명
DOC	Document Number Reference, 문서 번호 참조
INV	Invoice, 인보이스

orderID (Order Identification)

NDC 주문 식별 참조. TKT별로 고유하다.

필드	Fmt	설명
`owner`	an..5	항공사(소유자) 코드
`id`	an..40	주문 참조 번호

orderItemID (Order Item Identification)

주문 내 개별 항목 식별. OrderID당 최대 99회 반복.

필드	Fmt	설명
`owner`	an..5	항공사(소유자) 코드
`id`	an..99	주문 항목 참조 번호

10. 승객 정보

passengerName (Traveller Information)

승객의 성(Surname) 정보를 전달하는 구조.

필드	Fmt	설명
`surname`	an..70	승객 성(Surname) + 이름
`type`	an..3	단위 한정자

enhancedPaxInfoCriteria (Enhanced Traveller Information)

승객의 상세 정보를 전달하는 구조. PTC, 유아 여부, 타투 번호 등을 포함한다.

필드	Fmt	설명
`qualifier`	an..3	PAX = 승객, IN = 유아
`quantity`	n..15	수량
`type`	an..3	승객 유형 코드 (PTC)
`otherType`	an..3	추가 승객 유형
`uniqueCustomerIdentifier`	an..35	타투 번호 (PNR 내 승객 식별)
`infantIndicator`	an1	유아 지표

infantIndicator (유아 지표)

값	설명
1	Infant (INF), 유아 - Edifact 추가 정보 없음
2	Infant given name only (INF/BILL), 유아 이름만
3	Infant given and last name (INFGATES/BILL), 유아 성+이름

otherPaxNamesDetails (이름 상세)

승객 1인당 최대 5가지 이름 유형(성인/유아)을 전달한다.

필드	Fmt	설명
`nameType`	an..5	이름 유형 (Native, Universal 등)
`referenceName`	an1	참조 이름 여부 (Y/N)
`displayedName`	an1	PNR 표시 이름 여부 (Y/No)
`romanizationMethod`	an..4	로마자 변환 방법
`surname`	an..70	성
`givenName`	an..70	이름
`title`	an..70	호칭 (MR, MS 등)

nameType (이름 유형 — 950K 1A 12.2.28)

코드	설명
NN1	Romanizable Native Name, 로마자 변환 가능 원어 이름
NN2	Non-Romanizable Native Name, 로마자 변환 불가 원어 이름
RN1	Romanization of Native Name 1 in ASCII domain [A-Z]
RN2	Romanization of Native Name 1 in extended ASCII domain
UN	Universal Name, 범용 이름

romanizationMethod (로마자 변환 방법 — 5800 1A 11.2.14)

코드	설명
KAR	Exception table for last name + Revised romanization of Korean
MCR	McCune-Reishauer
RRK	Revised romanization of Korean, 한국어 개정 로마자 표기법

11. 가격 지표 (Pricing Indicator)

pricingIndicator 구조는 문서의 가격 산정 방법을 나타낸다.

필드	Fmt	설명
`indicators`	an..3	가격 지표 코드 (최대 20회 반복)

indicators (가격 지표 — 5387 IA 02.2.1462)

코드	설명
A	Automated pricing, 자동 가격 산정
M	Manual pricing, 수동 가격 산정

12. 상태 정보 (Status Details)

statusDetails 구조는 문서의 현재 상태, 보고서 마감 상태 등을 전달한다.

필드	Fmt	설명
`indicator`	an..3	상태 한정자 (His/Crt)
`action`	an..3	동작 코드
`type`	an..3	보고서 마감 유형
`description`	an..70	테이프 번호 (자유 텍스트)

type (보고서 마감 유형 — 9015 IA 02.2.5536)

보고서의 마감(closure) 유형을 나타내는 코드.

13. 코드셋 참조 테이블

Code List Responsible Agency (3055 IA 02.2.4599)

코드 목록 관할 기관.

코드	설명
2	CEC (Commission of the European Communities)
3	IATA (International Air Transport Association)
5	ISO (International Organization of Standardization)
6	IATCI
13	ICAO (International Civil Aviation Organization)
ZZZ	Mutually defined, 상호 약정

Code List Qualifier (1131 IA 02.2.929)

코드	설명
EC	Error Codes, 오류 코드
WEC	Warning code, 경고 코드
WZZ	Mutually defined warning, 상호 약정 경고
ZZZ	Mutually defined, 상호 약정

Attribute Function Code Qualifier (9017 UN 02.A.4219)

코드	설명
AGN	Agent Full Name, 에이전트 전체 이름
SLG	Short Login, 에이전트 약식 로그인

Currency (6345 IA 02.2.1432)

코드	설명
777	Neutral Unit of Construction (NUC), 중립 건설 단위

Issue Indicator (906T 1A 02.1.87 / 02.1.123)

코드	설명
O	Original transaction code, 원본 거래 코드
C	Current transaction code, 현행 거래 코드

Company Identification (9906 IA 02.2.21001)

코드	설명
7CC	Industry Car Rental Companies, 렌터카 업계
7HH	Industry Hotel Chains, 호텔 체인 업계

Source, coded (9890 IA 02.2.1337)

코드	설명
F	CRS Floor limit, CRS 한도
M	Manual, 수동
S	Link, 링크

14. 응답 구조 다이어그램

SalesReports_DisplayQueryReportReply
|
+-- errorGroup [C, 1]
|   +-- errorOrWarningCodeDetails [M, 1]
|   +-- errorWarningDescription [C, 1]
|
+-- queryReportDataDetails [C, 1]
    +-- currencyInfo [M, 1]
    +-- stockProviderDetails [C, 1]
    +-- dateDetails [M, 2]
    |
    +-- queryReportDataOfficeGroup [M, 9] ......... 오피스별
    |   +-- requestorAgencyDetails [M, 1]
    |   |
    |   +-- documentData [M, 9999] ................ 문서별
    |       +-- sequenceIdentification [M, 1]
    |       +-- validatingCarrierDetails [C, 1]
    |       +-- documentNumber [M, 1]
    |       +-- orderID [C, 1]
    |       +-- orderItemID [C, 99]
    |       +-- documentDetails [C, 1]
    |       +-- monetaryInformation [M, 1]
    |       |   +-- monetaryDetails [M, 1]
    |       |   +-- otherMonetaryDetails [C, 19]
    |       +-- bookingAgent [M, 2]
    |       +-- bookingAgentOtherUserDetails [C, 5]
    |       +-- transactionDataDetails [M, 1]
    |       |   +-- code .......................... 거래 코드
    |       |   +-- type .......................... 거래 유형
    |       |   +-- issueIndicator ................ O/C
    |       +-- fopDetails [M, 1]
    |       |   +-- fopDescription [M, 1]
    |       |   +-- monetaryInfo [M*, 1]
    |       +-- passengerName [C, 1]
    |       +-- enhancedPaxInfoCriteria [C, 1]
    |       +-- statusDetails [C, 1]
    |       +-- reservationInformation [C, 9]
    |       +-- pricingIndicator [C, 1]
    |       +-- agentDetails [C, 2]
    |       +-- agentOtherUserDetails [C, 5]
    |
    +-- actionDetails [C, 1]
    +-- salesPeriodDetails [C, 1]

15. 메시지 구조 용어

기술 문서에서 사용되는 메시지 구조 정의 용어.

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

데이터 형식 표기법

표기	의미	예시
`a3`	고정 3자리 문자	`USD`
`n4`	고정 4자리 숫자	`2024` (년도)
`an..35`	가변 영숫자 최대 35자리	`HONG/GILDONG MR`
`n..18`	가변 숫자 최대 18자리	`528400` (금액)
`an1`	고정 1자리 영숫자	`O` (Issue Indicator)

약어 모음

약어	정식 명칭	설명
ACCP	Amadeus Convergence Content Platform	Amadeus 통합 콘텐츠 플랫폼
ARC	Airlines Reporting Corporation	미주 지역 항공사 정산 기관
BSP	Billing and Settlement Plan	IATA 발권 정산 시스템
DFC	Default Filing Currency	오피스 기본 통화
EMD	Electronic Miscellaneous Document	부가서비스 전표
FOP	Form of Payment	결제 수단
IATA	International Air Transport Association	국제항공운송협회
MCO	Miscellaneous Charges Order	기타 비용 주문서
NDC	New Distribution Capability	항공사 직접 연결 표준
NUC	Neutral Unit of Construction	중립 건설 단위 (국제 운임 계산 기준)
PNR	Passenger Name Record	승객 예약 기록
PTA	Prepaid Ticket Advice	선납 발권 안내
PTC	Passenger Type Code	승객 유형 코드
SLG	Short Login	에이전트 약식 로그인
SOF	Sales report Office Filter	판매 보고서 오피스 필터
STP	Satellite Ticket Printer	위성 발권 프린터/오피스
TDO	Ticket Delivery Office	티켓 배달 오피스
TKT	Ticket	항공권

개요

Step 1-2: 검색

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

Step 7-9: 예약 생성

Step 10-12: 발권

Step 13-15: 후속 처리

보조 API

​1. 개요