POPBill Developers
가이드

튜토리얼

ASP 개발환경에서 팝빌 SDK를 추가하여 홈택스 전자세금계산서 수집요청 (RequestJob) 함수를 구현하는 예시입니다.

1. POPBiLL SDK 추가 및 설정

① 팝빌 연동자료실에서 ASP SDK 예제코드 다운로드 후 압축을 해제합니다.

② 압축해제한 SDK 예제코드에 포함된 Popbill/ 폴더를 웹사이트 Root Directory 경로에 복사합니다.

③ 홈택스연동 서비스 연동환경 설정을 위해 프로젝트 Root Directory에 common.asp 파일을 생성하고 아래의 코드를 참고하여 인증정보를 설정합니다.

<!--#include virtual="/Popbill/Popbill.asp"-->
<!--#include virtual="/Popbill/HTTaxinvoiceService.asp"-->

<%
  ' 링크허브에서 발급받은 인증정보 링크아이디(LinkID), 비밀키(SecretKey) 입력
  LinkID = "LINKID"
  SecretKey = "SwWxqU+0TExEXy/9TVjKPExI2VTUMMSLZtJf3Ed8q3I="

  ' 홈택스연동 서비스 모듈 생성
  set m_HTTaxinvoiceService = new HTTaxinvoiceService

  ' 홈택스연동 API 서비스 모듈 초기화
  m_HTTaxinvoiceService.Initialize LinkID, SecretKey

  ' 연동환경 설정값, Ture-사용, False-미사용
  m_HTTaxinvoiceService.IsTest = True

  ' 인증토큰 IP제한기능 사용여부, Ture-사용, False-미사용, 기본값(True)
  m_HTTaxinvoiceService.IPRestrictOnOff = True

  ' 팝빌 API 서비스 고정 IP 사용여부, Ture-사용, False-미사용, 기본값(False)
  m_HTTaxinvoiceService.UseStaticIP = False

  ' 로컬시스템 시간 사용여부 Ture-사용, False-미사용, 기본값(True)
  m_HTTaxinvoiceService.UseLocalTimeYN = True
%>

2. RequestJob 기능 구현

프로젝트에 함수 호출을 처리하는 파일을 생성하고, 아래의 코드를 참조하여 코드를 추가합니다.

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=euc-kr" />
    <link rel="stylesheet" type="text/css" href="/Example.css" media="screen" />
    <title>Popbill Hometax Taxinvoice Test.</title>
  </head>
<!--#include file="common.asp"-->
<%

  '팝빌회원 사업자번호, "-" 제외
  testCorpNum = "1234567890"

  '팝빌회원 아이디
  testUserID = "testkorea"

  '발행유형 SELL(매출), BUY(매입), TRUSTEE(위수탁)
  KeyType= SELL

  '검색 일자유형, W-작성일자, I-발행일자, S-전송일자
  DType = "S"

  '시작일자, 표시형식(yyyyMMdd)
  SDate = "20211201"

  '종료일자, 표시형식(yyyyMMdd)
  EDate = "20211230"


  On Error Resume Next

  jobID = m_HTTaxinvoiceService.requestJob(testCorpNum, KeyType, DType, SDate, EDate, testUserID)

  If Err.Number <> 0 then
    code = Err.Number
    message = Err.Description
    Err.Clears
  End If

  On Error GoTo 0
%>
  <body>
    <div id="content">
      <p class="heading1">Response</p>
      <br/>
      <fieldset class="fieldset1">
      <legend>수집 요청</legend>
      <% If code = 0 Then %>
        <ul>
          <li>jobID(작업아이디) : <%=jobID%> </li>
        </ul>
      <%	Else  %>
        <ul>
          <li>Response.code: <%=code%> </li>
          <li>Response.message: <%=message%> </li>
        </ul>
      <%	End If	%>
      </fieldset>
    </div>
  </body>
</html>

3. 결과 확인

함수 호출이 정상적으로 처리된 경우 Response가 "성공"으로 반환되며, 실패일 경우 PopbillException으로 오류코드("-"로 시작하는 8자리 숫자값)와 오류메시지가 반환됩니다. [오류코드] 바로가기