File-based 일정 주문 배송
파트너 포털의 일정 API에 대한 표준 보고서에는 숙박 전용 또는 여러 사업 부문(LOB)에 걸친 transaction-level 예약 내역이 포함됩니다. 당사의 표준 보고서를 활용하면 별도의 개발 시간 없이도 데이터를 신속하게 확보할 수 있습니다.
일정 API의 보고서는 트랜잭션 단위로 생성되며, 숙박(Lodging) 보고서를 위해 엄선된 60개 이상의 필드 목록과, 숙박 관리( multi-LOB ) 보고서를 위해 100개 이상의 필드를 제공합니다. 선택 가능한 항목은 다음과 같습니다:
- 여행 일정, 일정, 여행 금액 등 기본 예약 정보
- 여행자 및 구매자(다른 경우)의 고객 정보
- 확인 번호, 공급업체 및 위치, 사용된 LOB 수, 비용 등의 제품 정보
>> 파일 전송 설정에 대해 자세히 알아보기
>> 파일 수집을 위한 모범 사례
표준 보고서의 기본 필드
보고서를 사용자 지정할 때 선택할 수 있는 항목이 다양합니다. 이 항목들은 표준 보고서에 기본적으로 포함됩니다.
| 필드 이름 | 데이터 유형 | 설명 | 예 |
|---|---|---|---|
book_date | 날짜 | 예약이 처음 이루어진 날짜로, ISO 8601 날짜 형식으로 표시된 (YYYY-MM-DD). | 2023-02-05 |
transaction_date | 날짜 | 예약이 마지막으로 수정된 날짜. 예약 내용이 전혀 업데이트되지 않는다면, 이는book_date와 동일합니다. 날짜는 ISO 8601 날짜 형식으로 표시됩니다 (YYYY-MM-DD). | 2023-02-05 |
begin_use_date | 날짜 | 여행 시작일: 출발일, check-in 날짜, pick-up 날짜 등. ISO 8601 날짜 형식으로 표기된 (YYYY-MM-DD). | 2023-04-05 |
end_use_date | 날짜 | 여행 종료일: 도착일, check-out 날짜, drop-off 날짜 등, ISO 8601 날짜 형식으로 표기된 날짜 (YYYY-MM-DD). | 2023-04-06 |
transaction_type | varchar(200) | 기록된 거래 유형입니다. | 가능한 값: 구매, 부여, 수정, 취소. |
product_line_name | varchar(200) | 예약 항목이 속하는 사업 유형. | 가능한 값: 항공, 자동차, 크루즈, 목적지 서비스, 보험, 숙박, 패키지, 알 수 없음 |
package_indicator | varchar(100) | 예약 항목이 패키지(예: 항공권 + 호텔)의 일부인지 여부. | 가능한 값: 패키지의 일부, 독립형, 알 수 없음 |
product_component | varchar(200) | 패키지 구매에 포함된 제품. 구매 상품이 패키지가 아닌 경우, 단일 제품 라인 이름만 표시됩니다. | 항공, 자동차 |
itinerary_number | varchar(50) | 일정 번호 또는 POS 주문 참조 번호입니다. | 12345678910111 |
booking_item_id | varchar(50) | 일정의 일부로 예약된 특정 요소의 식별자입니다. 이 필드의 값은 양수일 수도 있고 음수일 수도 있습니다. | 1400882912 |
currency_code | char(3) | 예약 대금이 결제된 통화로, 표준 국제은행계좌번호(IBAN) 통화 코드 형식으로 표기됩니다. | USD |
gbv_local | decimal(18,4) | 총 예약 금액(GBV)은 결제 시 사용된 통화로 표시된, 세금 및 수수료를 포함한 총 예약 금액입니다. | 694.89 |
order_count | smallint | 패키지 구매 건수(품목 수가 아님). | 1 |
추가 선택 입력란
참고: 아래 표는 보고서에서 필드가 표시될 순서와 다릅니다. 필드의 순서는 생성/편집 과정에서 필드가 활성화된 순서에 따라 결정됩니다.
| 필드 이름 | 데이터 유형 | 설명 | 예 |
|---|---|---|---|
transaction_datetime | 타임스탬프 | 예약이 마지막으로 업데이트(수정)된 날짜 및 시간입니다. 예약 내용이 변경된 적이 없다면, 이 날짜와 시간은 예약일과 동일합니다. | 2023-02-05 06:05:00 |
booking_window | 정수 | 예약일과 check-in 날짜 사이의 일수. | 32 |
booking_status | varchar(50) | 개시, 진행 중, 완료, 수주, 또는 취소. | 진행 중 |
online_offline_indicator | varchar(100) | 예약이 온라인으로 이루어졌는지, 아니면 여행사를 통해 오프라인으로 이루어졌는지를 나타냅니다. | 온라인 |
point_of_sale_country | char(3) | 고객이 예약하는 판매처. | USD |
payment_type | varchar(50) | 사용한 결제 수단(신용카드, 포인트, 분할 결제 등). 대리점을 통한 후불 예약의 경우, 차량이나 호텔 예약 시 이 항목은 비워 둡니다. | 분할 지급 |
coupon_code | varchar(100) | 쿠폰 코드 사용 완료. | ABCD |
coupon_name | varchar(200) | 쿠폰 이름. | PRIME |
coupon_description | varchar(510) | 사용한 쿠폰에 대한 설명. | BoGo 5% |
coupon_price_amount_usd | decimal(18,4) | 쿠폰 금액(미국 달러). | -58.6877 |
gbv_usd | decimal(18,4) | 예약 총액(미국 달러 기준). | 694.8941 |
gbv_tpid | decimal(18,4) | TPID 통화로 표시된 총 GBV를 제공합니다. | 694.8941 |
taxes_and_fees_local | decimal(18,4) | 현지 통화로 표시된 총 세금 및 수수료. | 144.77 |
taxes_and_fees_usd | decimal(18,4) | 미화 기준 총 세금 및 수수료. | 144.77 |
taxes_and_fees_tpid | decimal(18,4) | TPID 통화로 표시된 세금 및 수수료 총액. | 144.77 |
insurance_gbv_local | decimal(18,4) | 현지 통화로 표시된 보험 금액. | 80.4 |
insurance_gbv_usd | decimal(18,4) | 보험 금액(미국 달러 기준). | 80.4 |
air_supplier_pnr | varchar(100) | 항공사 승객 명단(PNR). | ABCDEF |
air_carrier_pnr | varchar(100) | 항공사의 승객 명세서. | BCDEFG |
air_business_model | varchar(200) | 예약 서비스 중 항공 부문의 비즈니스 모델. | 여행사 |
air_trip_type | varchar(200) | 항공 여행 유형. | 편도 |
air_fare_class | varchar(200) | 구매한 항공권 요금 등급. | 비즈니스석 |
air_plating_carrier | varchar(200) | 항공사명. | 에어캐나다 |
airport_origin_code | char(3) | 항공편이 출발하거나 출발지로 하는 공항 코드. | YYZ |
airport_origin_location | varchar(406) | 항공편이 출발하거나 출발지인 장소. | 캐나다 온타리오주 토론토 |
airport_destination_code | char(3) | 항공편이 도착하는 공항 코드 또는 목적지. | FLL |
airport_destination_location | varchar(406) | 항공편이 도착하는 장소/목적지. | 미국 플로리다주 포트 로더데일 |
air_ticket_number | varchar(100) | 항공권 번호. | 123456789101 |
air_ticket_count | smallint | 예약된 항공권 수 (예약 항목 ID(보통 0 또는 1)가 포함된 상세 파일 기준). | 1 |
air_segment_count | smallint | 항공 여행의 구간 수(예약 항목 ID 수준 이상으로 집계된 경우, 해당 예약에 포함된 모든 승객의 모든 구간을 합산한 값이 됩니다). | 2 |
air_gbv_local | decimal(18,4) | 예약 내 항공편 부분의 총 예약 금액(현지 통화 기준). | 694.8941 |
air_gbv_usd | decimal(18,4) | 예약 중 항공편 부분의 총 예약 금액(미국 달러 기준). | 694.8941 |
air_gbv_tpid | decimal(18,4) | TPID 통화로 표시된 예약 중 항공편 부분의 총 예약 금액. | 694.8941 |
air_tpid_currency_code | char(3) | TPID 예약 통화가 표준 국제은행계좌번호(IBAN) 통화 코드 형식으로 표시됩니다. | USD |
total_person_count | 정수 | 예약에 포함된 총 인원 수 (숙박 부분만 해당). | 3 |
adult_count | smallint | 예약에 포함된 성인 인원 수 (숙박 부분만 해당). | 2 |
child_count | smallint | 예약에 포함된 어린이 인원 수 (숙박 부분만 해당). | 1 |
lodging_supplier_confirmation_code | varchar(100) | 예약 시 숙박 시 설 님이 제공한 인증 코드입니다. | 1516171819 |
lodging_business_model | varchar(200) | 예약 서비스 중 숙박 부문의 비즈니스 모델. | Merchant |
lodging_chain_independent | varchar(200) | 숙박 시설가 독립적인 것인지, 아니면 체인의 일부인지 여부를 나타내는 지표입니다. | 독립 브랜드 |
lodging_chain_name | varchar(200) | 예약한 숙박 시설의 체인(브랜드) 이름. | 독립 브랜드 |
lodging_property_name | varchar(200) | 숙박 시설 예약자 이름 | 코델리아 호텔 |
lodging_star_rating | 부동 | 숙박 시설 예약 건의 별점 평가. | 3 |
lodging_property_city | varchar(40) | 예약된 숙박 시설가 위치한 도시. | 파리 |
lodging_property_market_name | varchar(80) | 예약된 숙박 시설가 위치한 시장. | IDF - 프랑스 파리 |
lodging_property_state_province | varchar(40) | 숙박 시설 예약이 이루어진 주/도. | 파리 |
lodging_property_country | varchar(80) | 예약된 숙박 시설가 위치한 국가의 국가 코드. | 프랑스 |
lodging_refundable_rate_indicator | varchar(100) | 예약된 요금이 환불 가능 여부 또는 환불 불가 여부를 표시합니다. | 환불 가능한 취소 위약금율. |
lodging_rate_plan_name | varchar(200) | 예약된 요금제 이름. | 패키지 |
lodging_rate_type_name | varchar(200) | 예약된 요금 유형명. | 패키지 |
lodging_room_type_name | varchar(200) | 예약한 객실 유형명. | Comfort 2인실, 전용 욕실 |
lodging_length_of_stay | 정수 | 예약된 숙박 시설의 숙박 기간(박 수). | 5 |
lodging_room_count | smallint | 숙박 시설에서 예약된 객실 수. | 1 |
lodging_room_night_count | smallint | 예약된 객실 숙박 일수 (체류 기간 × 객실 수). | 5 |
lodging_gbv_local | decimal(18,4) | 예약 중 숙박 부분에 대한 총 예약 금액(현지 통화 기준). | 1379.8 |
lodging_gbv_usd | decimal(18,4) | 예약 중 숙박 부분의 총 예약 금액(미국 달러 기준). | 1029.9317 |
lodging_gbv_tpid | decimal(18,4) | TPID 통화로 표시된 예약 중 숙박 부분의 총 예약 금액. | 1029.9317 |
lodging_average_daily_rate_local | decimal(18,4) | 현지 통화로 표시된 숙박 시설의 일일 평균 예약 요금 (GBV / 숙박 기간). | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | 숙박 시설의 일일 평균 예약 요금(GBV / 숙박 기간 기준, 미국 달러). | 205.9863 |
lodging_tpid_currency_code | char(3) | Lodging TPID 예약 통화가 표준 국제은행계좌번호(IBAN) 통화 코드 형식으로 표시됩니다. | USD |
car_supplier_confirmation_code | varchar(100) | 예약 시 렌터카 업체에서 제공한 인증 코드. | ABC1234 |
car_business_model | varchar(200) | 자동차 부품 예약 서비스의 비즈니스 모델. | n/a |
car_vendor_name | varchar(200) | 예약한 렌터카 업체명. | Hertz |
car_type | varchar(200) | 예약한 차량 유형. | 2/4도어 소형차 |
car_pickup_location_code | char(3) | 예약한 차량을 인수 할 장소의 코드(일반적으로 공항 코드). | YDF |
car_pickup_location | varchar(200) | 예약한 차량을 인수할 장소. | 디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역) |
car_dropoff_location_code | char(3) | 예약한 차량을 반납할 장소의 코드(일반적으로 공항 코드). | YDF |
car_dropoff_location | varchar(200) | 예약한 차량을 반납할 장소. | 디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역) |
car_trip_type | varchar(200) | 차량 예약이 왕복인지 편도인지에 관계없이. | 왕복 |
car_rental_day_count | smallint | 차량 예약 일수. | 7 |
car_count | smallint | 예약된 차량 수. | 1 |
car_gbv_local | decimal(18,4) | 예약 중 차량 부분의 총 예약 금액(현지 통화 기준). | 310.8 |
car_gbv_usd | decimal(18,4) | 예약 중 차량 부분의 총 예약 금액(미국 달러 기준). | 231.9919 |
car_gbv_tpid | decimal(18,4) | TPID 통화로 표시된 예약 중 차량 부분의 총 예약 금액. | 1029.9317 |
car_tpid_currency_code | char(3) | 자동차 TPID 예약 통화가 표준 국제은행계좌번호(IBAN) 통화 코드 형식으로 표시됩니다. | USD |
activity_offering_name | varchar(200) | 예약된 목적지 서비스 활동의 이름. | 패션 오브 파라다이스 - 그레이트 배리어 리프 |
activity_vendor_name | varchar(200) | 예약된 목적지 서비스 공급업체명. | Viator (제3자) |
activity_vendor_city | varchar(200) | 판매자 지점이 위치한 도시. | 알 수 없음 |
activity_vendor_country_code | char(3) | 공급업체 지점이 위치한 국가의 국가 코드. | NZL |
activity_ticket_count | smallint | 해당 활동에 예약된 티켓 수. | 1 |
activity_gbv_local | decimal(18,4) | 예약 중 ‘목적지 서비스’ 항목의 현지 통화 기준 총 예약 금액. | 204.02 |
activity_gbv_usd | decimal(18,4) | 예약 중 ‘목적지 서비스’ 부분의 총 예약 금액(미국 달러 기준). | 152.2878 |
activity_gbv_tpid | decimal(18,4) | TPID 통화로 표시된 예약 중 활동 부분의 총 예약 금액. | 1029.9317 |
activity_tpid_currency_code | char(3) | 활동 TPID 예약 통화가 표준 국제은행계좌번호(IBAN) 통화 코드 형식으로 표시된 것. | USD |
loyalty_id | varchar(200) | 로열티/회원 번호. | 12345678 |
program_id | varchar(200) | 계층 정보를 나타냅니다 | 6549 |
passenger_name | varchar(200) | 예약에 등록된 사람의 이름(일반적으로 구매자 이름과 동일하나, 항공권 예약의 경우 항공권에 기재된 모든 승객의 이름이 나열됨). | 제임스 스미스 |
purchaser_first_name | varchar(200) | 예약을 구매하는 사람의 이름. | 제임스 |
purchaser_last_name | varchar(200) | 예약을 구매한 사람의 성. | Smith |
purchaser_email_address | varchar(200) | 예약을 구매하는 사람의 이메일 주소. | james.smith@email.com |
billing_address | varchar(200) | 예약 구매자의 주소(거리, 도시, 주/도, 국가, 우편번호 포함). | 뉴욕주 뉴욕시 1번가 123번지 |
billing_phone_number | varchar(200) | 예약을 구매하는 사람의 전화번호. | 10111213141 |
promotional_mail_indicator | char(3) | 해당 개인이 홍보 메일 수신에 동의했는지 여부를 나타내는 지표. | 0 |