서류 발급

무엇을 발급하나요

홈택스 국세 증명 서류와 법인등기사항전부증명서를 발급하고 원본 PDF를 내려받습니다. API는 요청을 접수한 뒤 발급을 진행합니다. 접수 응답의 issuanceKey로 결과를 조회하세요.

경로	용도
`POST /v1/documentIssuances`	서류 발급 요청
`GET /v1/documentIssuances/{issuanceKey}`	발급 결과 조회

이용 조건

홈택스 서류는 API 키가 속한 사업자의 서류를 발급합니다. 볼타 대시보드에 공동인증서를 등록하세요.
법인등기는 document.corporationNumber에 넣은 법인의 등기부를 발급합니다. 지원하는 법인 종류는 주식회사, 유한회사, 합명회사, 합자회사, 유한책임회사, 사단법인, 재단법인, 의료법인, 협동조합(사회적협동조합 포함), 기타법인(특허법인 등)입니다. 공동인증서는 필요 없습니다.

요금

서류 한 건마다 아래 포인트를 차감합니다. 발급에 실패하면 차감하지 않습니다.

서류	한 건 요금
홈택스 서류 5종	500포인트
법인등기사항전부증명서(열람용)	1,000포인트
법인등기사항전부증명서(제출용)	1,500포인트

지원 서류

`document.type`	서류	입력
`BUSINESS_REGISTRATION_PROOF`	사업자등록증명	`language`: `KO`, `EN`
`BUSINESS_REGISTRATION_CERTIFICATE`	사업자등록증 재발급	`reason`: 재발급 사유, 10자 이내
`TAX_PAYMENT_CERTIFICATE`	납세증명서	`purpose`: `PAYMENT_RECEIPT`(대금수령), `OTHER`(기타)
`VAT_TAX_BASE_PROOF`	부가가치세 과세표준증명	`from`, `to`: 과세기간 `YYYY-MM`
`STANDARD_FINANCIAL_STATEMENT_PROOF`	표준재무제표증명	`fiscalYearEnd`: 사업연도 종료 연월 `YYYY-MM`
`CORPORATE_REGISTRY_VIEW`	법인등기사항전부증명서(열람용)	`corporationNumber`: 법인등록번호 13자리, `cancelledEntries`: `INCLUDE`(말소사항 포함), `EXCLUDE`(미포함)
`CORPORATE_REGISTRY_ISSUANCE`	법인등기사항전부증명서(제출용)	`corporationNumber`: 법인등록번호 13자리, `cancelledEntries`: `INCLUDE`(말소사항 포함), `EXCLUDE`(미포함)

사업자등록증 재발급: reason은 사업자등록증에 그대로 인쇄됩니다. 실제 사유를 적으세요(예: 분실). API가 앞뒤 공백을 제거합니다. 비었거나 10자를 넘거나 제어 문자가 있으면 400 INVALID_REQUEST를 반환합니다.
사업자등록증명: language를 빼면 API가 400 INVALID_REQUEST를 반환합니다. 영문(EN)은 홈택스에 등록된 사업자 영문 정보로 발급합니다. 영문 정보가 없거나 형식이 맞지 않으면 FAILED로 끝나고 포인트를 차감하지 않습니다. 표기를 바꾸려면 홈택스에서 영문 정보를 먼저 수정하세요.
납세증명서: 국세 체납이 있으면 홈택스가 발급하지 않습니다. 유효기간은 발급일부터 30일입니다.
부가가치세 과세표준증명: from은 01월 또는 07월, to는 06월 또는 12월로 입력하세요. from은 to보다 늦을 수 없으며, 어기면 400 INVALID_REQUEST를 반환합니다. 최대 5개 연도까지 한 번에 발급합니다.
표준재무제표증명: 12월 결산 법인의 2025 사업연도라면 2025-12를 입력하세요. 개인사업자는 연도만 봅니다. 법인세나 종합소득세 신고를 마친 사업연도만 발급됩니다. 끝나지 않은 사업연도(종료 연월이 요청한 달이거나 그 뒤)는 API가 400 PERIOD_NOT_CLOSED를 반환하고 포인트를 예약하지 않습니다. 사업연도가 끝났어도 신고 전이면 FAILED로 끝나고 포인트를 차감하지 않습니다.
법인등기사항전부증명서: 인터넷등기소에서 발급합니다. corporationNumber는 1101111234567처럼 숫자만 넣거나 110111-1234567처럼 하이픈을 넣으세요. 형식이 틀리면 API가 400 INVALID_REQUEST를 반환합니다. cancelledEntries로 말소사항 포함 여부를 고르세요. 빼면 API가 400 INVALID_REQUEST를 반환합니다. 열람용은 내용 확인용입니다. 관공서나 은행에 낼 서류가 필요하면 제출용을 요청하세요. 같은 법인, 같은 서류, 같은 cancelledEntries를 다른 요청이 발급하는 중이면 API가 409 TARGET_BUSY를 반환합니다. 앞 요청이 끝난 뒤 다시 요청하세요.

