튜토리얼

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"

// 현금영수증 문서번호
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 try

4. 결과 확인

함수 호출 반환 결과는 아래와 같습니다.
- 성공 : Response code 로 숫자 1 반환
- 실패 : PopbillException 으로 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]