Bulk Issuance - Bulk API
The Bulk API proceeds the issuance for a submission consisted of maximum 100 cash receipts. By calling a Bulk API, it can reduce the processing time into 1/40 of the original time required when using [RegistIssue -Issue a cash receipt] API with polling method
POPBiLL recommends using Bulk API for the case of issuing over 10,000 cash receipt at once.
Bulk API vs Single API
| Bulk Submission Processing Time | Number of Issued Cash Receipts | Single Submission Processing + Issuance |
|---|---|---|
| 0.18 minute | 10K | 0.39 hour |
| 1.8 minutes | 100K | 4 hours |
| 4.5 minutes | 250K | 9.4 hours |
| 9.2 minutes | 500K | 19 hours |
| 18.3 minutes | 1000K | 1 day and 15 hours |
| *Issuance is proceeded as B/G process, and it takes (submission registration time *2.5) amount of time. |
While the general BulkAPI can issue the cash receipts of one seller, GroupBulk can issue the cash receipts of multiple sellers with a single API call. When using this function, the sellers must be registered as POPBiLL users, and it is required to have a prior consultation with POPBiLL to use this type of API.
Bulk Issuance Process
A partner/program provider is required to implement the submission process only and the rest of the issuance and NTS filing process will be asynchronously proceeded via POPBiLL server.
Document ID Management System
Document ID is a unique identification number that is generated by the partner/program provider. Each Bulk submission is assigned with a submission number and each cash receipt within a submission is assigned with a document ID. The assigned filing number cannot be reused.
| Subject of Management | Type | Field | Length | Description |
|---|---|---|---|---|
| Program Provider | Submission ID | submitID | 36 |
Unique identification number to identify Bulk submission
allowed to use alphabets, numbers, ‘-’, ‘_’
|
| Seller’s Document ID | mgtKey | 24 |
Unique identification number to identify each cash receipt
allowed to use alphabets, numbers, ‘-’, ‘_’
|
|
| POPBiLL | Submission Registration ID | receiptID | 24 | Concurrently generates with the Bulk submission registration process |
| NTS Confirmation Number | confirmNum | 24 | Concurrently generates with the issuance of the cash receipt |
To identify a cash receipt, you must use the combination of “date of trade” and "NTS confirmation number" as the unique identification value.
Status Check
POPBiLL provides two different methods to check the status of the cash receipts that are issued via POPBiLL Bulk API. The ‘Webhook’ method is recommended for Bulk API to automatically checks the status as the Bulk processing result is asynchronously responded.
- Webhook(Push) : POPBiLL provides two different methods to check the status of the cash receipts that are issued via POPBiLL Bulk API. The ‘Webhook’ method is recommended for Bulk API to automatically checks the status as the Bulk processing result is asynchronously responded.
- API(Polling) : program provider manually checks the status by repeatedly requesting the API
