5. 인증서 관리
5.1. GetTaxCertURL - 인증서 등록 팝업 URL
- 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록하기 위한 페이지의 팝업 URL을 반환합니다.
- 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
String getTaxCertURL(String CorpNum, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
5.2. RegistTaxCert - 인증서 등록
- 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록합니다.
- 공동인증서는 팝빌에서 발급하는 '표준 인증서', 은행에서 발급하는 '전자세금용 인증서' 또는 '기업범용 인증서'만 등록 가능합니다.
-
공동인증서 정보는 통신 구간의 보안을 위해 필드 레벨 암호화(FLE)되어 처리됩니다.
※ 통신구간 암호화 키 발급은 파트너 센터(1600-8536)로 문의하여 주시기 바랍니다.
- 공동인증서 비밀번호의 안전한 관리를 위해 DB 저장시 컬럼 암호화 하여 저장합니다.
Response RegistTaxCert(String CorpNum, String CertPublicKey, String CertPrivateKey, String CertCipher, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| CertPublicKey | String | - | Y |
공동인증서 공개키
Base64 Encoded
|
|
| CertPrivateKey | String | - | Y |
공동인증서 개인키
Base64 Encoded
|
|
| CertCipher | String | - | Y | 공동인증서 비밀번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
5.3. RegistTaxCertPFX - PFX 인증서 등록
- 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록합니다.
- 공동인증서는 팝빌에서 발급하는 '표준 인증서', 은행에서 발급하는 '전자세금용 인증서' 또는 '기업범용 인증서'만 등록 가능합니다.
-
공동인증서 정보는 통신 구간의 보안을 위해 필드 레벨 암호화(FLE)되어 처리됩니다.
※ 통신구간 암호화 키 발급은 파트너 센터(1600-8536)로 문의하여 주시기 바랍니다.
- 공동인증서 비밀번호의 안전한 관리를 위해 DB 저장시 컬럼 암호화 하여 저장합니다.
Response RegistTaxCertPFX(String CorpNum, String PFX, String Password, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| PFX | String | - | Y |
공동인증서 PFX 파일
Base64 Encoded
|
|
| Password | String | - | Y | 공동인증서 PFX 파일 비밀번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
5.4. GetCertificateExpireDate - 인증서 만료일 확인
- 팝빌 인증서버에 등록된 공동인증서의 만료일을 확인합니다.
Date getCertificateExpireDate(String CorpNum, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Date - 공동인증서 만료일자 (형식 : yyyyMMdd)
Throws
5.5. CheckCertValidation - 인증서 유효성 확인
- 팝빌 인증서버에 등록된 공동인증서의 유효성을 확인합니다.
Response checkCertValidation(String CorpNum, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
5.6. GetTaxCertInfo - 인증서 정보 확인
- 팝빌 인증서버에 등록된 공동인증서의 정보를 확인합니다.
TaxinvoiceCertificate GetTaxCertInfo(String CorpNum, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | String | 50 | N | 팝빌회원 아이디 |