라이센스 제출

POST 
/gds/vendor/properties/:vendor_property_id/licenses

• 숙소의 인허가 서류(permit) 또는 사업자등록증(business)을 제출합니다. 서류마다 요청을 하나씩 보내며, type으로 서류 종류를 지정합니다.
• permit은 인허가 서류로 영업신고증, 관광사업 등록증, 농어촌민박사업자 신고확인증 등이 해당합니다. data.type에는 인허가 유형 코드를 넣습니다.
• 서류 정보와 파일은 data에 함께 담습니다. 파일은 base64로 인코딩한 문자열로 보내며, 파일명은 받지 않습니다.
• 지원 형식은 jpeg, png, gif, webp, pdf이며 파일 내용으로 판단합니다. HEIC와 AVIF는 지원하지 않고, 이미지는 가로 450픽셀, 세로 200픽셀 이상이어야 합니다. 파일은 1개당 최대 10MB입니다.
• business에서 data.type이 corporation(법인)이면 data.name, data.address, data.industry, data.category도 필수입니다. personal(개인)이면 선택입니다.
• 제출한 요청은 pending으로 접수되고, ONDA 검수 후 confirm(승인) 또는 reject(반려)로 바뀝니다.
• 같은 서류 종류에 pending 요청이 남아 있을 때 다시 제출하면 이전 요청은 reject로 바뀌고, reason에 Superseded by request {새 요청 ID}가 기록됩니다. 새 요청이 400이나 422로 거절되면 이전 요청은 그대로 유지됩니다.
• 플러스 채널을 오픈하려면 permit과 business 모두 승인(confirm)받아야 합니다. 서류 종류별로 반영되는 서류는 가장 최근에 승인(confirm)된 1건뿐이며, 새 서류가 승인되기 전까지는 기존 승인 서류가 유지됩니다.

Request

Responsesapplication/json

200

접수한 서류 제출 요청을 반환합니다.

400

Bad Request. 필수 항목이 누락되었거나 값의 형식이 올바르지 않을 때 반환합니다. 지원하지 않는 type, 코드 목록에 없는 data.type, 자릿수나 체크섬이 맞지 않는 사업자등록번호, 미래 날짜, base64로 읽을 수 없는 파일이 여기에 해당합니다. 법인의 경우 data.name(상호), data.address(사업장 소재지), data.industry(업태), data.category(종목) 중 누락된 항목이 있어도 400을 반환합니다.

401

Unauthorized

404

Not Found. vendor_property_id가 이 공급사에 연결된 숙소의 ID가 아닐 때 반환합니다.

413

Payload Too Large. 요청 본문이 너무 클 때 반환합니다.

422

Unprocessable Entity. 지원하지 않는 파일 형식(HEIC, AVIF 등)이면 Unsupported file format, 이미지가 450x200 픽셀보다 작으면 Image must be at least 450x200 pixels, 이미지를 JPG로 변환하지 못하면 Image conversion failed를 반환합니다.