본문으로 이동
개요

사업자등록 상태 조회 API거래처, 정산 운영팀

거래처 정보를 등록한 뒤에도, 거래 전에 다시 확인하세요.

처음 등록한 정보만으로 계속 거래하고 있나요? 거래처의 사업자 상태와 과세유형을 요청 한 번에 최대 100건씩 조회해 거래처 등록과 발행 업무에 연결하세요.

01

등록할 때 한 번, 중요한 거래 전에 다시.

담당자가 사업자등록번호를 하나씩 검색하던 작업을 목록 단위 조회로 바꿉니다.

  1. 거래처를 등록할 때

    신규 거래처의 사업자 상태와 과세유형을 확인해 검토에 필요한 정보를 확보합니다.
  2. 세금계산서를 발행하기 전에

    저장된 정보에만 의존하지 않고 거래 시점의 상태를 다시 확인합니다.
  3. 거래처 목록을 점검할 때

    요청 한 번에 최대 100건씩 조회해 내부 목록과 비교하세요. 정기 실행과 변경 알림은 서비스의 운영 방식에 맞게 구현합니다.

02요청과 응답

요청 하나가 결과로 돌아오기까지

내 서비스와 볼타 API, 기관 사이를 오가는 순서입니다. 인증서 처리와 기관 연결은 볼타가 맡습니다.

03

조회 결과를, 담당자가 판단할 수 있는 정보로.

사업자 상태와 과세유형을 함께 받아 내부 업무에 반영하세요. 결과를 확인하지 못한 경우도 따로 구분해 재확인하세요.

  • 확인한 정보

    사업자 상태와 과세유형을 업무에 반영
  • 확인하지 못한 정보

    요금 없이 따로 구분해 재조회하거나 담당자가 확인

04도입 조건과 요금

시작하기 전에 확인하세요.

사업자등록 상태 조회

상태를 확인한 사업자등록번호만 차감합니다. 확인하지 못한 번호와 테스트 키 호출은 차감하지 않습니다.

사업자등록번호 1건당 10원

서비스 구독 요금과 별도이며, 사전 충전한 포인트에서 차감합니다. 상태를 확인하지 못한 번호는 차감하지 않습니다.

  • 사업자등록번호를 준비하세요. 요청 한 번에 최대 100건까지 조회합니다.
  • 조회 실패와 정보 없음은 별도 상태로 구분해 재조회하거나 담당자가 확인합니다.
포인트 충전 방식 보기 (새 창)

05

한 건만 확인하려면

코드를 붙이지 않고 지금 한 건만 조회하려면 무료 도구를 쓰세요.

06AI와 연동 시작

쓰던 AI 도구로 연동을 시작하세요.

공식 문서, 준비 조건, 테스트할 내용을 담았습니다. 프롬프트를 복사해 현재 프로젝트를 다루는 AI 도구에 전달하세요.

사업자등록 상태 조회 API: 연동 프롬프트

공식 문서, 상품 범위, 테스트 방법

프롬프트 내용 보기
현재 프로젝트에 이 볼타 API를 연동해 주세요.

거래처 정보를 등록한 뒤에도, 거래 전에 다시 확인하세요.

공식 문서를 먼저 읽고 현재 프로젝트의 언어와 구조에 맞는 구현 계획을 제안하세요.

https://docs.bolta.io/llms.txt

https://docs.bolta.io/docs/api-introduction/quickstart

https://docs.bolta.io/docs/api-introduction/business-registration-status

https://docs.bolta.io/docs/api-introduction/pricing

선행 조건과 범위:

- 사업자등록번호를 준비하세요. 요청 한 번에 최대 100건까지 조회합니다.

- 조회 실패와 정보 없음은 별도 상태로 구분해 재조회하거나 담당자가 확인합니다.

사업자등록 상태 조회: 사업자등록번호 1건당 10원

서비스 구독 요금과 별도이며, 사전 충전한 포인트에서 차감합니다. 상태를 확인하지 못한 번호는 차감하지 않습니다.

API 키는 서버 환경변수로 참조하고 대화창에 비밀 키를 요청하지 마세요. 문서의 테스트 키와 입력으로 먼저 검증하세요.

테스트 목표: 문서의 테스트 사업자등록번호로 상태, 과세유형과 결과 없음, 입력 오류를 구분한다. 목록 조회와 재확인 흐름을 검증한다.

문서에 없는 기능이나 응답을 추정하지 마세요. 확인이 필요한 부분을 표시하고 테스트 결과와 운영 전환 준비 사항을 정리하세요.

07FAQ

도입 전에 많이 묻는 질문

연동 방법과 오류 코드는 API 문서에 정리돼 있습니다.

API 문서 보기 (새 창)
정기 점검도 볼타가 자동으로 실행하나요?

API는 조회 결과를 제공합니다. 정기 실행 주기와 변경 알림은 고객사의 시스템에서 구성합니다.

조회 결과가 없으면 어떻게 처리하나요?

재조회하거나 담당자가 확인할 상태로 분류합니다.

무료로 이용할 수 있나요?

아니요. 라이브 조회는 사업자등록번호 1건당 10원입니다. 테스트 키로 조회하면 포인트를 차감하지 않습니다.

확인하지 못한 번호도 요금을 내나요?

아니요. 요금은 상태를 확인한 번호에만 매깁니다. 일괄 조회에서 확인하지 못한 번호는 상태가 빈 값으로 오고 요금에 포함하지 않습니다.

계약 없이 오늘부터 연동을 시작하세요.

문서의 테스트 사업자등록번호로 조회 흐름부터 검증하세요. 테스트 키는 포인트를 차감하지 않습니다.

도입 범위를 먼저 상의하고 싶다면API 도입 상담