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

연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우

계약 관리 플랫폼, 건물 관리 플랫폼 등 플랫폼에서 해당 플랫폼의 고객이 생성한 계약과 거래에 대한 세금계산서를 발행하는 워크로드에서 API를 사용하는 방법입니다.
1
고객 생성
볼타 전자세금계산서 발행 API를 이용하기 위해서는 고객(Customer)을 생성해야 합니다. 이는 파트너사의 고객을 의미합니다. 고객 생성 시 발급되는 CustomerKey는 볼타에서 고객을 식별하는데 이용되니 꼭 별도로 저장해주세요.
2
고객 공동인증서 등록
생성된 고객의 공동인증서를 등록하여야 합니다. CustomerKey와 함께 고객 공동인증서 등록 URL 조회 API를 호출하면 5분간 접근 가능한 URL이 제공됩니다. 해당 URL을 새 탭으로 열어 인증서를 받아주세요.
3
전자세금계산서 발행
인증서까지 등록 완료되었다면 전자세금계산서 발행 API를 이용하실 수 있습니다. 유효하지 않은 고객이거나 고객의 공동인증서가 미등록/만료/폐기된 상태라면 에러가 발생합니다.
4
전자세금계산서 발행 상태 변경 웹훅 발송
전자세금계산서 발행은 국세청의 처리 속도에 따라 다소 시간이 소요될 수 있습니다. 처리 결과 성공/실패에 따른 상태를 별도로 제공해주신 웹훅으로 전송해드립니다. 자세한 내용은 전자세금계산서 발행 상태 변경 웹훅에서 확인 해주세요.
Previous
전자(세금)계산서 발행마감일 정책
Next
연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
Built with