POPBill Developers
연동신청
  • 가이드 0
  • 레퍼런스 0
  • 오류코드 0
전자세금계산서
  • 전자세금계산서
  • 현금영수증
  • 전자명세서
  • 홈택스수집(세금)
  • 홈택스수집(현금)
  • 사업자등록상태조회
  • 기업정보조회
  • 계좌조회
  • 예금주조회
  • 카카오톡
  • 문자
  • 팩스
ASP
  • Java
  • PHP
  • .NET
  • .NET Core
  • Node.js
  • Python
  • Ruby
  • ASP
  • Delphi
  • PowerBuilder
  • Visual Basic
  • MS Access
가이드

자주 묻는 질문

팝빌 API 상품을 도입·연동하기 전에 확인해야 할 주요 사항과, 연동 과정에서 자주 문의되는 내용을 안내합니다.

공통

  1. API 연동에 기본료나 도입비용이 있나요?

    없습니다. 테스트 환경은 무료 포인트로 제공되며, 실제 서비스 이용 시에만 요금이 발생합니다.

  2. 프로그램을 연동하여 고객사에 팝빌 API를 제공할 수 있나요?

    네, 가능합니다. 단, 고객사가 팝빌에 파트너의 연동회원으로 가입해야 합니다.
    팝빌에서는 프로그램 공급사를 '파트너', 파트너의 프로그램을 이용하는 고객사를 '연동회원'이라고 하며, 파트너가 제공하는 프로그램에서 팝빌 API를 사용하기 위해서는 고객사의 연동회원 가입이 필요합니다. [회원 구조]

  3. 테스트 환경에서도 사전 준비가 필요한가요?

    네, 필요합니다. 팝빌 테스트 환경은 운영 환경과 동일하게 동작하므로, 사전 준비를 완료한 후에 테스트를 진행할 수 있습니다.
    또한 팝빌 테스트 환경에 등록된 정보는 운영 환경과 동기화되지 않으며, 서로 독립적으로 관리됩니다.

  4. 테스트 포인트가 부족합니다. 추가로 지원받을 수 있나요?

    네, 테스트 포인트가 소진된 경우 추가 신청을 통해 지원받을 수 있습니다. 테스트 환경에서는 팝빌이 제공하는 포인트로 개발을 진행하며, 포인트가 소진되면 팝빌에 테스트 포인트를 신청하여 계속 테스트할 수 있습니다.
    단, 원가가 발생하는 일부 서비스는 포인트 지원이 제한될 수 있습니다. [테스트 포인트 신청]

  5. 운영(Production) 환경에서 테스트 환경으로 전환할 수 있나요?

    네, 가능합니다. 설정 변경을 통해 테스트 환경과 운영 환경을 자유롭게 전환할 수 있습니다.
    * SDK 레퍼런스 - SDK 설정값(IsTest)을 변경합니다. [SDK 환경설정]
    * API 레퍼런스 - 도메인 및 ServiceID를 변경합니다. [API 환경설정]

  6. “호출한 API 상품에 이용 권한이 부여되지 않아 사용이 제한됩니다.” 오류 메시지가 응답 되었습니다. 어떻게 조치해야 하나요?

    네, 해당 오류는 호출한 API 상품이 미등록된 경우 발생합니다.
    추가로 API 상품 테스트 또는 사용이 필요한 경우, 연동문의를 통해 상품 추가를 요청해 주시기 바랍니다. [연동 문의]

  7. 팝빌 SDK 외에 기술 문서를 제공받을 수 있나요?

    네, 제공받을 수 있습니다.
    팝빌 SDK 사용이 어려운 환경에서는 직접 구현하실 수 있도록 API 레퍼런스가 제공됩니다. [API 레퍼런스]

