Certificate Management
1. GetTaxCertURL - URL to register the certificate
- This API returns the URL to register a certificate for issuance on POPBiLL authentication server.
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getTaxCertURL(String CorpNum, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|
| UserID | String | 50 | N | User’s POPBiLL ID |
Return
String - Response URL for a request
Throws
PopbillException
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - |
API response code
8 digits code that starts with (‘-’) [Error Code]
|
|
| message | String | - | Error message for any failed API process |
2. GetCertificateExpireDate - Check the expiration date of a certificate
- This API checks the expiration date of a certificate that is registered on POPBiLL authentication server.
Date getCertificateExpireDate(String CorpNum) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
Return
Date - Expiration date of a certificate (format : yyyyMMdd)
Throws
PopbillException
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - |
API response code
8 digits code that starts with (‘-’) [Error Code]
|
|
| message | String | - | Error message for any failed API process |
3. CheckCertValidation - Validate the certificate
- This API validates the certificate registered on POPBiLL authentication server.
Response checkCertValidation(String CorpNum) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
Return
Response
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - | API response code | |
| message | String | - | API response message |
Throws
PopbillException
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - |
API response code
8 digits code that starts with (‘-’) [Error Code]
|
|
| message | String | - | Error message for any failed API process |
4. GetTaxCertInfo - Check the information of a certificate
- This API checks the information of a certificate registered on POPBiLL authentication server.
TaxinvoiceCertificate GetTaxCertInfo(String CorpNum, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|
| UserID | String | 50 | N | User’s POPBiLL ID |
Return
TaxinvoiceCertificate
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| regDT | String | 14 |
Date and time of the certificate registration
format : yyyyMMddHHmmss
|
|
| expireDT | String | 14 |
Date and time of the expiration of the registered certificate
format : yyyyMMddHHmmss
|
|
| issuerDN | String | 200 | DN of the certificate issuer | |
| subjectDN | String | 200 | DN of the registered certificate | |
| issuerName | String | 12 |
Type of certificate
전자세금용 공동인증서 joint certificate for issuing e-Tax invoices
팝빌 특목용 공동인증서 POPBiLL special purpose joint certificate
기타 others
|
|
| oid | String | 30 | OID | |
| regContactName | String | 100 |
Name of the person in charge of certificate registration
a person who registered the joint certificate within POPBiLL authentication server
|
|
| regContactID | String | 50 |
ID of the person in charge of certificate registration
a person who registered the joint certificate within POPBiLL authentication server
|
Throws
PopbillException
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - |
API response code
8 digits code that starts with (‘-’) [Error Code]
|
|
| message | String | - | Error message for any failed API process |