본문으로 건너뛰기

라이센스 제출

숙소를 생성한 뒤 인허가 서류와 사업자등록증을 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의 number 254자, issuer 100자 / 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전문휴양업

인허가 상태 코드 (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가 양의 정수가 아닌 경우도 포함
404vendor_property_id가 이 공급사의 숙소가 아님. 상세 조회에서는 request_id가 그 숙소의 요청이 아닌 경우도 포함
413요청 본문이 너무 큼
422Unsupported 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입니다.