라이센스 제출

숙소의 라이센스(인허가 서류와 사업자등록증)를 ONDA에 제출하고 검수를 받습니다. 숙소 생성 직후부터 제출할 수 있습니다. 전체 진행 순서는 최초 판매 준비 개요를 참고하세요.

플러스 채널 오픈의 선행 조건

플러스 채널은 인허가 서류(permit)와 사업자등록증(business)이 모두 승인(confirm)된 숙소만 오픈할 수 있습니다. 한 종류만 승인된 상태로는 오픈할 수 없으니, 채널 오픈 신청 전에 두 서류의 승인 여부를 확인하세요.

서류 종류별로 1건만 반영

숙소에 반영되는 서류는 permit 1건, business 1건입니다. 같은 종류를 여러 번 제출해도 여러 건이 함께 반영되지 않고, 가장 최근에 confirm된 1건만 현재 서류로 반영됩니다. 서류를 교체하려면 새로 제출하세요. 새 서류가 pending이거나 reject되면 기존에 승인된 서류가 그대로 현재 서류이고, 새 서류가 confirm되면 그때 대체됩니다.

메서드	경로	설명
`POST`	`.../{vendor_property_id}/licenses`	서류 제출 (서류 1종당 요청 1건)
`GET`	`.../{vendor_property_id}/licenses`	제출 목록 조회 (최신순)
`GET`	`.../{vendor_property_id}/licenses/{request_id}`	제출 상세 조회 (처리 이력 포함)

목록 조회는 offset(기본 0)만큼 건너뛴 뒤 최대 limit건(기본 100, 최대 500)을 반환하며, count에는 숙소의 전체 요청 수가 담깁니다.

서류 종류

type으로 서류 종류를 지정하고, 서류 항목과 파일은 data에 담습니다.

`type`	서류	`data` 필수 항목
`permit`	인허가 서류 (영업신고증, 관광사업 등록증, 농어촌민박사업자 신고확인증 등)	`type`(인허가 유형 코드), `number`(신고·등록번호), `date`(신고·등록일), `file`
`business`	사업자등록증	`type`(`corporation` 법인 / `personal` 개인), `number`(사업자등록번호 10자리), `owner_name`(대표자명), `open_date`(개업연월일), `file`

법인(corporation)은 name(상호), address(사업장 소재지), industry(업태), category(종목)도 필수입니다. 개인은 선택입니다.
최대 길이: permit의 number 254자 / business의 owner_name 128자, name·address 254자, industry·category 64자 / 공통 comment 16,000자
날짜는 YYYY-MM-DD 형식이며 미래 날짜는 받지 않습니다(한국 시간 기준).
사업자등록번호는 하이픈을 넣어도 되고 빼도 됩니다.
comment(선택)에 검수 담당자에게 전달할 내용을 적을 수 있습니다.

인허가 유형 코드 (`permit`의 `data.type`)

코드	인허가 유형
`general_lodging`	일반숙박업
`residential_lodging`	생활숙박업
`foreign_tourist_urban_homestay`	외국인관광도시민박
`hanok_experience`	한옥체험
`rural_homestay`	농어촌 민박
`tourist_hotel`	관광호텔
`floating_tourist_hotel`	수상관광호텔
`korean_traditional_hotel`	한국전통호텔
`family_hotel`	가족호텔
`hostel`	호스텔
`small_hotel`	소형호텔
`medical_tourism_hotel`	의료관광호텔
`youth_hostel`	유스호스텔
`resort_condominium`	휴양 콘도미니엄
`tourist_pension`	관광펜션
`resort_pension`	휴양펜션업
`general_campground`	일반야영장업
`auto_campground`	자동차야영장업
`forest_lodge`	숲속의 집/산림 휴양관
`gosiwon`	고시원
`shared_homestay`	공유민박업
`specialized_resort`	전문휴양업

파일 규칙

항목	규칙
전송 방식	base64로 인코딩한 문자열을 `data.file`에 담음 (파일명은 받지 않음)
지원 형식	jpeg, png, gif, webp, pdf (파일 내용으로 판단)
미지원 형식	HEIC, AVIF 등
이미지 크기	가로 450px, 세로 200px 이상
파일 용량	파일 1개당 최대 10MB (base64로 인코딩하면 요청 본문은 약 1.33배 커짐)

요청 예시

인허가 서류(permit)

{
  "type": "permit",
  "data": {
    "type": "general_lodging",
    "number": "제2026-00123호",
    "date": "2026-03-02",
    "file": "JVBERi0xLjQKJeLjz9MK..."
  },
  "comment": "2026년 3월에 다시 발급받은 서류입니다."
}

사업자등록증(business) — 법인

{
  "type": "business",
  "data": {
    "type": "corporation",
    "number": "123-45-67891",
    "owner_name": "홍길동",
    "open_date": "2020-05-01",
    "name": "주식회사 예시호텔",
    "address": "서울특별시 강남구 테헤란로 1",
    "industry": "숙박업",
    "category": "호텔",
    "file": "JVBERi0xLjQKJeLjz9MK..."
  }
}

개인(personal)이면 name·address·industry·category를 생략할 수 있습니다.

예시의 file 값은 지면상 줄인 것입니다. 실제로는 파일 전체를 base64로 인코딩한 문자열을 보내야 하며, 잘린 값을 보내면 400이 반환됩니다.

오류 응답

코드	상황
`400`	필수 항목 누락 또는 형식 오류: 지원하지 않는 `type`, 코드 목록에 없는 `data.type`, 자릿수·체크섬이 맞지 않는 사업자등록번호, 미래 날짜, base64로 읽을 수 없는 파일, 법인의 `name`·`address`·`industry`·`category` 누락. 목록 조회의 `offset`·`limit` 범위 오류, 상세 조회의 `request_id`가 양의 정수가 아닌 경우도 포함
`404`	`vendor_property_id`가 이 공급사의 숙소가 아님. 상세 조회에서는 `request_id`가 그 숙소의 요청이 아닌 경우도 포함
`413`	요청 본문이 너무 큼
`422`	`Unsupported file format`(HEIC·AVIF 등 미지원 형식), `Image must be at least 450x200 pixels`(이미지 크기 미달), `Image conversion failed`(이미지를 JPG로 변환하지 못함)

처리 상태

pending 요청이 남아 있는 상태에서 같은 종류를 다시 제출하면, 이전 요청은 reject로 바뀌고 reason에 Superseded by request {새 요청 ID}가 기록됩니다. 새 요청이 400·422로 거절되면 이전 요청은 그대로 유지됩니다.
반려 사유는 목록 조회나 상세 조회의 reason에서 확인하고, 서류를 보완해 다시 제출합니다.
상세 조회의 histories(처리 이력)는 최신순입니다. 파일은 돌려주지 않으며(has_file로 저장 여부만 표시), 사업자등록번호는 뒤 5자리를 가려서 반환합니다.
제출하지 않은 comment와 선택 항목, 처리 사유가 없는 reason은 null로 반환됩니다. 코드 목록에 없는 인허가 유형은 data.type이 null입니다.

서류 종류​

인허가 유형 코드 (permit의 data.type)​

파일 규칙​

요청 예시​

오류 응답​

처리 상태​