View/Print
1. GetPopUpURL - URL to view the e-Tax invoice
- This API returns the URL to view a single e-Tax invoice on POPBiLL service website.
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getPopUpURL(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKey | String | 24 | Y | Document ID | |||||||||||
| 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. GetViewURL - URL to view the e-Tax invoice [without menus/buttons]
- This API returns the URL to view a single e-Tax invoice on POPBiLL service website (showing a page without menus and buttons).
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getViewURL(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKey | String | 24 | Y | Document ID | |||||||||||
| 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 |
3. GetPrintURL - URL to print the e-Tax invoice [for seller/buyer]
- This API returns the URL to print a single e-Tax invoice. A user can select a print option – for seller/buyer/both.
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getPrintURL(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKey | String | 24 | Y | Document ID | |||||||||||
| 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 |
4. GetEPrintURL - URL to print the e-Tax invoice [for buyer]
- This API returns the URL to print a single e-Tax invoice for buyer.
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getEPrintURL(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKey | String | 24 | Y | Document ID | |||||||||||
| 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 |
5. GetMassPrintURL - URL to print e-Tax invoices in bulk
- This API returns the URL to print multiple e-Tax invoices in bulk. (Maximum : 100 invoices)
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getMassPrintURL(String CorpNum, MgtKeyType KeyType, String[] MgtKeyList, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKeyList | String[ ] | Y |
List of Document ID of e-Tax invoices to print
maximum 100 invoices
|
||||||||||||
| 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 |
6. GetMailURL - URL for the e-Tax invoice notification mail button
- This API returns the URL to view a single e-Tax invoice via confirmation button located on the bottom of a notification mail.
- Returned URL has no limit on valid time.
String getMailURL(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillException- A buyer can click the confirmation button to notify the seller for checking the invoice.
Parameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKey | String | 24 | Y | Document ID | |||||||||||
| 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 |
7. GetPDFURL - URL to download the e-Tax invoice in PDF format
- This API returns the URL to download an e-Tax invoice in PDF format.
- Returned URL is valid for 30 seconds and after that you cannot access to the page.
String getPDFURL(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
Parameters
| No. | Field | Type | Length | Mandatory | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CorpNum | String | 10 | Y |
Business registration number
10-digits except (‘-’)
|
|||||||||||
| KeyType | MgtKeyType | - | Y |
Type of the e-Tax invoice
SELL sales
|
|||||||||||
|
MgtKeyType
|
|||||||||||||||
| MgtKey | String | 24 | Y | Document ID | |||||||||||
| 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 |