Developer Hub
This is an auto-generated translation

일정에 대한 API 제공

일정를 사용하면 고객의 예약 정보를 표시하고 투어나 체험과 같은 booking-related 상품이나 서비스를 찾을 수 있도록 도와줄 수 있습니다. 또한 데이터를 사용하여 예약 트렌드를 분석하고 이해관계자를 위한 보고서를 작성할 수도 있습니다.

배송 옵션

일정 데이터의 API 전송은 푸시 또는 풀 메커니즘을 사용할 수 있습니다.

푸시 메커니즘

푸시 서비스는 near-real 시간에 핵심적인 transaction-level 세부 정보에 초점을 맞춰 일정 업데이트가 제공되면 이를 전송하도록 설계되었습니다. 이 옵션을 사용하면 다음과 같이 할 수 있습니다:

  • 웹사이트 또는 앱에 고객의 예약 정보를 표시합니다.
  • 고객에게 여행에 필요한 추가 제품 및 서비스 구매를 제안하세요.

푸시 이벤트는 웹훅을 통해 HTTP POST메시지 형식으로 사용자가 제공한 URL로 전달됩니다. 이러한 메시지는 순서 없이 도착할 수 있으므로 creation_date및 update_date_time요소를 참조하여 순서를 결정하세요.

이 배달 옵션을 채택하는 방법에 대한 자세한 내용은 API 설정을 참조하세요.

풀 메커니즘

풀 서비스는 자세한 일정 데이터를 지원합니다:

  • 데이터 분석
  • 푸시 전송이 실패한 기간에 대한 데이터 검색
  • 헬프 데스크 조사

이 서비스는 두 개의 HTTP GET엔드포인트로 구성되어 있습니다:

  • creation_date_start, creation_date_end, update_date_time_start, update_date_time_end변수를 사용하여 지정된 시간 범위에서 생성되거나 업데이트된 일정 목록을 만듭니다.
  • 특정 일정를 검색합니다. itinerary_id

인증 프로세스에 대한 자세한 내용은 API 설정 을 참조하세요.

사용 가능한 필드

아래 표에는 중첩된 개체를 포함하여 푸시 및 풀 제공 방식을 통해 사용 가능한 필드가 나열되어 있습니다.

이름과 그 뒤의 마침표로 시작하는 필드 이름(예: <variable>.<nested variable>)은 중첩 관계를 나타냅니다.

화이트 레이블 템플릿

