Skip to main content
SaaS 구독, 월간 서비스 등 정기 결제가 발생할 때 세금계산서를 자동으로 발행하는 시나리오입니다.

​
워크플로우

발급자 등록

발급자 등록 API로 자사를 등록하고 issuerId를 저장합니다.

공동인증서 등록

정발행에 사용할 자사의 공동인증서를 등록합니다. 볼타 웹에서 직접 등록하거나, issuerId로 인증서 등록 URL 조회 API를 호출할 수 있습니다.

정기 발행 실행

결제 스케줄러가 트리거되면 정발행 API를 호출합니다. Bolta-Client-Reference-Id에 결제 ID와 시도 번호를 조합해 넣으면 같은 발행 시도의 중복 요청을 막고 처리 상태를 추적합니다. 요청자 관리번호는 인증 가이드를 참고하세요.

발행 완료 웹훅 수신

발행이 완료되면 볼타가 웹훅으로 taxInvoiceUrl이 담긴 알림을 보냅니다.

발행 완료 이메일

볼타가 구독자에게 세금계산서 수신 안내 이메일을 자동으로 보냅니다.

세금계산서 조회 (선택)

세금계산서 조회 API 또는 관리번호 조회 API로 발행 결과를 확인합니다.

​
적합한 경우

  • SaaS 구독 서비스에서 월/연 단위로 자동 청구하는 경우
  • 정기 납품, 유지보수 계약 등 반복 거래가 발생하는 경우
  • 스케줄러 기반 자동 발행이 필요한 경우

​
구현 팁

  • 결제 시스템의 스케줄러와 연동하여 결제 완료 시 자동 발행
  • 응답을 받지 못한 경우 같은 요청을 다시 보내지 않고 관리번호 조회 API로 접수 결과 확인
  • 발행 실패 웹훅을 받은 뒤 새 발행을 요청할 때는 새 Bolta-Client-Reference-Id 사용