사업자 프로필 조회 API거래처 등록 화면을 만드는 팀
거래처를 검색하고, 등록 정보를 채웁니다
상호나 대표자명으로 사업자를 찾고, 사업자등록번호로 상세 정보를 가져옵니다. 거래처 등록 화면에 검색과 자동 입력을 붙이세요.
01
찾고, 고르고, 거래처 정보를 채우세요
이름으로 찾는 검색과 번호로 읽는 상세 조회를 거래처 등록 흐름에 연결합니다.
이름으로 검색
상호, 이전 상호, 영문 상호, 대표자명으로 찾습니다. 상호 초성이나 사업자등록번호로도 검색합니다.후보 중 한 곳 선택
상호, 사업자등록번호, 지역, 가운데를 가린 대표자명으로 거래처를 고릅니다.상세 정보로 자동 입력
선택한 사업자의 상세 프로필로 상호, 대표자, 주소, 업태, 종목을 채웁니다. 없는 값은 사용자가 입력하도록 남겨 두세요.
02요청과 응답
요청 하나가 결과로 돌아오기까지
내 서비스와 볼타 API 사이를 오가는 순서입니다. 인증서나 기관 연결 없이 API 키만으로 호출합니다.
03
검색과 상세 조회, 필요한 단계만 붙이세요
번호를 모르면 이름으로 먼저 찾습니다. 번호를 알면 상세 조회만 호출해도 됩니다. 볼타가 공공 데이터를 모아 정리한 정보를 받습니다.
| 구분 | 검색 | 상세 조회 |
|---|---|---|
| 쓰는 때 | 사업자등록번호를 모를 때 | 사업자등록번호를 알 때 |
| 찾는 방법 | 상호, 대표자명, 초성, 사업자등록번호 | 사업자등록번호 한 건 |
| 받는 정보 | 상호, 사업자등록번호, 지역, 가린 대표자명, 저장된 등록 상태 | 상호, 대표자, 주소, 전화번호와 이메일, 업태와 종목, 개업일 |
04도입 조건과 요금
시작하기 전에 확인하세요.
사업자 프로필 검색
검색으로 돌려준 결과 수만큼 차감합니다. 다음 결과를 받아도 받은 건수만큼 차감합니다.
결과 1건당 9원
사업자 프로필 상세 조회
상세 조회에 성공한 건만 차감합니다. 프로필이 없거나 오류가 나면 차감하지 않습니다.
사업자등록번호 1건당 90원
결과 없는 검색, 프로필이 없는 상세 조회, 오류 응답, 테스트 키 호출은 차감하지 않습니다. 같은 번호를 다시 조회하면 다시 차감합니다.
- 발급자 등록, 공동인증서, 구독 플랜 없이 API 키만으로 이용합니다.
- 등록 상태와 과세유형은 마지막으로 확인해 저장한 값입니다. 거래 전 현재 상태는 사업자등록 상태 조회 API로 확인하세요.
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-profile https://docs.bolta.io/docs/api-introduction/business-registration-status https://docs.bolta.io/docs/api-introduction/pricing 선행 조건과 범위: - 발급자 등록, 공동인증서, 구독 플랜 없이 API 키만으로 이용합니다. - 등록 상태와 과세유형은 마지막으로 확인해 저장한 값입니다. 거래 전 현재 상태는 사업자등록 상태 조회 API로 확인하세요. 사업자 프로필 검색: 결과 1건당 9원 사업자 프로필 상세 조회: 사업자등록번호 1건당 90원 결과 없는 검색, 프로필이 없는 상세 조회, 오류 응답, 테스트 키 호출은 차감하지 않습니다. 같은 번호를 다시 조회하면 다시 차감합니다. API 키는 서버 환경변수로 참조하고 대화창에 비밀 키를 요청하지 마세요. 문서의 테스트 키와 입력으로 먼저 검증하세요. 테스트 목표: 테스트 키는 실제 데이터를 읽지 않고 고정된 모의 데이터를 돌려줍니다. 테스트상사를 검색해 후보 선택과 상세 조회를 시험하세요. 대표자명, 초성, 지역 검색은 라이브 키로 확인하세요. 문서에 없는 기능이나 응답을 추정하지 마세요. 확인이 필요한 부분을 표시하고 테스트 결과와 운영 전환 준비 사항을 정리하세요.
07FAQ
도입 전에 많이 묻는 질문
연동 방법과 오류 코드는 API 문서에 정리돼 있습니다.
API 문서 보기 (새 창)사업자등록번호를 몰라도 검색하나요?
상호, 이전 상호, 영문 상호, 대표자명으로 검색합니다. 상호 초성은 3자 이상, 사업자등록번호는 10자리로 검색하세요. 지역이나 업종 이름을 함께 넣어 결과를 좁힙니다.
검색과 상세 조회는 어떻게 과금하나요?
검색은 돌려준 결과 1건당 9원, 상세 조회는 성공 1건당 90원입니다. 결과 없는 검색, 프로필이 없는 상세 조회, 오류, 테스트 키 호출은 차감하지 않습니다. 다음 결과를 받거나 같은 번호를 다시 조회하면 다시 차감합니다.
휴업, 폐업 상태도 실시간으로 확인하나요?
프로필의 등록 상태와 과세유형은 볼타가 마지막으로 확인해 저장한 값입니다. 확인하지 못한 값은 비어 있습니다. 호출 시점의 상태가 필요하면 사업자등록 상태 조회 API를 쓰세요.
사업자등록 상태 조회 API 보기주소나 연락처는 항상 있나요?
공공 데이터에 없는 값은 비어 있습니다. 대표자명도 원천 자료가 가린 값이면 가린 그대로 받습니다. 거래처 폼에 자동 입력한 뒤 사용자가 확인하고 빈 값을 채우도록 구성하세요.
계약 없이 오늘부터 연동을 시작하세요.
API 키를 발급하고 테스트 데이터로 거래처 검색과 자동 입력부터 붙여 보세요. 발급자 등록이나 공동인증서는 필요 없습니다.
도입 범위를 먼저 상의하고 싶다면API 도입 상담