본 개발가이드는 팝빌에서 제공하는 전자세금계산서 API, 전자명세서 API, 현금영수증 API, 문자 API, 팩스 API, 휴폐업조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 전자세금계산서 API 예제를 통해 ‘SDK 이용방법’과 ‘상업용 환경설정’ 방법을 상세히 안내드립니다.
- SDK 개발환경은 Delphi v5 ~ XE.x 지원
- API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용
1. SDK 이용방법 안내
개발환경 구성을 위해서는 API 인증에 사용되는 ‘인증정보 설정’ 과정을 모두 완료해야 정상적으로 링크허브 API 상품을 이용할 수 있습니다. 다음의 설명을 참조하시기 바랍니다.
- 통신모듈 Synapse 라이브러리와 OpenSSL DLL를 사용하지 않는 최신 버전의 SDK가 업데이트 되었습니다. 이전 버전을 연동하셨던 고객들께서는 최신버전을 사용하시기 바랍니다.
인증정보 설정
SDK 샘플소스를 다운로드한 후 “Example.pas” 파일에 링크아이디(LinkID)와 비밀키(SecretKey)를 각각 링크허브 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정이 완료됩니다.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
unit Example; interface uses Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, StdCtrls, TypInfo, Popbill, PopbillTaxinvoice, ExtCtrls; const //링크아이디. LinkID = 'TESTER'; // 파트너 통신용 비밀키. 유출 주의. SecretKey = '8yXlHKIgCBDy1uxA1bNsfRHi0wuQA6m+aQOombSCtd4='; type |
▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)
1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]
2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]
2. 상업용 연동환경 설정
테스트 완료 후 상업용 연동환경 설정을 위해서는 “Example.pas” 파일의 FormCreate 프로시저에 선언되어있는 IsTest 변수값을 “false” 로 기재하거나 주석으로 처리하면 상업용 연동환경 설정이 완료됩니다.
168 169 170 171 172 173 174 175 176 |
procedure TfrmExample.FormCreate(Sender: TObject); begin MgtKeyType := SELL; //세금계산서 모듈 초기화. taxinvoiceService := TTaxinvoiceService.Create(LinkID,SecretKey); taxinvoiceService.IsTest := false; end; |
※ 테스트용에서 설정한 인증정보(링크아이디/비밀키)는 상업용에서도 동일하게 사용되므로 별도의 수정 불필요
상업용 연동환경 설정을 완료 후 팝빌 홈페이지(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