인증서 관리

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

미리보기

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

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

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. RegistTaxCert - 인증서 등록

• 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록합니다.
• 공동인증서는 팝빌에서 발급하는 ‘표준 인증서’, 은행에서 발급하는 ‘전자세금용 인증서’ 또는 ‘기업범용 인증서’만 등록 가능합니다.

Response RegistTaxCert(String CorpNum, String CertPublicKey, String CertPrivateKey, String CertCipher, String UserID) throws PopbillException

공동인증서 정보는 통신 구간의 보안을 위해 필드 레벨 암호화(FLE)되어 처리됩니다.
※ 통신구간 암호화 키 발급은 파트너 센터(1600-8536)로 문의하여 주시기 바랍니다.
공동인증서 비밀번호의 안전한 관리를 위해 DB 저장시 컬럼 암호화 하여 저장합니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	CertPublicKey	String	-	Y	공동인증서 공개키 → Base64 Encoded
3	CertPrivateKey	String	-	Y	공동인증서 개인키 → Base64 Encoded
4	CertCipher	String	-	Y	공동인증서 비밀번호
5	UserID	String	50	N	팝빌회원 아이디

응답

Response

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

예외

PopbillException

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

3. RegistTaxCertPFX - PFX 인증서 등록

• 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록합니다.
• 공동인증서는 팝빌에서 발급하는 ‘표준 인증서’, 은행에서 발급하는 ‘전자세금용 인증서’ 또는 ‘기업범용 인증서’만 등록 가능합니다.

Response RegistTaxCertPFX(String CorpNum, String PFX, String Password, String UserID) throws PopbillException

공동인증서 정보는 통신 구간의 보안을 위해 필드 레벨 암호화(FLE)되어 처리됩니다.
※ 통신구간 암호화 키 발급은 파트너 센터(1600-8536)로 문의하여 주시기 바랍니다.
공동인증서 비밀번호의 안전한 관리를 위해 DB 저장시 컬럼 암호화 하여 저장합니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	PFX	String	-	Y	공동인증서 PFX 파일 → Base64 Encoded
3	Password	String	-	Y	공동인증서 PFX 파일 비밀번호
4	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. GetCertificateExpireDate - 인증서 만료일 확인

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

Date getCertificateExpireDate(String CorpNum, String UserID) throws PopbillException

요청

Parameters

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

응답

Date - 공동인증서 만료일자

예외

PopbillException

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

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

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

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 처리 실패에 대한 오류메시지

6. GetTaxCertInfo - 인증서 정보 확인

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

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 처리 실패에 대한 오류메시지