튜토리얼
.NET 개발환경에서 팝빌 SDK를 추가하여 기업정보조회 (BizInfoCheck) 함수를 구현하는 예시입니다.
1. POPBiLL SDK 추가
① 팝빌 연동자료실에서 VB.NET SDK 예제코드 다운로드 후 압축을 해제합니다.
② 다운받은 SDK 예제코드의 Linkhub/, Popbill/ 폴더를 SDK를 적용할 프로젝트 경로에 복사하고. Linkhub.csproj, Popbill.csproj를 각각 기존 프로젝트로 추가합니다.
③ Popbill 프로젝트를 적용할 프로젝트의 참조로 추가합니다.
2. POPBiLL SDK 설정
연동환경 설정값, 기업정보조회 서비스 클래스를 선언하고 Form1_Load() 함수에 서비스 클래스 초기화 코드를 추가합니다.
Public Class Form1
'링크아이디
Private Const LinkID As String = "TESTER"
'비밀키
Private SecretKey As String = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="
'기업정보조회 서비스 객체 선언
Private bizInfoCheckService As BizInfoCheckService
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
'기업정보조회 서비스 객체 초기화
bizInfoCheckService = New BizInfoCheckService(LinkID, SecretKey)
'연동환경 설정, true-테스트, false-운영(Production), (기본값:false)
bizInfoCheckService.IsTest = True
'인증토큰 IP 검증 설정, true-사용, false-미사용, (기본값:true)
bizInfoCheckService.IPRestrictOnOff = True
'통신 IP 고정, true-사용, false-미사용, (기본값:false)
bizInfoCheckService.UseStaticIP = false;
'로컬시스템 시간 사용여부, true-사용, false-미사용, (기본값:false)
bizInfoCheckService.UseLocalTimeYN = False
End Sub
End Class3. BizInfoCheck 기능 구현
Web Form을 추가하여 checkBizInfo.aspx를 생성하여 응답코드, 메시지 확인 페이지를 추가하고, checkBizInfo.aspx.cs 파일의 Page_Load 이벤트에 함수 호출 코드를 추가합니다.
checkBizInfo.aspx
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="checkBizInfo.aspx.cs" Inherits="Popbill.BizInfoCheck.Example.checkBizInfo" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Popbill BizInfoCheck</title>
</head>
<body>
<div>
<p>Response</p>
<br/>
<fieldset>
<legend>기업정보조회</legend>
<% if (!String.IsNullOrEmpty(code)) { %>
<ul>
<li>Response.code : <%= code %> </li>
<li>Response.message : <%= message %></li>
</ul>
<% } else { %>
<ul>
<li>corpNum (사업자번호) : <%= bizCheckInfo.corpNum%></li>
<li>companyRegNum (법인번호): <%=bizCheckInfo.companyRegNum%></li>
<li>checkDT (확인일시) : <%=bizCheckInfo.checkDT%></li>
<li>corpName (상호): <%=bizCheckInfo.corpName%></li>
<li>corpCode (기업형태코드): <%=bizCheckInfo.corpCode%></li>
<li>corpScaleCode (기업규모코드): <%=bizCheckInfo.corpScaleCode%></li>
<li>personCorpCode (개인법인코드): <%=bizCheckInfo.personCorpCode%></li>
<li>headOfficeCode (본점지점코드) : <%=bizCheckInfo.headOfficeCode%></li>
<li>industryCode (산업코드) : <%=bizCheckInfo.industryCode%></li>
<li>establishCode (설립구분코드) : <%=bizCheckInfo.establishCode%></li>
<li>establishDate (설립일자) : <%=bizCheckInfo.establishDate%></li>
<li>CEOName (대표자명) : <%=bizCheckInfo.ceoname%></li>
<li>workPlaceCode (사업장구분코드): <%=bizCheckInfo.workPlaceCode%></li>
<li>addrCode (주소구분코드) : <%=bizCheckInfo.addrCode%></li>
<li>zipCode (우편번호) : <%=bizCheckInfo.zipCode%></li>
<li>addr (주소) : <%=bizCheckInfo.addr%></li>
<li>addrDetail (상세주소) : <%=bizCheckInfo.addrDetail%></li>
<li>enAddr (영문주소) : <%=bizCheckInfo.enAddr%></li>
<li>bizClass (업종) : <%=bizCheckInfo.bizClass%></li>
<li>bizType (업태) : <%=bizCheckInfo.bizType%></li>
<li>result (상태코드) : <%=bizCheckInfo.result%></li>
<li>resultMessage (상태메시지) : <%=bizCheckInfo.resultMessage%></li>
<li>closeDownTaxType (사업자과세유형) : <%=bizCheckInfo.closeDownTaxType%></li>
<li>closeDownTaxTypeDate (과세유형전환일자):<%=bizCheckInfo.closeDownTaxTypeDate%></li>
<li>closeDownState (휴폐업상태) : <%=bizCheckInfo.closeDownState%></li>
<li>closeDownStateDate (휴폐업일자) : <%=bizCheckInfo.closeDownStateDate%></li>
</ul>
<% } %>
</fieldset>
</div>
</body>
</html>checkBizInfo.aspx.cs
using System;
using System.Collections;
using System.Collections.Generic;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
namespace Popbill.BizInfoCheck.Example
{
public partial class checkBizInfo : System.Web.UI.Page
{
public String code;
public String message;
public List<BizCheckInfo> bizCheckInfo;
protected void Page_Load(object sender, EventArgs e)
{
// 팝빌회원 사업자번호, '-' 제외 10자리
String MemberCorpNum = "1234567890";
// 조회할 사업자번호
String CheckCorpNum = "1234567890"
try
{
bizCheckInfo = Global.bizInfoCheckService.checkBizInfo(MemberCorpNum, CheckCorpNum);
}
catch (PopbillException ex)
{
code = ex.code.ToString();
message = ex.Message;
}
}
}
}4. 결과 확인
함수 호출 반환 결과는 아래와 같습니다.
- 성공 : result(상태코드) 숫자 100 반환
- 실패 : PopbillException 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]