필드 이름정의예
itinerary_id일정 번호 또는 POS 주문 참조 번호입니다.72622069245694
status일정 및 개별 항목의 상태입니다.가능한 값입니다:
confirmed
취소됨
creation_date*예약이 처음 이루어진 날짜로, ISO 8601 날짜 형식으로 표시됩니다(YYYY-MM-DD).2023-02-05
update_date_time*ISO 8601 날짜 형식으로 표시된 일정의 마지막 업데이트 날짜 및 시간(YYYY-MM-dd'T"HH:mm:ss.SSSZ)입니다.2023-10-21T00:00:00.000Z
online일정가 온라인(참)으로 예약되었는지 또는 에이전트를 통해 예약되었는지(거짓)를 나타냅니다. 부울 값으로 표시됩니다.true
package일정가 패키지의 일부인지, 아니면 독립형 예약인지 표시합니다. 부울 값으로 표시됩니다.false
payment_type결제 페이지에서 사용한 결제 수단입니다.가능한 값:
신용카드
포인트
분할 결제
point_of_sale_country_code고객이 예약을 한 POS의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.GB
purchaser예약한 사람의 신원 정보입니다. 중첩된 항목의 목록은 purchaser 표를 참조해 주세요. 
property_booking_items일정의 일부로 예약된 숙박 시설 구성 요소입니다. 중첩된 항목의 목록은 property_booking_items 표를 참조해 주세요. 
flight_booking_items일정의 일부로 예약된 항공 구성 요소입니다. 중첩된 항목의 목록은 flight_booking_items 표를 참조해 주세요. 
car_booking_items일정의 일부로 예약된 렌터카 구성 요소입니다. 중첩된 항목의 목록은 car_booking_items 표를 참조해 주세요. 
activity_booking_items일정의 일부로 예약된 즐길거리 구성 요소입니다. 중첩된 항목의 목록은 activity_booking_items 표를 참조해 주세요. 
insurance_booking_items일정의 일부로 예약된 보험 구성 요소입니다. 중첩된 항목의 목록은 insurance_booking_items 표를 참조해 주세요. 
rate예약 항목 또는 전체 일정의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 
coupon해당되는 경우 일정에 적용된 쿠폰입니다. 중첩된 항목의 목록은 coupon 표를 참조해 주세요. 
|

purchaser

이 필드는 예약한 사람을 식별합니다.

필드 이름정의예
purchaser.email**예약한 사람의 이메일 주소입니다.smith@example.com
purchaser.loyalty_id**회원혜택 프로그램 멤버십 식별자입니다.12345678
purchaser.first_name**예약한 사람의 이름입니다.Jane
purchaser.last_name**예약한 사람의 성입니다.Smith

property_booking_items

이러한 필드는 일정의 일부로 예약된 숙박 시설 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882912
status특정 숙박 시설 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨
checkin_date*해당 숙박 시설 요소의 체크인 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01
checkout_date*해당 숙박 시설 요소의 체크아웃 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05
property.idExpedia Group's 호텔 또는 휴가용 숙소의 고유 식별자 숙박 시설.1400882912
property.chain_name해당되는 경우 숙박 시설이 속한 체인의 이름입니다.독립 브랜드
property.brand_name해당되는 경우 숙박 시설이 속한 브랜드의 이름입니다. 한 체인에 여러 브랜드가 있을 수 있습니다.사보이 시그니처
property.name호텔 또는 휴가용 주택의 이름입니다.호텔 1
property.city숙박 시설이 위치한 도시의 이름입니다.토론토
property.state_province_name숙박 시설이 위치한 주 또는 도의 이름입니다.온타리오
property.country_code숙박 시설이 위치한 국가의 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
property.star_rating숙박 시설의 등급입니다.3.0
room_name호텔 또는 휴가용 렌탈업체에서 정의한 예약 객실 유형입니다.Comfort 전용 욕실이 있는 더블룸
adult_count해당 예약에 포함된 성인의 인원수입니다.2
child_count해당 예약에 포함된 어린이의 인원수입니다.0
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.true
property_confirmation_id***호텔 또는 휴가용 렌탈 업체에서 제공한 확인 번호입니다.1516171819
rate숙박 시설 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

flight_booking_items

이러한 필드는 일정의 일부로 예약된 항공 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882911
status특정 항공 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨
departure_date*해당 항공 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01
arrival_date*해당 항공 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02
airline.plating_carrier_name항공권을 발행한 항공사의 이름입니다.에어캐나다
airline.plating_carrier_code국제항공운송협회(IATA) 항공권을 발권한 항공사의 코드.AC
carrier_pnr항공권을 발권한 항공사의 기록에 있는 승객 이름입니다.SMITH
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지
fare_class티켓의 좌석 등급입니다.이코노미
airport_origin_code출발지 공항의 IATA 코드입니다.LHR
airport_origin_location출발 공항의 위치입니다.런던, 영국(LHR-히드로)
airport_destination_code도착 공항의 코드입니다. IATA 형식으로 표시됩니다.YYZ
airport_destination_location도착 공항의 위치입니다.토론토, 온타리오(YYZ-레스터 B. 피어슨 국제공항)
ticket_number항공편의 티켓 번호입니다.123456789
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.true
segment_count항공권의 항공편 구간 수입니다.1
rate항공편 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

car_booking_items

이러한 필드는 일정의 일부로 예약된 렌터카 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910
status특정 렌터카 여행 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨
pickup_date*렌터카 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02
return_date*렌터카 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05
rental_company.name***렌터카 회사 이름입니다.Hertz
car_type***렌터카 유형입니다.2/4도어 소형차
pickup_location렌터카의 픽업 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)
pickup_country_code***렌터카 픽업 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
return_location렌터카의 반납 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)
return_country_code***렌터카 반납 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지
rental_company_confirmation_id***렌터카 회사에서 제공한 확인 번호입니다.ABC1234
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.false
rate렌터카 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

activity_booking_items

