기업4 APIs

MY 홈택스

#MY홈택스#사업자등록사항#정정신고#업종코드#업태#종합소득세신고상태#홈택스

OVERVIEW

상품요약

홈택스 'MY 홈택스' 영역이 제공하는 사업자 등록 사항과 정정 신고 관련 정보, 개인 사업자의 주소지, 종합소득세 신고서 제출 상태를 한 번에 확인할 수 있는 유형의 API입니다. 사업자 등록사항 및 담당자 안내에서는 상호·대표자·개업일·주업종·주업태·종목·사업자 구분 등 계속·휴업·전년도 폐업 사업장까지 포함한 기본 사항이, 사업자 정정 신고 정보에서는 전화번호·주소·대표자·업종·업태·발행주식수·액면가 같은 법인 정보가 반환됩니다. 개인 사업자 주소지 조회로 도로명·지번·우편번호까지 일관되게 받을 수 있어 ERP·세무 SaaS·거래처 관리 시스템이 사업자 마스터 데이터를 주기적으로 동기화하거나 업태·업종 변경을 감지하는 데 자주 선택되는 카테고리입니다.

SYSTEM FLOW

시스템 흐름

클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 4개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.

ENDPOINTS

제공 API (4종)

API명제공 정보자료 출처
사업자 등록사항 및 담당자 안내
반환상호명·대표자명·개업일자·주업종 코드·주업태·종목명·사업자 구분 등 계속 사업 또는 휴업 중이거나 전년도 이후 폐업한 사업장의 기본 사항
홈택스
사업자 정정신고 정보 조회
반환법인 정보(전화번호·주소·대표자명·업종·업태·발행주식수·액면가)
홈택스
개인 사업자 주소지 정보 조회
반환개인 사업자의 성명·도로명 주소·지번 주소·우편번호
홈택스
종합소득세 신고서 제출 상태 조회(개인 전용)
반환종합소득세 신고서 제출 여부 (개인 납세자 기간 내 제출 상태)
홈택스

USE CASES

이용사례

ERP·세무 SaaS·거래처 관리 시스템이 사업자 마스터 데이터를 주기적으로 동기화하고 업태·업종·주소 변경을 감지하려 할 때 자주 선택되는 MY 홈택스 기본 정보 조회 API 유형입니다.

ERP·거래처 마스터 관리

  • 거래처 등록 후 사업자 등록사항과 주업종·업태를 주기 스캔해 변경분을 감지
  • 정정 신고 정보로 법인 대표·주소·발행주식 변동을 자동 반영
  • 개인 사업자 주소지 변동을 배송·청구서 발송 주소 자동 갱신에 활용

세무대행·세무 SaaS 수임처 현황 파악

  • 종합소득세 신고서 제출 상태로 수임처별 신고 진행률 대시보드 구성
  • 업종·업태 변경 시점을 감지해 적용 세목·가산세 규칙을 자동 재계산
  • 휴업·폐업 이력을 조기에 탐지해 수임 관리·청구 중단에 연결

핀테크·여신 심사 보조 정보

  • 여신 차주의 사업자 기본 사항과 업종 변경 이력을 신용 리스크 모델에 편입
  • 발행주식수·액면가 같은 자본 구조 변동을 법인 신용 평가에 반영
  • 개인사업자 주소지 정합성으로 온라인 본인 주소 검증 보조 지표로 활용

RECOMMENDED

추천 API