POPBill Developers
API Reference

1. 현금영수증 발행

1.1. RegistIssue - 즉시 발행

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

IssueResponse

Throws

PopbillException

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

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

IssueResponse

Throws

PopbillException

1.3. BulkSubmit - 초대량 발행 접수

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

BulkResponse

Throws

PopbillException

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

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

BulkCashbillResult

Throws

PopbillException

1.5. Delete - 삭제

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

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

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

Response

Throws

PopbillException