POPBill Developers
API Reference

1. 현금영수증 발행

1.1. RegistIssue - 즉시 발행

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

IssueResponse

Throws

PopbillException

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

  • 작성된 취소 현금영수증 데이터를 팝빌에 저장과 동시에 발행하여 "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책
  • 취소 현금영수증의 금액은 원본 금액을 넘을 수 없습니다.
  • 원본 현금영수증의 거래일시보다 과거의 거래일시를 입력할 수 없습니다.
def revokeRegistIssue(CorpNum, mgtKey, orgConfirmNum, orgTradeDate, smssendYN=False, memo=None, UserID=None, isPartCancel=False, cancelType=None, supplyCost=None, tax=None, serviceFee=None, totalAmount=None, emailSubject=None, tradeDT=None):
  • 원본 현금영수증의 국세청 승인번호와 거래일자는 [GetInfo – 상태확인]함수를 통해 확인 가능합니다.
  • 취소 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
순번변수명타입길이필수설명
CorpNum str 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
mgtKey str 24 Y 파트너가 할당한 문서번호
※ 영문, 숫자, 하이픈('-')을 이용하여 24자리 이하의 고유한 값 할당
orgConfirmNum str 9 Y 원본 현금영수증의 국세청 승인번호
CashbillInfo의 변수 'confirmNum'를 통해 내용 확인 가능
orgTradeDate str 8 Y 원본 현금영수증의 거래일자 (형식 : yyyyMMdd)
CashbillInfo의 변수 'tradeDate'를 통해 내용 확인 가능
smssendYN bool - N 현금영수증 발행시 알림문자 전송여부 : True / False 중 택 1
└ True : 전송
└ False : 미전송
└ 원본 현금영수증의 구매자(고객)의 휴대폰번호 문자 전송
memo str 200 N 현금영수증 상태 이력을 관리하기 위한 메모
UserID str 50 N 팝빌회원 아이디
isPartCancel bool - 조건부 현금영수증 취소유형 : True / False 중 택 1
└ True : 부분 취소
└ False : 전체 취소
※ 미입력시 기본값 False 처리
cancelType int 1 N 현금영수증 취소사유 : 1 / 2 / 3 중 택 1
└ 1 : 거래취소
└ 2 : 오류발급취소
└ 3 : 기타
※ 미입력시 기본값 1 처리
supplyCost str 9 조건부 공급가액
└ {isPartCancel} 값이 True 인 경우 취소할 공급가액 입력
└ {isPartCancel} 값이 False 인 경우 미입력
tax str 9 조건부 부가세
└ {isPartCancel} 값이 True 인 경우 취소할 부가세 입력
└ {isPartCancel} 값이 False 인 경우 미입력
serviceFee str 9 조건부 봉사료
└ {isPartCancel} 값이 True 인 경우 취소할 봉사료 입력
└ {isPartCancel} 값이 False 인 경우 미입력
totalAmount str 9 조건부 거래금액 (공급가액+부가세+봉사료)
└ {isPartCancel} 값이 True 인 경우 취소할 거래금액 입력
└ {isPartCancel} 값이 False 인 경우 미입력
emailSubject str 300 N 현금영수증 발행 안내메일 제목
※ 미입력시 팝빌에서 설정한 기본값 사용
tradeDT str 14 N 거래일시 (형식 : yyyyMMddHHmmss)
└ 전날부터 당일까지 입력가능
※ 미입력시 기본값 발행일시 처리
Return

IssueResponse

Throws

PopbillException

1.3. BulkSubmit - 초대량 발행 접수

  • 최대 100건의 현금영수증 발행을 한번의 요청으로 접수합니다.
def bulkSubmit(self, CorpNum, SubmitID, cashbillList, UserID=None):
  • 현금영수증 자진발급분은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
  • 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
순번변수명타입길이필수설명
CorpNum str 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
SubmitID str 36 Y 제출아이디
└ 영문, 숫자, '-' 조합으로 구성
cashbillList Cashbill[ ] Y 현금영수증 객체정보 목록 (최대 100건)
UserID str 50 N 팝빌회원 아이디
Return

BulkResponse

Throws

PopbillException

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

  • 접수시 기재한 SubmitID를 사용하여 현금영수증 접수결과를 확인합니다.
  • 개별 현금영수증 처리상태는 접수상태(txState)가 완료(2) 시 반환됩니다.
def getBulkResult(self, CorpNum, SubmitID, UserID=None):
Parameters
순번변수명타입길이필수설명
CorpNum str 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
SubmitID str 36 Y 초대량 발행 접수시 기재한 제출아이디
UserID str 50 N 팝빌회원 아이디
Return

BulkCashbillResult

Throws

PopbillException

1.5. Delete - 삭제

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

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

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

Response

Throws

PopbillException