# 홈택스수집 API

홈택스에 신고된 현금영수증 매입/매출 내역을 수집하는 API 입니다. 자체 개발한 HTTP 통신으로 송/수신하는 Protocol 스크래핑 기술방식을 이용하여 국세청 실시간 정보를 빠르게 수집합니다. 홈택스에서 조회 전용으로 발급하는 ‘부서사용자’ 인증방식으로 인증서 등록없이 다수 사용자의 동시 접속에도 중단없이 서비스 이용이 가능합니다.

> 팝빌 홈택스수집은 ‘부서사용자’(인증서 등록 불필요)와 ‘공동인증서’ 인증방식을 모두 지원합니다. [\[인증관리\]](https://developers.popbill.com/guide/htcashbill/introduction/manage-cert)

## API 목록

### 홈택스 수집 요청

- [1. RequestJob - 수집 요청](https://developers.popbill.com/reference/htcashbill/ruby/api/job#RequestJob)
- [2. GetJobState - 수집 상태 확인](https://developers.popbill.com/reference/htcashbill/ruby/api/job#GetJobState)
- [3. ListActiveJob - 수집 상태 목록 확인](https://developers.popbill.com/reference/htcashbill/ruby/api/job#ListActiveJob)

### 수집 내역 확인

- [1. Search - 수집 내역 확인](https://developers.popbill.com/reference/htcashbill/ruby/api/search#Search)
- [2. Summary - 수집 내역 합계](https://developers.popbill.com/reference/htcashbill/ruby/api/search#Summary)

### 홈택스 인증 관리

- [1. GetCertificatePopUpURL - 홈택스 인증정보 등록 팝업 URL](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#GetCertificatePopUpURL)
- [2. GetCertificateExpireDate - 인증서 만료일자 확인](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#GetCertificateExpireDate)
- [3. CheckCertValidation - 인증서 유효성 검증](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#CheckCertValidation)
- [4. RegistDeptUser - 부서사용자 계정 등록](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#RegistDeptUser)
- [5. CheckDeptUser - 부서사용자 등록 여부](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#CheckDeptUser)
- [6. CheckLoginDeptUser - 부서사용자 유효성 검증](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#CheckLoginDeptUser)
- [7. DeleteDeptUser - 부서사용자 계정 삭제](https://developers.popbill.com/reference/htcashbill/ruby/api/cert#DeleteDeptUser)