이러한 필드는 일정의 일부로 예약된 즐길거리 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910
status특정 즐길거리의 상태입니다.가능한 값입니다:
confirmed
취소됨
activity_start_date*즐길거리의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03
activity_end_date*즐길거리의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03
vendor.name***즐길거리를 제공하는 공급업체의 이름입니다.올리비아의 투어
vendor.city***즐길거리 공급업체가 위치한 도시입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)
vendor.country_code***즐길거리 공급업체가 위치한 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
offering_name***즐길거리의 이름입니다.패션 오브 파라다이스 - 그레이트 배리어 리프
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.true
rate즐길거리 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

insurance_booking_items

이러한 필드는 일정의 일부로 예약된 보험 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882610
status선택한 특정 보험의 상태입니다.가능한 값입니다:
confirmed
취소됨
rate선택한 보험의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

rate

이러한 필드는 예약 항목 또는 전체 일정의 요금 및 가격 세부 정보를 나열합니다. 여기에는 예약의 금전적 가치를 설명하는 중첩된 값이 포함되며, 총 예약 가치와 세금 및 수수료로 세분화됩니다.

필드 이름정의예
rate_plan_name항목의 가격에 사용된 요금제의 이름입니다. 숙박 시설 예약 상품에만 사용할 수 있습니다.룸온리
rate_plan_type예약에 사용된 요금 유형입니다. 숙박 시설 예약 상품에만 사용할 수 있습니다.판매 요금
refundable해당 예약 구성요소가 환불 가능한지 여부(참) 또는 환불 불가능(거짓)입니다.true
pricing예약의 금전적 가치를 캡처하는 개체로, 총 예약 가치와 세금 및 수수료로 세분화됩니다. 
pricing.gross_booking_value예약의 금전적 가치를 캡처하는 객체입니다. 
pricing.gross_booking_value.billable_currency결제에 사용된 통화로 예약의 금전적 가치를 나타내는 객체입니다. 
pricing.gross_booking_value.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP
pricing.gross_booking_value.billable_currency.value총 예약 금액입니다.2520.80
pricing.taxes_and_fees예약에 대한 세금 및 수수료의 금액과 통화입니다. 
pricing.taxes_and_fees.billable_currency예약에 대한 세금 및 수수료의 금액(결제에 사용된 통화 기준)입니다. 
pricing.taxes_and_fees.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP
pricing.taxes_and_fees.billable.currency.value총 예약 금액입니다.491.10

coupon

필드 이름정의예
code***예약에 사용된 쿠폰 코드입니다.ABCD
name***쿠폰 이름입니다.PRIME
description***쿠폰에 대한 설명입니다.BoGo 5%
currency***쿠폰 금액이 적용된 통화입니다. ISO 4217 형식으로 표시됩니다.GBP
value***쿠폰의 금액입니다.126.04

모든 화이트 라벨 템플릿 필드에 대한 참고 사항

* 날짜 필드는 협정 세계시(UTC) 기준입니다.
** 개인 식별 정보(PII) 데이터를 나타냅니다. 이 정보는 회사의 지침에 따라 올바르게 처리해야 합니다. 꼭 필요한 경우에만 포함해 주세요.
*** 해당 필드에 대한 데이터는 예약이 생성되거나 업데이트된 다음 날 오후 6시부터 오후 8시(UTC) 사이에 제공됩니다. 현재 실시간에 가까운 데이터는 제공되지 않습니다.

여행사 제휴 프로그램(TAAP)

