워크플로우
발급자 등록
발급자 등록 API를 호출하여 공급자를 발급자로 등록하고
issuerId를 저장합니다.인증서 등록 URL 발급
issuerId로 인증서 등록 URL 조회 API를 호출하여 공급자가 인증서를 등록할 수 있는 URL을 발급받습니다.공급자 인증서 등록
공급자가 발급받은 URL에 직접 접속해 공동인증서를 등록합니다. 등록 완료 후 리다이렉트 복귀와 결과 확인은 인증서 등록 연동을 참고하세요.
역발행 요청
역발행 API를 호출합니다.
승인 URL 획득
승인 URL 조회 API를 호출하여 승인 페이지 URL을 발급받습니다. 생성된 URL은 10분간 유효합니다.
간편 승인
공급자가 승인 URL에 접속하여 세금계산서를 승인합니다. 플랫폼에서 새 탭 열기나 페이지 이동으로 URL을 보여 주세요.
발행 완료 웹훅 수신
승인이 완료되면 볼타가 웹훅으로
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를 호출하세요.
적합한 경우
- 플랫폼 UX 안에서 승인 프로세스를 완결하고 싶은 경우
- 공급자가 이미 인증서를 등록한 상태인 경우
- 플랫폼에서 승인 상태를 직접 추적해야 하는 경우