최초 판매 준비
공급사가 ONDA로 숙소·객실타입·요금제 모델·요금제 콘텐츠를 생성(POST)하고, 라이센스를 제출한 뒤 요금재고(ARI)를 전송해 판매를 준비하는 최초 동기화 흐름입니다. 콘텐츠 생성 방향은 모두 공급사 → ONDA이며, 콘텐츠 조회(GET)는 비상용 옵션입니다. 서류 승인 여부는 제출 목록·상세 조회로 확인합니다.
단계별 흐름
- 코드 카탈로그 조회 —
GET /gds/vendor/meta(숙소·객실 생성 시 사용할_tags등 tag code 조회) - 숙소 생성 —
POST /gds/vendor/properties - 라이센스 제출 —
POST .../{vendor_property_id}/licenses(인허가 서류 · 사업자등록증, 플러스 채널 오픈 전 두 서류 모두 승인 필요) - 객실타입 생성 —
POST .../{vendor_property_id}/roomtypes - 요금제 모델 생성 —
POST .../{vendor_property_id}/rateplan-models - 요금제 생성 —
POST .../roomtypes/{vendor_roomtype_id}/rateplans(vendor_rateplan_model_id결합) - 요금·영업일 전송 —
POST .../ari(요금제 단위) - 재고 전송 —
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 전송 예시와 규칙 |