{"openapi":"3.0.3","info":{"title":"APICK 사업자 서류 판독(OCR)","version":"1.0.0","description":"사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 사진에서 등록번호·상호·대표자·주소·발급일 같은 항목을 나눠 돌려줍니다. 등록번호가 올바른 형식인지 검증하고, 사업자등록증·신고증은 원하면 지금 영업 중인 사업자인지(계속·휴업·폐업)도 함께 알려줍니다. 판매자 입점·거래처 등록·법인 계좌 개설 서류를 손으로 옮겨 적는 일을 줄이는 데 맞춰 만들었습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/business_doc_ocr":{"post":{"summary":"사업자 서류 판독(OCR)","description":"사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 사진에서 등록번호·상호·대표자·주소·발급일 같은 항목을 나눠 돌려줍니다. 등록번호가 올바른 형식인지 검증하고, 사업자등록증·신고증은 원하면 지금 영업 중인 사업자인지(계속·휴업·폐업)도 함께 알려줍니다. 판매자 입점·거래처 등록·법인 계좌 개설 서류를 손으로 옮겨 적는 일을 줄이는 데 맞춰 만들었습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"doc_type":{"type":"string","description":"판독한 문서 종류 사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 중 하나입니다."},"fields":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"000-00-00000 형식의 등록번호"},"과세유형":{"type":"string","description":"서류 제목에 적힌 유형(일반과세자·간이과세자·면세사업자·법인사업자 등)"},"상호":{"type":"string","description":"상호 또는 법인명(단체명)"},"대표자":{"type":"string","description":"대표자 이름"},"생년월일":{"type":"string","description":"개인 사업자의 대표자 생년월일"},"개업연월일":{"type":"string","description":"개업일"},"법인등록번호":{"type":"string","description":"법인의 000000-0000000 형식 번호"},"사업장소재지":{"type":"string","description":"사업장 주소"},"본점소재지":{"type":"string","description":"법인의 본점 주소"},"업태":{"type":"string","description":"사업의 종류 가운데 업태"},"종목":{"type":"string","description":"사업의 종류 가운데 종목"},"발급사유":{"type":"string","description":"신규·정정 등 발급 사유"},"공동사업자":{"type":"string","description":"공동사업자 이름"},"전자세금계산서전자우편":{"type":"string","description":"전자세금계산서 전용 전자우편 주소"},"발급일자":{"type":"string","description":"서류 발급일"},"발급기관":{"type":"string","description":"서류 끝에 적힌 발급 기관 이름"}},"description":"항목별 값입니다. 읽지 못한 항목은 빈 문자열입니다. 날짜는 YYYY-MM-DD로 맞춥니다."},"checks":{"type":"object","properties":{"사업자등록번호_형식":{"type":"boolean","description":"등록번호를 000-00-00000 형식으로 읽었는지 여부입니다."},"사업자등록번호_검증숫자":{"type":"boolean","description":"등록번호 마지막 검증 숫자가 맞는지 여부입니다."},"문서종류_일치":{"type":"boolean","description":"doc_type으로 지정한 서류와 읽은 서류가 같은지 여부입니다. 자동 판별이면 항상 true입니다."},"법인등록번호_형식·법인등록번호_검증숫자":{"type":"boolean","description":"등기부·법인 인감에서 법인등록번호를 000000-0000000 형식으로 읽었는지, 마지막 검증 숫자가 맞는지 여부입니다."},"주민등록번호_형식":{"type":"boolean","description":"개인 인감에서 주민등록번호 앞 7자리를 읽었는지 여부입니다."}},"description":"자동 확인 결과입니다. 사업자등록증·신고증은 사업자등록번호, 등기부·법인 인감은 법인등록번호, 개인 인감은 주민등록번호를 기준으로 확인합니다."},"missing":{"type":"array","items":{},"description":"읽지 못한 필수 항목 이름입니다. 빈 배열이면 필수 항목을 모두 읽었습니다."},"business_kind":{"type":"string","description":"사업자등록증일 때 개인 또는 법인입니다."},"status":{"type":"object","properties":{"조회결과":{"type":"string","description":"확인·미등록·조회 실패·조회 안 함(사업자등록번호 확인 필요)·조회 안 함(사업자등록번호가 없는 서류) 중 하나입니다."},"사업자상태":{"type":"string","description":"계속사업자·휴업자·폐업자입니다."},"과세유형":{"type":"string","description":"현재 과세유형입니다."},"폐업일":{"type":"string","description":"폐업한 사업자의 폐업일입니다. 영업 중이면 빈 문자열입니다."}},"description":"check_status=1일 때만 담깁니다."},"success":{"type":"integer","description":"처리 결과입니다. 1: 성공(과금), 0: 실패, 3: 시간 초과(과금 없음)."},"seal_kind":{"type":"string","description":"인감증명서일 때 개인 또는 법인입니다."},"text":{"type":"string","description":"include_text=1일 때 서류에서 읽은 전체 글자입니다. 주민등록번호 뒤 6자리는 가립니다."}},"description":"판독 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상 처리했는지 여부입니다."},"cost":{"type":"integer","description":"이번 요청에서 차감된 포인트입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 문의할 때 함께 알려 주세요."}},"description":"호출 공통 정보"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 가운데 한 장의 사진입니다. 등기부는 법인 정보가 적힌 첫 면을 보냅니다. (file)","format":"binary"},"doc_type":{"type":"string","description":"문서 종류: auto(기본, 자동 판별) · business_registration(사업자등록증) · ecommerce_registration(통신판매업 신고증) · corporate_registry(법인 등기사항증명서) · seal_certificate(인감증명서) (string)"},"check_status":{"type":"string","description":"1 이면 사업자등록번호로 현재 사업자 상태(계속·휴업·폐업)와 과세유형을 함께 확인 (추가 요금 없음, 등기부·인감증명서는 조회 안 함) (string)","example":"1"},"include_text":{"type":"string","description":"1 이면 판독한 전체 글자(text)도 함께 반환 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"}},"required":["image"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","판독할 이미지(image)가 없습니다.","서류 사진을 image 필드로 보내세요."],["400","이미지 형식의 파일만 보낼 수 있습니다.","PNG·JPEG 이미지인지 확인하세요. PDF는 PDF 이미지 변환으로 먼저 바꿉니다."],["400","문서 종류(doc_type)는 auto·business_registration·ecommerce_registration·corporate_registry·seal_certificate 중 하나입니다.","doc_type 값을 고치거나 생략하세요."],["422","이미지에서 글자를 읽지 못했습니다. …","서류 전체가 밝고 반듯하게 나오도록 다시 찍게 하세요."],["422","사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서를 찾지 못했습니다. …","다른 서류이거나 일부만 찍힌 사진입니다. 서류 전체를 다시 받으세요."],["424","서류를 판독하지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 뒤 한 번 더 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}