발급 가능 시간

서류	요청 가능 시간
납세증명서	매일 06:00~22:00(한국 시간)
그 밖의 서류	24시간

요청 가능 시간 밖에 요청하면 API가 409 OUTSIDE_SERVICE_HOURS를 반환하고 포인트를 예약하지 않습니다. 요청 가능 시간에 다시 요청하세요. 홈택스가 점검 등으로 신청을 받지 않으면 FAILED로 끝나고 포인트를 차감하지 않습니다. 잠시 뒤 다시 요청하세요.

발급 요청

curl -X POST https://xapi.bolta.io/v1/documentIssuances \
  -H "Authorization: Basic {apiKey}" \
  -H "Bolta-Client-Reference-Id: order-20260919-001" \
  -H "Content-Type: application/json" \
  -d '{
    "document": { "type": "BUSINESS_REGISTRATION_PROOF", "language": "KO" }
  }'

법인등기는 document에 법인등록번호와 말소사항 포함 여부를 넣으세요.

{
  "document": { "type": "CORPORATE_REGISTRY_ISSUANCE", "corporationNumber": "110111-1234567", "cancelledEntries": "EXCLUDE" }
}

Bolta-Client-Reference-Id에는 요청마다 새 값(1~255자)을 넣으세요. 응답을 받지 못했다면 같은 값과 본문으로 다시 보내세요. API가 기존 요청을 돌려줍니다. API는 202 Accepted와 아래 응답을 반환합니다.

{
  "issuanceKey": "00000000-0000-4000-8000-000000000001",
  "clientReferenceId": "order-20260919-001",
  "type": "BUSINESS_REGISTRATION_PROOF",
  "language": "KO",
  "status": "ACCEPTED",
  "requestedAt": "2026-09-19T03:00:00Z",
  "issuedOn": null,
  "retentionExpiresAt": null,
  "downloadUrl": null,
  "downloadUrlExpiresAt": null
}

응답의 language는 발급한 서류의 언어입니다. 사업자등록증명이 아닌 서류는 항상 KO입니다.

결과 조회

curl https://xapi.bolta.io/v1/documentIssuances/{issuanceKey} \
  -H "Authorization: Basic {apiKey}"

홈택스 서류는 보통 30초 안에 끝납니다. 5~10초 간격으로 조회하세요. 같은 사업자의 홈택스 서류를 여러 건 보내면 뒤 요청은 앞 요청이 끝난 뒤 시작합니다. 기다리는 시간이 1시간을 넘기면 FAILED로 바뀌고 포인트를 차감하지 않습니다. 법인등기는 몇 분이 걸리고, 요청이 몰리면 더 늦어집니다. 인터넷등기소에서 찾을 수 없는 법인등록번호, 해산이나 폐쇄로 살아 있는 등기부가 없는 법인, 지원하지 않는 종류의 법인은 FAILED로 끝나고 포인트를 차감하지 않습니다. 지점이 있거나 상호를 바꾼 법인은 본점의 현재 등기부로 발급합니다.

`status`	뜻	할 일
`ACCEPTED`	접수, 기관 신청 전	기다리세요
`SUBMITTED`	기관 신청 완료, 결과 대기	기다리세요
`COMPLETED`	발급 완료	`downloadUrl`로 내려받으세요
`FAILED`	발급 실패	홈택스 서류는 인증서, 체납, 신고 여부를 확인하세요. 법인등기는 법인등록번호와 법인의 종류, 상태를 확인하세요. 문제가 없으면 잠시 뒤 다시 요청하세요. 다시 요청할 때는 새 `Bolta-Client-Reference-Id`를 쓰세요
`ACTION_REQUIRED`	볼타가 결과 확인 중	같은 서류를 다시 요청하지 마세요. 확인이 끝나면 `COMPLETED` 또는 `FAILED`로 바뀝니다

COMPLETED 응답에는 다음 값이 채워집니다.

필드	설명
`issuedOn`	원본 PDF에 적힌 발급일(법인등기는 열람일 또는 발급일) `YYYY-MM-DD`
`retentionExpiresAt`	보관 만료 시각. 발급 후 30일
`downloadUrl`	원본 PDF 주소. 홈택스 서류는 5분, 법인등기는 1분 동안 유효
`downloadUrlExpiresAt`	주소 만료 시각

