연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우

계약 관리 플랫폼, 건물 관리 플랫폼 등 플랫폼에서 해당 플랫폼의 고객이 생성한 계약과 거래에 대한 세금계산서를 발행하는 워크로드에서 API를 사용하는 방법입니다.

고객 생성

볼타 전자세금계산서 발행 API를 이용하기 위해서는 고객(Customer)을 생성해야 합니다. 이는 파트너사의 고객을 의미합니다. 고객 생성 시 발급되는 CustomerKey는 볼타에서 고객을 식별하는데 이용되니 꼭 별도로 저장해주세요.

고객 공동인증서 등록

생성된 고객의 공동인증서를 등록하여야 합니다. CustomerKey와 함께 고객 공동인증서 등록 URL 조회 API를 호출하면 5분간 접근 가능한 URL이 제공됩니다. 해당 URL을 새 탭으로 열어 인증서를 받아주세요.

전자세금계산서 발행

인증서까지 등록 완료되었다면 전자세금계산서 발행 API를 이용하실 수 있습니다. 유효하지 않은 고객이거나 고객의 공동인증서가 미등록/만료/폐기된 상태라면 에러가 발생합니다.

전자세금계산서 발행 상태 변경 웹훅 발송

전자세금계산서 발행은 국세청의 처리 속도에 따라 다소 시간이 소요될 수 있습니다. 처리 결과 성공/실패에 따른 상태를 별도로 제공해주신 웹훅으로 전송해드립니다. 자세한 내용은 전자세금계산서 발행 상태 변경 웹훅에서 확인 해주세요.