POPBill Developers
가이드

대량발행 - Bulk API

Bulk API는 한 번 호출로 최대 100건의 현금영수증을 일괄처리 함으로써, 한 건씩 반복하여 처리할 때 발생하는 오버헤드를 최소화합니다. 또한 발행을 팝빌에서 B/G 프로세스로 처리하여 발행 소요시간을 기존 대비 1/40 수준으로 단축할 수 있습니다.

팝빌에서는 동시에 1만건 이상 현금영수증을 발행하는 경우 Bulk API 이용을 권장합니다.

Bulk API vs Single API

Bulk 발행과 단건 발행의 처리방식 비교
Bulk API - 접수 발행건수 Single API - 접수+발행
0.18분 1만 0.39시간
1.8분 10만 4시간
4.5분 25만 9.4시간
9.2분 50만 19시간
18.3분 100만 1일 15시간
*발행은 팝빌 B/G 프로세스로 처리되며 (접수시간*2.5) 소요됩니다.
GroupBulk API

API 1회 호출로 다수 가맹점의 현금영수증을 한꺼번에 발행하기 위해서는 GroupBulk API 이용을 권장합니다. 단, GroupBulk API 이용은 팝빌과 사전협의가 필요합니다.

대량발행 프로세스

프로그램 공급사는 접수 단계만을 처리하며, 접수된 현금영수증에 대한 발행 및 국세청 전송은 팝빌이 비동기식으로 처리합니다. [BulkSubmit - 대량발행 접수]

문서번호 관리체계

문서번호란 현금영수증 중복 발행을 방지하고자 프로그램 공급사가 직접 생성하여 할당하는 고유번호 입니다. Bulk 접수 단위로 접수번호를 할당하고, Bulk에 포함된 개별 현금영수증 단위로 문서번호를 할당합니다. 단, 한번 사용된 접수번호는 재사용이 불가합니다.

관리주체 유형 변수명 길이 설명
프로그램 공급사 제출아이디 submitID 36 접수 시점에 고객사에서 할당한 제출아이디
공급자 문서번호 mgtKey 24 문서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
팝빌 접수아이디 receiptID 24 접수 시점에 팝빌에서 자동으로 할당
국세청 승인번호 confirmNum 24 현금영수증 발행 시점에 팝빌에서 자동으로 할당
동일한 국세청 승인번호가 존재합니다. 중복하여 할당이 가능한가요?

같은 거래일자에는 국세청 승인번호를 중복하여 할당하지 않으며, 다른 거래 일자에는 동일한 국세청 승인번호로 할당될 수 있습니다.

상태확인

팝빌 Bulk API로 발행된 현금영수증 상태 확인을 위해 2가지 방법을 지원합니다. Bulk API는 팝빌이 처리한 B/G 프로세스의 처리결과가 비동기로 응답되기 때문에 상태 변경시점에 동기식으로 확인 가능한 'Webhook' 방식을 권장합니다.

  • Webhook(Push) : 팝빌에서 상태가 변경된 시점에 실시간으로 프로그램 공급사가 지정한 Callback URL 서버로 이벤트 전달 [Webhook]
  • API(Polling) : 프로그램 공급사가 주기적으로 API를 호출하여 상태 확인