홈택스
납세사실증명서 발급(신청)
국세청 홈택스에 납세사실증명서 발급을 신청합니다. 홈택스 연동 데이터를 내부 업무 흐름에 연결해 활용할 수 있습니다.
활용 시나리오
- 관공서 금융기관 제출 — 대출 보조금 입찰 서류로 납세사실증명이 요구될 때, 홈택스 신청 Job을 API로 실행하고 접수번호를 남깁니다.
- 기간 지정 신청 — 수납 신고 기간 파라미터를 명시해 해당 구간의 납세 사실만 증명하도록 신청 옵션을 통제합니다.
- 다수 법인 일괄 대행 — 세무대리인이 고객별 account_link 세션으로 납세사실증명 신청을 반복 실행하고 결과를 ERP에 적재합니다.
- 완납증명과 구분 운영 — 국세완납증명(별도 Job)과 납세사실증명을 상품 action 단위로 분리해 잘못된 증명서 신청을 방지합니다.
연동 절차
- 1. 홈택스 세션 납세자 확인 — account_link_id 세션을 준비하고, tin txpr_nm 필요 시 params에 지정합니다.
- 2. 증명 기간 옵션 설정 — 수납기간 연 월 및 표시 발급 수령 옵션을 정책에 맞게 지정합니다.
- 3. 납세사실증명 신청 — POST .../tax-payment-record Job(cert_napse_sasil)으로 홈택스에 신청합니다.
- 4. 접수 결과 연계 — cvaId rcatNo를 저장하고 목록 다운로드 등 후속 Job과 연결합니다.