필드 이름정의예
itinerary_id일정 번호 또는 POS 주문 참조 번호입니다.72622069245694
status일정 및 개별 항목의 상태입니다.가능한 값입니다:
confirmed
취소됨
creation_date*예약이 처음 이루어진 날짜로, ISO 8601 날짜 형식으로 표시됩니다(YYYY-MM-DD).2023-02-05
update_date_time*ISO 8601 날짜 형식으로 표시된 일정의 마지막 업데이트 날짜 및 시간(YYYY-MM-dd'T"HH:mm:ss.SSSZ).2023-10-21T00:00:00.000Z
online일정가 온라인(참)으로 예약되었는지, 아니면 에이전트를 통해 예약되었는지(거짓)를 나타냅니다. 부울 값으로 표시됩니다.true
point_of_sale_country_code고객이 예약한 국가의 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.GB
purchaser예약한 사람의 신원 정보입니다. 중첩된 항목의 목록은 purchaser 표를 참조해 주세요. 
agency예약을 진행한 TAAP 여행사 및 에이전트의 신원 확인. 중첩된 항목의 목록은 agency 표를 참조해 주세요. 
payment일정에 대한 결제 정보입니다. 중첩된 항목의 목록은 payment 표를 참조해 주세요. 
property_booking_items일정의 일부로 예약된 숙박 시설 구성 요소입니다. 중첩된 항목의 목록은 property_booking_items 표를 참조해 주세요. 
flight_booking_items일정의 일부로 예약된 항공 구성 요소입니다. 중첩된 항목의 목록은 flight_booking_items 표를 참조해 주세요. 
car_booking_items일정의 일부로 예약된 렌터카 구성 요소입니다. 중첩된 항목의 목록은 car_booking_items 표를 참조해 주세요. 
activity_booking_items일정의 일부로 예약된 즐길거리 구성 요소입니다. 중첩된 항목의 목록은 activity_booking_items 표를 참조해 주세요. 
rate예약 항목 또는 전체 일정의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 
earnings예약 항목 또는 전체 일정의 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요. 
|

purchaser

이 필드는 여행할 사람을 식별합니다.

필드 이름정의예
purchaser.email**여행자의 이메일 주소입니다.smith@example.com
purchaser.first_name**여행자의 이름입니다.Jane
purchaser.last_name**여행자의 성입니다.Smith

에이전시

이 필드는 예약을 진행한 TAAP 여행사 및 에이전트를 식별합니다.

필드 이름정의예
agency.name예약을 진행한 여행사( TAAP )의 이름입니다.세계 여행
agency.id예약을 진행한 TAAP 여행사의 추적 코드입니다.WS02555
agency.agent.first_name**예약을 진행한 TAAP 상담원의 이름입니다.Bob
agency.agent.last_name**예약을 진행한 TAAP 상담원의 성입니다.Jones
agency.agent.email**예약을 진행한 TAAP 상담원의 이메일 주소입니다.bjones@worldtravel.com

결제 내역

이 필드에는 일정에 대한 결제 세부 정보가 포함되어 있습니다.

필드 이름정의예
payment_type결제 페이지에서 사용한 결제 수단입니다.가능한 값:
신용카드
포인트
분할 급여
status일정가 결제되었는지 여부를 나타냅니다.가능한 값:
유료
미지급
deferred일정에 대한 결제가 연기되었는지(참) 또는 결제되었는지(거짓) 여부입니다. 부울 값으로 표시됩니다.true
payment_due_date결제 기한 ISO 8601 날짜 형식(YYYY-MM-DD). 후불 결제에만 적용됩니다.2023-02-05
payee일정 결제의 책임자가 누구인지 표시합니다.가능한 값:
에이전시
고객

property_booking_items

이러한 필드는 일정의 일부로 예약된 숙박 시설 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882912
status특정 숙박 시설 요소의 상태입니다.가능한 값:
확정됨
취소됨
checkin_date*해당 숙박 시설 요소의 체크인 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01
checkout_date*해당 숙박 시설 요소의 체크아웃 날짜입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05
property.idExpedia Group에서 호텔 또는 휴가용 주택에 사용하는 고유 식별자입니다.1400882912
property.chain_name해당되는 경우 숙박 시설이 속한 체인의 이름입니다.독립 브랜드
property.brand_name해당되는 경우 숙박 시설이 속한 브랜드의 이름입니다. 한 체인에 여러 브랜드가 있을 수 있습니다.사보이 시그니처
property.name호텔 또는 휴가용 주택의 이름입니다.호텔 1
property.city숙박 시설이 위치한 도시의 이름입니다.토론토
property.state_province_name숙박 시설이 위치한 주 또는 도의 이름입니다.온타리오
property.country_code숙박 시설이 위치한 국가의 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
property.star_rating숙박 시설의 등급입니다.3.0
room_name호텔 또는 휴가용 렌탈업체에서 정의한 예약 객실 유형입니다.Comfort 전용 욕실이 있는 더블룸
adult_count예약에 포함된 성인 수입니다.2
child_count예약에 포함된 어린이 수입니다.0
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.true
property_confirmation_id***호텔 또는 휴가용 렌탈 업체에서 제공한 확인 번호입니다.1516171819
rate숙박 시설 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

flight_booking_items

이러한 필드는 일정의 일부로 예약된 항공 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882911
status특정 항공 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨
departure_date*해당 항공 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-01
arrival_date*해당 항공 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02
airline.plating_carrier_name항공권을 발행한 항공사의 이름입니다.에어캐나다
airline.plating_carrier_codeIATA 항공권을 발권한 항공사의 코드를 입력합니다.AC
carrier_pnr항공권을 발권한 항공사의 기록에 있는 승객 이름입니다.SMITH
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지
fare_class티켓의 좌석 등급입니다.이코노미
airport_origin_code출발지 공항의 IATA 코드입니다.LHR
airport_origin_location출발 공항의 위치입니다.런던, 영국(LHR-히드로)
airport_destination_code도착 공항의 코드입니다. IATA 형식으로 표시됩니다.YYZ
airport_destination_location도착 공항의 위치입니다.토론토, 온타리오(YYZ-레스터 B. 피어슨 국제공항)
ticket_number항공편의 티켓 번호입니다.123456789101
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.true
segment_count항공권의 항공편 구간 수입니다.1
rate항공편 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

car_booking_items

이러한 필드는 일정의 일부로 예약된 렌터카 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910
status특정 렌터카 여행 요소의 상태입니다.가능한 값입니다:
confirmed
취소됨
pickup_date*렌터카 여행 요소의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-02
return_date*렌터카 여행 요소의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-05
rental_company.name***렌터카 회사 이름입니다.Hertz
car_type***렌터카 유형입니다.2/4도어 소형차
pickup_location렌터카의 픽업 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)
pickup_country_code***렌터카 픽업 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
return_location렌터카의 반납 위치입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)
return_country_code***렌터카 반납 위치의 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
trip_type예약한 여행의 유형입니다.가능한 값:
편도
왕복
다구간 목적지
rental_company_confirmation_id***렌터카 회사에서 제공한 확인 번호입니다.ABC1234
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.false
rate렌터카 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 

