본 개발가이드는 팝빌에서 제공하는 전자세금계산서 API, 전자명세서 API, 현금영수증 API, 문자 API, 팩스 API, 휴폐업조회 API, 홈택스 매입/매출 조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 전자세금계산서 API 예제를 통해 ‘SDK 이용방법’과 ‘상업용 환경설정’ 방법을 상세히 안내드립니다.
-
SDK 개발환경은 .NET Framework V3.5 환경에서 제작
-
API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용
1. SDK 이용방법 안내
개발환경 구성을 위해서는 API 인증에 사용되는 ‘인증정보 설정’ 을 완료해야 정상적으로 링크허브 API 상품을 이용할 수 있습니다. 다음의 설명을 참조하시기 바랍니다.
인증정보 설정
SDK 샘플소스를 다운로드한 후 “Popbill.Taxinovice” 프로젝트의 Global.asax 파일에 링크아이디(LinkID)와 비밀키(SecretKey)를 각각 링크허브 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정이 완료됩니다.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
using System; using System.Collections; using System.Configuration; using System.Data; using System.Linq; using System.Web; using System.Web.Security; using System.Web.SessionState; using System.Xml.Linq; namespace Popbill.Taxinvoice { public class Global : System.Web.HttpApplication { // 링크아이디 private string LinkID = "TESTER"; // 비밀키 private string SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="; // 세금계산서 서비스 객체 선언 public static TaxinvoiceService taxinvoiceService; protected void Application_Start(object sender, EventArgs e) { // 세금계산서 서비스 객체 초기화 taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey); // 연동환경 설정값, 개발용(true), 상업용(false) taxinvoiceService.IsTest = true; } } } |
▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)
1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]
2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]
2. 상업용 환경설정
“Popbill.Taxinvoice” 프로젝트의 “Global.asax” 파일의 IsTest 변수값을 “false”로 기재하면 상업용 연동환경 설정이 완료됩니다.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
using System; using System.Collections; using System.Configuration; using System.Data; using System.Linq; using System.Web; using System.Web.Security; using System.Web.SessionState; using System.Xml.Linq; namespace Popbill.Taxinvoice { public class Global : System.Web.HttpApplication { // 링크아이디 private string LinkID = "TESTER"; // 비밀키 private string SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="; // 세금계산서 서비스 객체 선언 public static TaxinvoiceService taxinvoiceService; protected void Application_Start(object sender, EventArgs e) { // 세금계산서 서비스 객체 초기화 taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey); // 연동환경 설정값, 개발용(true), 상업용(false) taxinvoiceService.IsTest = false; } } } |
※ 테스트용에서 설정한 인증정보(링크아이디/비밀키)는 상업용에서도 동일하게 사용되므로 별도의 수정 불필요
상업용 연동환경 설정을 완료 후 팝빌 홈페이지(https://www.popbill.com)에 연동회원가입을 해야합니다. 연동회원가입에 관한 자세한 사항은 아래의 링크를 참조하시기 바랍니다.
[참고] 팝빌 상업용 연동회원 가입절차 안내 [http://www.popbill.com] [바로가기]
▼ [참고] 언어별 SDK 개발가이드
- Java – SpringMVC SDK 개발가이드
- Java – JSP SDK 개발가이드
- C#.NET SDK 개발가이드
- VB.NET SDK 개발가이드
- ASP.NET SDK 개발가이드
- PHP SDK 개발가이드
- ASP SDK 개발가이드
- Python SDK 개발가이드
- Python – Django SDK 개발가이드
- Node.js SDK 개발가이드
- Ruby – Rails SDK 개발가이드
- Delphi SDK 개발가이드
- Visual Basic SDK 개발가이드
- PowerBuilder SDK 개발가이드
- VBA SDK 개발가이드
고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.
링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr