발행유형

팝빌 현금영수증은 모든 발행유형(승인/취소 발행)을 지원하며, 필요한 발행 유형만 선택하여 연동할 수 있습니다.

현금거래에 대한 증빙으로, 가맹점이 구매자의 식별번호(휴대폰번호, 카드번호, 사업자번호 등)를 기준으로 현금영수증을 발행하는 유형입니다.

구분	식별번호	설명
소득공제용	휴대폰번호 / 주민등록번호 / 신용카드 또는 현금영수증 카드번호	구매자가 개인인 경우 (자진발급 가능)
지출증빙용	휴대폰번호 / 사업자번호 / 신용카드 또는 현금영수증 카드번호	구매자가 사업자인 경우

자진발급

구매자가 현금영수증 발급을 거부하거나, 구매자의 식별번호를 확인할 수 없는 경우 발행하는 현금영수증입니다.
이 때, 국세청이 지정한 대표번호(010-000-1234)를 사용하여 소득공제용으로만 발행할 수 있습니다.

팝빌에 저장과 동시에 발행하여 현금영수증을 처리합니다. [RegistIssue - 즉시 발행]
가맹점이 기재사항을 작성하여 발행한 현금영수증은 팝빌이 자동으로 국세청 전송 처리합니다.

문서번호란 현금영수증의 중복 발행을 방지하고 내부 관리를 위해 프로그램 공급사가 직접 생성하여 할당하는 고유번호 입니다.

관리주체	유형	변수명	길이	설명
프로그램 공급사	문서번호	mgtKey	24	문서 관리를 위해 파트너가 할당하는 식별번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
팝빌	국세청승인번호	confirmNum	9	현금영수증 발행 시점에 팝빌에서 자동으로 할당

동일한 국세청승인번호가 존재합니다. 중복하여 할당이 가능한가요?

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

팝빌에서 처리된 현금영수증 상태 확인을 위해 아래 2가지 방법을 지원합니다.

Webhook(Push)
팝빌에서 현금영수증 상태가 변경된 시점에 프로그램 공급사가 지정한 Callback URL로 이벤트 전송 [Webhook]
API(Polling)
프로그램 공급사가 주기적으로 API를 호출하여 상태 확인

발행된 현금영수증의 전체 또는 부분 현금거래를 취소하기 위해 발행하는 유형입니다. 단, 취소 금액의 합은 승인 현금영수증의 금액을 초과할 수 없습니다.

당초 승인 현금영수증의 '거래일자'와 '국세청승인번호'를 이용하여 전체 또는 부분 취소 현금영수증을 발행합니다.
부분 취소의 경우 '부분 취소 거래금액' 입력이 필요합니다. [RevokeRegistIssue - 취소 현금영수증 즉시 발행]

IsPartCancel(취소유형) 값을 false(전체 취소)로 설정하고, 부분취소 금액을 입력하는 경우 어떻게 처리되나요?

IsPartCancel이 false로 설정된 경우에는, 부분 취소 금액을 입력하더라도 전체 취소로만 처리됩니다.
부분 취소의 경우에는 취소 유형을 반드시 true(부분 취소)로 설정하고 부분 취소 금액을 입력하여 주시기 바랍니다.

문서번호란 현금영수증의 중복 발행을 방지하고 내부 관리를 위해 프로그램 공급사가 직접 생성하여 할당하는 고유번호 입니다.

관리주체	유형	변수명	길이	설명
프로그램 공급사	문서번호	mgtKey	24	문서 관리를 위해 파트너가 할당하는 식별번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
팝빌	국세청승인번호	confirmNum	9	현금영수증 발행 시점에 팝빌에서 자동으로 할당

동일한 국세청승인번호가 존재합니다. 중복하여 할당이 가능한가요?

국세청승인번호는 같은 거래일자 내에서는 에 중복하여 할당되지 않지만, 거래일자가 다른 경우 동일한 국세청승인번호가 할당될 수 있습니다.
따라서 국세청승인번호와 거래일자를 함께 확인하여 고유값(Unique Value)으로 관리해야 합니다.

팝빌에서 처리된 현금영수증 상태 확인을 위해 아래 2가지 방법을 지원합니다.

Webhook(Push)
팝빌에서 현금영수증 상태가 변경된 시점에 프로그램 공급사가 지정한 Callback URL로 이벤트 전송 [Webhook]
API(Polling)
프로그램 공급사가 주기적으로 API를 호출하여 상태 확인