1. 현금영수증 발행

1.1. RegistIssue - 즉시 발행

작성된 현금영수증 데이터를 팝빌에 저장과 동시에 발행하여 "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책

Function RegistIssue(CorpNum As String, Cashbill As PBCashbill, Optional UserID As String = "", Optional emailSubject As String = "") As PBResponse

현금영수증 자진발급분은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
Cashbill	PBCashbill	-	Y	현금영수증 객체정보
UserID	String	50	N	팝빌회원 아이디
emailSubject	String	300	N	현금영수증 발행 안내메일 제목 기본값 : 팝빌에서 설정한 안내메일 제목 사용

Return

PBResponse

Throws

Err

1.2. RevokeRegistIssue - 취소 현금영수증 즉시 발행

당초 승인 현금영수증의 취소거래 발행 API 입니다.
작성된 취소 현금영수증 데이터를 팝빌에 저장과 동시에 발행하여 "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책
부분 취소 현금영수증을 발행하는 경우 'IsPartCancel' 값을 true 로 설정하여 주시기 바랍니다.
당초 국세청승인번호와 거래일자는 [GetInfo – 상태확인]함수를 통해 확인 가능합니다.

Function RevokeRegistIssue(CorpNum As String, mgtKey As String, orgConfirmNum As String, orgTradeDate As String, Optional smssendYN As Boolean = False, Optional memo As String = "", Optional UserID As String = "", Optional isPartCancel As Boolean = False, Optional cancelType As Integer = 0, Optional supplyCost As String = "", Optional tax As String = "", Optional serviceFee As String = "", Optional totalAmount As String = "", Optional emailSubject As String = "", Optional tradeDT As String = "") As PBResponse

유의사항

당초 승인 현금영수증의 거래일시보다 과거의 거래일시를 입력할 수 없습니다.
취소 현금영수증의 거래금액의 합은 당초 승인 현금영수증의 거래금액을 넘을 수 없습니다.
취소 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
mgtKey	String	24	Y	파트너가 할당한 문서번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
orgConfirmNum	String	9	Y	당초 국세청승인번호 PBCbInfo의 {confirmNum} 통해 내용 확인 가능
orgTradeDate	String	8	Y	당초 거래일자 PBCbInfo의 변수 'tradeDate'를 통해 내용 확인 가능 형식 : yyyyMMdd
smssendYN	Boolean	-	N	현금영수증 발행시 알림문자 전송여부 true전송 false미전송 : 기본값 당초 승인 현금영수증의 구매자(고객)의 휴대폰번호 문자 전송
memo	String	200	N	현금영수증 상태 이력을 관리하기 위한 메모
UserID	String	50	N	팝빌회원 아이디
isPartCancel	Boolean	-	N	현금영수증 취소유형 True부분 취소 False전체 취소 : 기본값
cancelType	Integer	1	N	현금영수증 취소사유 1거래취소 : 기본값 2오류발급취소 3기타
supplyCost	String	9	조건부	부분 취소 공급가액 양수만 입력 {isPartCancel}=true 경우 필수
tax	String	9	조건부	부분 취소 부가세 양수 또는 0 입력 {isPartCancel}=true 경우 필수
serviceFee	String	9	조건부	부분 취소 봉사료 양수 또는 0 입력 {isPartCancel}=true 경우 필수
totalAmount	String	9	조건부	부분 취소 거래금액 양수만 입력 거래금액 = 공급가액 + 부가세 + 봉사료 {isPartCancel}=true 경우 필수
emailSubject	String	300	N	현금영수증 발행 안내메일 제목 기본값 : 팝빌에서 설정한 안내메일 제목 사용
tradeDT	String	14	N	거래일시 전일부터 당일까지 입력 가능 형식 : yyyyMMddHHmmss 기본값 : 발행일시 사용

Return

PBResponse

Throws

Err

1.3. BulkSubmit - 초대량 발행 접수

최대 100건의 현금영수증 발행을 한번의 요청으로 접수합니다.

Function BulkSubmit(CorpNum As String, submitID As String, cashbillList As Collection, Optional UserID As String = "") As PBBulkResponse

현금영수증 자진발급분은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
SubmitID	String	36	Y	제출아이디 영문, 숫자, '-' 조합으로 구성
cashbillList	Collection of PBCashbill		Y	현금영수증 객체정보 목록 최대 : 100건
UserID	String	50	N	팝빌회원 아이디

Return

PBBulkResponse

Throws

Err

1.4. GetBulkResult - 초대량 접수결과 확인

접수시 기재한 SubmitID를 사용하여 현금영수증 접수결과를 확인합니다.
개별 현금영수증 처리상태는 접수상태(txState)가 완료(2) 시 반환됩니다.

Function GetBulkResult(CorpNum As String, submitID As String, Optional UserID As String = "") As PBBulkCashbillResult

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
SubmitID	String	36	Y	초대량 발행 접수시 기재한 제출아이디
UserID	String	50	N	팝빌회원 아이디

Return

PBBulkCashbillResult

Throws

Err

1.5. Delete - 삭제

삭제 가능한 상태의 현금영수증을 삭제합니다.
※ 삭제 가능한 상태: "전송실패"

Function Delete(CorpNum As String, mgtKey As String, Optional UserID As String = "") As PBResponse

삭제처리된 현금영수증의 문서번호는 재사용이 가능합니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
mgtKey	String	24	Y	파트너가 할당한 문서번호
UserID	String	50	N	팝빌회원 아이디

Return

PBResponse

Throws

Err