라이센스 제출
숙소를 생성한 뒤 인허가 서류와 사업자등록증을 ONDA에 제출해 검수를 받으세요. 전체 순서는 최초 판매 준비 개요를 참고하세요.
:::warning 플러스 채널 오픈의 선행 조건
플러스 채널을 신청하기 전에 인허가 서류(permit)와 사업자등록증(business)이 모두 승인(confirm)됐는지 확인하세요.
:::
:::info 서류 종류별로 1건만 반영
숙소에는 인허가 서류(permit)와 사업자등록증(business)이 각각 1건씩 반영됩니다. 서류를 교체하려면 같은 종류의 새 서류를 제출하세요. 새 서류가 승인(confirm)될 때까지는 이전에 승인된 서류가 적용됩니다.
:::
| 메서드 | 경로 | 설명 |
|---|---|---|
POST | .../{vendor_property_id}/licenses | 서류 제출 (서류 1종당 요청 1건) |
GET | .../{vendor_property_id}/licenses | 제출 목록 조회 (최신순) |
GET | .../{vendor_property_id}/licenses/{request_id} | 제출 상세 조회 (처리 이력 포함) |
목록 조회 API는 최신 요청부터 offset건(기본 0)을 건너뛰고 최대 limit건(기본 100, 최대 500)을 반환합니다. count는 해당 숙소의 전체 요청 수입니다.
서류 종류
type으로 서류 종류를 지정하고, 서류 항목과 파일은 data에 담습니다.
type | 서류 | data 필수 항목 |
|---|---|---|
permit | 인허가 서류 (영업신고증, 관광사업 등록증, 농어촌민박사업자 신고확인증 등) | type(인허가 유형 코드), number(신고·등록번호), date(신고·등록일), issuer(발급 기관), file |
business | 사업자등록증 | type(corporation 법인 / personal 개인), number(사업자등록번호 10자리), owner_name(대표자명), open_date(개업연월일), file |
permit을 제출할 때 발급 기관(issuer)은 서류에 표시된 이름을 그대로 입력하세요(최대 100자). 인허가 상태(status)를 보낼 때는 아래 코드표의 코드를 사용하세요.- 법인(
corporation)은name(상호),address(사업장 소재지),industry(업태),category(종목)도 필수입니다. 개인은 선택입니다. - 최대 길이:
permit의number254자,issuer100자 /business의owner_name128자,name·address254자,industry·category64자 / 공통comment16,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 | 전문휴양업 |
인허가 상태 코드 (permit의 data.status, 선택)
서류를 제출할 때의 영업 상태를 아래 표의 지방행정 인허가 코드로 보내세요. status를 생략하면 상세 조회에서 null을 반환합니다.
| 코드 | 상태 |
|---|---|
01 | 영업/정상 |
02 | 휴업 |
03 | 폐업 |
04 | 취소/말소/만료/정지/중지 |
05 | 제외/삭제/전출 |
06 | 기타 |
파일 규칙
| 항목 | 규칙 |
|---|---|
| 전송 방식 | 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",
"issuer": "서울특별시 강남구청장",
"status": "01",
"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로 인코딩해 보내세요. 문자열을 잘라 보내면 API가 400을 반환합니다.
오류 응답
| 코드 | 상황 |
|---|---|
400 | 필수 항목 누락 또는 형식 오류: 지원하지 않는 type, 코드 목록에 없는 data.type, permit의 data.issuer 누락, 코드 목록에 없는 data.status, 자릿수·체크섬이 맞지 않는 사업자등록번호, 미래 날짜, 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) 서류와 같은 종류의 서류를 다시 제출하면, API는 이전 요청을 반려(reject)하고reason에Superseded by request {새 요청 ID}를 기록합니다. 새 요청이400이나422로 실패하면 이전 요청은 계속 검수 대기 상태입니다. - 반려 사유는 목록이나 상세 응답의
reason에서 확인하세요. 서류를 보완한 뒤 다시 제출하세요. - 상세 조회 응답의
histories는 최신순입니다.has_file은 파일 저장 여부만 나타냅니다. API는 파일을 응답에 담지 않으며, 사업자등록번호의 뒤 5자리를 가립니다. - 제출하지 않은
comment와 선택 필드는null입니다. 처리 사유가 없으면reason이, 코드표에 없는 인허가 유형이면data.type이null입니다.