# 기업정보조회

## 1. CheckBizInfo - 단건 조회

- 사업자번호 1건에 대한 기업정보를 확인합니다.

```vb
Function CheckBizInfo(CorpNum As String, CheckCorpNum As String, UserID as String) As PBBizCheckInfo
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- CheckCorpNum `type: String` `length: 10` `required: Y` `description: 조회할 사업자번호`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**PBBizCheckInfo**

- corpNum `type: String` `length: 10` `description: 사업자번호`
- companyRegNum `type: String` `length: 13` `description: 법인등록번호`
- checkDT `type: String` `length: 14` `description: 기업정보조회일시`
  - 형식 : yyyyMMddHHmmss
- corpName `type: String` `length: 256` `description: 상호`
- ceoname `type: String` `length: 128` `description: 대표자명`
- corpCode `type: String` `length: 3` `description: 기업형태코드`
  - `100`: 일반회사
  - `101`: 신설회사
  - `102`: 외감
  - `103`: 피합병
  - `110`: 거래소(상장)
  - `111`: 거래소(관리)
  - `112`: 코스닥(등록)
  - `113`: 코스닥(관리)
  - `114`: 코넥스
  - `200`: 폐업
  - `201`: 부도
  - `300`: 휴업
  - `900`: 미정의
  - `999`: 기타
- corpScaleCode `type: String` `length: 2` `description: 기업규모코드`
  - `10`: 대기업
  - `11`: 대기업(금융)
  - `20`: 중견기업
  - `21`: 중견기업(하)
  - `30`: 중소기업
  - `90`: 기타(비영리법인)
  - `99`: 기타
- personCorpCode `type: String` `length: 2` `description: 개인/법인코드`
  - `1`: 법인
  - `2`: 개인
  - `99`: 기타
- headOfficeCode `type: String` `length: 2` `description: 본점/지점코드`
  - `1`: 본점
  - `2`: 지점
  - `99`: 기타
- industryCode `type: String` `length: 6` `description: 산업코드`
  - 한국표준산업분류(10차) 기준
- establishDate `type: String` `length: 8` `description: 설립일자`
  - 형식 : yyyyMMdd
- establishCode `type: String` `length: 2` `description: 설립코드`
  - `1`: 주식
  - `2`: 합자
  - `3`: 합명
  - `4`: 유한
  - `5`: 조합
  - `6`: 정부투자기관
  - `7`: 개인
  - `8`: 학교
  - `9`: 병원
  - `10`: 단체 또는 협회
  - `11`: 미정의
  - `99`: 기타
- workPlaceCode `type: String` `length: 2` `description: 사업장코드`
  - `10`: 본사
  - `20`: 공장
  - `30`: 서울사무소
  - `31`: 사무소
  - `32`: 영업소
  - `33`: 지점
  - `34`: 출장소
  - `40`: 연구소
  - `50`: 건설공장
  - `60`: 창고
  - `99`: 기타
- addrCode `type: String` `length: 2` `description: 주소유형코드`
  - `1`: 도로명
  - `2`: 지번
  - `3`: 입력(입수)
  - `99`: 기타
- zipCode `type: String` `length: 6` `description: 우편번호`
- addr `type: String` `length: 256` `description: 주소`
- addrDetail `type: String` `length: 256` `description: 상세주소`
- enAddr `type: String` `length: 256` `description: 영문주소`
- bizClass `type: String` `length: 4096` `description: 업종`
- bizType `type: String` `length: 4096` `description: 업태`
- result `type: Integer` `length: 3` `description: 상태코드`
  - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/bizinfocheck/vba/response-code#result-code)
- resultMessage `type: String` `length: 4096` `description: 상태메시지`
- closeDownState `type: Integer` `length: 1` `description: 휴폐업상태`
  - `0`: 미등록
  - `1`: 사업중
  - `2`: 폐업
  - `3`: 휴업
  - `9`: 확인실패
- closeDownStateDate `type: String` `length: 8` `description: 휴폐업일자`
  - 형식 : yyyyMMdd
- closeDownTaxType `type: Integer` `length: 2` `description: 과세유형`
  - `null`: 미등록
  - `10`: 일반과세자
  - `20`: 면세사업자
  - `30`: 간이과세자
  - `31`: 간이과세자 세금계산서 발급사업자
  - `40`: 비영리법인 또는 국가기관, 고유번호가 할당된 단체
  - `99`: 확인실패
- closeDownTaxTypeDate `type: String` `length: 8` `description: 과세유형 전환일자`
  - 형식 : yyyyMMdd

### 예외

**Err**

- LastErrCode `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- LastErrMessage `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`