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

​
워크플로우

발급자 등록

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

공동인증서 등록

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

정기 발행 실행

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

발행 완료 웹훅 수신

발행이 완료되면 웹훅으로 taxInvoiceUrl이 포함된 알림이 전송됩니다.

발행 완료 이메일

구독자에게 세금계산서 수신 안내 이메일이 자동 발송됩니다.

세금계산서 조회 (선택)

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

​
적합한 경우

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

​
구현 팁

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