현금영수증 발행

현금영수증 발행 요청은 비동기입니다. API가 202 Accepted와 issuanceKey를 먼저 반환합니다. 일부 결과는 빠르게 확정됩니다. 처리 중이거나 발행 결과 확인이 필요한 요청은 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다. 상태 조회에서 ISSUED를 확인하거나 CASH_RECEIPT_ISSUED 웹훅을 받아 최종 발행 결과를 확인하세요.

수취인 유형(recipient.type)과 발급수단(recipient.value) 입력 방식, 금액·검증 규칙은 현금영수증 발행 가이드를 참고하세요.

POST

cashReceipts

curl --request POST \
  --url https://xapi.bolta.io/v1/cashReceipts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "itemName": "서비스 이용료",
  "issuer": {
    "businessRegistrationNumber": "1234567890",
    "organizationName": "공급자 상호",
    "representativeName": "공급자대표",
    "telephone": "02-1234-5678"
  },
  "recipient": {
    "type": "PHONE",
    "value": "010-1234-5678"
  },
  "amount": {
    "supplyAmount": 100,
    "vatAmount": 10,
    "taxFreeAmount": 0
  }
}
'

{
  "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
}

{
  "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 키와 요청자 관리번호로 요청 내용과 유형까지 동일하게 다시 호출하면 API가 기존 접수 건의 issuanceKey를 담은 202 Accepted 응답을 반환합니다. 요청 내용이나 유형이 다르면 409 Conflict와 IDEMPOTENCY_CONFLICT를 반환합니다. 상태를 다시 조회할 때 이 값을 clientReferenceId에 입력하세요. 인증 가이드

Required string length: 1 - 255

Pattern: \S

Bolta-Webhook-Test-Code

enum<string>

테스트 키에서 발행 실패 웹훅을 재현할 때만 사용하세요. 발행 실패 코드를 입력하면 API가 해당 실패 웹훅을 전송합니다. 운영(라이브)에서는 사용하지 마세요. 현금영수증 웹훅

사용 가능한 옵션:

INVALID_ISSUER,

INVALID_RECIPIENT_IDENTIFIER,

UNKNOWN

본문

application/json

현금영수증 발행 요청 본문

itemName

string

필수

품목명(20자 이하)

Required string length: 1 - 20

예시:

"서비스 이용료"

issuer

object

필수

현금영수증을 발급하는 공급자 정보입니다.

Show child attributes

recipient

object

필수

수취인(발급 대상) 정보입니다. type에 맞춰 value를 입력하세요. 자세한 규칙은 현금영수증 발행 가이드를 참고하세요.

Option 1
Option 2
Option 3

Show child attributes

amount

object

필수

발행 금액입니다. 각 항목과 총액(supplyAmount + vatAmount + taxFreeAmount)은 9,999,999,999 이하여야 하며, 총액은 0보다 커야 합니다.

Show child attributes

응답

API가 발행 요청을 접수했습니다. 최종 결과는 웹훅이나 상태 조회 API로 확인하세요.

issuanceKey

string

필수

현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으므로 문자열 전체를 그대로 저장하세요.

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"

curl --request POST \
  --url https://xapi.bolta.io/v1/cashReceipts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "itemName": "서비스 이용료",
  "issuer": {
    "businessRegistrationNumber": "1234567890",
    "organizationName": "공급자 상호",
    "representativeName": "공급자대표",
    "telephone": "02-1234-5678"
  },
  "recipient": {
    "type": "PHONE",
    "value": "010-1234-5678"
  },
  "amount": {
    "supplyAmount": 100,
    "vatAmount": 10,
    "taxFreeAmount": 0
  }
}
'

{
  "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
}

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

세금계산서 발행

세금계산서 역발행

발급자

인증서

세금계산서 조회

현금영수증

현금영수증 발행

인증

헤더

본문

응답