자주하는 질문

API 를 테스트하고 싶습니다. 테스트에 필요한 절차가 어떻게 되나요?

팝빌 API 서비스를 테스트하기 위해서는 우선적으로 서비스 연동신청이 필요합니다. 연동신청 승인 이후 담당자의 메일로 송부된 인증정보를 통해 SDK Example 코드를 테스트할 수 있습니다.

API 를 직접 구현해야 하나요?

팝빌의 모든 서비스는 API로 구현한 언어별 SDK로 지원되며, 개발 과정에서 사전에 정의된 언어별 SDK의 함수 호출하는 방식을 이용하여 쉽게 기능을 구현할 수 있습니다. 현재 Java, PHP, .Net, Node.js, Python, ASP, Delphi, PowerBuilder, Visual Basic6, VBA, Ruby, SAP ERP를 지원하고 있습니다.

API 호출에 대한 사용횟수 또는 동시처리에 대한 제한이 있나요?

API 호출에 대한 사용횟수 또는 동시처리에 대한 제한은 없습니다. 다만 서버에 부하를 발생시키는 의도적인 공격에 대해서는 모니터링을 통해 IP를 제한하고 있습니다.

API 를 통해 주고받는 요청/응답 전문은 암호화 되나요?

모든 팝빌 API 서비스는 TLS 암호화 통신을 기반으로 HMAC-SHA1 알고리즘이 적용되어 있습니다. 또한 네트워크 스니핑(Sniffing)/스푸핑(Spoofing) 등 제 3자가 의도적으로 네트워크 패킷을 획득/변조 하더라도 보안에 문제가 발생하지 않도록 OAuth 기반의 링크허브 인증, Bearer Token 인증이 팝빌 서버에 적용되어 있습니다.

호스팅 서버를 사용하고 있습니다. 팝빌 API를 이용할 수 있나요?

팝빌 API는 HTTP 통신이 가능한 모든 환경에서 이용 가능합니다. 팝빌에서 제공되는 SDK는 개발언어 자체의 HTTP 내장함수가 구현되어 별도의 모듈이나 라이브러리 설치 없이도 함수 기능을 이용할 수 있습니다. 호스팅 서버의 보안정책상 아웃바운드 트래픽을 제한하는 서버환경에서도 팝빌 API 서버 IP를 화이트리스트에 등록하시면 문제없이 SDK를 이용할 수 있습니다.

모바일 어플리케이션을 개발하고 있습니다. 전자세금계산서 기능을 구현할 수 있나요?

모바일 어플리케이션을 개발하는 경우 고객사에서 팝빌 전자세금계산서 API 기능을 처리할 별도의 서버를 구축하고 모바일 어플리케이션을 통해 작성된 세금계산서 정보를 서버로 전송하는 방식으로 구현할 수 있습니다.

모바일 서비스 팝빌 연동

SDK 사용에 대한 기술지원을 받고 싶습니다. 어떤 방법이 있나요?

팝빌 기술지원센터에서는 각 언어별 전담 개발자들이 유선/메일/원격지원을 통해 연동개발을 지원하고 있습니다.

팝빌 기술지원센터

브라우저에서 URL을 호출하거나 Postman과 같이 HTTP Request를 호출해 테스트 할 수 없나요?

팝빌 API 서비스는 인증 및 토큰 발급 과정이 필요하기 때문에, 단순한 HTTP Request 호출로 테스트를 진행할 수 없습니다. 인증 및 토큰 발급 과정은 지원하는 언어의 SDK에 구현되어 있기 때문에 별도의 구현과정은 필요 없습니다.

도입을 검토 중입니다. SDK를 사용할 때 비용을 지불하나요?

팝빌 API 개발진행 시 별도의 비용은 소요되지 않습니다. 기본적으로 모든 고객사에게 개발환경에서의 테스트를 진행을 위해 개발용 포인트를 무료로 지원하고 있으며, 지원된 포인트를 모두 소진하였을 경우 경우에 따라 충전처리가 필요할 수 있습니다.

외부 네트워크와 차단된 내부망 환경입니다. API를 연동할 수 있나요?

외부 네트워크와 차단된 내부망 환경에서는 외부 연결이 가능한 DMZ존에 Proxy 서버를 세팅하여 API를 호출할 수 있습니다. 실제 Proxy 환경을 구현한 파트너사의 사례가 많고, Proxy 구축 가이드 문서와 함께 기술지원센터의 개발지원을 받아 연동을 진행 할 수 있습니다.

SDK 함수 호출시 "링크아이디에 사용 가능한 아이피주소가 아닙니다." 오류가 발생합니다.

해당 오류는 연동신청 승인 후 메일로 발급해드린 인증정보(링크아이디, 비밀번호)를 SDK 예제코드에서 변경하지 않고 SDK 예제코드의 함수를 호출하였을 때 발생합니다. 인증정보에 대한 변수값을 변경하였는지 확인하고, 서버환경이라면 서버 애플리케이션에 적용을 위해 재시작 또는 리로드해주시기 바랍니다.

SDK 함수 호출시 "인증키와 사용자아이디로 사용자를 식별할 수 없습니다." 오류가 발생합니다.

해당 오류는 함수 파라미터로 기재된 '팝빌회원 아이디'가 올바르지 않은 경우에 발생합니다. 함수 호출시 기재된 팝빌회원 아이디가 회원가입시 기재한 정보와 일치하는지, 또는 파트너 신청시 메일로 발급해드린 인증정보에 포함된 '링크아이디' 를 '팝빌회원 아이디'에 기재하지 않았는지 확인 하시기 바랍니다.

