BRNSTATUS¶
종류: EGTools 전용 함수
사업자등록번호의 현재 상태를 확인합니다(국세청, data.go.kr).
구문¶
=BRNSTATUS(등록번호, [api_key])
인수¶
| 인수 | 필수 | 설명 |
|---|---|---|
| 등록번호 | 필수 | 사업자등록번호(들), 하이픈 허용 |
| api_key | 선택 | data.go.kr 인증키, 1회 입력하면 레지스트리에 저장 |
반환¶
각 사업자등록번호의 과세유형 텍스트(tax_type)를 입력과 같은 모양으로 반환합니다(배열 입력이면 스필). 입력이 비었으면 #VALUE!를 반환하고, 키 누락·네트워크·서비스 오류는 "ERROR: …" 텍스트, 조회되지 않은 번호는 "#N/A" 텍스트로 표시됩니다.
예제¶
| 수식 | 결과 | 설명 |
|---|---|---|
=BRNSTATUS("123-45-67890") |
사업자등록 상태 조회(네트워크·API 키 필요) |
참고¶
- API 키는 배포되지 않습니다. 공공데이터포털 국세청 사업자등록정보 상태조회에서 발급받아 마지막 인수로 1회 입력하거나 리본 [EGTools] → [API 키 관리]에서 등록하면 사용자 계정에 저장되어 이후 생략할 수 있습니다.
- data.go.kr 인증키는 계정당 하나이므로 KOREANHOLIDAYS·리본 달력/일정표와 같은 키를 공유합니다. 예전 버전에서 사업자등록용으로 따로 등록해 둔 키는 처음 사용할 때 자동으로 통합 슬롯으로 옮겨집니다(사용자가 다시 등록할 필요는 없습니다).
- 서비스가 키를 거부하면(HTTP 401/403 등) 저장된 키를 자동 삭제하고 재발급 안내를 반환합니다.
- 사업자등록번호가 숫자로 저장된 셀도 그대로 조회합니다 — 숫자는 지수 표기 없이 정수 문자열로 바꾸고, 앞자리 0이 사라져 9자리가 된 값은 10자리로 복원합니다. 하이픈·공백 등 숫자가 아닌 문자는 무시하며, 빈 셀은 빈 문자열로 반환됩니다.
- 100건 단위로 묶어 POST 요청하므로 대량 조회에 적합합니다.
- 사업자등록번호 배열의 일괄 조회(100건 단위)는 그대로 유지됩니다. api_key에 배열을 지정하면 저장 전에 #VALUE!를 반환합니다(잘못된 키 저장 방지).
- 지원: Excel 2010+. 모든 Excel 버전에서
BRNSTATUS이름 그대로 등록됩니다.