튜토리얼

PowerBuilder 개발환경에서 팝빌 SDK를 추가하고, 현금영수증 즉시 발행 (RegistIssue) API를 호출하는 기본 과정을 단계별로 따라 해볼 수 있도록 구성된 가이드 입니다.

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 탭

  // API Key
  // - 연동신청 시 발급받은 인증 정보(linkid, secretkey로 구성)
  // • linkid: 파트너를 식별하기 위한 고유 식별자
  // • secretkey: API 인증토큰 발급에 사용되는 키
  //
  // TODO: 아래 linkid, secretkey를 발급받은 정보로 교체해 주세요.
  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. API 응답결과 확인

API 호출 응답결과는 다음과 같습니다.

구분	응답
성공	code : 1
실패	code : 오류코드 (8자리 음의 정수) [오류코드] message : 오류메시지