Bulk Issuance - Bulk API
The Bulk API proceeds the issuance for a submission consisted of maximum 100 tax invoices. By calling a Bulk API, it can reduce the processing time into 1/40 of the original time required when using [RegistIssue - Issue an e-Tax invoice] API with polling method.
POPBiLL recommends using Bulk API for the case of issuing over 10,000 invoices at once.
Bulk API vs Single API
| Bulk Submission Processing Time | Number of Issued e-Tax Invoices | Single Submission Processing + Issuance |
|---|---|---|
| 0.4 minute | 10K | 0.67 hour |
| 4 minutes | 100K | 7 hours |
| 10 minutes | 250K | 16 hours |
| 20 minutes | 500K | 1 day and 4 hours |
| 45 minutes | 1000K | 2 days and 8 hours |
| *Issuance is processed via B/G process, and it takes (submission registration time *2.5) amount of time. |
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 submitID(submission ID) by the partner and each e-Tax invoice within a submission is assigned with an invoicerMgtKey(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 distinguish Bulk submission
allowed to use alphabets, numbers, ‘-’, ‘_’
|
| Seller’s Document ID | invoicerMgtKey | 24 |
Document ID that is generated via general issuance process
allowed to use alphabets, numbers, ‘-’, ‘_’
|
|
| POPBiLL | Submission Registration ID | receiptID | 24 | Concurrently generates with the Bulk submission registration process |
| NTS Confirmation Number | ntsConfirmNum | 24 | POPBiLL generates this value as the result of the issuance |
"NTS confirmation number" is the unique value for NTS reporting that is automatically assigned by POPBiLL system.
Status Check
POPBiLL provides two different methods to check the status of the e-Tax invoices 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) : program provider receives a real-time event message for any status change of an e-Tax invoice via designated callback URL
- API(Polling) : program provider manually checks the status by repeatedly requesting the API
