홈택스

부가가치세 신고내역 조회

국세청 홈택스에서 부가가치세 세금신고내역을 신고일자 구간(rtn_dt_srt rtn_dt_end, YYYYMMDD)으로 조회합니다. 홈택스 연동 데이터를 내부 업무 흐름에 연결해 활용할 수 있습니다.

활용 시나리오

  • 부가세 신고 이력 대사 — 신고일자 구간으로 부가가치세 신고내역을 수집해 내부 ERP 신고 보조 자료와 비교합니다.
  • 다른 세목과 구분 — 법인세 등 다른 마케팅 카드 제목과 1:1이 아님 — 본 Job은 **VAT 신고내역 조회**만 수행합니다.
  • 홈택스 납부세액 검토 — 차가감 납부세액 등 필드를 보고 이상 신고 수정 필요 건을 추려 담당자 검토 목록을 만듭니다.
  • 기간 조회 자동화 — 최대 1년 범위 내에서 분기 연 단위 조회 Job을 스케줄해 마감 전 신고 이력을 자동 수집합니다.

연동 절차

  1. 1. 세션 연동 — account_link_id 홈택스 세션을 준비합니다.
  2. 2. 신고일자 구간 — rtn_dt_srt rtn_dt_end(YYYYMMDD, ≤1년)를 지정합니다.
  3. 3. 조회 실행 — hometax.tax.return_history.search_vat Job을 호출합니다.
  4. 4. 분석 저장 — 응답 data를 파싱 적재하고 필요 시 환급 고지 조회와 연계합니다.

API 상품 목록 보기

부가가치세 신고내역 조회 상세 페이지