본 개발가이드는 팝빌에서 제공하는 전자세금계산서 API, 전자명세서 API, 현금영수증 API, 문자 API, 팩스 API, 휴폐업조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 전자세금계산서 API 예제를 통해 ‘SDK 이용방법’과 ‘상업용 환경설정’ 방법을 상세히 안내드립니다.
- SDK 개발환경은 .NET Framework V3.x 이상 또는 v2.x 기반에서 제작
- API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용
1. SDK 이용방법 안내
개발환경 구성을 위해서는 API 인증에 사용되는 ‘인증정보 설정’ 을 완료해야 정상적으로 링크허브 API 상품을 이용할 수 있습니다. 다음의 설명을 참조하시기 바랍니다.
SDK 샘플소스를 다운로드한 후 “frmExample.cs” 파일에 링크아이디(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 |
using System; using System.Collections.Generic; using System.Windows.Forms; namespace Popbill.Taxinvoice.Example.csharp { public partial class frmExample : Form { //링크아이디 private string LinkID = "TESTER"; //비밀키 private string SecretKey = "2eQzzRuuygccucjyhFLMGkQEz7MzmDB9wA++aZROr1I="; private TaxinvoiceService taxinvoiceService; private const string CRLF = "\r\n"; public frmExample() { InitializeComponent(); //초기화 taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey); //테스트를 완료한후 아래 변수를 false로 변경하거나, 아래줄을 삭제하여 실제 서비스 연결. taxinvoiceService.IsTest = true; } |
▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)
1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]
2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]
2. 상업용 환경설정
예제폴더에 포함되어 있는 “frmExample.cs” 파일의 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 |
using System; using System.Collections.Generic; using System.Windows.Forms; namespace Popbill.Taxinvoice.Example.csharp { public partial class frmExample : Form { //연동상담시 발급받은 연동아이디 private string LinkID = "TESTER"; //연동상담시 발급받은 비밀키 private string SecretKey = "OTbVGsQdnLrc8kmmyIXr8W+nX+vDH6tAERiM+DNPFXo="; private TaxinvoiceService taxinvoiceService; private const string CRLF = "\r\n"; public frmExample() { InitializeComponent(); //초기화 taxinvoiceService = new TaxinvoiceService(LinkID, SecretKey); //테스트를 완료한후 아래 변수를 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