발행

1. RegistIssue - 승인 현금영수증 발행

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

def registIssue(corpNum, cashbill, memo = '', userID = '', emailSubject = '')

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

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	cashbill	Cashbill	-	Y	현금영수증 정보
Cashbill 순번 변수명 타입 길이 필수 설명 1 mgtKey String 24 Y 문서번호 → 문서 관리를 위해 파트너가 할당하는 식별번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 2 orgConfirmNum String 9 조건부 당초 국세청승인번호 → 취소 현금영수증 작성시 필수 3 orgTradeDate String 8 조건부 당초 거래일자 → 취소 현금영수증 작성시 필수 4 tradeType String 4 Y 문서형태 (택 1) 승인거래 취소거래 5 tradeUsage String - Y 거래구분 (택 1) 소득공제용 지출증빙용 6 tradeOpt String 4 N 거래유형 일반 기본값 도서공연 대중교통 → 도서공연 : 도서, 공연, 박물관, 미술관, 수영장, 체력단련장, 신문구독료(종이신문), 영화관람료 7 taxationType String - Y 과세형태 (택 1) 과세 비과세 8 totalAmount String 9 Y 거래금액 (공급가액+부가세+봉사료) → 양수만 입력 9 supplyCost String 9 Y 공급가액 → 양수만 입력 10 tax String 9 Y 부가세 → 양수 또는 0 입력 11 serviceFee String 9 Y 봉사료 → 양수 또는 0 입력 12 franchiseCorpNum String 10 Y 가맹점 사업자번호 → 팝빌회원 사업자번호 ('-' 제외) 13 franchiseTaxRegID String 4 N 가맹점 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 14 franchiseCorpName String 200 N 가맹점 상호 15 franchiseCEOName String 100 N 가맹점 대표자 성명 16 franchiseAddr String 400 N 가맹점 주소 17 franchiseTEL String 20 N 가맹점 전화번호 18 identityNum String 19 Y 식별번호 → {tradeUsage} 값이 "소득공제용" 경우 주민등록/휴대폰/카드번호/자진발급용 번호(010-000-1234) 입력 {tradeUsage} 값이 "지출증빙용" 경우 사업자번호/휴대폰/카드번호 입력 주민등록번호 13자리, 휴대폰번호 10~11자리, 카드번호 13~19자리, 사업자번호 10자리 입력 가능 19 customerName String 70 N 구매자(고객) 성명 20 itemName String 70 N 주문 상품명 21 orderNumber String 200 N 주문번호 22 email String 100 N 구매자(고객) 메일 23 hp String 20 N 구매자(고객) 휴대폰 24 smssendYN Boolean - N 구매자 알림문자 전송 여부 true 전송 false 미전송 : 기본값 → 수신자 : 구매자 휴대폰번호 {hp} 문자 전송 포인트가 차감(단, 전송실패 건은 환불) 25 cancelType Integer 1 N 취소사유 1 거래취소 : 기본값 2 오류발급취소 3 기타 → {tradeType}="취소거래" 경우 입력 26 memo String 200 N 현금영수증 상태 이력을 관리하기 위한 메모 → 대량(Bulk)발행 경우 사용 27 emailSubject String 300 N 현금영수증 발행 안내메일 제목 ※ 기본값 : 팝빌에서 설정한 안내메일 제목
3	memo	String	200	Y	현금영수증 상태 이력을 관리하기 위한 메모
4	userID	String	50	N	팝빌회원 아이디
5	emailSubject	String	300	N	현금영수증 발행 안내메일 제목 ※ 기본값 : 팝빌에서 설정한 안내메일 제목 사용

응답

IssueResponse

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	confirmNum	String	9	국세청승인번호 → 현금영수증 발행 시점에 팝빌에서 자동으로 할당
4	tradeDate	String	8	거래일자 → 현금영수증 발행 시점에 팝빌에서 자동으로 할당 형식 : yyyyMMdd

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

2. RevokeRegistIssue - 취소 현금영수증 발행

당초 승인 현금영수증의 취소거래 발행 API 입니다.

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

def revokeRegistIssue(corpNum, mgtKey, orgConfirmNum, orgTradeDate, smssendYN = false, memo = "", userID = "", isPartCancel = false, cancelType = nil, supplyCost = nil, tax = nil, serviceFee = nil, totalAmount = nil)

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

요청

Parameters

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

응답

IssueResponse

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	confirmNum	String	9	국세청승인번호 → 현금영수증 발행 시점에 팝빌에서 자동으로 할당
4	tradeDate	String	8	거래일자 → 현금영수증 발행 시점에 팝빌에서 자동으로 할당 형식 : yyyyMMdd

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

3. Delete - 삭제

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

def delete(corpNum, mgtKey, userID = '')

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

요청

Parameters

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

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지