Bulk 발행
Bulk 발행은 한번의 호출로 100건의 전자세금계산서를 일괄 접수하는 초대량 Bulk API로 처리 가능합니다. 단건 발행 API를 다량으로 호출하는 경우 발생하는 네트워크 통신 오버헤드, Transaction Delay 개선하여 초대량 발행에 최적화된 처리응답을 제공합니다.
발행 효율성을 높이기 위해 1만건 이상의 세금계산서 일괄 발행 시 Bulk API 이용을 권장합니다.
Bulk 발행 vs 단건 발행
단건 발행은 세금계산서의 접수와 발행을 동기식으로 일괄 처리하여 발행에 대한 결과를 즉시 수신합니다. Bulk 발행은 접수와 발행 단계를 분리하여 접수만을 선행적으로 일괄 처리한 이후 비동기식으로 발행 처리합니다.
구분 | 난이도 | 처리방식 | 호출건수(1회) | 호출횟수 | 처리시간 (접수+발행) |
|
Bulk 발행 | 높음 | 비동기식 [요청1→요청2→…응답1→응답2…] | 100건 | 1,000회 | 10분 | |
단건 발행 | 낮음 | 동기식 [요청1→응답1→요청2→응답2…] | 1건 | 100,000회 | 7시간 | |
※ 산출된 데이터와 도식은 전자세금계산서 10만건 발행 기준으로 제공되었습니다. |

처리속도
구분 | 1만 | 10만 | 25만 | 50만 | 100만 |
Bulk 발행 | 50초 | 8.3분 | 20.8분 | 41.7분 | 83.3분 |
단건 발행 | 33분 | 330분 | 825분 | 1,628분 | 3,306분 |
접수
프로그램 공급사는 접수 단계만을 처리하며, 접수된 세금계산서에 대한 발행 및 국세청 전송은 팝빌이 비동기식으로 처리합니다. [Bulksubmit–대량발행 접수] 상세보기
접수/문서번호 관리체계
세금계산서 중복 발행을 방지하고자 프로그램 공급사가 직접 구성하여 할당하는 고유번호 입니다. Bulk 접수 건과 세금계산서 문서 단위로 접수번호와 문서번호를 각각 할당하며, 한번 사용된 접수/문서번호는 재사용이 불가합니다.
관리주체 | 유형 | 변수명 | 길이 | 필수 | 비고 |
프로그램 공급사 | 접수번호 | submitID | 36 | O |
Bulk 발행 접수 건을 식별하기 위한 고유번호
└ 영문, 숫자, '-', '_' 이용 가능 |
공급자 문서번호 | invoicerMgtKey | 24 | △ |
정발행 프로세스에서 할당
└ 영문, 숫자, '-', '_' 이용 가능 |
|
수탁자 문서번호 | trusteeMgtKey | 24 | △ |
위수탁발행 프로세스에서 할당
└ 영문, 숫자, '-', '_' 이용 가능 |
|
팝빌 | 접수아이디 | receiptID | 24 | O | Bulk 발행 접수와 동시에 생성 |
국세청 승인번호 | ntsConfirmNum | 24 | O | 전자세금계산서 발행과 동시에 생성 |
"국세청 승인번호"는 세금계산서의 국세청 신고를 위해 팝빌이 구성하여 할당하며, 세금계산서 식별 값으로 이용됩니다.
상태확인
팝빌에서 처리된 전자세금계산서 상태 확인을 위해 아래 2가지 방법을 지원합니다. 대량 건의 상태확인이 필요한 Bulk 발행의 경우 프로세스 효율성을 높이는 'Webhook' 방식을 권장합니다.
- API(Polling) : 프로그램 공급사가 직접 API를 호출하여 수동으로 상태 확인
- Webhook : 사전에 등록한 콜백 URL로 상태변경 이벤트 발생 시점에 팝빌 전달한 실시간 메시지를 수신하여 확인 [Webhook] 상세보기