워크플로우
발급자 등록
발급자 등록 API를 호출하여 공급자를 발급자로 등록합니다.
역발행 요청
역발행 API를 호출합니다. 승인 요청 메일을 받을 주소는 요청 본문의
supplier.manager.email에 입력하세요.승인 요청 이메일 발송
볼타가 승인 요청 메일을 발송합니다. 공급자는 이메일 링크를 열어 볼타에서 승인합니다.
공급자 승인
공급자가 이메일 링크를 통해 볼타에 접속하여 세금계산서를 승인합니다.
발행 완료 웹훅 수신
승인이 완료되면 웹훅으로
taxInvoiceUrl이 포함된 알림이 전송됩니다.세금계산서 조회 (선택)
세금계산서 조회 API로 발행 결과를 확인합니다.
중복 요청 처리
역발행 요청에 선택형Bolta-Client-Reference-Id 헤더를 추가할 수 있습니다. 1~255자의 비어 있지 않은 값을 입력하고, 발행 요청마다 사용하지 않은 값을 쓰세요.
같은 API 키에서 이미 사용한 값을 다시 보내면 요청 본문이 같아도 API가 HTTP 400과 INVALID_REQUEST를 반환합니다. 응답을 받지 못했다면 역발행을 다시 요청하지 말고 관리번호 조회 API로 접수 결과를 확인하세요. 자세한 규칙은 인증 가이드를 참고하세요.
역발행 요청 취소
승인 전이라면 요청 취소 API를 호출하여 역발행 요청을 취소할 수 있습니다.- 정상 취소 시 HTTP 200과 함께 응답이 반환됩니다.
- 이미 승인/취소/발행된 경우에는 에러가 반환됩니다.
적합한 경우
- 공급자의 인증서를 사전에 확보하기 어려운 경우
- 공급자가 이메일로 간편하게 승인하길 원하는 경우
- 플랫폼이 승인 UI를 직접 구현할 필요 없이 볼타에 위임하는 경우