인증서 관리

1. GetTaxCertURL - 인증서 등록 팝업 URL

미리보기

공동인증서를 등록하는 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 1,000px / height = 630px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

function string getTaxCertURL(string corpnum, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디

응답

string - 요청에 대한 응답 URL

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

2. GetCertificateExpireDate - 인증서 만료일 확인

팝빌 인증서버에 등록된 공동인증서의 만료일을 확인합니다.

function string getcertificateexpiredate(string corpnum) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)

응답

string - 인증서 만료일자 (형식 : yyyyMMdd)

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

3. CheckCertValidation - 인증서 유효성 확인

팝빌 인증서버에 등록된 공동인증서의 유효성을 확인합니다.

function response checkcertvalidation(string corpnum, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

4. GetTaxCertInfo - 인증서 정보 확인

팝빌 인증서버에 등록된 공동인증서의 정보를 확인합니다.

function taxinvoicecertificate getTaxCertInfo (string corpnum, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디

응답

TaxinvoiceCertificate

순번	변수명	타입	길이	설명
1	regDT	string	14	등록일시 → 형식 : yyyyMMddHHmmss 인증서를 팝빌 인증서버에 등록한 시간
2	expireDT	string	14	만료일시 → 형식 : yyyyMMddHHmmss 팝빌 인증서버에 등록된 인증서의 만료일시
3	issuerDN	string	200	발급자 DN
4	subjectDN	string	200	인증서 DN
5	issuerName	string	12	인증서 종류 전자세금용 공동인증서 팝빌 특목용 공동인증서 기타
6	OID	string	30	OID
7	regContactName	string	100	등록 담당자 성명 → 팝빌 인증서버에 인증서를 등록한 담당자 성명
8	regContactID	string	50	등록 담당자 아이디 → 팝빌 인증서버에 인증서를 등록한 담당자 팝빌회원 아이디

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지