현금영수증 발행

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' \
  --header 'Supplier-Key: <supplier-key>' \
  --data '
{
  "itemName": "서비스 이용료",
  "issuer": {
    "businessRegistrationNumber": "5648102684",
    "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>"
}

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

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

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

인증

Authorization

string

header

필수

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

헤더

Supplier-Key

string

필수

공급자 등록 API(POST /v1/suppliers)에서 발급받은 supplierKey를 입력하세요. 요청 본문의 issuer.businessRegistrationNumber는 이 키에 연결된 사업자등록번호와 같아야 합니다. 용어 정리 | 인증 가이드

Bolta-Client-Reference-Id

string

필수

1~255자의 요청자 관리번호를 입력하세요. 이 값은 멱등키로 사용합니다. 같은 값과 동일한 요청으로 다시 호출하면 API가 기존 결과를 반환하고, 요청 내용이나 유형이 다르면 409 Conflict를 반환합니다. 상태를 다시 조회할 때 이 값을 clientReferenceId에 입력하세요. 인증 가이드

Bolta-Webhook-Test-Code

enum<string>

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

사용 가능한 옵션:

INVALID_ISSUER,

INVALID_RECIPIENT_IDENTIFIER,

ORIGINAL_ISSUANCE_FAILED,

UNKNOWN

본문

application/json

현금영수증 발행 요청 본문

itemName

string

필수

품목명(20자 이하)

Required string length: 1 - 20

예시:

"서비스 이용료"

issuer

object

필수

현금영수증 공급자 정보입니다. businessRegistrationNumber에는 Supplier-Key에 연결된 사업자등록번호를 입력하세요.

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' \
  --header 'Supplier-Key: <supplier-key>' \
  --data '
{
  "itemName": "서비스 이용료",
  "issuer": {
    "businessRegistrationNumber": "5648102684",
    "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>"
}

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

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

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

세금계산서

세금계산서 역발행

공급자

인증서

현금영수증

인증

헤더

본문

응답