본문으로 바로가기
링크허브 공식블로그

연동이 쉬워진다

링크허브 공식블로그

가치를 연결하다/튜토리얼

[Java - JSP] 팝빌 전자세금계산서 API 연동 가이드

안녕하세요. 고객의 가치를 연결하는 비즈니스 파트너 링크허브 입니다.


본 포스팅에서는 JAVA - JSP 개발환경에서 고객사들이 팝빌 전자세금계산서 API SDK를 쉽고 빠르게 이용할 수 있도록, 예시를 이용하여 연동 설정 방법을 안내드리겠습니다. 먼저, SDK를 추가한 후 "즉시발행(RegistIssue) API"를 구현하는 순서로 진행하겠습니다. 

팝빌 SDK는 JDK v1.6 이상 개발환경에서 이용 가능하며, API 호출과 응답의 메시지 인코딩은 "UTF-8 Character-Set"을 지원합니다.


"팝빌은 링크허브에서 자체 개발하고 직접 운영하는 전자세금계산서 서비스 Brand Name 입니다."



아래 설명하는 예시는 [ CentOS 6.8 | Tomcat7 | JDK 1.6 ] 기준으로 작성되어 있어, 이용 중이신 개발환경과 차이가 있을 수 있는 점 감안해 주시기 바랍니다.



1. 전자세금계산서 SDK 추가 


① 링크허브 연동자료실에서 JAVA - JSP 전자세금계산서 SDK를 다운로드 후 압축을 해제합니다. 


[참고] JAVA - JSP 전자세금계산서 SDK 다운로드 - https://www.linkhub.co.kr/Downloads/Taxinvoice/95?PageNum=1



② SDK내에 포함되어 있는 다음 3개 jar파일을 복사합니다. 



③ 웹서버 기본 디렉토리에 "$CATALINA_HOME/webapps/ROOT/common.jsp" 환경설정을 위한 파일을 생성하고 세금계산서 인스턴스, 인증정보(LinkID, SecretKey)연동환경 설정값(IsTest)을 선언합니다.


<%-- 세금계산서 인스턴스 생성 --%>

<jsp:useBean id="taxinvoiceService" scope="application" class="com.popbill.api.taxinvoice.TaxinvoiceServiceImp"/>


<%-- 링크허브에서 발급받은 인증정보 링크아이디(LinkID), 비밀키(SecretKey) 입력 --%>

<jsp:setProperty name="taxinvoiceService" property="linkID" value="TESTID"/>

<jsp:setProperty name="taxinvoiceService" property="secretKey" value="SwWxqU+0TExEXy/9TVjKPExI2VTUMMSLZtJf3Ed8q3I="/>


<%-- 연동환경 설정값, true-개발용(테스트베드), false-상업용(실서비스) --%>

<jsp:setProperty name="taxinvoiceService" property="test" value="true"/>


▶ 링크허브에서 발급받은 고객사 인증정보로 링크아이디(LinkID)와 비밀키(SecretKey) 값을 변경하시기 바랍니다.



2. API 구현


① RegistIssue API를 호출하는 "$CATALINA_HOME/webapps/ROOT/registIssue.jsp" 파일을 생성하고, 세금계산서를 발행하기 위해 RegistIssue API를 작성합니다.



※ 전자세금계산서 발행(전자서명)을 위해서는 사전에 공급자의 인증서가 팝빌 개발용(https://test.popbill.com) 사이트에 등록되어 있어야 합니다.

[참고] 전자세금계산서 발행을 위한 공인인증서 등록방법 안내 - https://linkhub.tistory.com/95



② 브라우저에서 registIssue.jsp 페이지를 로드하여 RegistIssue API가 정상적으로 처리 되었음을 메시지를 통해 확인합니다.



③ 발행된 전자세금계산서는 팝빌 개발용(test.popbill.com) 사이트에서 확인할 수 있습니다.

[참고] 팝빌 연동 개발을 위한 테스트베드(개발용) 안내 - https://linkhub.tistory.com/91


팝빌에서 제공하는 다양한 API는 동일한 컨셉으로 개발되어 있어, 하나의 서비스를 이용한 경험이 있으면 다른 서비스들도 유사한 방법으로 빠르게 연동이 가능하니 많은 이용 부탁드립니다. 


지금까지 JAVA - JSP 개발환경에서 전자세금계산서 API를 연동하는 방법에 대해 안내드렸는데, 내용에 대한 추가적인 문의가 있으면 기술지원센터로 편하게 연락주시기 바랍니다.




고객사의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락 주시기 바랍니다.

기술지원센터 / T. 1600-9854 / E. code@linkhub.co.kr








  • Today
  • Total