팝빌 홈택스연동(현금) API란? (REST API)
홈택스에 접속하지 않고 이용중인 시스템에 연동하여 국세청에 신고된 현금영수증 매입/매출 내역을 실시간으로 확인하는 API 입니다. 사용자가 원하는 시점에 보관된 DB가 아닌 실시간 홈택스정보를 제공하며, HTTP 통신 이외 별도 자원을 이용하지 않아 탁월한 서비스 속도를 보장합니다. 팝빌에서 제공하는 SDK의 함수를 호출하는 방식으로 쉽고 편리하게 홈택스연동(현금) API 서비스를 이용할 수 있습니다.
- 주요기능 홈택스 매입/매출 내역 조회 및 수집
- 특장점 인증서 사용하지 않고 조회 가능(국내 유일)
- 일반 통신환경
- 망분리 통신환경
※ 스크래핑이란, 대고객 서비스를 제공하는 Web 페이지에서 필요한 정보만을 추출해 가공하는 기술입니다..
※ 도입사 시스템이 정보보호 또는 접근제어를 위해 내부(업무용)와 외부(비업무용) 네트워크를 따로 관리하는 망분리 통신환경입니다.
홈택스연동(현금) 프로세스
1) 수집 요청(RequestJob) : 홈택스에 신고된 현금영수증 매입/매출 내역을 조회하기 위해 팝빌에 수집을 요청합니다.
※ 서비스 이용 전, 홈택스에서 등록한 현금영수증 자료조회 부서사용자 계정 또는 인증서를 팝빌에 등록해주시기 바랍니다.
2) 상태 확인(GetJobState) : 수집 작업의 진행 상태(접수/대기/진행/완료)와 성공 여부(성공/실패)를 확인합니다.
3) 수집결과 조회(Search/Summary) : 목록 조회(Search) 또는 수집결과 요약정보 조회(Summary) 를 확인합니다.
연동개발 진행절차
1) 연동신청 : 연동개발에 필요한 인증정보를 발급받기 위해 연동신청을 진행합니다. 연동신청 바로가기
2) 개발 및 테스트
튜토리얼을 참고하여 인증정보를 변경합니다. 개발환경(테스트베드)에서는 모든 기능이 상업용 환경과 동일하게 동작하기 때문에, 실제와 동일한 조건으로 개발 및 테스트를 진행할 수 있습니다.
팝빌 인증정보란?
- 비밀키(SecretKey): 통신전문 위변조를 방지하여 신뢰할 수 있는 상태에서 통신을 가능하게 하는 고유정보
- 링크아이디(LinkID): 팝빌 서비스를 연동하는 프로그램 공급사를 식별하고 회원가입시 공급사의 허가된 연동회원임을 증명하는 정보 [참고] 파트너 회원 안내 보기
팝빌 홈택스연동(현금) API 특장점
01
팝빌 서비스 모든 기능이 30여개 API 형태로 제공
02
HTTP 통신 가능한 개발환경에서 연동 가능
(개발언어별 SDK + 상세 매뉴얼 제공)
03
자체 기술력으로 구현한 강력한 상호인증체계
(HMAC + Bearer token + 자체 인증방식)
04
TLS 방식으로 전송라인 전구간에서 암호화 통신
05
Webhook을 통한 실시간 상태값 자동 전달
06
자체 시스템에 다양한 형태로 커스터마이징 가능