Bulk 대량발행

POPBiLL 대량발행 성능비교

Bulk 대량발행 API는 한번의 요청에 최대 100건의 발행을 접수하는 API 입니다. 단건 발행 API로 다량의 요청을 처리하는 경우 발생하는 네트워크 통신 오버헤드, Transaction Delay의 개선과 다량의 요청에 최적화된 처리응답을 제공하는 API 입니다. 접수 이후에는 단건 발행 프로세스와 동일하게 처리되며 상태정보, 거래처 휴폐업여부, 국세청 전송결과는 Webhook 또는 API (Polling) 를 통해 확인할 수 있습니다.

  • Webhook
  • API (Polling)

대량발행 프로세스 - Webhook

① 대량발행 접수

ㆍ 팝빌 SDK에 구현된 BulkSubmit API로 대량발행을 접수를 요청합니다. [참고] BulkSubmit

ㆍ 접수 요청을 식별하기 위해 제출아이디(SubmitID-최대 36자) 고유값을 할당하여 대량발행 접수 API를 요청합니다.

ㆍ 접수 요청에 사용된 제출아이디(SubmitID)는 재사용할 수 없습니다.

② Webhook 이벤트 메시지 수신

ㆍ 고객사에서 지정한 콜백 URL로 메시지를 수신하여 대량발행 처리상태, 거래처 휴폐업상태, 국세청 전송결과를 반영합니다.

ㆍ Webhook 메시지에 포함된 유형(Type) 항목을 통해 처리유형을 구분할 수 있습니다.

ㆍ "BULKRESULT" : 전자세금계산서 발행처리 결과코드(발행성공 또는 오류코드)와 국세청 승인번호를 전송합니다.

ㆍ "CLOSEDOWN" : 거래처 휴폐업상태 정보를 전송합니다.

ㆍ "NTS" : 국세청 전송결과(전송성공-304, 전송실패-305)를 나타내는 상태코드를 전송합니다.

POPBiLL 대량 발행 프로세스 흐름도 Webhook 버전

ㆍ 고객사에서 지정한 URL로 메시지를 수신하여 대량발행 처리상태, 거래처 휴폐업정보, 국세청 전송결과를 확인합니다.

ㆍ API Polling 방식에서 발생하는 불필요한 네트워크 트래픽 및 리소스의 부담을 줄일 수 있습니다.

대량발행 프로세스 - API

① 대량발행 접수

ㆍ 팝빌 SDK에 구현된 BulkSubmit API로 대량발행을 접수를 요청합니다. [참고] BulkSubmit

ㆍ 접수 요청을 식별하기 위해 제출아이디(SubmitID-최대 36자) 고유값을 할당하여 대량발행 접수 API를 요청합니다.

ㆍ 접수 요청에 사용된 제출아이디(SubmitID)는 재사용할 수 없습니다.

② 대량발행 접수 처리결과 확인

ㆍ GetBulkResult API로 대량발행 접수 처리결과를 확인합니다.[참고] GetBulkResult

ㆍ 대량발행 접수건의 상태가 대기/처리중(txState=0/1)인 경우, 2~5초 간격으로 API 사용하여 처리완료(txState=2)를 확인합니다.

ㆍ 처리완료(txState=2) 응답시 issueList 항목에 배열형태의 전자세금계산서 처리결과(발행성공 또는 오류코드)를 확인합니다.

③ 국세청 전송결과 확인

ㆍ 전자세금계산서 다수건 상태 확인(GetInfos-최대 1000건) API로 국세청 전송성공/실패 상태코드를 확인합니다.[참고] GetInfos

ㆍ 발행일 기준 다음영업일 오후 3시에 국세청 전송이 시작됩니다. 전송결과 응답은 평균 15분이 소요됩니다.

POPBiLL 대량 발행 프로세스 흐름도 API 버전

ㆍ 대량발행 처리결과를 확인하기 위해 API로 발행상태, 거래처 휴폐업정보, 국세청 전송결과를 확인합니다.

ㆍ Webhook 수신서버 운영이 불가하거나 네트워크 보안정책상 Inbound Traffic이 허용되지 않는 경우 API를 구현할 수 있습니다.

식별번호 관리체계

관리 항목 변수명 길이 비고
고객사 제출아이디 submitID 36 대량발행 접수를 식별하기 위해 고객사에서 할당한 고유번호
└ 영문, 숫자, '-', '_' 이용 가능
공급자 문서번호 invoicerMgtKey 24 고객사에서 세금계산서에 할당한 고유번호 (정발행시 기재)
└ 영문, 숫자, '-', '_' 이용 가능
수탁자 문서번호 trusteeMgtKey 24 고객사에서 세금계산서에 할당한 고유번호 (위수탁발행시 기재)
└ 영문, 숫자, '-', '_' 이용 가능
팝빌 접수 아이디 receiptID 24 대량발행 접수건의 식별을 위해 팝빌에서 할당한 고유번호
※ 대량발행 접수와 동시에 할당
국세청 승인번호 ntsConfirmNum 24 국세청 신고를 위해 팝빌에서 할당한 고유번호
※ 세금계산서 발행과 동시에 할당

기술지원센터

팝빌 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.

T. 1600-9854   E. code@linkhubcorp.com

연동문의