홈택스
미수령 환급금 조회
국세청 홈택스에서 미수령 국세환급금(찾아가지 않은 환급금) 존재 여부를 조회합니다. 홈택스 연동 데이터를 내부 업무 흐름에 연결해 활용할 수 있습니다.
활용 시나리오
- 고객 환급 안내 — 세무대리 플랫폼이 고객사 미수령 환급 여부를 주기적으로 조회해 안내합니다.
- 정기 신고 환급과 구분 — 환급세액 정기 신고 조회(refund.search_detail)와 별도로 **미수령** 전용 action을 사용합니다.
- 홈택스 온보딩 점검 — 신규 연동 시 미수령 환급 스캔을 자동 실행해 CS 티켓을 생성합니다. 자동화 스케줄로 반복 조회를 줄이고 오류 발생 시 알림을 보냅니다.
- 내부 수익 리스크 — 미수령 건수가 있으면 후속 수령 절차 안내 워크플로를 트리거합니다. 팀별 역할에 맞게 결과를 저장하고 후속 업무 흐름에 연결합니다.
연동 절차
- 1. 세션 연동 — account_link_id 홈택스 세션을 준비합니다.
- 2. 식별(선택) — txpr_dscm_no txpr_nm 필요 시 params에 지정합니다.
- 3. 조회 실행 — POST .../unclaimed-refund Job을 호출합니다.
- 4. 후속 안내 — unpdRfndScnt 등 결과로 고객 안내 티켓을 생성합니다.