홈택스

체납 연체 납부 내역 조회

국세청 홈택스에서 체납 연체 관련 납부 내역을 조회합니다. 홈택스 연동 데이터를 내부 업무 흐름에 연결해 활용할 수 있습니다.

활용 시나리오

  • 거래처 법인 체납 모니터링 — 연동 세션 기준 체납 목록을 주기적으로 조회해 잔여 납부세액이 있는지 확인합니다.
  • 대출 심사 전 점검 — 심사 전 체납 가산세 내역을 API로 수집해 내부 스코어링에 반영합니다.
  • 고지 납부 내역과 구분 — 세금 납부 환급 고지 통합 조회(notice)와 별도로 **체납 전용** action을 사용합니다.
  • 홈택스 기간별 스냅샷 — strt_dt/end_dt로 발송 기간을 좁혀 월별 스냅샷을 적재합니다.

연동 절차

  1. 1. 세션 연동 — account_link_id 홈택스 세션(TIN 자동)을 준비합니다.
  2. 2. 조회 기간 — strt_dt/end_dt 또는 전체 조회를 선택합니다.
  3. 3. 조회 실행 — POST .../overdue-history Job을 호출합니다.
  4. 4. 리스크 처리 — aftBrkdDVOList를 파싱 알림 대시보드에 반영합니다.

API 상품 목록 보기

체납 연체 납부 내역 조회 상세 페이지