POPBill Developers
API Reference

1. 현금영수증 발행

1.1. RegistIssue - 즉시 발행

def registIssue(corpNum, cashbill, memo = '', userID = '', emailSubject = '')
  • 현금영수증 자진발급분은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
  • 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
cashbill Cashbill - Y 현금영수증 객체정보
memo String 200 Y 현금영수증 상태 이력을 관리하기 위한 메모
userID String 50 N 팝빌회원 아이디
emailSubject String 300 N 현금영수증 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
Return

IssueResponse

Throws

PopbillException

1.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
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
mgtKey String 24 Y 파트너가 할당한 문서번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
orgConfirmNum String 9 Y 당초 승인 현금영수증의 국세청승인번호
CashbillInfo의 {confirmNum} 통해 내용 확인 가능
orgTradeDate String 8 Y 당초 승인 현금영수증의 거래일자
CashbillInfo의 변수 '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 조건부 부분 취소 공급가액
tax String 9 조건부 부분 취소 부가세
serviceFee String 9 조건부 부분 취소 봉사료
totalAmount String 9 조건부 부분 취소 거래금액
거래금액 = 공급가액+부가세+봉사료
Return

IssueResponse

Throws

PopbillException

1.3. Delete - 삭제

  • 삭제 가능한 상태의 현금영수증을 삭제합니다.

    ※ 삭제 가능한 상태: "전송실패"

def delete(corpNum, mgtKey, userID = '')
  • 삭제처리된 현금영수증의 문서번호는 재사용이 가능합니다.
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
mgtKey String 24 Y 파트너가 할당한 문서번호
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException