팝빌 연동환경

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

1. 1) 회사정보 – 사업자번호, 회사명, 대표자, 업태, 종목, 주소
2. 2) 계정정보 – ID, PW
   • 입력하신 정보로 팝빌 파트너 관리자와 팝빌 테스트 사이트와 팝빌 운영(Prodution) 사이트 계정이 생성됩니다.
   • 승인이 완료된 ID는 변경이 불가하므로 개인이 아닌 회사를 대표하는 계정정보로 신청하여 주시기 바랍니다.
3. 3) 담당자정보 – 이름, 이메일, 연락처

팝빌은 연동신청 접수 후 20분(영업일 기준) 이내에 프로그램 공급사 고유 API Key 를 발급합니다. 팝빌 홈택스수집 API 사용을 위해 수신한 API Key 를 SDK에 설정합니다.

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

홈택스에 로그인하여 매입/매출 데이터를 조회하기 위해 팝빌 테스트 계정에 인증정보를 등록이 필요합니다. 팝빌은 '부서사용자' 와 '공동인증서' 2가지 인증방식을 지원하며, 다수 사용자의 동시 접속에도 중단없이 서비스 이용이 가능한 '부서사용자' 인증방식을 권장합니다.

• 부서사용자 [권장]
  1. 1) 팝빌 사이트 등록
     - 팝빌 테스트 사이트 로그인 (https://test.popbill.com) > 홈택스수집 > 환경설정 > 인증 관리 > 부서사용자 인증
  2. 2) API 등록
     - 홈택스수집 인증 관리 API를 호출하여 등록 [GetTaxCertURL - 인증서 등록 팝업 URL]
     - 부서사용자 계정등록 API를 호출하여 등록 [RegistDeptUser - 부서사용자 계정등록]
• 공동인증서
  1. 1) 팝빌 사이트 등록
     - 팝빌 테스트 사이트 로그인 (https://test.popbill.com) > 홈택스수집 > 환경설정 > 인증 관리 > 인증서 인증
  2. 2) API 등록
     - 홈택스수집 인증 관리 API를 호출하여 등록 [GetTaxCertURL - 인증서 등록 팝업 URL]
     

API Key 를 설정한 SDK와 연동 문서를 참고하여 모든 API 테스트가 가능합니다. 테스트 데이터가 아닌 실제 매입/매출 데이터를 수집하여 개발 테스트를 진행하며, 테스트 기간의 연장이 필요한 경우 '포인트 요청'이 가능합니다. [포인트 요청]

• 튜토리얼

  [.Net Core 튜토리얼]

• SDK 예제

  [SDK 다운로드]

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

   - API Key 는 팝빌 테스트 환경와 팝빌 운영(Production) 환경에서 동일하게 적용되어 별도 운영용 API Key 발급이 필요하지 않습니다.

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

   SDK 환경설정 변경

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

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