본문으로 건너뛰기

최초 판매 준비

공급사가 ONDA로 숙소·객실타입·요금제 모델·요금제 콘텐츠를 생성(POST)하고, 라이센스를 제출한 뒤 요금재고(ARI)를 전송해 판매를 준비하는 최초 동기화 흐름입니다. 콘텐츠 생성 방향은 모두 공급사 → ONDA이며, 콘텐츠 조회(GET)는 비상용 옵션입니다. 서류 승인 여부는 제출 목록·상세 조회로 확인합니다.

단계별 흐름​

  1. 코드 카탈로그 조회 — GET /gds/vendor/meta (숙소·객실 생성 시 사용할 _tags 등 tag code 조회)
  2. 숙소 생성 — POST /gds/vendor/properties
  3. 라이센스 제출 — POST .../{vendor_property_id}/licenses (인허가 서류 · 사업자등록증, 플러스 채널 오픈 전 두 서류 모두 승인 필요)
  4. 객실타입 생성 — POST .../{vendor_property_id}/roomtypes
  5. 요금제 모델 생성 — POST .../{vendor_property_id}/rateplan-models
  6. 요금제 생성 — POST .../roomtypes/{vendor_roomtype_id}/rateplans (vendor_rateplan_model_id 결합)
  7. 요금·영업일 전송 — POST .../ari (요금제 단위)
  8. 재고 전송 — POST .../ari/avails (객실타입 단위 통합 재고)

체크리스트​

  • GET /gds/vendor/meta로 _tags 등 코드 카탈로그 조회 후 매핑 테이블 내재화
  • 숙소 → 객실타입 → 요금제 모델 → 요금제 순서로 생성
  • 숙소 생성 후 인허가 서류(permit)와 사업자등록증(business) 제출, 플러스 채널 오픈 전 두 서류 모두 confirm 확인
  • 숙소·객실 생성 시 _tags에 meta 조회 tag code 사용
  • 요금제 생성 시 vendor_rateplan_model_id 결합 확인
  • 요금·영업일은 POST .../ari로 요금제 단위 전송, 재고는 POST .../ari/avails로 객실타입 단위 통합 재고 전송
  • 각 호출은 전 채널 공통(default) 값과 채널별 값(channels[] 전체 선언)을 1회 호출에 함께 담아 전송
  • 부분 전송 활용: ari는 변경 항목만 포함 (영업일 is_business_day / 요금 basic_price·sale_price·net_price)
  • ari/avails 재고는 룸온리(객실타입) 기준에 맞춤, 기간(from-to) 항목당 최대 730일
  • (옵션) 비상용 콘텐츠 조회(GET) 동작 확인

세부 가이드​

단계가이드
1, 2, 4~6콘텐츠 생성 — 코드 카탈로그, 다국어, 요금제 구조, 엔드포인트
3라이센스 제출 — 서류 종류, 파일 규칙, 검수 상태, 인허가 유형 코드
7, 8요금·재고 전송 — ARI · Avails 전송 예시와 규칙