워크플로우
발급자 등록
발급자 등록 API로 자사를 등록하고
issuerId를 저장합니다.공동인증서 등록
정발행에 사용할 자사의 공동인증서를 등록합니다. 볼타 웹에서 직접 등록하거나,
issuerId로 인증서 등록 URL 조회 API를 호출할 수 있습니다.발행 완료 웹훅 수신
발행이 완료되면 웹훅으로
taxInvoiceUrl이 포함된 알림이 전송됩니다.발행 완료 이메일
구독자에게 세금계산서 수신 안내 이메일이 자동 발송됩니다.
세금계산서 조회 (선택)
세금계산서 조회 API 또는 관리번호 조회 API로 발행 결과를 확인합니다.
적합한 경우
- SaaS 구독 서비스에서 월/연 단위로 자동 청구하는 경우
- 정기 납품, 유지보수 계약 등 반복 거래가 발생하는 경우
- 스케줄러 기반 자동 발행이 필요한 경우
구현 팁
- 결제 시스템의 스케줄러와 연동하여 결제 완료 시 자동 발행
Client-Reference-Id에 결제 ID를 사용하면 멱등성 보장과 추적이 용이- 발행 실패 웹훅 수신 시 재시도 로직 구현 권장