호텔 API 공급사
여행사와 OTA를 위한 호텔 API: 호텔 요금은 어디서 오는가
호텔 API를 사용하면 웹사이트에서 실시간 객실 재고와 가격을 보여주고 확정 예약으로 연결할 수 있습니다. 이 페이지에서는 호텔 결과를 항목별로 분해하고, 계약할 수 있는 네 가지 호텔 API를 비교하며, 여러 공급사가 같은 호텔을 판매할 때 어떤 일이 생기는지 설명합니다.
- 베드뱅크, OTA, GDS, 직접 연결
- 하나의 호텔, 여러 공급사 ID
- 정적 요금과 동적 요금
- 기본 제공 커넥터
호텔 결과의 구조
호텔 결과의 모든 줄은 API에서 옵니다
결과 페이지의 객실 오퍼 하나는 여러 공급사 데이터로 만들어집니다. 일부는 한 번 가져와 저장하고, 일부는 검색할 때마다 실시간으로 받아옵니다.
Galata Corner Rooms
갈라타, 이스탄불
- 디럭스 더블룸
- 조식 포함
- 11월 12일 23:59까지 무료 취소
- 환불 가능
- 넷 요금
- USD 368.00
- 마크업 12%
- + 44.16
- 1정적 콘텐츠이름, 주소, 성급, 사진, 편의시설입니다. 공급사의 콘텐츠 API에서 일정에 따라 가져와 검색마다 호출하지 않고 자체 데이터베이스에서 제공합니다.
- 2객실 유형해당 날짜에 대해 공급사가 반환하는 객실명과 투숙 인원입니다. 같은 객실도 공급사마다 이름이 다를 수 있습니다.
- 3식사 조건포함된 식사입니다. 룸온리, 조식 포함, 하프 보드, 풀 보드, 올 인클루시브가 있으며 식사 조건마다 별도의 요금이 적용됩니다.
- 4요금숙박 기간과 인원에 대한 총 가격으로, 재고 조회 호출에서 실시간으로 반환됩니다. 짧은 시간 동안만 유효합니다.
- 5취소 정책무료 취소 기한과 그 이후의 위약금입니다. 공급사가 요금과 함께 보내고 예약 전에 다시 확인해 줍니다.
- 6요금 유형환불 가능 또는 환불 불가입니다. 환불 불가 요금은 보통 더 저렴하지만 전액을 지불하지 않고는 취소할 수 없습니다.
- 7넷 요금과 판매가여행사용 호텔 API 대부분은 넷 요금을 반환합니다. 여기에 마크업을 더하면 판매가가 됩니다. 커미션형 요금은 공급사가 가격을 정하고 수수료를 지급합니다.
이 요소들을 검색, 결제, 바우처로 엮어 주는 엔진은 호텔 예약 시스템 API 페이지에서 설명합니다.
호텔 API 유형
호텔 API의 네 가지 유형
호텔 API는 재고의 출처, 계약 가능한 주체, 요금 형태에 따라 다릅니다. 대부분의 여행사는 둘 이상을 함께 사용합니다.
- 01
베드뱅크 및 도매 API
PHPTRAVELS에서는: Hotelbeds, RateHawk, Hotelston, Stuba, Wanderbeds, TBO Holidays제공되는 것
도매업체가 계약한 전 세계 대규모 호텔 포트폴리오의 넷 요금을 업계에 재판매할 수 있습니다.
계약 주체
도매업체가 계정을 승인한 뒤의 여행사, OTA, 투어 오퍼레이터.
적합한 용도
모든 객실에 자체 마진을 설정하는 B2B 판매와 패키지.
- 02
OTA 제휴 및 파트너 API
PHPTRAVELS에서는: Agoda, Booking제공되는 것
OTA 자체 호텔 재고로, 보통 소비자 가격에 숙박당 수수료가 붙습니다.
계약 주체
OTA의 파트너 프로그램에 승인된 제휴사와 파트너.
적합한 용도
넷 요금을 관리하지 않고 폭넓은 소비자용 재고를 원하는 B2C 사이트.
- 03
GDS 호텔 콘텐츠
PHPTRAVELS에서는: Amadeus, Travelport제공되는 것
GDS를 통해 유통되는 호텔 체인과 숙소로, 기업 요금과 협상 요금이 많습니다.
계약 주체
GDS 계약이 있는 여행사로, 보통 항공권에 쓰는 것과 같은 계약입니다.
적합한 용도
기업 출장 및 이미 GDS로 항공권을 예약하는 여행사.
- 04
채널 매니저를 통한 직접 연결
PHPTRAVELS에서는: 채널 매니저 연결 및 자체 엑스트라넷제공되는 것
호텔이 이미 쓰는 채널 매니저를 통해 호텔에서 직접 전달되는 요금과 재고.
계약 주체
귀사와 각 호텔이 개별 계약을 맺습니다.
적합한 용도
호텔 직접 계약, 얼로트먼트 또는 지역 전문성을 가진 여행사.
도매업체 커넥터는 Hotelbeds API 연동, RateHawk API 연동, Hotelston API 연동 가이드에서, OTA는 Agoda API 연동에서, 호텔 직접 연결은 채널 매니저 연동에서 각각 다룹니다.
매핑 문제
공급사 셋, 호텔 하나
호텔 API를 둘 이상 연결하면 같은 숙소가 공급사별 이름과 ID로 여러 번 들어옵니다. 매핑이 없으면 여행자에게 중복이 보이고 요금도 비교할 수 없습니다.
- 베드뱅크 AGalata Corner RoomsHTL-48213
- 베드뱅크 BGalata Corner Hotel Rooms88417
- OTA APIGALATA CORNER RMS - ISTANBUList_gal_0192
이름과 주소
정확히 같은 텍스트뿐 아니라 철자, 약어, 음역까지 비교합니다.
좌표
몇 미터 떨어져 있고 이름이 비슷한 두 레코드는 같은 건물일 가능성이 매우 높습니다.
공통 코드
체인 코드, GDS 숙소 코드, 공급사 간 상호 참조가 있으면 일치를 확인해 줍니다.
객실과 식사 조건
호텔이 일치한 뒤 객실 유형, 식사 조건, 정책을 비교하므로 진짜 중복만 통합됩니다.
PHPTRAVELS는 연결된 공급사 전반에서 숙소를 매핑하고 일치하는 객실마다 최저 요금을 유지합니다. 엔진 내부에서 매핑과 중복 제거가 실행되는 방식은 호텔 예약 시스템 API에서 설명합니다.
PHPTRAVELS에서 바로 사용
자체 키로 켜는 호텔 API 커넥터
아래 호텔 공급사는 이미 PHPTRAVELS 숙박 모듈에 연결되어 있습니다. 공급사와 계약하고 관리자 화면에 인증 정보를 입력한 뒤 테스트하고 오픈하면 됩니다. 연동 디렉터리의 실시간 목록입니다.
Agoda연동 가이드
Amadeus
Booking.com연동 가이드
Hotelbeds연동 가이드
Hotelston연동 가이드
RateHawk연동 가이드
Stuba
TBO Holidays연동 가이드
Travelport
Wanderbeds- 모든 연동
목록에 없는 호텔 공급사가 필요하신가요? 문서가 있는 호텔 API라면 연결할 수 있으며 소스 코드는 귀사의 소유입니다. 맞춤형 API 연동 또는 여행 XML API 공급사 목록를 참고하세요.
정적과 동적
정적 요금과 동적 요금
호텔 가격이 사이트에 도달하는 방법은 두 가지입니다. 대부분의 플랫폼은 둘 다 필요합니다. 폭넓은 판매를 위한 API 실시간 요금과 직접 계약한 호텔을 위한 저장 요금입니다.
정적 요금
계약서나 요금표를 바탕으로 미리 불러와 플랫폼에 저장한 가격과 얼로트먼트.
동적 요금
검색할 때마다 공급사 API에 실시간으로 요청하고 예약 전에 확인하는 가격과 재고.
- 가격이 보관되는 곳
- 자체 데이터베이스 또는 엑스트라넷공급사 시스템, 검색마다 반환
- 재고
- 직접 관리하고 해제하는 얼로트먼트그 순간 공급사가 보유한 수량
- 가격 변동
- 귀사 또는 호텔이 계약을 갱신할 때수시로 변동, 투숙객 결제 전에 재확인
- 팀의 업무
- 요금, 판매 중지, 얼로트먼트 입력공급사별 계약, 인증, 매핑
- 주요 출처
- 호텔과의 직접 계약베드뱅크, OTA API, GDS 호텔 콘텐츠
PHPTRAVELS에서는 자체 엑스트라넷의 계약 객실이 연결된 호텔 API의 객실과 같은 결과에 표시됩니다. 숙소 기능을 확인하세요. 자체 객실을 직접 판매하는 호텔에는 대신 호텔 예약 엔진이 필요합니다.
예약 생애주기
검색부터 사후 관리까지 다섯 번의 호출
어떤 호텔 API를 쓰든 예약은 같은 단계를 거칩니다. 한 단계라도 건너뛰면 잘못된 가격으로 객실을 판매하게 됩니다.
- 1
재고 조회
목적지, 날짜, 인원을 보내면 호텔, 객실, 식사 조건, 요금이 반환됩니다.
- 2
재확인
선택한 요금을 결제 전에 현재 취소 정책과 함께 다시 계산합니다.
- 3
예약
투숙객 이름을 공급사에 보내면 예약 번호가 반환됩니다.
- 4
바우처
호텔, 객실, 식사 조건, 정책, 예약 번호가 담긴 바우처가 투숙객에게 전달됩니다.
- 5
변경 또는 취소
변경과 취소는 공급사 규정을 따르며, 많은 호텔 API에서 변경은 취소 후 재예약으로 처리됩니다.
호텔 API는 여행 웹사이트가 호텔 재고와 요금을 검색하고, 가격을 확정하고, 실시간으로 예약을 생성할 수 있게 해 주는 웹 서비스 모음입니다. 베드뱅크, OTA, GDS, 채널 매니저가 각각 제공합니다.
베드뱅크 API는 넷 요금을 제공하므로 직접 마크업을 더해 판매가를 정합니다. OTA 제휴 API는 보통 소비자 가격을 제공하고 수수료를 지급합니다. 베드뱅크는 B2B와 패키지에, OTA API는 소비자 사이트에 적합합니다.
많은 공급사가 개발용 무료 테스트 접근을 제공합니다. 다만 객실을 판매하려면 공급사의 승인된 계정이 항상 필요하며, 예약당 수익은 공급사의 상업 조건에 따라 결정됩니다.
공급사마다 고유한 호텔명과 ID를 사용하기 때문입니다. 매핑은 이름, 주소, 좌표, 공통 코드로 이를 대조해 호텔을 한 번만 표시하고 최저 요금을 보여줍니다.
검색 결과는 캐시되었거나 빠르게 계산된 것이며 객실은 매진될 수 있습니다. 그래서 결제 전에 공급사에서 요금을 재확인하고, 투숙객에게는 확정된 가격과 정책을 보여줍니다.
전액을 지불하지 않으면 취소할 수 없는 요금 유형입니다. 같은 객실과 식사 조건의 환불 가능 요금보다 보통 저렴합니다.
네. PHPTRAVELS는 연결된 모든 호텔 공급사를 함께 검색하고, 같은 호텔을 공급사 간에 매핑해 마크업이 적용된 하나의 목록으로 보여줍니다.
아니요. 각 호텔 공급사와 직접 계약하고 관리자 화면에 본인의 인증 정보를 입력합니다. PHPTRAVELS는 예약 플랫폼과 기본 제공 커넥터를 제공합니다.
네. Enterprise 플랜에서 PHPTRAVELS REST API는 연결된 모든 공급사의 검색과 예약을 하나의 형식으로 제공하며, 예약 이벤트용 웹훅도 지원합니다.