본문으로 바로가기
링크허브 공식블로그

연동이 쉬워진다

링크허브 공식블로그

가치를 연결하다/튜토리얼

[PHP] 팝빌 전자명세서 API 연동 가이드

안녕하세요. 고객의 가치를 연결하는 비즈니스 파트너 링크허브 입니다.


본 포스팅에서는 PHP 개발환경에서 고객사들이 팝빌 전자명세서 API SDK를 쉽고 빠르게 이용할 수 있도록, 예시를 이용하여 연동 설정 방법을 안내드리겠습니다. 먼저, SDK를 추가한 후 "즉시발행(RegistIssue) API"를 구현하는 순서로 진행하겠습니다. 




팝빌 SDK는 PHP v4.x 이상 모든 개발환경에서 이용 가능하며, API 호출과 응답의 메시지 인코딩은 "UTF-8 Character-Set"을 지원합니다.


"팝빌은 링크허브에서 자체 개발하고 직접 운영하는 전자명세서 서비스 Brand Name 입니다."



아래 설명하는 예시는 [ CentOS v6.8 | Apache v2.2.15 | PHP v5.5.38 ] 기준으로 작성되어 있어, 이용 중이신 개발환경과 차이가 있을 수 있는 점 감안해 주시기 바랍니다.



1. 서버환경 구성


전자명세서 API 연동을 위해서 통신환경 구성을 위한 curl, openssl 두 가지의 PHP 모듈이 반드시 추가되어 있어야 합니다. 

curl 모듈은 통신 프로토콜을 이용하여 데이터를 전송하기 위한 라이브러리와 커맨드 라인 도구를 제공하고, openssl 모듈은 보안 프로토콜인 TLS 통신을 지원하며 암호화 기능 및 여러가지 유틸리티가 포함되어 있습니다.

다음 커맨드를 사용하여 서버에 설치되어 있는 PHP 모듈을 확인합니다. 


# php -m
[php modules]
bz2
curl
date
ftp
json
openssl
session
standard
tokenizer

[Zend Modules]


curl 모듈이 설치되어 있지 않다면, 다음을 참고하여 curl 모듈을 추가합니다.


[참고] PHP-curl 모듈 추가 과정 https://linkhub.tistory.com/145




2. 팝빌 SDK 추가 


① 링크허브 연동자료실에서 PHP 팝빌 SDK 예제코드를 다운로드 후 압축을 해제합니다. 


[참고] PHP 전자명세서 SDK 다운로드 - https://www.linkhub.co.kr/Downloads/Statement/59?PageNum=1



② SDK 내에 포함되어 있는 "Popbill" 폴더 전체를 웹서버 Root Directory에 복사합니다. 


웹서버 FilePath : /{RootDirectory}/Popbill/



③ 팝빌 API 환경설정과 전자명세서 클래스 초기화를 위해 아래의 내용을 참조하여 common.php 생성하고 주석을 참조하여 변수의 값을 수정합니다. 


FilePath : /{RootDirectory}/common.php


▶ 링크허브에서 발급받은 고객사 인증정보로 링크아이디(LinkID)와 비밀키(SecretKey) 값을 변경하시기 바랍니다.

<?php

  require_once './Popbill/PopbillStatement.php';

  // 링크아이디
  $LinkID = 'TESTER';

  // 비밀키. 유출에 주의하시기 바랍니다.
  $SecretKey = 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=';

  // 통신방식 기본은 CURL , curl 사용에 문제가 있을경우 STREAM 사용가능.
  // STREAM 사용시에는 php.ini의 allow_fopen_url = on 으로 설정해야함.
  define('LINKHUB_COMM_MODE','CURL');

  $StatementService = new StatementService($LinkID, $SecretKey);

  // 연동환경 설정값, 개발용(true), 상업용(false)
  $StatementService->IsTest(true);

?> 


Window 운영체제에 APM을 구축한 환경에서 SSL 관련 오류가 발생하는 경우 define('LINKHUB_COMM_MODE', 'STREAM')으로 변경하시기 바랍니다.



3. API 구현


① 전자명세서 즉시발행 함수인 RegistIssue API를 호출하기 위한 파일을 생성합니다.


FilePath : /{DocumentRoot}/RegistIssue.php





② RegistIssue.php 페이지를 호출하여 전자명세서 즉시발행 함수 호출결과를 확인합니다.

예) 함수호출 성공 처리시




예) 함수호출 실패 처리시 








③ 발행된 전자명세서는 팝빌 개발용(test.popbill.com) 사이트에서 확인할 수 있습니다.




[참고] 팝빌 연동 개발을 위한 테스트베드(개발용) 안내 - https://linkhub.tistory.com/91



팝빌에서 제공하는 다양한 API는 동일한 컨셉으로 개발되어 있어, 하나의 서비스를 이용한 경험이 있으면 다른 서비스들도 유사한 방법으로 빠르게 연동이 가능하니 많은 이용 부탁드립니다. 


지금까지 PHP 개발환경에서 전자명세서 API를 연동하는 방법에 대해 안내드렸습니다. 내용에 대한 추가적인 문의가 있으면 기술지원센터로 편하게 연락주시기 바랍니다.




고객사의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락 주시기 바랍니다.

기술지원센터 / T. 1600-9854 / E. code@linkhub.co.kr








  • Today
  • Total