> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 현금영수증 발행 상태 조회

> 발행·취소 요청에 사용한 `Bolta-Client-Reference-Id`로 처리 상태를 조회하세요. `status`로 성공·실패를 판별하세요. 실패 사유는 `failure`에서 확인하세요.




## OpenAPI

````yaml /openapi.yaml get /v1/cashReceipts/status
openapi: 3.1.0
info:
  title: 볼타 API
  description: >
    볼타 전자세금계산서 API입니다. [API 소개](/docs/api-introduction/overview) | [인증
    가이드](/docs/api-introduction/authentication) | [사용
    사례](/docs/api-introduction/usecase-b2b)
  version: 1.0.0
servers:
  - url: https://xapi.bolta.io
    description: 볼타 API 서버
security:
  - basicAuth: []
tags:
  - name: 세금계산서
    description: >
      전자(세금)계산서 발행 및 관리. [발행 금액 계산](/docs/api-introduction/issuance-guide) |
      [수정발행 유형](/docs/api-introduction/amendment-guide)
  - name: 세금계산서 역발행
    description: >
      전자(세금)계산서 역발행 요청 및 관리. [이메일 승인
      역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인
      역발행](/docs/api-introduction/usecase-reverse-simple)
  - name: 현금영수증
    description: >
      현금영수증을 발행·취소하고 처리 상태를 조회합니다. 발행·취소의 최종 결과는 웹훅이나 상태 조회 API로 확인하세요. [현금영수증
      발행 가이드](/docs/api-introduction/cash-receipt-guide) | [웹훅
      이벤트](/docs/api-introduction/webhook-events)
  - name: 공급자
    description: >
      세금계산서를 발행하는 공급자(발행자)를 등록·관리합니다. [용어 정리](/docs/api-introduction/glossary) |
      [대리 정발행](/docs/api-introduction/usecase-delegated)
  - name: 인증서
    description: |
      공급자 공동인증서 등록 및 관리. [인증 가이드](/docs/api-introduction/authentication)
paths:
  /v1/cashReceipts/status:
    get:
      tags:
        - 현금영수증
      summary: 현금영수증 발행 상태 조회
      description: >
        발행·취소 요청에 사용한 `Bolta-Client-Reference-Id`로 처리 상태를 조회하세요. `status`로
        성공·실패를 판별하세요. 실패 사유는 `failure`에서 확인하세요.
      parameters:
        - name: clientReferenceId
          in: query
          description: 발행·취소 요청에 사용한 Bolta-Client-Reference-Id
          required: true
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CashReceiptStatusResponse'
          headers: {}
        '400':
          description: 잘못된 요청
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  schemas:
    CashReceiptStatusResponse:
      type: object
      description: 현금영수증 발행·취소 처리 상태
      properties:
        clientReferenceId:
          type: string
          description: 요청자 관리번호(Bolta-Client-Reference-Id)
        issuanceKey:
          $ref: '#/components/schemas/CashReceiptIssuanceKey'
        type:
          type: string
          description: '요청 유형. ISSUE: 발행, CANCELLATION: 취소'
          enum:
            - ISSUE
            - CANCELLATION
        status:
          type: string
          description: >
            처리 상태. `PENDING`·`REQUEST_SUCCESS`는 처리 중, `ISSUED`·`CANCELED`는 성공,
            `REQUEST_FAILURE`·`ISSUE_FAILED`·`CANCEL_FAILED`는 실패입니다.
            `EXTERNALLY_CANCELED`는 볼타 외부에서 취소된 종료 상태입니다.
          enum:
            - PENDING
            - REQUEST_SUCCESS
            - REQUEST_FAILURE
            - ISSUED
            - ISSUE_FAILED
            - CANCELED
            - CANCEL_FAILED
            - EXTERNALLY_CANCELED
        originalIssuanceKey:
          description: 취소 요청의 원본 발행 식별 키
          anyOf:
            - $ref: '#/components/schemas/CashReceiptIssuanceKey'
            - type: 'null'
        cashReceiptApprovalNumber:
          type:
            - string
            - 'null'
          description: 발행 성공 시 제공하는 현금영수증 승인번호
        failure:
          description: 실패 상태일 때 제공하는 실패 사유
          anyOf:
            - type: object
              properties:
                code:
                  type: string
                  description: 실패 코드
                message:
                  type: string
                  description: 실패 사유 설명
              required:
                - code
                - message
            - type: 'null'
        message:
          type: string
          description: 처리 상태 메시지
      required:
        - clientReferenceId
        - issuanceKey
        - type
        - status
        - message
    ErrorResponse:
      type: object
      description: API 요청 실패 시 반환되는 에러 응답
      properties:
        code:
          type: string
          description: 에러 타입 식별자
        message:
          type: string
          description: 에러 설명
      required:
        - code
        - message
    CashReceiptIssuanceKey:
      type: string
      description: 현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으므로 문자열 전체를 그대로 저장하세요.
      examples:
        - MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

````