POPBill Developers
POPBill Developers 끊임없는 고민으로 빈틈없는 기술력을 제공합니다.

팝빌은 2004년부터 시작된 API 연동에 대한 높은 이해도와 뛰어난 기술력을 가지고 개발자를 위한 연동가이드를 만듭니다. 팝빌 API는 전자세금계산서, 현금영수증 뿐만 아니라, 데이터 수집, 금융, 메시징 등 다양한 서비스로 넓혀 나가고 있습니다.

가이드
전자세금계산서
Python
가이드 전자세금계산서 Python 연동환경 구성

팝빌 연동환경

팝빌은 테스트(Sandbox) 환경과 운영(Production) 환경을 독립적으로 운영하고, 운영환경과 모든 기능이 동일하게 작동하는 테스트 환경을 제공하여 실제 서비스와 동일한 조건에서 연동개발이 가능하도록 지원하고 있습니다.

  • 독립적인 개발환경
  • 동일 인증코드(LinkID, SecretKey) 사용
  • 테스트포인트 무료 지원 (일부 제한)

테스트환경에서는 세금계산서의 국세청 신고를 가상으로 처리하고 있습니다. 따라서 테스트환경에서 발행된 세금계산서는 국세청에 실제로 신고되지 않습니다.

연동절차

  1. 연동신청 : 프로그램 공급사 사업자정보로 연동신청 합니다. [연동신청] 바로가기

    개발 테스트를 위하여 연동신청에 필요한 입력정보는 아래와 같습니다.

    1. 1) 회사정보 – 사업자번호, 회사명, 대표자, 업태, 종목, 주소
    2. 2) 계정정보 – ID, PW
      • 입력하신 정보로 관리자와 팝빌(테스트(Sandbox), 운영(Production)) 사이트 계정이 생성됩니다.
      • 승인이 완료된 ID는 변경이 불가하므로 개인이 아닌 회사를 대표하는 계정정보로 신청하여 주시기 바랍니다.
    3. 3) 담당자정보 – 이름, 이메일, 연락처
  2. 인증코드 설정 : 팝빌에서 발급한 인증코드를 수신하여 SDK에 설정합니다. [SDK 환경설정] 바로가기

    팝빌은 연동신청 접수 후 20분(영업일 기준) 이내에 프로그램 공급사 고유 인증코드를 발급합니다. 팝빌 전자세금계산서 API 사용을 위해 수신한 인증코드를 SDK에 설정합니다.

    • 링크아이디(LinkID) : 프로그램 공급사를 식별할 수 있는 고유정보로 회원가입 등 고객사 관리에 사용됩니다.
    • 비밀키(SecretKey) : API 통신전문 변조를 방지하기 위해 사용됩니다.

    인증코드는 프로그램 공급사를 식별할 수 있는 고유정보로 외부에 유출되지 않도록 주의합니다.

  3. 공동인증서 등록 : 용도에 맞는 공동인증서를 테스트 계정에 등록합니다. [공동인증서 등록] 바로가기

    세금계산서 발행은 등록된 공동인증서로 전자서명 하여 처리합니다. 발행 테스트를 위해서는 팝빌 테스트(Sandbox) 계정에 용도에 맞는 프로그램 공급사의 공동인증서 등록이 필요합니다.

    인증서 등록은 아래 2가지 방법을 지원합니다.

    다른 사업자 정보로 테스트를 할 수 없나요?

    연동신청한 사업자 정보가 아닌 다른 사업자 정보로 테스트 하기 위해서는 테스트환경 계정 생성(회원가입)이 필요합니다. 아래 방법으로 팝빌 테스트 계정을 생성하고 사업자의 인증서를 등록하여 테스트 진행이 가능합니다.

    - 팝빌 사이트(Sandbox) : "연동회원" 선택 [회원가입] 바로가기
    - API : [JoinMember-연동회원 신규가입] 바로가기

    사업자의 인증서를 등록하지 못할 때는 어떻게 테스트 하나요?
    • 사업자 공동인증서를 등록할 수 없는 경우 팝빌에서는 테스트용 가상 사업자 계정에서 사용 가능한 인증서를 지원합니다.
    • 가상 사업자정보(사업자번호: 123-45-67890)로 테스트 계정을 생성하고, 팝빌에서 제공받은 테스트 인증서를 등록합니다.
    • 테스트 인증서는 프로그램 공급사의 연동개발 편의를 위하여 제공하는 용도로 외부에 유출되지 않도록 유의하시기 바랍니다.
  4. 개발 테스트 : 개발에 필요한 테스트포인트를 무료 제공합니다.

    인증코드를 설정한 SDK와 연동 문서를 참고하여 모든 API 테스트가 가능합니다. 팝빌은 테스트포인트를 무료(일부 제한)로 제공하며, 포인트를 모두 소진한 경우 추가 요청도 가능합니다. [포인트 요청] 바로가기

  5. 운영(Production) 서비스 전환 : 전환 요청 당일 즉시 서비스 이용이 가능합니다.
    1. 1) 테스트가 완료된 후 운영(Production) 환경으로 서비스 전환을 신청합니다. [운영(Production) 전환] 신청하기
    2. 2) 운영 서비스 전환을 위한 협의사항을 팝빌 담당자와 유선으로 확인합니다.
    3. 3) 팝빌로부터 전환 완료 메일 수신한 후 SDK 환경설정 변수값을 변경합니다.

      - API 인증코드는 테스트와 운영 환경에서 동일하게 적용되어 별도 상업용 인증코드 발급이 필요하지 않습니다.

      - 전환 후에도 SDK 환경설정 변수로 테스트와 운영 환경을 모두 이용할 수 있습니다.

      SDK 환경설정 변경

      SDK의 서비스 객체를 생성하는 config의 IsTest값을 "true"(개발)에서 "false"(운영)로 변경합니다. [SDK 환경설정] 바로가기

    4. 4) 팝빌 운영 환경 회원가입 및 서비스 이용을 위한 사전 준비사항(인증서 등록, 포인트 충전 등)을 처리합니다.

    테스트환경은 운영환경과 독립적으로 구성되어, 가입된 계정 및 등록된 인증서는 운영 환경에 이관되지 않습니다.