JAVA - Spring MVC SDK 적용방법 | 링크허브 개발가이드

[JAVA – Spring MVC] SDK 적용방법

2019.04.04

본 개발가이드는 팝빌에서 제공하는 전자세금계산서 API, 전자명세서 API, 현금영수증 API, 문자 API, 팩스 API, 휴폐업조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 전자세금계산서 API 예제를 통해 ‘SDK 이용방법’과 ‘상업용 환경설정’ 방법을 상세히 안내드립니다.

JAVA Spring MVC 기반으로 제작
Java JDK v1.6 최적화
API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용

1. SDK 이용방법 안내

SDK를 이용하기 위해서는 API 상품 라이브러리 추가를 위한 ‘Maven 업데이트’ 와 통신전문 보안에 사용되는 ‘인증정보 설정’ 이 필요합니다. 다음의 설명에 따라 SDK를 이용하시기 바랍니다.

Maven 업데이트

예제 프로젝트에 팝빌 라이브러리를 추가하기 위해서 “pom.xml” 파일에 다음의 코드가 추가되어 있는지 확인하고 SDK 샘플 프로젝트의 Maven 업데이트를 진행합니다. Maven 업데이트 이후 샘플 파일의 한글이 깨지는 현상이 발생하는 경우, 해당 파일의 Character-Set을 ‘UTF-8’로 변경하시기 바랍니다.


<!-- Popbill SDK -->
	<dependency>
		<groupId>kr.co.linkhub</groupId>
		<artifactId>popbill-sdk</artifactId>
		<version>1.19.0</version>
	</dependency>

120

121

122

123

124

125

126

127

<groupId>kr.co.linkhub</groupId>

<artifactId>popbill-sdk</artifactId>

</dependency>

인증정보 설정

Maven 업데이트 완료 후 “servlet-context.xml” 파일에 사업자번호(TestCorpNum)와 회원아이디(TestUserID)를 테스트 개발환경(https://test.popbill.com) 가입시 기재한 정보로 수정하고 링크아이디(LinkID)와 비밀키(SecretKey)를 링크허브 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정이 완료됩니다.

[참고] 팝빌 테스트용 연동회원 가입절차 안내 [http://test.popbill.com] [바로가기]


<util:properties id="EXAMPLE_CONFIG">
	<beans:prop key="TestCorpNum">1234567890</beans:prop>
	<beans:prop key="TestUserID">testkorea</beans:prop>
	<beans:prop key="LinkID">TESTER</beans:prop>
	<beans:prop key="SecretKey">3v5o87sx07SrQ1ao1207YKZT+Fcil9OkYPPYpbFslj8=</beans:prop>
	<beans:prop key="IsTest">true</beans:prop>
</util:properties>

<util:properties id="EXAMPLE_CONFIG">

<beans:prop key="TestCorpNum">1234567890</beans:prop>

<beans:prop key="TestUserID">testkorea</beans:prop>

<beans:prop key="LinkID">TESTER</beans:prop>

<beans:prop key="SecretKey">3v5o87sx07SrQ1ao1207YKZT+Fcil9OkYPPYpbFslj8=</beans:prop>

<beans:prop key="IsTest">true</beans:prop>

</util:properties>

▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)

1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]

2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]

2. 상업용 환경설정

테스트 완료 후 연동환경을 상업용으로 설정하기 위해서는 “servlet-context.xml” 파일의 IsTest Property값을 “false” 로 처리하면 상업용 연동환경 설정이 완료됩니다.


	<!-- 
		LinkID : 링크허브에서 발급받은 파트너 링크아이디.
		SecretKey : 링크허브에서 발급받는 비밀키.
		IsTest : true이면 test.popbill.com으로 연결, 기본값은 false. 
	-->
	<util:properties id="EXAMPLE_CONFIG">
		<beans:prop key="TestCorpNum">1234567890</beans:prop>
		<beans:prop key="TestUserID">testkorea</beans:prop>
		<beans:prop key="LinkID">TESTER</beans:prop>
		<beans:prop key="SecretKey">3v5o87sx07SrQ1ao1207YKZT+Fcil9OkYPPYpbFslj8=</beans:prop>
		<beans:prop key="IsTest">false</beans:prop>
		
	</util:properties>