# 서비스 소개

국세청 홈택스에 신고된 현금영수증 매입/매출 내역을 수집하는 서비스입니다.\
팝빌 자체 스크래핑 기술을 이용하여 국세청에 신고된 데이터를 빠르게 수집이 가능합니다. [\[제안서 다운로드\]](https://developers.popbill.com/customer-center/proposal)

![팝빌 홈택스수집(현금영수증) 소개](https://developers.popbill.com/images/guide/introduction/hometax/htcashbill/img-intro.webp)

## 수집

홈택스 수집 방식은 팝빌에서 매일 오전 8시에 자동으로 전달하는 ‘Webhook(Push)’ 방식과 파트너가 API를 호출하여 수집하는 ‘API(Polling)’ 방식을 지원합니다.

**Webhook(Push)**

팝빌은 홈택스에서 수집한 매입/매출 내역을 매일 오전 8시마다 파트너가 지정한 Callback URL로 자동 전달합니다.

```mermaid
sequenceDiagram
      participant 파트너
      participant Webhook Receiver
      participant POPBiLL

      파트너->>POPBiLL: Callback URL 등록 <br/> 부서사용자 등록
      POPBiLL->>Webhook Receiver: 매입/매출 상세정보 전달
      Note left of POPBiLL: 매일 오전 8시 마다
```

**API(Polling)**

파트너가 팝빌로 수집을 요청하고 팝빌에서 수집이 완료되면, 파트너는 수집내역을 확인합니다.

```mermaid
sequenceDiagram
    participant 파트너
    participant POPBiLL

    파트너->>POPBiLL: 인증정보 등록 (부서사용자/인증서)
    파트너->>POPBiLL: 홈택스 수집 요청 + 수집 내역 확인
    POPBiLL->>파트너: 수집내역 목록 및 요약정보 반환
```

## 주요기능

홈택스수집 API 관련하여 팝빌에서 제공하는 기능입니다. 고객사는 필요한 기능만 선별하여 시스템에 연동할 수 있습니다. [\[홈택스수집 API 목록\]](https://developers.popbill.com/api-reference/htcashbill/api#api-list)

- 수집요청
- 수집내역 정보 확인
- 수집정보 상세 확인
- 홈택스 인증 관리
- 정액제 신청/포인트 관리
- 회원 관리

## 특장점

팝빌 홈택스수집 API 관련하여 제공하는 주요 특장점은 다음과 같습니다.

1. **공동인증서 등록 없이 홈택스 매입/매출 수집**: 홈택스에서 사용하는 반영구적인 부서사용자 계정을 등록하여 공동인증서 없이도 매입/매출내역 수집 가능
2. **다양한 거래유형 제공**: 파빌 자체 스크래핑 기술로 보관된 DB가 아닌 홈택스에서 신고된 매입/매출 내역을 실시간으로 수집하여 전달
3. **업계 유일 Webhook 지원**: 팝빌에서 고객사 서버로 홈택스에서 신고된 매앱/매출 정보 자동으로 전달