메인 콘텐츠로 건너뛰기
SaaS 구독, 월간 서비스 등 정기 결제가 발생할 때 세금계산서를 자동으로 발행하는 시나리오입니다.

워크플로우

공동인증서 등록

정발행을 위해 자사의 공동인증서를 등록합니다. 볼타 웹에서 직접 등록하거나, 인증서 등록 URL 조회 API로 등록 URL을 발급받을 수 있습니다.

정기 발행 실행

결제 스케줄러가 트리거되면 정발행 API를 호출하여 세금계산서를 발행합니다. Client-Reference-Id 헤더를 활용하면 중복 발행을 방지할 수 있습니다. 자세한 내용은 인증 가이드를 참고하세요.

발행 완료 웹훅 수신

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

발행 완료 이메일

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

세금계산서 조회 (선택)

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

적합한 경우

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

구현 팁

  • 결제 시스템의 스케줄러와 연동하여 결제 완료 시 자동 발행
  • Client-Reference-Id에 결제 ID를 사용하면 멱등성 보장과 추적이 용이
  • 발행 실패 웹훅 수신 시 재시도 로직 구현 권장