전자세금계산서

  1. 동시에 1만건 이상의 전자세금계산서 발행이 가능하나요?

    네, 가능합니다. 팝빌 Bulk(대량발행) API를 이용하면 1만건의 전자세금계산서를 30초 이내에 처리할 수 있으며, 단건 발행을 반복하는 방식보다 최대 약 40배 빠르게 처리하여 오버헤드를 최소화할 수 있습니다. [<국내유일>팝빌 전자세금계산서 Bulk API]

  2. 전자세금계산서 웹훅(Webhook) 서비스를 지원하나요?

    네, 지원합니다. 팝빌은 전자세금계산서의 발행 및 국세청 전송 상태 변경 시점에 고객사 서버로 정보를 실시간 자동 전송하는 웹훅(Outgoing Webhook) 서비스를 무료로 제공합니다.
    이를 통해 상태 확인을 위한 반복적인 API 호출을 줄여 리소스를 절감할 수 있으며, 고객사의 개발 소요시간을 낮추고 시스템 운영 효율을 높일 수 있습니다. [<업계유일>팝빌 전자세금계산서 Webhook]

  3. 전자세금계산서 발행시 거래처의 휴폐업 여부를 확인할 수 있나요?

    네, 확인할 수 있습니다.
    팝빌은 전자세금계산서 발행과 동시에 거래처 사업자번호의 휴폐업 여부를 홈택스에서 실시간으로 자동 조회하는 기능을 무료로 제공합니다.
    단, 전자세금계산서 발행전 휴폐업 여부를 확인하고자 하는 경우에는 사업자등록상태조회(유료) API를 이용해 주시기 바랍니다.

  4. 회사의 공동인증서를 보유하지 않아도 전자세금계산서 API 연동 개발 및 테스트가 가능하나요?

    네 가능합니다. 회사의 공동인증서를 보유하고 있지 않더라도, 테스트 공동인증서를 신청하시면 테스트 환경에서만 사용 가능한 테스트용 공동인증서를 지원받아 연동 개발 및 발행 테스트를 진행하실 수 있습니다.
    단, 운영 환경에서는 회사 명의의 공동인증서가 반드시 필요합니다. [테스트 공동인증서 신청]

  5. 전자세금계산서 역발행 기능을 이용하고 싶습니다. 이용 절차가 궁금해요.

    팝빌에서 제공하는 역발행 기능을 이용하기 위해서는 공급자와 공급받는자 모두 팝빌에 회원가입을 하셔야 합니다.
    공급받는자가 역발행을 요청하면 공급자는 팝빌에 등록된 공동인증서로 전자서명하여 전자세금계산서를 발행할 수 있습니다. [역발행]

  6. 전자세금계산서 위수탁 기능을 이용하고 싶습니다. 이용 절차가 궁금해요.

    팝빌에서 제공하는 위수탁 기능을 이용하기 위해서는 수탁자만 팝빌에 회원가입 하시면 됩니다.
    단, 위수탁 형태로 세무처리가 가능한 구조인지 내부적으로 검토가 먼저 필요하며, 위탁자(공급자)의 권한을 위임받은 수탁자의 공동인증서로 전자서명하여 발행하는 방식으로 이용할 수 있습니다. [위수탁]

  7. 팝빌로 전자세금계산서 발행 업체를 변경하려는데, 기존 업체의 데이터를 확인할 수 있나요?

    네 확인하실 수 있습니다.
    팝빌로 전자세금계산서 서비스를 이전하는 기업을 위해, 최근 1년동안 홈택스에 신고된 전자세금계산서 정보를 무료로 이관해드리는 마이그레이션 서비스를 제공하고 있습니다.
    마이그레이션 서비스 이용을 원하시는 경우, 파트너센터로 신청해 주시기 바랍니다. [연동 문의]

기타

  1. 팝빌 API 사용 시 IP 또는 방화벽 등록이 필요한가요?

    기본적으로 팝빌 API 사용에 있어 IP 또는 방화벽 등록은 필수 사항이 아닙니다.
    단, 고객사의 보안정책(방화벽 등)으로 고정 IP 설정이 필요한 경우 아래와 같이 설정할 수 있습니다.
    · SDK Reference - [UseStaticIP : 통신 IP 고정(방화벽)] 설정
    · API Reference - [공통 정의 사항] Base URL을 고정IP 주소로 변경
    또한 고객사 Source IP에 대한 [IP Whitelisting] 를 설정하여 보안을 강화할 수 있습니다.