서류 발급 요청

POST

documentIssuances

curl --request POST \
  --url https://xapi.bolta.io/v1/documentIssuances \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessRegistrationNumber": "1234567890",
  "document": {
    "type": "BUSINESS_REGISTRATION_PROOF",
    "language": "KO"
  }
}
'

{
  "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
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

인증

Authorization

string

header

필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

헤더

Bolta-Client-Reference-Id

string

필수

1~255자의 요청자 관리번호를 입력하세요. 같은 값과 같은 본문으로 다시 보내면 API가 기존 요청을 반환합니다. 같은 값에 다른 본문을 보내면 409 Conflict와 IDEMPOTENCY_CONFLICT를 반환합니다.

Required string length: 1 - 255

Pattern: \S

본문

application/json

서류 발급 요청

businessRegistrationNumber

string

필수

API 키가 속한 사업자의 사업자등록번호. 하이픈을 넣어도 됩니다.

예시:

"1234567890"

document

object

필수

발급할 서류. type에 맞춰 입력을 채우세요.

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

응답

접수 완료

서류 발급 요청과 결과

issuanceKey

string<uuid>

필수

발급 요청 식별자

clientReferenceId

string

필수

요청에 사용한 Bolta-Client-Reference-Id

type

enum<string>

필수

서류 종류

사용 가능한 옵션:

BUSINESS_REGISTRATION_PROOF,

BUSINESS_REGISTRATION_CERTIFICATE,

TAX_PAYMENT_CERTIFICATE,

VAT_TAX_BASE_PROOF,

STANDARD_FINANCIAL_STATEMENT_PROOF

language

enum<string>

필수

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

사용 가능한 옵션:

KO,

EN

status

enum<string>

필수

발급 상태

ACCEPTED: 접수
SUBMITTED: 홈택스 신청 완료, 결과 대기
COMPLETED: 발급 완료
FAILED: 발급 실패. 포인트를 차감하지 않습니다. 인증서, 체납, 신고 여부를 확인하고 새 Bolta-Client-Reference-Id로 다시 요청하세요
ACTION_REQUIRED: 볼타가 결과 확인 중. 같은 서류를 다시 요청하지 마세요. COMPLETED 또는 FAILED로 바뀔 때까지 기다리세요

사용 가능한 옵션:

ACCEPTED,

SUBMITTED,

COMPLETED,

FAILED,

ACTION_REQUIRED

requestedAt

string<date-time>

필수

요청을 접수한 시각(UTC)

issuedOn

string<date> | null

필수

원본 PDF에 적힌 발급일. COMPLETED에서만 채웁니다.

retentionExpiresAt

string<date-time> | null

필수

보관 만료 시각(UTC). 발급 후 30일입니다. COMPLETED에서만 채웁니다.

downloadUrl

string<uri> | null

필수

원본 PDF 주소. 5분 동안 유효합니다. COMPLETED이고 보관 기간 안일 때만 채웁니다. 테스트 키는 샘플 PDF 주소입니다.

downloadUrlExpiresAt

string<date-time> | null

필수

downloadUrl 만료 시각(UTC)

curl --request POST \
  --url https://xapi.bolta.io/v1/documentIssuances \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessRegistrationNumber": "1234567890",
  "document": {
    "type": "BUSINESS_REGISTRATION_PROOF",
    "language": "KO"
  }
}
'

{
  "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
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

세금계산서 발행

세금계산서 역발행

발급자

인증서

세금계산서 조회

현금영수증

사업자등록 상태 조회

입출금내역 조회

서류 발급

인증

헤더

본문

응답