튜토리얼
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_cashbillserviceWindow Form Open() 함수
3. RegistIssue 기능 구현
Form에 버튼을 생성하고 버튼의 Click Event 코드에 현금영수증 즉시 발행 (RegistIssue) 기능을 추가합니다.
cashbill l_cashbill
response l_response
string mgtKey, corpNum
// 팝빌회원 사업자번호
corpNum = "1234567890"
// 현금영수증 문서번호
mgtKey = "20220101-021"
// [필수] 문서번호, 가맹점별 고유번호 할당 1~24자리 영문, 숫자조합으로 중복없이 구성
l_cashbill.mgtkey = mgtKey
// [취소거래 발행시 필수] 당초 승인 현금영수증 국세청승인번호
l_cashbill.orgConfirmNum = ""
// [취소거래 발행시 필수] 당초 승인 현금영수증 거래일자
l_cashbill.orgTradeDate = ""
// [필수] 문서형태, {승인거래, 취소거래} 중 기재
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"
// [필수] 식별번호
// 거래구분(tradeUsage) - '소득공제용' 인 경우
// - 주민등록/휴대폰/카드번호 기재 가능
// 거래구분(tradeUsage) - '지출증빙용' 인 경우
// - 사업자번호/주민등록/휴대폰/카드번호 기재 가능
l_cashbill.identityNum = "0101112222"
// 구매자명
l_cashbill.customerName = "고객명"
// 주문상품명
l_cashbill.itemName = "상품명"
// 주문번호
l_cashbill.orderNumber = "주문번호"
// 구매자 이메일
// 팝빌 개발환경에서 테스트하는 경우에도 안내 메일이 전송되므로,
// 실제 거래처의 메일주소가 기재되지 않도록 주의
l_cashbill.email = "test@test.com"
// 구매자 휴대폰
l_cashbill.hp = "010-111-222"
// 메모
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 try4. 결과 확인
함수 호출 반환 결과는 아래와 같습니다.
- 성공 : Response code 숫자 1 반환
- 실패 : PopbillException 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]