# 볼타 사용 가이드

> 전자세금계산서 자동화와 효율화, 예약 발행을 볼타에서 만나보세요. 전자세금계산서 업무가 쉬워집니다.

## 서비스 이용 가이드

### 시작하기

- [업무별 이용 가이드](https://docs.bolta.io/docs/overview.md): 발행, 입금 확인, 비용 지급과 연동에 필요한 가이드를 찾으세요.
- [구글로 시작하기](https://docs.bolta.io/docs/onboarding/getting-started-google.md): Google 계정으로 가입하고 로그인합니다.
- [이메일로 시작하기](https://docs.bolta.io/docs/onboarding/getting-started-email.md): 업무용 이메일을 인증하고 볼타 계정을 만듭니다.
- [회사 정보 등록](https://docs.bolta.io/docs/onboarding/company-registration.md): 사업자등록번호와 회사 정보를 확인하고 워크스페이스를 만듭니다.
- [공동인증서 등록](https://docs.bolta.io/docs/onboarding/certificate-registration.md): 세금계산서 발행에 사용할 사업자 공동인증서를 등록합니다.
- [무료체험 시작하기](https://docs.bolta.io/docs/onboarding/free-trial.md): 스탠다드 플랜을 1주 동안 체험합니다.
- [워크스페이스 추가](https://docs.bolta.io/docs/onboarding/add-more-workspace.md): 다른 사업자를 관리할 워크스페이스를 만듭니다.

### 세금계산서

- [세금계산서 발행정보 요청](https://docs.bolta.io/docs/invoice/sales/issuance-request-form.md): 거래처에게 발행정보를 받아 검토한 뒤 세금계산서를 발행합니다.
- [받은 세금계산서 조회와 저장](https://docs.bolta.io/docs/invoice/recipient-view.md): 알림 링크에서 세금계산서를 조회하고 PDF와 XML을 내려받습니다.

#### 발행하기

- [매출세금계산서 간편발행](https://docs.bolta.io/docs/invoice/sales/issue/quick.md): 거래처와 품목을 입력하고 세금계산서를 발행합니다.
- [이전 발행 내용으로 발행하기](https://docs.bolta.io/docs/invoice/sales/issue/load.md): 기존 세금계산서의 거래처와 품목을 불러와 새로 발행합니다.
- [세금계산서 예약발행](https://docs.bolta.io/docs/invoice/sales/issue/schedule.md): 미래 작성일자를 지정해 세금계산서 발행을 예약합니다.
- [세금계산서 반복발행](https://docs.bolta.io/docs/invoice/sales/issue/recurring.md): 정해진 날짜마다 같은 세금계산서를 자동으로 발행합니다.
- [세금계산서 대량발행](https://docs.bolta.io/docs/invoice/sales/issue/bulk.md): 엑셀 파일로 한 번에 최대 20,000건을 등록하고 발행합니다.
- [세금계산서 발행요청 승인](https://docs.bolta.io/docs/invoice/sales/issue/approval.md): 발행 권한이 있는 팀원이 세금계산서 내용을 검토하고 승인합니다.
- [수정세금계산서 발행](https://docs.bolta.io/docs/invoice/sales/issue/amend.md): 발행을 완료한 세금계산서의 수정 사유를 선택하고 발행합니다.

#### 내역 관리

- [발행 내역 조회와 일괄 관리](https://docs.bolta.io/docs/invoice/sales/management/history.md): 상태별 발행 내역, 변경 이력과 담당자를 확인하고 관리 정보를 일괄 수정합니다.
- [발행내용 변경](https://docs.bolta.io/docs/invoice/sales/management/edit.md): 발행 전 세금계산서의 내용을 변경하는 방법을 안내합니다.
- [세금계산서 메모](https://docs.bolta.io/docs/invoice/sales/management/memo.md): 세금계산서에 내부 관리용 메모를 남깁니다.
- [세금계산서 라벨](https://docs.bolta.io/docs/invoice/sales/management/label.md): 업무 기준에 따라 세금계산서를 분류합니다.
- [세금계산서 이메일 재전송](https://docs.bolta.io/docs/invoice/sales/management/email-resend.md): 발행한 세금계산서를 지정한 이메일로 다시 보냅니다.
- [세금계산서 PDF 저장과 출력](https://docs.bolta.io/docs/invoice/sales/management/print-and-pdf-export.md): 세금계산서 PDF를 내려받고 출력합니다.

#### 역발행 요청과 승인

- [역발행 세금계산서란?](https://docs.bolta.io/docs/invoice-issuance-request/introduce.md): 공급받는자가 세금계산서 정보를 작성하고 공급자에게 발행을 요청합니다.
- [요청현황 확인](https://docs.bolta.io/docs/invoice-issuance-request/request-status.md): 역발행 요청의 승인 상태와 상세 내용을 확인합니다.
- [승인용 인증서 준비](https://docs.bolta.io/docs/invoice-issuance-request/certificate.md): 역발행 요청을 승인할 회사 명의의 인증서를 준비합니다.
- [역발행 요청 승인](https://docs.bolta.io/docs/invoice-issuance-request/approval.md): 거래처가 보낸 요청을 확인하고 회사 명의 인증서로 승인합니다.

### 현금영수증

- [현금영수증 간편발행](https://docs.bolta.io/docs/cash-receipt/issue.md): 발행 유형과 거래 금액을 입력하고 현금영수증을 발행합니다.
- [현금영수증 내역 관리](https://docs.bolta.io/docs/cash-receipt/history.md): 발행 상태와 상세 내용을 확인하고 취소발행합니다.

### 매출, 매입과 계좌

- [매출과 매입 내역 연동](https://docs.bolta.io/docs/setting/general/data-sync.md): 홈택스 내역과 은행 계좌를 연결하고 연동 상태를 확인합니다.
- [은행 계좌 연동과 해지](https://docs.bolta.io/docs/bank/account-management.md): 은행 계좌를 연결하고 연동 상태를 관리합니다.
- [매출 내역 조회](https://docs.bolta.io/docs/accounting/revenues.md): 세금계산서와 현금영수증 매출을 확인하고 입금 내역을 관리합니다.
- [매입 내역 조회](https://docs.bolta.io/docs/accounting/expenses.md): 매입 거래와 지급 내역을 확인합니다.
- [입출금 내역 관리](https://docs.bolta.io/docs/bank/transaction-management.md): 연동한 은행 계좌의 입금과 출금 내역을 확인합니다.
- [홈택스 매출세금계산서 가져오기](https://docs.bolta.io/docs/invoice/sales/management/fetch-external.md): 홈택스의 매출세금계산서를 볼타에 연결합니다.
- [홈택스 매입세금계산서 가져오기](https://docs.bolta.io/docs/invoice/purchase/fetch-external.md): 홈택스의 매입세금계산서를 볼타에 연결합니다.
- [입금 내역 관리](https://docs.bolta.io/docs/invoice/sales/management/deposit-history.md): 매출 거래에 입금 날짜와 금액을 연결합니다.
- [지급 내역 관리](https://docs.bolta.io/docs/invoice/purchase/payment-history.md): 매입 거래에 지급 날짜와 금액을 연결합니다.
- [AI 입금 매칭](https://docs.bolta.io/docs/accounting/payment-matches.md): 입금 거래와 매출의 연결 제안을 검토합니다.
- [입금 매칭 규칙 관리](https://docs.bolta.io/docs/accounting/matching-rules.md): 거래처와 적요 조건으로 입금 매칭 규칙을 추가하고 수정합니다.
- [거래 내역 보관과 해제](https://docs.bolta.io/docs/accounting/archive.md): 매출, 매입, 입출금 내역을 보관하거나 다시 목록에 표시합니다.

### 고객 관리

- [고객 정보 등록](https://docs.bolta.io/docs/customer/creation.md): 사업자 또는 개인 고객과 담당자를 등록합니다.
- [고객 메모 관리](https://docs.bolta.io/docs/customer/memo.md): 고객 정보에 업무용 메모를 남깁니다.
- [고객 거래 내역 확인](https://docs.bolta.io/docs/customer/issue-history.md): 고객별 매출과 입금 내역을 확인합니다.

### 입금 요청과 수금

- [입금 요청 사전설정](https://docs.bolta.io/docs/deposit-request/preset.md): 입금 요청에 사용할 계좌와 서류를 등록합니다.
- [세금계산서 발행 시 입금 요청 보내기](https://docs.bolta.io/docs/deposit-request/issue-with-invoice.md): 세금계산서를 발행하면서 입금 요청을 보냅니다.
- [미수금 입금 요청하기](https://docs.bolta.io/docs/deposit-request/request-outstanding.md): 미수금이 남은 매출을 선택해 입금 요청을 보냅니다.
- [입금 요청 내역 관리](https://docs.bolta.io/docs/deposit-request/management.md): 보낸 입금 요청과 입금 상태를 확인합니다.
- [입금 요청을 받는 거래처 화면](https://docs.bolta.io/docs/deposit-request/recipient-view.md): 거래처가 알림 링크에서 입금 요청을 조회하는 방법을 안내합니다.

### 지급 요청과 이체

- [지급요청서 양식 관리](https://docs.bolta.io/docs/payment-request/template.md): 지급 요청에 사용할 양식을 만들고 관리합니다.
- [예산 관리하기](https://docs.bolta.io/docs/payment-request/budget.md): 지급 요청에 사용할 예산과 사용 금액을 관리합니다.
- [지급 요청하기](https://docs.bolta.io/docs/payment-request/write.md): 지급 양식을 작성하고 담당자의 승인을 받습니다.
- [이체 내역 관리하기](https://docs.bolta.io/docs/payment-request/payment-history.md): 승인이 끝난 지급 요청을 확인하고 이체 결과를 기록합니다.

### 외부 연동

- [슬랙 연동](https://docs.bolta.io/docs/integrations/slack.md): 슬랙에서 볼타 알림을 받고 승인 요청을 처리합니다.
- [구글 스프레드시트 연동](https://docs.bolta.io/docs/integrations/spreadsheet.md): 볼타 내역을 Google 스프레드시트에 연결합니다.

### 팀원과 권한

- [팀원 초대](https://docs.bolta.io/docs/setting/team/invitation.md): 이메일로 팀원을 초대하고 권한을 부여합니다.
- [권한 생성](https://docs.bolta.io/docs/setting/team/role-management.md): 팀원의 업무에 맞는 권한을 만들고 관리합니다.
- [팀원 관리](https://docs.bolta.io/docs/setting/team/team-management.md): 팀원 권한을 변경하거나 워크스페이스에서 내보냅니다.

### 계정, 회사와 결제 설정

- [개인 정보 수정](https://docs.bolta.io/docs/setting/general/profile-account.md): 계정 이름과 비밀번호를 변경하세요.
- [회사 정보 수정](https://docs.bolta.io/docs/setting/general/profile-company.md): 세금계산서에 사용할 사업자 정보와 담당자 정보를 수정하세요.
- [워크스페이스 기본값 설정](https://docs.bolta.io/docs/setting/general/workspace-settings.md): 팀원이 함께 사용할 세금계산서 발행 기본값과 입금 요청 정보를 설정합니다.
- [공동인증서 재등록](https://docs.bolta.io/docs/setting/general/certificate-registration.md): 갱신하거나 새로 발급한 공동인증서를 등록합니다.
- [플랜 결제 및 관리](https://docs.bolta.io/docs/setting/general/billing-subscription.md): 현재 플랜, 결제 수단과 결제 내역을 확인하고 플랜을 변경하세요.

### 개발자센터

- [API 키](https://docs.bolta.io/docs/developer-center/api-key.md): 개발자센터에서 테스트 키와 라이브 키를 만들고 관리합니다.
- [웹훅 연결하기](https://docs.bolta.io/docs/developer-center/webhook-connection.md): API 키에 웹훅 수신 URL을 등록합니다.
- [API 로그](https://docs.bolta.io/docs/developer-center/api-log.md): API 키별 요청과 응답 내용을 확인합니다.
- [웹훅 로그](https://docs.bolta.io/docs/developer-center/webhook-log.md): API 키별 웹훅 전송 결과와 내용을 확인합니다.
- [발급자 관리](https://docs.bolta.io/docs/developer-center/issuers.md): API 키에 등록한 발급자의 정보와 인증서 유효기간을 확인합니다.
- [개발자 관리](https://docs.bolta.io/docs/developer-center/developers.md): 개발자를 초대하고 개발자센터 접근을 관리합니다.
- [개발자센터 결제 관리](https://docs.bolta.io/docs/developer-center/billing.md): API 이용의 결제 방식, 포인트와 자동충전 설정을 확인합니다.

### 참고

- [업데이트 노트](https://docs.bolta.io/docs/update-note.md)
- [서비스 이용약관](https://docs.bolta.io/docs/terms-of-service.md)
- [개인정보처리방침](https://docs.bolta.io/docs/privacy-policy.md): (주)볼타코퍼레이션(이하 ‘회사’)은 관련 법령에 따라 ‘볼타’(이하 ‘서비스’)를 이용하는 이용자의 개인정보를 보호하고, 이와 관련한 고충을 신속하고 원활하게 처리하기 위하여 다음과 같이 개인정보 처리방침을 수립·공개합니다.

## API 소개

### API 소개

- [API 개요](https://docs.bolta.io/docs/api-introduction/overview.md): 볼타 API가 제공하는 기능과 시작 방법을 안내합니다.
- [빠른 시작](https://docs.bolta.io/docs/api-introduction/quickstart.md): 테스트 키로 첫 전자세금계산서를 발행합니다.
- [개발자 도구](https://docs.bolta.io/docs/api-introduction/developer-tools.md): 샌드박스 환경, API 문서, 디버깅 도구 등 볼타가 제공하는 개발자 도구를 소개합니다.
- [보안](https://docs.bolta.io/docs/api-introduction/security.md): 볼타 API의 통신 보안과 API 키 보안을 안내합니다.
- [요금 안내](https://docs.bolta.io/docs/api-introduction/pricing.md): 볼타 API 요금 안내입니다.

### API 가이드

#### 공통

- [인증](https://docs.bolta.io/docs/api-introduction/authentication.md): 볼타 API 인증 방식과 요청 헤더 사용법을 안내합니다.
- [인증서 등록 연동](https://docs.bolta.io/docs/api-introduction/certificate-registration.md): 발급자의 공동인증서를 외부에서 등록받고, 리다이렉트 복귀 후 등록 결과를 확인하는 워크플로우입니다.
- [용어 정리](https://docs.bolta.io/docs/api-introduction/glossary.md): 공급자, 공급받는자, 수탁자, 발급자 등 볼타 API의 주요 용어를 정리합니다.
- [에러 코드](https://docs.bolta.io/docs/api-introduction/error-codes.md): 볼타 API 에러 코드를 안내합니다.
- [웹훅 이벤트](https://docs.bolta.io/docs/api-introduction/webhook-events.md): 볼타 웹훅의 전송 방식과 제품별 이벤트 타입을 안내합니다.

#### 세금계산서

- [발행 금액 계산](https://docs.bolta.io/docs/api-introduction/issuance-guide.md): 전자(세금)계산서 발행 시 품목, 공급가액, 세액의 계산 방식을 안내합니다.
- [수정발행 유형](https://docs.bolta.io/docs/api-introduction/amendment-guide.md): 전자(세금)계산서 수정발행의 유형별 동작 방식과 계산 예시를 안내합니다.
- [공급받는자 식별번호](https://docs.bolta.io/docs/api-introduction/recipient-identification-number.md): 전자(세금)계산서 발행 시 공급받는자 식별번호 입력 기준을 안내합니다.
- [세금계산서 웹훅](https://docs.bolta.io/docs/api-introduction/webhook-tax-invoice.md): 전자세금계산서 발행 결과 웹훅의 이벤트 타입과 페이로드를 안내합니다.
- [세금계산서 발행 마감일 조회](https://docs.bolta.io/docs/api-introduction/tax-invoice-issue-due-date.md): 작성일자로 전자(세금)계산서 발행 마감일을 조회하는 API의 요청 방법과 마감일 기준을 안내합니다.
- [세금계산서 PDF 조회](https://docs.bolta.io/docs/api-introduction/tax-invoice-pdf.md): Open API로 발행한 세금계산서의 PDF를 내려받는 API의 이용 조건, 재호출 방법, 파일 이름 규칙, 오류를 안내합니다.

#### 현금영수증

- [현금영수증 발행](https://docs.bolta.io/docs/api-introduction/cash-receipt-guide.md): 현금영수증 발행, 상태 조회, 취소 API의 흐름과 입력 규칙을 안내합니다.
- [현금영수증 웹훅](https://docs.bolta.io/docs/api-introduction/webhook-cash-receipt.md): 현금영수증 발행과 취소 결과 웹훅의 이벤트 타입, 페이로드, 발송 시점을 안내합니다.

#### 사업자등록 상태 조회

- [사업자등록 상태 조회](https://docs.bolta.io/docs/api-introduction/business-registration-status.md): 사업자등록번호의 등록 상태와 과세유형을 단건 또는 일괄로 조회하는 API의 입력 규칙과 응답을 안내합니다.

#### 사업자등록증 인식과 진위확인

- [사업자등록증 인식과 진위확인](https://docs.bolta.io/docs/api-introduction/business-registration-certificate.md): 사업자등록증 파일에서 사업자 정보를 읽고 국세청 진위확인까지 하는 API의 요청, 응답, 요금, 호출 한도를 안내합니다.

#### 사업자 프로필 조회

- [사업자 프로필 조회](https://docs.bolta.io/docs/api-introduction/business-profile.md): 상호나 사업자등록번호로 사업자를 검색하고 상세 프로필을 조회하는 API의 요청, 응답, 요금, 호출 한도를 안내합니다.

#### 매출/매입 내역 조회

- [매출/매입 내역 조회](https://docs.bolta.io/docs/api-introduction/revenue-expense.md): 볼타에 쌓인 매출과 매입 세금계산서를 조회하고 수집을 요청하는 API의 이용 조건, 주요 제한, cursor 사용법을 안내합니다.

#### 입출금 내역 조회

- [입출금 내역 조회](https://docs.bolta.io/docs/api-introduction/bank-account-transactions.md): 볼타에 연결한 입출금 계좌와 입출금 내역을 조회하고 동기화를 요청하는 API의 이용 조건과 cursor 사용법을 안내합니다.

#### 예금주 조회

- [예금주 조회](https://docs.bolta.io/docs/api-introduction/bank-account-holder.md): 은행코드와 계좌번호로 예금주명을 조회하는 API의 이용 조건, 요금, 일괄 조회와 금액 지정형 가상계좌 처리 방법을 안내합니다.

#### 서류 발급

- [서류 발급](https://docs.bolta.io/docs/api-introduction/document-issuance.md): 사업자등록증명, 납세증명서 같은 홈택스 국세 증명 서류와 법인등기사항전부증명서를 발급하고 원본 PDF를 내려받는 API를 안내합니다.

### 사용 사례

- [B2B 거래](https://docs.bolta.io/docs/api-introduction/usecase-b2b.md): 기업 간 거래에서 세금계산서를 정발행하는 워크플로우입니다.
- [정기 결제 (SaaS)](https://docs.bolta.io/docs/api-introduction/usecase-recurring.md): SaaS 구독 서비스에서 정기적으로 세금계산서를 자동 발행하는 워크플로우입니다.
- [대리 정발행](https://docs.bolta.io/docs/api-introduction/usecase-delegated.md): 플랫폼이 공급자를 대신하여 세금계산서를 정발행하는 워크플로우입니다.
- [위수탁 발행](https://docs.bolta.io/docs/api-introduction/usecase-brokered.md): 수탁자가 위탁자를 대신해 전자(세금)계산서를 정발행하는 절차를 안내합니다.
- [이메일 승인 역발행](https://docs.bolta.io/docs/api-introduction/usecase-reverse-email.md): 역발행 요청 후 공급자가 이메일 링크를 통해 승인하는 워크플로우입니다.
- [간편 승인 역발행](https://docs.bolta.io/docs/api-introduction/usecase-reverse-simple.md): 플랫폼 내에서 승인 URL을 통해 공급자가 직접 승인하는 역발행 워크플로우입니다.

### SDK/노코드 연동

- [SDK: Zapier](https://docs.bolta.io/docs/api-introduction/sdk-zapier.md): Zapier를 이용한 볼타 API 연동을 안내합니다.
- [SDK: Make](https://docs.bolta.io/docs/api-introduction/sdk-make.md): Make를 이용한 볼타 API 연동을 안내합니다.
- [CLI](https://docs.bolta.io/docs/api-introduction/sdk-cli.md): Bolta CLI로 터미널에서 세금계산서를 발행, 조회, 관리하는 방법을 안내합니다.

## API 문서

### 세금계산서 발행

- [전자(세금)계산서 정발행](https://docs.bolta.io/api-reference/tax-invoice-issuance/issue-tax-invoice.md): 전체 품목의 금액 합이 발행 금액이 됩니다. `taxType`에 따라 품목의 세액(`tax`)을 전달하세요.
- [전자(세금)계산서 수정발행 - 계약의 해제](https://docs.bolta.io/api-reference/tax-invoice-issuance/amend-tax-invoice--cancellation-of-contract.md): `date`(작성일자) 하나만 전달하면 기존 발행건을 상계처리합니다. 원본 세금계산서의 품목 공급가액이 음수이면 수정발행할 수 없습니다.
- [전자(세금)계산서 수정발행 - 공급가액 변동](https://docs.bolta.io/api-reference/tax-invoice-issuance/amend-tax-invoice--change-in-supply-cost.md): 기존 대비 늘어난(+) 금액이나 줄어든(-) 금액을 품목으로 전달하세요. `taxType`에 따라 품목의 세액(`tax`)을 전달하세요.
- [전자(세금)계산서 수정발행 - 착오에 의한 이중발급](https://docs.bolta.io/api-reference/tax-invoice-issuance/amend-tax-invoice--double-issuance-by-mistake.md): 요청 본문 없이 호출하면 기존 발행건을 상계처리합니다. 작성일자는 당초 세금계산서의 작성일자를 자동으로 적용합니다.

### 세금계산서 역발행

- [전자(세금)계산서 역발행](https://docs.bolta.io/api-reference/reverse-issuance/request-reverse-issuance.md): 전체 품목의 금액 합이 발행 금액이 됩니다. `taxType`에 따라 품목의 세액(`tax`)을 전달하세요.
- [전자(세금)계산서 역발행 - 요청 상태 조회](https://docs.bolta.io/api-reference/reverse-issuance/retrieve-reverse-issuance-request-status.md): 역발행 요청의 현재 상태를 조회합니다. 웹훅을 받지 못했거나 공급자가 아직 승인하지 않은 요청을 확인할 때 쓰세요.
- [전자(세금)계산서 역발행 - 승인 URL 조회](https://docs.bolta.io/api-reference/reverse-issuance/retrieve-reverse-issuance-approval-url.md): 역발행 승인 URL을 조회합니다. URL은 10분간 유효하며, 공급자의 공동인증서가 등록돼 있어야 합니다.
- [전자(세금)계산서 역발행 - 요청 취소](https://docs.bolta.io/api-reference/reverse-issuance/cancel-reverse-issuance-request.md): 역발행 요청을 취소합니다. 이미 승인, 취소, 발행된 요청이면 API가 에러를 반환합니다.

### 발급자

- [발급자 목록 조회](https://docs.bolta.io/api-reference/issuer/list-issuers.md): 현재 API 키로 등록한 발급자와 인증서 상태를 조회합니다.
- [발급자 등록](https://docs.bolta.io/api-reference/issuer/register-issuer.md): 세금계산서를 발급할 사업자를 등록하고 `issuerId`를 발급받습니다.
- [발급자 조회](https://docs.bolta.io/api-reference/issuer/retrieve-issuer.md): 등록된 발급자 정보와 인증서 상태를 조회합니다.

### 인증서

- [발급자 공동인증서 등록 URL 조회](https://docs.bolta.io/api-reference/certificate/retrieve-issuer-certificate-registration-url.md): 발급자가 공동인증서를 등록할 수 있는 URL을 발급합니다.
- [발급자 공동인증서 등록 내역 조회](https://docs.bolta.io/api-reference/certificate/retrieve-issuer-certificate-registration-status.md): 가장 최근 인증서 등록 내역 1건을 조회합니다. 등록 후 30초 이내에 확인하세요.
- [발급자 공동인증서 등록 해제](https://docs.bolta.io/api-reference/certificate/unregister-issuer-certificate.md): 등록된 발급자 공동인증서를 삭제합니다.

### 세금계산서 조회

- [전자(세금)계산서 내용 조회](https://docs.bolta.io/api-reference/tax-invoice-retrieval/retrieve-tax-invoice.md): `발행 완료`된 전자(세금)계산서의 내용(국세청승인번호 포함)을 조회합니다.
- [세금계산서 PDF 조회](https://docs.bolta.io/api-reference/tax-invoice-retrieval/retrieve-tax-invoice-pdf.md): 발행 완료한 세금계산서(정발행, 역발행, 수정세금계산서)의 PDF 다운로드 주소를 조회합니다. 발행을 요청한 API 키로 호출하세요. 포인트를 차감하지 않습니다. 첫 호출이 PDF 생성을 시작합니다. `202`를 받으면 `Retry-After` 초 뒤 같은 요청을 다시 보내세요. 준비되면 API가 `200`과 5분 동안 유효한 주소를 반환합니다. 주소가 만료되면 다시 호출해 새 주소를 받으세요. 테스트 키는 바로 `200`과 샘플 PDF 주소를 반환합니다. [세금계산서 PDF 조회 가이드](/docs/api-introduction/…
- [전자(세금)계산서 요청자 관리번호 이용하여 조회](https://docs.bolta.io/api-reference/tax-invoice-retrieval/retrieve-tax-invoice-by-client-reference.md): `Bolta-Client-Reference-Id`로 요청 처리 상태를 조회합니다. 요청자 관리번호는 [인증 가이드](/docs/api-introduction/authentication#client-reference-id)를 참고하세요.
- [전자(세금)계산서 발행 마감일 조회](https://docs.bolta.io/api-reference/tax-invoice-retrieval/retrieve-tax-invoice-issuance-deadline.md): 작성일자를 보내면 그 전자(세금)계산서의 발행 마감일을 반환합니다. 마감일 당일까지 발행할 수 있습니다. 정발행과 역발행 요청 API도 마감일을 검증합니다. 발행 전에 마감일을 미리 확인할 때 쓰세요. 발급자 등록, 공동인증서, 요청자 관리번호가 필요 없습니다. 테스트 키와 라이브 키가 같은 결과를 반환하며 포인트를 차감하지 않습니다.

### 현금영수증

- [현금영수증 발행](https://docs.bolta.io/api-reference/cash-receipt/issue-cash-receipt.md): 현금영수증 발행 요청은 비동기입니다. API가 `202 Accepted`와 `issuanceKey`를 먼저 반환합니다. 처리 중이거나 발행 결과 확인이 필요한 요청은 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다. 상태 조회에서 `ISSUED`를 확인하거나 `CASH_RECEIPT_ISSUED` 웹훅을 받아 최종 발행 결과를 확인하세요.
- [현금영수증 발행 상태 조회](https://docs.bolta.io/api-reference/cash-receipt/retrieve-cash-receipt-status.md): 발행이나 취소 요청에 사용한 `Bolta-Client-Reference-Id`로 처리 상태를 조회합니다. `status`로 성공과 실패를 판별하고, 실패 사유는 `failure`에서 확인하세요. LIVE 요청은 처리 중이거나 발행 결과 확인이 필요하면 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다.
- [현금영수증 취소](https://docs.bolta.io/api-reference/cash-receipt/cancel-cash-receipt.md): 발행 처리에 접수된 원본 현금영수증을 전액 취소합니다. 국세청 발급 확정 전에도 취소할 수 있지만, 원본 요청이 `PENDING` 상태이면 취소할 수 없습니다. API가 `202 Accepted`를 먼저 반환합니다. 최종 결과는 웹훅이나 상태 조회 API로 확인하세요. 볼타 외부(예: 홈택스)에서 전액이나 일부가 먼저 취소된 원본을 취소해도 API는 `202 Accepted`를 반환합니다. 이 취소 요청은 `CANCEL_FAILED` 상태와 `CANCELLATION_TARGET_NOT_FOUND` 실패 코드로 끝납니다. 원본이 이미…

### 사업자등록 상태 조회

- [사업자등록 상태 단건 조회](https://docs.bolta.io/api-reference/business-registration-status/check-business-registration-status.md): 사업자등록번호 한 건의 등록 상태와 과세유형을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 상태를 확인하면 10포인트를 차감합니다. 테스트 키는 가이드에 안내한 고정 번호만 모의 조회합니다. 여러 번호를 한 번에 조회하려면 일괄 조회 API를 쓰세요. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status)
- [사업자등록 상태 일괄 조회](https://docs.bolta.io/api-reference/business-registration-status/check-business-registration-statuses-in-bulk.md): 사업자등록번호를 한 번에 최대 100개까지 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 상태를 확인한 번호마다 10포인트를 차감하고, `status`가 `null`인 번호는 차감하지 않습니다. 중복 번호는 처음 나온 것만 남기고, 요청 순서대로 `results`에 담습니다. 이번 요청에서 확인하지 못한 번호는 `status`가 `null`이니 잠시 후 그 번호만 다시 조회하세요. 한 건도 확인하지 못하면 `503`을 반환합니다. 테스트 키는 가이드에 안내한 고정 번호만 모의 조회하며, 목록…

### 사업자등록증 인식과 진위확인

- [사업자등록증 인식과 진위확인](https://docs.bolta.io/api-reference/business-registration-certificate-extraction-and-verification/extract-and-verify-business-registration-certificate.md): 사업자등록증 파일 한 건을 읽고, 읽은 사업자등록번호, 첫 번째 대표자명, 개업일로 국세청 진위확인을 합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 처리에 최대 약 45초가 걸리므로 클라이언트 읽기 타임아웃은 60초 이상으로 잡으세요.

### 사업자 프로필 조회

- [사업자 프로필 검색](https://docs.bolta.io/api-reference/business-profile/search-business-profiles.md): 상호, 대표자명, 사업자등록번호로 사업자를 검색합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 돌려준 결과 한 건마다 9포인트를 차감하고, 결과가 없으면 차감하지 않습니다.
- [사업자 프로필 상세 조회](https://docs.bolta.io/api-reference/business-profile/retrieve-business-profile.md): 사업자등록번호 한 건의 상세 프로필을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 조회에 성공하면 90포인트를 차감하고, 프로필이 없는 번호(`404`)는 차감하지 않습니다.

### 매출/매입 내역 조회

- [매출 내역 조회](https://docs.bolta.io/api-reference/revenue-and-expense/list-revenues.md): 볼타에 쌓인 매출을 볼타에서 바뀐 순서로 반환합니다. 작성일자 순서가 아닙니다. 대시보드에 보이는 매출은 `ACTIVE`로, 보관하거나 비활성이 되어 안 보이게 된 매출은 `id`만 담은 `REMOVED`로 옵니다. 같은 `id`가 여러 번 올 수 있으니 받은 순서대로 `id` 기준으로 덮어쓰거나 지우세요. 홈택스에서 수집해 상세를 채우는 중인 매출은 `id`만 담은 `PENDING`으로 오고, 상세가 채워지면 같은 `id`가 `ACTIVE`로 다시 옵니다.
- [매입 내역 조회](https://docs.bolta.io/api-reference/revenue-and-expense/list-expenses.md): 볼타에 쌓인 매입을 볼타에서 바뀐 순서로 반환합니다. 파라미터, 응답, cursor 규칙은 매출 내역 조회와 같습니다. 매입은 볼타가 지급 완료 여부를 다시 판정할 때도 순서가 뒤로 옮겨지므로 내용이 같은 매입이 한 번 더 올 수 있습니다. 덮어쓰면 됩니다.
- [매출 동기화 요청](https://docs.bolta.io/api-reference/revenue-and-expense/request-revenue-sync.md): 대시보드에서 연동한 매출 전부의 수집을 요청합니다. API가 `202 Accepted`로 접수만 하고 수집은 비동기로 진행합니다. 볼타가 매출을 주기적으로 수집하므로, 방금 국세청에 올라간 문서가 급할 때만 요청하세요. 수집 상태를 조회하는 경로는 없습니다. 저장한 cursor로 `GET /v1/revenues`를 이어 받으세요.
- [매입 동기화 요청](https://docs.bolta.io/api-reference/revenue-and-expense/request-expense-sync.md): 대시보드에서 연동한 매입 전부의 수집을 요청합니다. API가 `202 Accepted`로 접수만 하고 수집은 비동기로 진행합니다. 볼타가 매입을 주기적으로 수집하므로, 방금 국세청에 올라간 문서가 급할 때만 요청하세요. 수집 상태를 조회하는 경로는 없습니다. 저장한 cursor로 `GET /v1/expenses`를 이어 받으세요.

### 입출금 내역 조회

- [입출금 계좌 목록 조회](https://docs.bolta.io/api-reference/bank-account-transactions/list-bank-accounts.md): API 키가 속한 사업자에 연결된 입출금 계좌와 계좌별 동기화 상태를 조회합니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 계좌는 볼타 대시보드에서 먼저 연결하세요.
- [입출금 내역 조회](https://docs.bolta.io/api-reference/bank-account-transactions/list-bank-account-transactions.md): 볼타가 은행에서 가져와 적재한 입출금 내역을 볼타에서 거래가 바뀐 순서로 반환합니다. 거래 시각 순서가 아닙니다. 새로 적재됐거나 다시 보이게 된 거래는 `ACTIVE`로, 대시보드에서 안 보이게 된 거래는 `id`만 담은 `REMOVED`로 옵니다. 같은 `id`가 여러 번 올 수 있으니 받은 순서대로 `id` 기준으로 덮어쓰거나 지우세요.
- [입출금 내역 동기화 요청](https://docs.bolta.io/api-reference/bank-account-transactions/request-bank-account-sync.md): 연결된 모든 입출금 계좌의 은행 조회를 요청합니다. API가 `202 Accepted`로 접수만 하고 은행 조회는 비동기로 진행합니다. 볼타가 입출금 내역을 주기적으로 가져오므로, 그 전에 최신 내역이 필요할 때만 요청하세요. 진행 상황은 계좌 목록 조회의 `syncStatus`로 확인하고, `IN_PROGRESS`가 끝나면 저장한 cursor로 입출금 내역을 이어 받으세요.

### 예금주 조회

- [예금주 단건 조회](https://docs.bolta.io/api-reference/bank-account-holder/inquire-bank-account-holder.md): 은행코드와 계좌번호로 예금주명 한 건을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 입금 금액이 정해진 가상계좌는 `amount`에 금액을 넣어야 조회합니다.
- [예금주 일괄 조회](https://docs.bolta.io/api-reference/bank-account-holder/bulk-inquire-bank-account-holders.md): 계좌 1~100개의 예금주명을 한 번에 조회합니다. 계좌마다 결과 하나를 요청과 같은 순서로 돌려줍니다. 찾지 못한 계좌는 `holderName`이 `null`이고 `error`에 원인이 옵니다.

### 서류 발급

- [서류 발급 요청](https://docs.bolta.io/api-reference/document-issuance/request-document-issuance.md): 서류 발급을 접수합니다. API가 `202 Accepted`와 `issuanceKey`를 반환하고 발급은 비동기로 진행합니다. `issuanceKey`로 결과를 조회하세요.
- [서류 발급 결과 조회](https://docs.bolta.io/api-reference/document-issuance/retrieve-document-issuance.md): 발급 요청의 상태를 조회합니다. 홈택스 서류는 보통 30초 안에 끝나니 5~10초 간격으로 조회하세요. 법인등기는 몇 분이 걸립니다. 같은 사업자의 홈택스 서류를 여러 건 보내면 뒤 요청은 앞 요청이 끝난 뒤 시작합니다. 기다리는 시간이 1시간을 넘기면 `FAILED`로 바뀌고 포인트를 차감하지 않습니다. `COMPLETED`가 되면 `downloadUrl`로 원본 PDF를 내려받으세요. 주소는 홈택스 서류 5분, 법인등기 1분(테스트 키 샘플 주소는 5분) 동안 유효하고, 만료되면 다시 조회해 새 주소를 받으세요. 파일 이름은 `…

## OpenAPI Specs

- [openapi](/openapi.yaml)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (71 pages)](https://docs.bolta.io/_llms/en.txt): Documentation for English.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.