File-based 배송 일정
파트너 포털()의 일정 API 표준 보고서에는 숙박 전용 또는 여러 비즈니스 라인(LOB)에 대한 transaction-level 예약이 포함되어 있습니다. 표준 보고서를 사용하면 추가 개발 시간 없이 신속하게 데이터를 얻을 수 있습니다.
일정 API에 대한 보고서는 거래 수준에서 작성되며, 숙소의 경우 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 | 십진수(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 | 십진수(18,4) | 쿠폰 금액은 미국 달러입니다. | -58.6877 |
gbv_usd | 십진수(18,4) | 미국 달러로 표시된 예약의 총 예약 금액입니다. | 694.8941 |
taxes_and_fees_local | 십진수(18,4) | 현지 통화로 표시된 총 세금 및 수수료. | 144.77 |
taxes_and_fees_usd | 십진수(18,4) | 총 세금 및 수수료는 미국 달러 기준입니다. | 144.77 |
taxes_and_fees_tpid | 십진수(18,4) | 총 세금 및 수수료는 TPID 통화로 표시됩니다. | 144.77 |
insurance_gbv_local | 십진수(18,4) | 현지 통화로 표시된 보험 금액입니다. | 80.4 |
insurance_gbv_usd | 십진수(18,4) | 미국 달러로 표시된 보험 금액입니다. | 80.4 |
air_supplier_pnr | varchar(100) | 공급업체 항공 승객 이름 기록. | 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 | 십진수(18,4) | 현지 통화로 표시된 예약의 항공 부분 총 예약 금액입니다. | 694.8941 |
air_gbv_usd | 십진수(18,4) | 예약 중 항공 부분의 총 예약 금액(미국 달러 기준)입니다. | 694.8941 |
air_gbv_tpid | 십진수(18,4) | 예약의 항공 부분 총 예약 금액(TPID 통화 기준)입니다. | 694.8941 |
air_tpid_currency_code | char(3) | 표준 국제 은행 계좌 번호(IBAN) 통화 코드 형식으로 표시되는 TPID 예약 통화입니다. | 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) | 숙박 예약 구성 요소의 비즈니스 모델. | 머천트 |
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 더 블룸, 전용 욕실 |
lodging_length_of_stay | 정수 | 예약한 숙소의 숙박 기간(숙박 일수) 숙박 시설. | 5 |
lodging_room_count | smallint | 숙박 시설에 예약된 객실 수입니다. | 1 |
lodging_room_night_count | smallint | 예약 객실 숙박 일수(숙박 기간 * 객실 수). | 5 |
lodging_gbv_local | 십진수(18,4) | 현지 통화로 표시된 숙박 부분의 총 예약 금액입니다. | 1379.8 |
lodging_gbv_usd | 십진수(18,4) | 예약 중 숙박 부분의 총 예약 금액(미국 달러 기준)입니다. | 1029.9317 |
lodging_gbv_tpid | 십진수(18,4) | 예약 중 숙박 부분의 총 예약 금액(TPID 통화 기준)입니다. | 1029.9317 |
lodging_average_daily_rate_local | 십진수(18,4) | 현지 통화로 표시된 숙박 시설 예약의 일일 평균 요금(GBV/숙박 기간)입니다. | 275.96 |
lodging_average_daily_rate_usd | 십진수(18,4) | 예약된 숙박 시설의 일일 평균 요금(GBV/체류 기간)(미국 달러 기준)입니다. | 205.9863 |
lodging_tpid_currency_code | char(3) | 표준 국제은행 계좌 번호(IBAN) 통화 코드 형식으로 표시되는 숙소 TPID 예약 통화입니다. | 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 | 십진수(18,4) | 현지 통화로 표시된 예약 중 차량 부분의 총 예약 금액입니다. | 310.8 |
car_gbv_usd | 십진수(18,4) | 예약 중 자동차 부분의 총 예약 금액(미국 달러 기준)입니다. | 231.9919 |
car_gbv_tpid | 십진수(18,4) | 예약 중 차량 부분의 총 예약 금액(TPID 통화 기준)입니다. | 1029.9317 |
car_tpid_currency_code | char(3) | 차량 TPID 예약 통화는 표준 국제 은행 계좌 번호(IBAN) 통화 코드 형식으로 표시됩니다. | USD |
activity_offering_name | varchar(200) | 예약된 대상 서비스 활동의 이름입니다. | 패션 오브 파라다이스 - 그레이트 배리어 리프 |
activity_vendor_name | varchar(200) | 예약한 대상 서비스 공급업체의 이름입니다. | 바이에이터(3P) |
activity_vendor_city | varchar(200) | 벤더 지점이 위치한 도시입니다. | 알 수 없음 |
activity_vendor_country_code | char(3) | 벤더 지점이 위치한 국가 코드입니다. | NZL |
activity_ticket_count | smallint | 액티비티를 위해 예약한 티켓 수입니다. | 1 |
activity_gbv_local | 십진수(18,4) | 현지 통화로 표시된 예약 중 목적지 서비스 부분의 총 예약 금액입니다. | 204.02 |
activity_gbv_usd | 십진수(18,4) | 예약 중 목적지 서비스 부분의 총 예약 가치(미국 달러 기준)입니다. | 152.2878 |
activity_gbv_tpid | 십진수(18,4) | 예약의 활동 부분의 총 예약 가치(TPID 통화 기준)입니다. | 1029.9317 |
activity_tpid_currency_code | char(3) | 표준 국제 은행 계좌 번호(IBAN) 통화 코드 형식으로 표시되는 액티비티 TPID 예약 통화입니다. | USD |
loyalty_id | varchar(200) | 로열티/회원 ID 번호. | 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) | 예약을 구매하는 사람의 주소(거리, 도시, 주/도, 국가, 우편번호 포함). | 123 1st Street, 뉴욕, NY |
billing_phone_number | varchar(200) | 예약을 구매하는 사람의 전화번호입니다. | 10111213141 |
promotional_mail_indicator | char(3) | 개인이 프로모션 메일 수신에 등록했는지 여부를 나타내는 지표입니다. | 0 |