국세청 사업자 조회 API, 30분 만에 연동하기

BTSDB 가이드 · 개발 — 상태조회/진위확인 API 실전

회원가입 시 사업자 검증, 거래처 일괄 점검, ERP 연동 — 국세청이 공공데이터포털로 개방한 사업자등록정보 진위확인 및 상태조회 서비스를 쓰면 무료로 구현할 수 있습니다. BTSDB도 이 API를 사용합니다. 신청부터 운영 팁까지 정리했습니다.

상태조회 (status)

사업자번호만으로 계속/휴업/폐업 + 과세유형 + 폐업일을 반환. 거래처 모니터링·일괄 검증에 적합.

진위확인 (validate)

번호 + 개업일 + 대표자성명을 함께 보내 국세청 등록 정보와 일치하는지 확인. 회원가입 시 "본인 사업자" 검증에 적합.

POST 방식이며, 한 번에 최대 100건을 배열로 보낼 수 있습니다.

POST https://api.odcloud.kr/api/nts-businessman/v1/status?serviceKey={인코딩키}
Content-Type: application/json

{"b_no": ["1208800767", "2518601289"]}

응답의 핵심 필드:

b_stt / b_stt_cd

계속사업자(01) · 휴업자(02) · 폐업자(03)

tax_type / tax_type_cd

과세유형. 미등록 번호는 tax_type에 "국세청에 등록되지 않은…" 문구가 옵니다

end_dt

폐업일(YYYYMMDD)

tax_type_change_dt

과세유형 전환일 — 간이↔일반 전환 감지에 유용

· 한도: 호출당 100건, 일 단위 대량 한도가 있어 웬만한 서비스는 충분하지만, 페이지뷰마다 호출하지 말고 결과를 캐시(TTL 24시간 권장)하세요.

· 체크섬 선검증: 무작위 입력의 90%는 체크섬에서 걸러집니다. API 호출 전에 10자리·검증번호 검사를 먼저 하면 한도를 아낍니다. (검증 알고리즘)

· 미등록도 캐시: 등록되지 않은 번호도 결과를 저장해 두면(negative cache) 봇의 반복 조회로부터 한도를 지킬 수 있습니다.

· 키 관리: 인증키를 소스코드에 하드코딩하지 말고 환경변수·시크릿 파일로 분리하세요. 저장소에 노출된 키는 재발급해야 합니다.

· 키 유효기간: 활용신청은 2년 단위로 만료됩니다. 만료되면 오류 코드 없이 "기한 만료된 서비스키" 응답이 오므로, 응답 파싱 실패를 조용히 삼키지 말고 로그로 남기세요.

일회성 확인이나 소량 점검이라면 API 연동 없이 BTSDB 상단 검색창으로 충분합니다. 국세청 상태조회에 더해 고용산재·통신판매·국민연금 데이터까지 한 페이지에서 확인됩니다.

API 스펙은 국세청·공공데이터포털 사정에 따라 변경될 수 있으니 연동 시점의 공식 문서를 기준으로 하세요.