bolta-open-api
  1. 가이드
bolta-open-api
  • 볼타 전자(세금)계산서 API 문서
  • 가이드
    • API 키
    • 요청·응답 본문
    • 방화벽 및 보안 프로토콜
    • 웹훅(Webhook) 연결하기
    • 공동인증서 등록 Redirect 정책
    • 전자(세금)계산서 발행마감일 정책
    • 요청자 관리번호 지정하기 / Client-Reference-Id
  • 전자(세금)계산서 발행 API 연동 사례
    • 연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
    • 연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
  • API 문서
    • 전자(세금)계산서 정발행
      • 전자(세금)계산서 정발행
    • 전자(세금)계산서 역발행
      • 전자(세금)계산서 역발행
      • 전자(세금)계산서 역발행 - 승인 URL 조회
      • 전자(세금)계산서 역발행 - 요청 취소
    • 전자(세금)계산서 수정발행
      • 전자(세금)계산서 수정발행 - 계약의 해제
      • 전자(세금)계산서 수정발행 - 공급가액 변동
    • 전자(세금)계산서 조회
      • 전자(세금)계산서 국세청승인번호 조회
      • 전자(세금)계산서 요청자 관리번호 이용하여 조회
    • 고객
      • 고객 생성
      • 고객 공동인증서 등록 URL 조회
      • 고객 공동인증서 등록해제
      • 고객 조회
  • SDK
    • SDK: Zapier
    • SDK: Make
  • 에러 코드
    • 전자(세금)계산서 발행 API
    • 전자(세금)계산서 발행 웹훅
    • 고객 생성 API
    • 공통 에러
  1. 가이드

요청자 관리번호 지정하기 / Client-Reference-Id

요청자 관리번호는 왜 사용되나요?#

각 요청을 처리하는데 있어서 볼타에서 채번하는 관리번호가 있어요. 하지만, 이 관리번호는 요청이 정상적으로 접수·처리되어야만 얻을 수 있는 값이에요.
외부 API를 호출한다고 하면 다양한 상황이 발생할 수 있어요. 대표적으로는 네트워크 오류로 타임아웃이 발생하는 경우가 있을 수 있어요. 이 경우에는 해당 요청이 실패했다고 확신하기 어려워요. 이 상황에서 요청을 한번 더 보내면 요청이 중복으로 처리될 수 있는거죠.
이런 경우, 즉 나의 요청이 고유하게 처리되게 하기 위하여 사용하는게 요청자 관리번호에요.

요청 관리번호는 어떻게 사용하나요?#

현재는 아래 API에 대하여 요청자 관리번호를 지원하고 있어요.
전자(세금)계산서 정발행
전자(세금)계산서 수정발행 - 계약의 해제
전자(세금)계산서 수정발행 - 공급가액 변동
위 API를 호출하실 때, HTTP Request Header에 아래 값을 전달하시면 돼요.
...
Bolta-Client-Reference-Id: ABC_123
...
Client-Reference-Id는 API Key 단위로 고유해요. 동일한 API Key에서 같은 Client-Reference-Id 값을 전달하면 HTTP Status Code 400 응답이 내려가요.
Modified at 2025-10-16 06:00:01
Previous
전자(세금)계산서 발행마감일 정책
Next
연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
Built with