콘텐츠 생성
숙소, 객실타입, 요금제 모델, 요금제를 등록할 때 필요한 값을 설명합니다. 생성 순서는 최초 판매 준비 개요를 참고하세요.
코드 카탈로그(meta) 활용
숙소와 객실의 _tags 같은 필드에는 ONDA가 정의한 태그 코드를 사용하세요.
GET /gds/vendor/meta는 사용할 수 있는 코드 목록을 반환합니다.- 콘텐츠를 처음 등록하기 전에 코드 목록을 조회하고 공급사 코드와 ONDA 코드의 대응표를 만드세요.
- 콘텐츠를 수정할 때도 같은 코드 목록에서
_tags값을 선택하세요. - 코드가 추가되거나 삭제될 수 있으므로 목록을 주기적으로 다시 조회하세요.
한국어 외 언어 콘텐츠 전송
한국어 외 언어로도 콘텐츠를 보내려면 i18n에 언어별 값을 넣으세요.
- 대상: 숙소·객실타입·요금제 모델·요금제의
i18n필드 - 공급사에서 사용할 언어 코드를 정하세요. 예를 들어
ko,en,ja,zh로 언어를 구분할 수 있습니다. - 언어별 콘텐츠를 연결하고, 요청한 언어의 콘텐츠가 없을 때 사용할 기본 언어를 정하세요.
- 표시할 수 없는 특수문자는 콘텐츠를 보내기 전에 제거하세요.
요금제 모델 · 요금제 구조
요금제는 객실타입 하나와 요금제 모델 하나를 연결한 것입니다. 객실타입과 요금제 모델은 모두 숙소에 속합니다.
:::info 요금제 모델 type 생성 규칙
숙소별로 만들 수 있는 요금제 모델 수는 type에 따라 다릅니다.
standalone은 숙소당 정확히 1개를 만들어야 합니다.package: 생성 개수 제한 없음 :::
:::tip 채널 전용 요금제 — 요금제 모델 channels 필드
특정 채널에서만 판매하려면 POST .../rateplan-models 요청에 선택 필드인 channels를 넣으세요.
channels를 생략하면 모든 채널에서 판매합니다. 이 필드를 보내면 배열에 지정한 채널에서만 판매합니다.- 채널을 열 때 ONDA는 배열에 지정한 채널 중 객실 매핑이 생성되어 열린 채널에 요금제 매핑을 만듭니다.
- 채널 오픈 후
channels를 수정하면 다음과 같이 처리합니다.- 추가(
[131] → [131, 132]): 132만 매핑 생성 - 채널 132를 빼면(
[131, 132] → [131]) 기존 매핑은 유지합니다. 이후 생성하는 요금제는 채널 132에 매핑하지 않습니다. - 빈값(
[131, 132] → []): 생성 가능한 모든 채널 매핑 생성 :::
- 추가(
숙소 기본 추가 성인요금 (settings.extra_adult_price)
숙소를 생성하거나 수정할 때 요청 본문의 settings에 기본 추가 성인요금을 넣을 수 있습니다.
- 값: 정수(KRW).
null전송 시 미설정으로 초기화됩니다. - 레거시 채널: Agoda·Trip.com의 Occupancy Based 요금에 포함됩니다. Per Room 요금에는 포함되지 않습니다.
- 플러스 채널: 인원추가비용으로 사용됩니다.
콘텐츠 엔드포인트
모든 경로는 /gds/vendor로 시작합니다.
| 객체 | 메서드 | 경로 | 필수값 · 비고 |
|---|---|---|---|
| 숙소 | POST | /properties | 필수 id, i18n (ko-kr) · settings.extra_adult_price 지원 |
| 숙소 | PATCH | /properties/{vendor_property_id} | 숙소 수정 · extra_adult_price 초기화(null) |
| 숙소 | GET | /properties · /{vendor_property_id} | 비상용 조회 |
| 객실타입 | POST | /properties/{vendor_property_id}/roomtypes | 필수 id, i18n (ko-kr) |
| 객실타입 | PATCH | .../roomtypes/{vendor_roomtype_id} | 객실 수정 |
| 객실타입 | GET | .../roomtypes · /{vendor_roomtype_id} | 비상용 조회 |
| 요금제 모델 | POST | /properties/{vendor_property_id}/rateplan-models | 필수 id, i18n (ko-kr) · optional channels |
| 요금제 모델 | PATCH | .../rateplan-models/{vendor_rateplan_model_id} | 모델 수정 |
| 요금제 모델 | GET | .../rateplan-models · /{vendor_rateplan_model_id} | 비상용 조회 |
| 요금제 | POST | .../roomtypes/{vendor_roomtype_id}/rateplans | 필수 id, vendor_rateplan_model_id |
| 요금제 | PATCH | .../rateplans/{vendor_rateplan_id} | 요금제 수정 |
| 요금제 | GET | .../rateplans · /{vendor_rateplan_id} | 비상용 조회 |
경고
요금제를 생성할 때는 요청 본문의 필수 필드인 vendor_rateplan_model_id에 연결할 요금제 모델의 ID를 넣으세요.