튜토리얼
PowerBuilder 개발환경에서 팝빌 SDK를 추가하여 현금영수증 즉시 발행 (RegistIssue) 함수를 구현하는 예시입니다.
1. POPBiLL SDK 추가
① 팝빌 연동자료실에서 PowerBuilder SDK 예제코드 다운로드 후 압축을 해제합니다.
② 압축해제한 SDK 예제코드에서 linkhub.pbl, popbill.pbl 파일을 기존 프로젝트 폴더로 복사하고 Library List에 추가합니다.

2. POPBiLL SDK 설정
Window 폼의 Declare Instance Variables 탭에 API Key 와 클래스를 선언하고 open() 함수에 클래스 초기화 코드를 추가합니다.
Declare Instance Variables 탭
// 링크아이디
in_cashbillservice.linkid = in_linkid
// 비밀키
in_cashbillservice.secretkey = in_secretkey
// 현금영수증 서비스 객체 선언
cashbillservice in_cashbillservice
Window Form Open() 함수
3. RegistIssue 기능 구현
Form에 버튼을 생성하고 버튼의 Click Event 코드에 현금영수증 즉시 발행 (RegistIssue) 기능을 추가합니다.
cashbill l_cashbill
response l_response
string mgtKey, corpNum
// 팝빌회원 사업자번호, "-" 제외
corpNum = "1234567890"
// 문서번호
// 문서 관리를 위해 파트너가 할당하는 식별번호
// 1~24자리 영문 대소문자, 숫자, 특수문자('-','_')로 구성
mgtKey = "20250314-001"
// 문서번호, 가맹점별 고유번호 할당 1~24자리 영문, 숫자조합으로 중복없이 구성
l_cashbill.mgtkey = mgtKey
// 거래일시, 형식(yyyyMMddHHmmss)
// 발행기준 전일부터 당일까지 입력 가능
// 미입력시 기본값(발행일시) 처리됨
l_cashbill.tradeDT = "20250319093919"
// 문서형태
l_cashbill.tradetype = "승인거래"
// 거래구분, [소득공제용, 지출증빙용] 중 기재
l_cashbill.tradeUsage = "소득공제용"
// 거래유형, [일반, 도서공연, 대중교통] 중 기재
l_cashbill.tradeOpt = "일반"
// 과세형태, [과세, 비과세] 중 기재
l_cashbill.taxationType = "과세"
// 합계금액, 공급가액 + 부가세 + 봉사료
l_cashbill.totalAmount = "11000"
// 공급가액
l_cashbill.supplyCost = "10000"
// 부가세
l_cashbill.tax = "1000"
// 봉사료
l_cashbill.serviceFee = "0"
// 가맹점 사업자번호
l_cashbill.franchiseCorpNum = "1234567890"
// 가맹점 종사업장 식별번호
l_cashbill.franchiseTaxRegID = ""
// 가맹점 상호
l_cashbill.franchiseCorpName = "가맹점 상호"
// 가맹점 대표자 성명
l_cashbill.franchiseCEOName = "가맹점 대표자"
// 가맹점 주소
l_cashbill.franchiseAddr = "가맹점 주소"
// 가맹점 전화번호
l_cashbill.franchiseTEL = "070-1234-1234"
// 식별번호, 거래구분에 따라 작성
// 소득공제용 - 주민등록/휴대폰/카드번호/자진발급용 번호(010-000-1234) 기재가능
// 지출증빙용 - 사업자번호/주민등록/휴대폰/카드번호 기재가능
l_cashbill.identityNum = "0101112222"
// 주문 상품명
l_cashbill.itemName = "상품명"
// 주문번호
l_cashbill.orderNumber = "주문번호"
// 구매자(고객) 성명
l_cashbill.customerName = "고객명"
// 구매자(고객) 휴대폰
l_cashbill.hp = "010-111-222"
// 구매자(고객) 이메일
// 팝빌 개발환경에서 테스트하는 경우에도 안내 메일이 전송되므로,
// 실제 구매자의 메일주소가 기재되지 않도록 주의
l_cashbill.email = "test@test.com"
// 현금영수증 상태 이력을 관리하기 위한 메모
string memo = "즉시 발행 메모"
try
l_response = in_cashbillservice.registissue(corpNum, l_cashbill, memo)
messagebox("현금영수증 즉시 발행", "응답코드 : " + String(l_response.code) + "~n응답메시지 : " + l_response.message + "~n국세청승인번호 : " + l_response.confirmnum + "~n거래일자 : " + l_response.tradedate)
catch(popbillexception pe)
messagebox("현금영수증 즉시 발행", "응답코드 : " + String(pe.getcode()) + "~n응답메시지 : " + pe.getmessage())
end try
4. 결과 확인
함수 호출 반환 결과는 아래와 같습니다.
- 성공 : Response code 숫자 1 반환
- 실패 : PopbillException 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]