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. API 연동 외에 팝빌 사업자등록상태조회 사용이 가능한 방법이 있나요?

    팝빌은 API 기능을 사이트(www.popbill.com)에서도 동일하게 사용할 수 있도록 제공하고 있습니다.
    팝빌 사이트에서 1건씩 조회하는 일반조회와 최대 5만건까지 한번에 조회하는 대량조회를 이용할실 수 있으며, API 조회 결과에 대한 내역 확인도 가능합니다.

  2. 사업자등록상태조회를 실시간으로 제공하고 있나요?

    네, 실시간으로 제공합니다.
    팝빌 사업자등록상태조회는 홈택스로부터 사업자등록상태를 실시간으로 수집하여 정보를 제공하며, 사업자의 과세유형과 휴폐업 상태를 확인하실 수 있습니다. [사업자등록상태조회 제공정보]

  3. 팝빌 사업자등록상태조회 서비스의 처리량과 처리속도는 어느 정도인가요?

    팝빌 사업자등록상태조회 서비스는 처리량에 제한을 두지 않으며, 실시간으로 홈택스로부터 조회한 결과를 제공합니다.
    사업자번호 1건 조회에 약 0.01초(10ms)가 소요되며, 10만건 조회에 약 15분 정도가 소요됩니다.

  4. 공공 API로 제공하는 데이터와 차이점이 뭔가요?

    팝빌 사업자등록상태조회 서비스는 사업자등록상태 조회를 위한 공공기관 회선을 이중화하여 운영하고 있습니다.
    이로 인해 홈택스 시스템 점검 또는 장애가 발생하더라도 이중화를 통해 자동으로 전환되어, 안정적으로 서비스 이용이 가능합니다.

  5. 단건 조회로 대량 조회가 가능한가요?

    네, 가능합니다. 팝빌은 사업자번호 조회 1건 당 약 0.01초 소요되어, 별도의 조회 주기 제한없이 단건 조회 API를 반복 호출하는 방식으로 대량 조회가 가능합니다.
    다만, 10,000건 이상 사업자등록상태를 조회하는 경우에는 대량 조회 API 사용을 권장합니다.

  6. 사업자등록상태 조회결과 중 과세정보에 '미등록'은 무엇인가요?

    과세정보 항목 중 미등록은 국세청 홈택스에 등록되지 않은 사업자를 의미합니다.
    실제 존재하지 않는 사업자일 가능성이 높으므로, 고객사는 해당 사업자번호를 반드시 재확인하시기 바랍니다.

기타

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

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