주소가 만료되면 다시 조회해 새 주소를 받으세요. 보관 기간이 지나면 downloadUrl은 null입니다. 내려받은 파일 이름은 {서류명}_{사업자등록번호}_{발급일}.pdf입니다. 예를 들어 사업자등록증명_123-45-67890_20260919.pdf이고, 영문 증명은 사업자등록증명(영문)_...으로 시작합니다. 법인등기는 사업자등록번호 대신 법인등록번호를 씁니다. 열람용은 법인등기열람_110111-1234567_20260922.pdf, 제출용은 법인등기발급_...입니다. 한글 파일 이름을 지원하지 않는 클라이언트는 business-registration-proof_1234567890_20260919.pdf 같은 영문 이름으로 받습니다. 같은 날 같은 서류를 여러 번 받으면 파일 이름이 같습니다. 파일을 따로 저장한다면 issuanceKey와 함께 기록하세요.

테스트 키

테스트 키는 기관에 신청하지 않고 포인트도 차감하지 않습니다.

홈택스 서류는 항상 바로 COMPLETED로 끝납니다.
법인등기는 corporationNumber로 결과가 정해집니다. 아래 번호만 받고, 다른 번호는 API가 400 INVALID_REQUEST를 반환합니다.

`corporationNumber`	결과
`1100000000014`	바로 `COMPLETED`
`1100000000071`	바로 `FAILED`

COMPLETED 조회 응답에는 샘플 PDF 주소가 담깁니다. 샘플은 실제 서류가 아니며 서류 종류와 관계없이 내용이 같습니다. 샘플 주소는 5분 동안 유효하고, 발급일은 2026년 1월 1일로 고정입니다. 만료 뒤 재조회와 파일 이름 규칙은 실제 발급과 같으니 다운로드 연동을 테스트 키로 확인하세요.

오류

상태 코드	에러 코드	발생 조건
`400`	`INVALID_REQUEST`	요청 형식 오류, 사업자등록증명의 `language` 누락, 법인등록번호 형식 오류, 법인등기의 `cancelledEntries` 누락, 테스트 키로 안내 목록 밖 법인등록번호 요청
`400`	`PERIOD_NOT_CLOSED`	표준재무제표증명의 사업연도가 끝나지 않음. 신고를 마친 사업연도로 다시 요청하세요
`401`	-	API 키 인증 실패. 응답 본문 없음
`402`	`PAYMENT_REQUIRED`	포인트 잔액 부족. 개발자센터에서 충전하세요
`404`	`DOCUMENT_ISSUANCE_NOT_FOUND`	없는 `issuanceKey`, 다른 파트너나 다른 모드 키로 접수한 요청
`409`	`CERTIFICATE_REQUIRED`	공동인증서 미등록 또는 만료. 홈택스 서류만 해당
`409`	`IDEMPOTENCY_CONFLICT`	같은 `Bolta-Client-Reference-Id`에 다른 본문
`409`	`OUTSIDE_SERVICE_HOURS`	서류의 요청 가능 시간 밖 요청. 발급 가능 시간을 확인하세요
`409`	`TARGET_BUSY`	같은 법인, 같은 등기 서류, 같은 `cancelledEntries`를 다른 요청이 발급 중. 앞 요청이 끝난 뒤 다시 요청하세요
`409`	`AVAILABLE_POINTS_INSUFFICIENT`	진행 중인 다른 요청 때문에 지금 쓸 수 있는 포인트 부족. 충전하거나 그 요청이 끝난 뒤 다시 요청하세요
`429`	`TOO_MANY_IN_FLIGHT`	처리 중인 요청이 5건. 동시에 보낸 요청도 5건까지만 접수합니다. 끝난 뒤 다시 요청하세요
`503`	`DOCUMENT_ISSUANCE_UNAVAILABLE`	지금은 발급할 수 없음. 포인트를 예약하지 않습니다. 잠시 후 다시 요청하세요

API 소개

API 가이드

사용 사례

SDK/노코드 연동

무엇을 발급하나요

이용 조건

요금

지원 서류

발급 가능 시간

발급 요청

결과 조회

테스트 키

오류

​무엇을 발급하나요

​이용 조건

​요금

​지원 서류

​발급 가능 시간

​발급 요청

​결과 조회

​테스트 키

​오류

무엇을 발급하나요

이용 조건

요금

지원 서류

발급 가능 시간

발급 요청

결과 조회

테스트 키

오류