선사
제휴 선사
제휴 선박 · 7박
- 승선
- 2027-05-15
- 귀항
- 2027-05-22
코스
- D1사우샘프턴--:-- · 17:00
- D2항해일
- D3브뤼허(제브뤼허)08:00 · 18:00
- D4암스테르담09:00 · 19:00
- D5항해일
- D6코펜하겐07:00 · 17:00
- D7오슬로09:00 · 16:00
- D8사우샘프턴07:00 · --:--
설명을 위한 예시 레코드이며 특정 선사의 형식이 아닙니다.
크루즈 예약 API
여행사를 위한 크루즈 API: 출항 일정, 객실, 결제 일정
크루즈 API를 사용하면 웹사이트에 실시간 출항 일정을 보여 주고, 객실 등급별 요금을 계산하고, 선사에 크루즈 예약을 생성할 수 있습니다. 이 페이지에서는 데이터가 어떻게 생겼는지, 객실과 결제가 어떻게 작동하는지, 그리고 PHPTRAVELS 사이트에 크루즈 재고를 올리는 두 가지 방법을 설명합니다.
- 출항 일정과 기항지 코스
- 객실 등급과 데크 플랜
- 예약금과 잔금
- 크루즈 맞춤 연동
크루즈 API가 반환하는 것
하나의 출항 일정을 데이터로 표현하기
크루즈는 출항 일정 단위로 판매됩니다. 선박 한 척, 코스 하나, 출발일 하나입니다. 형식이 달라도 모든 크루즈 API는 이 단위를 중심으로 만들어집니다.
검색 요청에는 지역, 월 또는 날짜 범위, 기간, 투숙 인원을 보냅니다. 응답은 출항 일정 목록이며, 각 항목에는 선박, 선사, 승선일과 귀항일, 기항지와 시간, 항해일 수, 그리고 아직 남아 있는 객실 등급별 1인 기준 대표 요금이 담깁니다.
그다음에는 선택한 등급을 실제 투숙객 기준으로 가격 산정하고, 선택 가능한 객실을 조회하고, 예약을 생성하고, 그 예약에 대한 결제를 받는 호출이 이어집니다. 선사마다 이름과 형식이 다르므로, 플랫폼은 고객에게 보여 주기 전에 모든 소스를 동일한 출항 일정, 객실, 예약 모델로 매핑합니다.
예약 가능
객실 등급
선박의 네 단계: 내측, 오션뷰, 발코니, 스위트
크루즈 API는 각 출항 일정 아래에 객실 등급을 나열합니다. 객실 등급은 가격을 좌우하는 가장 큰 요인이며, 하나가 여러 조건을 동시에 바꿉니다.
- 01내측창문 없음
해당 출항 일정의 시작 가격입니다. 선사는 데크와 위치에 따라 여러 등급으로 나누고, 각각에 고유 코드를 붙이는 경우가 많습니다.
가격 수준 - 02오션뷰창문 또는 현창
자연광이 들어오는 한 단계 위의 객실입니다. 시야가 일부 가려지는 등급도 있으며, API는 등급 설명에 이를 표시합니다.
가격 수준 - 03발코니전용 베란다
전용 야외 공간이 있습니다. 데크 높이와 선체 중앙인지 선미인지에 따라 등급이 달라집니다.
가격 수준 - 04스위트발코니와 거실
요금표의 최상위이며 요금에 특전이 포함되는 경우가 많고, 특정 객실로 판매될 가능성이 가장 큰 등급입니다.
가격 수준
등급 코드와 요금 코드
각 객실 등급에는 코드가 있으며, 하나의 출항 일정은 여러 요금 코드로 판매될 수 있습니다. 일반 요금, 프로모션 요금, 단체 또는 대리점 요금 등입니다. 같은 객실이라도 요금 코드에 따라 가격과 조건이 달라집니다.
보장 예약과 객실 지정 예약
보장 예약에서는 고객이 등급을 구매하고, 선사가 나중에 해당 등급 이상의 객실을 배정합니다. 객실 지정 예약은 예약 시점에 객실 번호를 확정합니다. 많은 선사가 두 방식의 요금을 다르게 책정합니다.
객실 선택
데크 플랜에서 객실 고르기
선사가 객실 지정 예약을 허용하면, API는 선택한 등급에서 남아 있는 객실을 데크, 위치, 수용 인원과 함께 반환합니다.
데크 9
객실을 선택하세요
선수선미
0814
242636
29
011119
- 내측
- 오션뷰
- 발코니
- 스위트
- 이용 불가
객실 9110
내측
내측 객실로, 이 데크에서 가장 낮은 가격입니다. 객실 지정 또는 보장 예약으로 판매됩니다.
오션뷰
선체가 좁아지는 선수 쪽의 창문 객실입니다. API는 등급과 함께 전망 안내를 반환합니다.
발코니
선체 중앙의 발코니 객실입니다. 데크 안의 위치가 고유한 가격을 가진 별도 등급으로 나뉘는 경우도 많습니다.
스위트
선미 방향의 넓은 발코니가 있는 스위트입니다. 보통 보장 예약이 아니라 객실 지정으로 예약됩니다.
- 1.객실 조회고객이 등급을 고르면 플랫폼이 선사에 해당 등급의 빈 객실을 요청하고 데크 위에 표시합니다.
- 2.객실 임시 확보많은 크루즈 API는 고객이 이름을 입력하고 결제하는 동안 선택한 객실을 잠시 확보해 둘 수 있습니다.
- 3.예약 확정예약이 객실 번호, 투숙객, 요금 코드를 확정하면 선사가 예약 번호를 반환합니다.
PHPTRAVELS 크루즈에서는 선박마다 데크와 객실 등급을 등록할 수 있어, 객실이 자체 재고이든 연결된 선사의 것이든 고객이 정확한 정보를 보고 선택할 수 있습니다.
결제 일정
먼저 예약금, 나머지는 출항 전에
크루즈는 몇 달 전에 예약하고 단계별로 결제합니다. 날짜와 금액은 출항 일정과 요금마다 선사가 정하며, API가 예약과 함께 반환합니다.
- 01
예약과 예약금
고객은 객실을 확정하기 위해 선사가 정한 예약금을 1인 또는 예약 건당으로 결제합니다.
- 02
잔금 납부 기한
잔금은 출발 전 선사가 정한 날짜까지 내야 합니다. 미납된 예약은 그 이후 선사가 취소할 수 있습니다.
- 03
서류
전액이 결제되면 선사가 크루즈 서류를 발급하고, 고객은 체크인 정보를 입력합니다.
- 04
출항일
고객이 승선합니다. 이후의 변경은 선내에서 또는 선사 규정에 따라 처리됩니다.
기간별 취소 수수료
예약금 기간수수료 증가최고 수수료
출항이 가까울수록 취소 시 공제되는 요금 비율이 커집니다. 기간과 비율은 선사와 요금마다 다르므로, 크루즈 API가 예약과 함께 보내고 플랫폼이 결제 전에 고객에게 보여 줍니다.
직접 계약한 출항 일정을 판매할 때도 크루즈은 같은 방식으로 작동합니다. 출항 일정마다 예약금과 잔금 기한을 설정하고, 미결제 잔액은 납부될 때까지 관리자 화면에서 추적됩니다.
크루즈 요금
크루즈 요금은 이렇게 구성됩니다
크루즈 요금은 호텔이나 항공권과 다르게 보입니다. 크루즈 API는 구성 요소를 따로 반환하므로, 예약 엔진은 선사와 같은 방식으로 이를 합산해야 합니다.
선사의 가격 위에 PHPTRAVELS가 선박, 출항 일정 또는 채널별로 마크업과 수수료를 적용하며, B2B 여행 포털의 에이전트는 자신의 순 요금(넷 요금)을 확인합니다.
객실이 아닌 1인 기준
크루즈 요금은 고객 1인 기준으로 제시됩니다. 2인실은 1인 요금의 두 배이며, API는 나이와 객실 내 순서에 따라 각 고객의 요금을 계산합니다.
2인 1실 기준
대표 요금은 2인이 함께 쓰는 것을 전제로 합니다. 3번째와 4번째 투숙객은 보통 낮은 요금을 내고, 혼자 승선하는 고객은 싱글 추가 요금을 냅니다.
세금, 수수료, 항만 이용료
정부 세금, 수수료, 항만 이용료는 크루즈 요금에 더해 1인당 부과됩니다. 합계에 예상 밖의 금액이 없도록 별도 항목으로 보여 주세요.
선내 크레딧과 부가 혜택
일부 요금에는 선내 크레딧, 음료 패키지, 팁이 포함됩니다. API는 이를 요금 포함 사항으로 반환하며, 같은 객실인데 요금이 다른 이유가 되기도 합니다.
크루즈 재고를 확보하는 방법
자체 계약 또는 선사 API
사이트에 크루즈를 올리는 방법은 두 가지입니다. 많은 여행사가 첫 번째로 시작해, 물량이 늘면 두 번째를 추가합니다.
크루즈 모듈에서 바로 사용 가능
자체 크루즈 계약 등록
계약한 출항 일정을 관리자 화면에 입력합니다. 선박, 데크, 객실 등급, 기항지별 코스, 출발일, 1인 요금, 시즌, 예약금, 잔금 기한을 등록할 수 있습니다. 크루즈 파트너에게는 공급사 로그인을 부여해 자신의 출항 일정을 직접 최신 상태로 관리하게 할 수 있습니다.
- 보유한 단체 좌석과 할당분
- 선사별 수수료
- B2B 에이전트용 순 요금
- 설치한 날부터 바로 운영
맞춤 연동
선사 또는 콘솔리데이터 API 연결
PHPTRAVELS 연동 목록에는 바로 쓸 수 있는 크루즈 커넥터가 없습니다. 모든 요금제에 전체 소스 코드가 포함되므로, 선사나 크루즈 콘솔리데이터의 API는 맞춤형 API 연동로 연결하여 모듈이 이미 보여 주는 출항 일정, 객실, 예약에 매핑합니다.
- 선사 또는 콘솔리데이터와 직접 계약합니다
- API 자격 증명을 직접 받아 보관합니다
- 커넥터가 출항 일정, 등급, 객실을 매핑합니다
- 예약, 결제, 취소는 선사의 규정을 따릅니다
공급사를 찾고 계신가요? 여행 XML API 공급사 목록에는 API로 유통하는 선사가 정리되어 있으며, API 연동이란에서 이런 연결을 어떻게 만드는지 설명합니다.
크루즈 API는 선사나 크루즈 콘솔리데이터가 여행 판매업체에 공개하는 웹 서비스 모음입니다. 시스템에서 출항 일정을 검색하고, 코스를 읽고, 객실 등급 가격을 산정하고, 예약 가능한 객실을 조회하고, 예약을 생성하고, 예약금과 잔금을 받는 데 사용합니다.
아니요. 크루즈 모듈은 직접 관리하는 재고, 즉 계약한 선박, 객실 등급, 출항 일정을 중심으로 만들어졌습니다. 특정 선사나 콘솔리데이터와의 연결은 포함된 소스 코드를 기반으로 맞춤 연동으로 개발합니다.
여행 판매업체로서 선사 또는 크루즈 콘솔리데이터에 신청합니다. 이용 조건은 선사와 시장에 따라 다릅니다. 계약 체결과 자격 증명 수령은 직접 진행하며, PHPTRAVELS는 공급사 자격 증명을 제공하지 않습니다.
보장 예약은 정해진 가격으로 객실 등급을 확보하는 방식이며, 실제 객실은 나중에 선사가 해당 등급 이상으로 배정합니다. 객실 지정 예약은 예약 시점에 객실 번호를 확정합니다.
선사가 출항 일정과 요금마다 정하며, API가 예약과 함께 반환합니다. 직접 등록한 출항 일정은 관리자 화면에서 출항 일정별로 예약금과 잔금 기한을 설정합니다.
크루즈 요금은 고객 1인 기준으로 제시되며, 보통 두 명이 한 객실을 쓰는 것을 전제로 합니다. 3번째와 4번째 투숙객은 각자의 요금을 내고, 혼자 쓰는 고객은 싱글 추가 요금을 내며, 세금, 수수료, 항만 이용료는 1인당 더해집니다.
네. 에이전트는 B2B 포털에서 각자의 순 요금과 수수료로 예약하고 에이전트 지갑으로 결제합니다. 공개 사이트와 같은 설치본에서 운영됩니다.
Enterprise 요금제에는 문서가 포함된 PHPTRAVELS REST API와 웹훅이 들어 있고, 모든 요금제에 전체 소스 코드가 포함되므로 개발자가 크루즈 예약 엔진을 확장하거나 다른 시스템과 연결할 수 있습니다.
이미 계약한 출항 일정을 크루즈 모듈에 등록하고 판매 반응을 확인하세요. 선사와의 제휴나 물량이 충분해지면, 맞춤 연동으로 해당 선사의 API를 추가합니다.