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