전자세금계산서 API 비용을 알고 싶습니다.

전자세금계산서 API는 발행 건당 포인트가 소진되는 방식으로 제공되며, 단가와 관련된 사항은 파트너센터로 문의하여 주시기 바랍니다.

팝빌 파트너센터 :1600-8536sales@linkhub.co.kr

팝빌 개발환경에도 전자세금계산서 공인인증서 등록이 필요하나요?

팝빌 개발환경은 전자세금계산서의 국세청 전송을 제외한 모든 기능이 상업용 환경과 동일하게 구현되어 있기 때문에 공인인증서 등록 역시 사업자의 세금계산서 발행을 위해 필수적인 사항입니다. 부득이한 상황으로 인해 사업자의 공인인증서를 등록할 수 없는 경우 테스트용 사업자 인증서를 지원해드리고 있으니 언제든 편하게 연락 주시기 바랍니다.

팝빌 기술지원센터 :1600-9854code@linkhub.co.kr

Chrome 브라우저로 팝빌 사이트에서 공급자의 공인인증서를 등록 할 수 없나요?

공인인증서 등록은 Internet Explorer 브라우저의 ActiveX를 기반으로 하는 툴킷을 통해 팝빌 사이트 공인인증서 등록 페이지를 호출하는 방식으로 진행되기 때문에 크롬으로는 공인인증서 등록 처리가 불가합니다.

SDK 호출을 통해 테스트한 세금계산서는 어디서 확인할 수 있나요?

SDK를 통해 발행한 세금계산서는 팝빌 개발환경 사이트에서 확인할 수 있습니다. 개발환경 사이트에 로그인하여 상단의 [전자세금계산서] 메뉴를 선택하시면 세금계산서 상태에 따른 문서함에서 테스트한 세금계산서 정보를 확인할 수 있습니다.

전자세금계산서의 메일, 문자, 팩스 전송 기능 이용시 포인트가 차감되나요?

팝빌 서비스에서 메일 전송 기능은 포인트가 소진되지 않습니다. 하지만 문자, 팩스 기능은 사용 건수에 따라 포인트 차감이 차감됩니다.

전자세금계산서 안내메일을 수신하는 이메일 주소를 추가하고 싶습니다.

메일을 수신하는 업무 담당자가 다수인 경우, 전자세금계산서 작성시 기재할 수 있는 '추가담당자(addContactList)' 배열을 이용하여 담당자명과 메일주소를 추가하고 안내메일을 전송 할 수 있습니다. 추가담당자 목록 배열은 최대 5개까지 추가하여 작성 할 수 있습니다.

위수탁 세금계산서를 발행하고 싶습니다. 위수탁 세금계산서 발행은 어떤 함수를 이용해야 하나요?

위수탁 세금계산서 발행은 정발행을 구현하는 함수와 동일한 'RegistIssue(즉시 발행)' 함수를 사용하여 구현할 수 있습니다. 위수탁 발행에 대한 자세한 설명은 위수탁발행 - 프로세스를 참조하시기 바랍니다.

발행마감 기한이 지난 전자세금계산서를 신고하고 싶습니다.

전자세금계산서 작성시 작성일자에 발행마감 기한이 지난 일자를 기재하여 신고하는 경우 '지연발행' 세금계산서로 가산세 대상이 됩니다. 가산세가 발생하더라도 '지연발행' 세금계산서를 발행해야 하는 경우 'RegistIssue(즉시발행)' 함수 호출시 forceIssue(지연발행 강제여부) 변수를 true로 기재하여 발행할 수 있습니다.

공급받는자가 사업자가 아닌 개인인 경우 전자세금계산서 발행을 어떻게 처리해야 하나요?

전자세금계산서의 공급받는자가 사업자가 아닌 '개인'인 경우 공급받는자 정보 중 3가지 필드(invoiceeType, invoiceeCorpNum, invoiceeCorpName)를 아래와 같이 작성하여 발행합니다.

전자세금계산서 개인발행

전자세금계산서 뿐만 아니라 다른 서비스도 테스트하고 싶습니다 어떻게 해야 하나요?

전자세금계산서 API 연동을 이미 진행하셨다면, 유사한 함수 패턴과 로직으로 구현된 SDK를 통해 팝빌의 다른 서비스 테스트 및 기능 구현이 보다 수월합니다. 테스트에 앞서 API 서비스 이용을 위한 사전설정이 필요하므로 파트너센터로 연락주시기 바랍니다.

팝빌 파트너센터 :1600-8536sales@linkhub.co.kr

전자세금계산서 SDK 기능 개발을 완료하였습니다. 상업용 전환은 어떻게 진행하나요?

상업용 전환은 파트너센터에서 진행을 도와드리고 있습니다. 아래의 연락처로 연락주시기 바랍니다.

팝빌 파트너센터 :1600-8536sales@linkhub.co.kr

팝빌 SDK를 업데이트 하더라도 기존에 구현한 함수는 영향이 없나요?

팝빌 API 서비스의 언어별 SDK는 github을 통해 공개되어 있으며, 버전관리 및 하위호환성을 보장하고 있습니다. 공개된 자료는 아래의 github 링크를 참조하시기 바랍니다.

기술지원센터

팝빌 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.

T. 1600-9854   E. code@linkhub.co.kr

연동문의