본문으로 건너뛰기

콘텐츠 생성

숙소, 객실타입, 요금제 모델, 요금제를 등록할 때 필요한 값을 설명합니다. 생성 순서는 최초 판매 준비 개요를 참고하세요.

코드 카탈로그(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를 넣으세요.