activity_booking_items

이러한 필드는 일정의 일부로 예약된 즐길거리 구성 요소를 나열합니다.

필드 이름정의예
booking_item_id일정의 일부로 예약된 특정 요소의 식별자입니다.1400882910
status특정 즐길거리의 상태입니다.가능한 값입니다:
confirmed
취소됨
activity_start_date*즐길거리의 시작일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03
activity_end_date*즐길거리의 종료일입니다. ISO 8601 날짜 형식으로 표시(YYYY-MM-DD).2023-02-03
vendor.name***즐길거리를 제공하는 공급업체의 이름입니다.올리비아의 투어
vendor.city***즐길거리 공급업체가 위치한 도시입니다.디어 레이크, 뉴펀들랜드 앤 래브라도(YDF-디어 레이크 지역)
vendor.country_code***즐길거리 공급업체가 위치한 국가 코드입니다. ISO 3166-1 alpha-2 형식의 두 글자로 표시됩니다.CA
offering_name***즐길거리의 이름입니다.험버 강 트레일 하이킹
expedia_collect예약이 결제 페이지에서 결제되었는지(true) 또는 공급업체에 직접 결제해야 하는지(false)를 나타내는 부울 값입니다.true
rate즐길거리 예약의 요금 및 가격 세부 정보입니다. 중첩된 항목의 목록은 rate 표를 참조해 주세요. 
earnings액티비티 예약 항목의 수수료 세부 정보입니다. 중첩된 항목의 목록은 earnings 표를 참조해 주세요. 

rate

이러한 필드는 예약 항목 또는 전체 일정의 요금 및 가격 세부 정보를 나열합니다. 여기에는 예약의 금전적 가치를 설명하는 중첩된 값이 포함되며, 총 예약 가치와 세금 및 수수료로 세분화됩니다.

