bolta-open-api
전자(세금)계산서 발행 API 연동 사례
Copy Page
bolta-open-api
볼타 전자(세금)계산서 API 문서
가이드
API 키
요청·응답 본문
방화벽 및 보안 프로토콜
웹훅(Webhook) 연결하기
공동인증서 등록 Redirect 정책
전자(세금)계산서 발행마감일 정책
요청자 관리번호 지정하기 / Client-Reference-Id
전자(세금)계산서 발행 API 연동 사례
연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
API 문서
전자(세금)계산서 정발행
전자(세금)계산서 정발행 - Bulk
전자(세금)계산서 정발행
전자(세금)계산서 수정발행
전자(세금)계산서 수정발행 - 계약의 해제
전자(세금)계산서 수정발행 - 공급가액 변동
전자(세금)계산서 역발행
전자(세금)계산서 역발행
전자(세금)계산서 역발행 - 승인 URL 조회
전자(세금)계산서 역발행 - 요청 취소
고객
고객 생성
고객 공동인증서 등록 URL 조회
고객 공동인증서 등록 내역 조회
고객 공동인증서 등록해제
고객 조회
전자(세금)계산서 조회
전자(세금)계산서 내용 조회
전자(세금)계산서 요청자 관리번호 이용하여 조회
SDK
SDK: Zapier
SDK: Make
에러 코드
전자(세금)계산서 발행 API
전자(세금)계산서 발행 웹훅
고객 생성 API
공통 에러
Schemas
Request
Model
전자세금계산서 공급자
전자세금계산서 공급받는자
전자세금계산서 품목
전자세금계산서 발행 요청
공급자 생성 요청
Response
Field
IssuanceKey
발행상태
ClientKey
Webhook
웹훅 메시지
Common
Field
날짜(yyyy-MM-dd)
이메일
사업자등록번호
주소
대표자명
종목
업태
상호명
발행목적
종사업장번호
전자세금계산서 담당자
고객(Customer)
전자(세금)계산서 발행 API 연동 사례
Copy Page
연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
B2B 매출을 거래 어드민으로 관리하고, 그에 대한 세금계산서를 발행하는 경우 API를 사용하는 방법입니다.
1
고객 생성
볼타 전자세금계산서 발행 API를 이용하기 위해서는 고객(Customer)을 생성해야 합니다. 연동하시는 회사 정보로 생성해주세요. 고객 생성 시 발급되는
CustomerKey
는 볼타에서 고객을 식별하는데 이용되니 꼭 별도로 저장해주세요.
2
공동인증서 등록
세금계산서를 발행하기 위해서는 공동인증서를 등록하여야 합니다.
볼타 웹 서비스
에서 인증서를 등록해주세요.
고객 공동인증서 등록 URL 조회
API 를 이용하실 수도 있습니다.
3
전자세금계산서 발행
공동인증서가 등록되었다면
전자세금계산서 발행
API를 이용하실 수 있습니다. 공동인증서가 미등록/만료/폐기된 상태라면 에러가 발생합니다.
4
전자세금계산서 발행 상태 변경 웹훅 발송
전자세금계산서 발행은 국세청의 처리 속도에 따라 다소 시간이 소요될 수 있습니다. 처리 결과 성공/실패에 따른 상태를 별도로 제공해주신 웹훅으로 전송해드립니다. 자세한 내용은
전자세금계산서 발행 상태 변경 웹훅
에서 확인 해주세요.
Previous
연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
Next
전자(세금)계산서 정발행 - Bulk