필드 이름정의예
refundable해당 예약 구성요소가 환불 가능한지 여부(참) 또는 환불 불가능(거짓)입니다.true
pricing예약의 금전적 가치를 캡처하는 개체로, 총 예약 가치와 세금 및 수수료로 세분화됩니다. 
pricing.gross_booking_value세금 및 수수료를 포함한 예약 금액입니다. 
pricing.gross_booking_value.billable_currency예약 금액(결제에 사용된 통화 기준)입니다. 
pricing.gross_booking_value.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP
pricing.gross_booking_value.billable_currency.value총 예약 금액입니다.2520.80
pricing.taxes_and_fees예약에 대한 세금 및 수수료의 금액과 통화입니다. 
pricing.taxes_and_fees.billable_currency예약에 대한 세금 및 수수료의 금액(결제에 사용된 통화 기준)입니다. 
pricing.taxes_and_fees.billable_currency.currency고객이 예약을 결제하는 통화입니다. ISO 4217 형식으로 표시됩니다.GBP
pricing.taxes_and_fees.billable.currency.value총 예약 금액입니다.491.10

수익

필드 이름정의예
commission총 예약 금액에 포함된 예약 또는 아이템의 수수료 금액을 나타내는 객체입니다. 
commission.billable_currency결제 통화로 수수료 금액을 나타내는 객체입니다. 
commission.billable_currency.currencyISO 4217 형식으로 표시되는 수수료 값의 통화USD
commission.billable_currency.value수수료의 금전적 가치.100.25
service_chargeTAAP 대행사가 일정에 적용한 서비스 수수료를 나타내는 개체입니다. 
service_charge.amountTAAP 대행사가 일정에 적용한 서비스 수수료의 금전적 가치를 나타내는 개체입니다. 
service_charge.amount.billable_currency결제 통화로 서비스 수수료 금액을 나타내는 객체입니다. 
service_charge.amount.billable_currency.currencyISO 4217 형식으로 표시되는 서비스 요금 값의 통화입니다.USD
service_charge.amount.billable_currency.valueTAAP 대행사가 일정에 적용한 서비스 수수료의 금전적 가치입니다.50.50
service_charge.taxes_and_fees서비스 요금에 대한 세금 및 수수료의 가치와 통화를 나타내는 객체입니다. 
service_charge.taxes_and_fees.billable_currency서비스 요금에 대한 세금 및 수수료의 금전적 가치를 결제 통화로 나타내는 객체입니다. 
service_charge.taxes_and_fees.billable_currency.currency결제 통화, ISO 4217 형식으로 표시됩니다.USD
service_charge.taxes_and_fees.billable_currency.value고객이 세금 및 수수료로 결제한 금액(청구 통화 기준)입니다.5.25

모든 TAAP 필드에 대한 참고 사항

* 날짜 필드는 협정 세계시(UTC) 기준입니다. ** 개인 식별 정보(PII) 데이터를 나타냅니다. 이 정보는 회사의 지침에 따라 올바르게 처리해야 합니다. 꼭 필요한 경우에만 입력해 주세요. *** 해당 필드의 데이터는 예약이 생성되거나 업데이트된 다음 날 오후 6시부터 오후 8시(UTC) 사이에 제공됩니다. 현재 실시간에 가까운 데이터는 제공되지 않습니다.

API 세부 정보

비즈니스에서 여정 API 데이터를 사용하는 방식에 따라 API 스키마 및 구성에 대한 스냅샷을 제공했습니다. OpenAPI 사양을 다운로드하고 API 테스트 소프트웨어를 사용하여 예제 및 스키마 정의가 실제 출력과 어떻게 비교되는지 이해할 수 있습니다.

화이트 레이블 템플릿

푸시 및 풀 전달 방법을 통해 화이트 라벨 템플릿 파트너가 사용할 수 있는 필드(중첩된 개체 포함)는 다음과 같습니다:




TAAP

푸시 및 풀 전달 방법을 통해 TAAP 파트너가 사용할 수 있는 필드(중첩된 개체 포함)는 다음과 같습니다:




이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 Developer Hub를 만드는 데 도움을 주셔서 감사합니다!

개인정보 처리방침 쿠키 정책 이용약관

Expedia, Inc.는 외부 웹사이트 콘텐츠에 대해 책임을 지지 않습니다.
© 2024 Expedia, Inc., Expedia Group 계열사. All rights reserved. Expedia 및 비행기 로고는 Expedia, Inc.의 상표 또는 등록 상표입니다. CST# 2029030-50.