ERP·거래처 마스터 관리
- 거래처 등록 후 사업자 등록사항과 주업종·업태를 주기 스캔해 변경분을 감지
- 정정 신고 정보로 법인 대표·주소·발행주식 변동을 자동 반영
- 개인 사업자 주소지 변동을 배송·청구서 발송 주소 자동 갱신에 활용
기업4 APIs
MY 홈택스
#MY홈택스#사업자등록사항#정정신고#업종코드#업태#종합소득세신고상태#홈택스
OVERVIEW
상품요약
홈택스 'MY 홈택스' 영역이 제공하는 사업자 등록 사항과 정정 신고 관련 정보, 개인 사업자의 주소지, 종합소득세 신고서 제출 상태를 한 번에 확인할 수 있는 유형의 API입니다. 사업자 등록사항 및 담당자 안내에서는 상호·대표자·개업일·주업종·주업태·종목·사업자 구분 등 계속·휴업·전년도 폐업 사업장까지 포함한 기본 사항이, 사업자 정정 신고 정보에서는 전화번호·주소·대표자·업종·업태·발행주식수·액면가 같은 법인 정보가 반환됩니다. 개인 사업자 주소지 조회로 도로명·지번·우편번호까지 일관되게 받을 수 있어 ERP·세무 SaaS·거래처 관리 시스템이 사업자 마스터 데이터를 주기적으로 동기화하거나 업태·업종 변경을 감지하는 데 자주 선택되는 카테고리입니다.
- 분류
- 기업 데이터
- 자료 출처
- 홈택스
- 수집 방식
- 홈택스에서 조회한 결과를 수집해 단일 스키마로 정규화
- 제공 API
- 4종
- 연동 구조
- 단일 원천, 서브 API 병렬 호출
- 주요 활용
- ERP·거래처 마스터 관리, 세무대행·세무 SaaS 수임처 현황 파악, 핀테크·여신 심사 보조 정보
SYSTEM FLOW
시스템 흐름
클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 4개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.
ENDPOINTS
제공 API (4종)
| API명 | 제공 정보 | 자료 출처 |
|---|---|---|
| 사업자 등록사항 및 담당자 안내 | 반환상호명·대표자명·개업일자·주업종 코드·주업태·종목명·사업자 구분 등 계속 사업 또는 휴업 중이거나 전년도 이후 폐업한 사업장의 기본 사항 | 홈택스 |
| 사업자 정정신고 정보 조회 | 반환법인 정보(전화번호·주소·대표자명·업종·업태·발행주식수·액면가) | 홈택스 |
| 개인 사업자 주소지 정보 조회 | 반환개인 사업자의 성명·도로명 주소·지번 주소·우편번호 | 홈택스 |
| 종합소득세 신고서 제출 상태 조회(개인 전용) | 반환종합소득세 신고서 제출 여부 (개인 납세자 기간 내 제출 상태) | 홈택스 |
USE CASES
이용사례
ERP·세무 SaaS·거래처 관리 시스템이 사업자 마스터 데이터를 주기적으로 동기화하고 업태·업종·주소 변경을 감지하려 할 때 자주 선택되는 MY 홈택스 기본 정보 조회 API 유형입니다.
세무대행·세무 SaaS 수임처 현황 파악
- 종합소득세 신고서 제출 상태로 수임처별 신고 진행률 대시보드 구성
- 업종·업태 변경 시점을 감지해 적용 세목·가산세 규칙을 자동 재계산
- 휴업·폐업 이력을 조기에 탐지해 수임 관리·청구 중단에 연결
핀테크·여신 심사 보조 정보
- 여신 차주의 사업자 기본 사항과 업종 변경 이력을 신용 리스크 모델에 편입
- 발행주식수·액면가 같은 자본 구조 변동을 법인 신용 평가에 반영
- 개인사업자 주소지 정합성으로 온라인 본인 주소 검증 보조 지표로 활용
ONBOARDING
도입 절차
상담부터 연동·검수까지 네 단계로 진행합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 01
상담 신청
필요한 데이터와 사용 목적을 알려주시면 접수합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 02
타당성·범위 회신
원천 공개 여부와 수집 방식, 법적 검토를 거쳐 상담 접수 후 2~5영업일 내 타당성을 회신드립니다.
STEP 03
응답 스키마 합의
견적 단계에서 응답 스키마를 합의합니다. 필드명·필터·요약 가공은 정규화 레이어에서 조정합니다.
STEP 04
연동·검수
인증키를 발급하고 연동합니다. 필요한 원천을 병렬 호출해 단일 응답으로 정규화한 결과를 함께 검수합니다.
FAQ
자주 묻는 질문
MY 홈택스 API는 어떤 데이터를 조회할 수 있나요?
사업자 등록사항 및 담당자 안내, 사업자 정정신고 정보 조회, 개인 사업자 주소지 정보 조회, 종합소득세 신고서 제출 상태 조회(개인 전용)의 엔드포인트를 제공합니다. 반환: 상호명·대표자명·개업일자·주업종 코드·주업태·종목명·사업자 구분 등 계속 사업 또는 휴업 중이거나 전년도 이후 폐업한 사업장의 기본 사항
ERP·거래처 마스터 관리에 MY 홈택스 API를 어떻게 활용하나요?
거래처 등록 후 사업자 등록사항과 주업종·업태를 주기 스캔해 변경분을 감지. 정정 신고 정보로 법인 대표·주소·발행주식 변동을 자동 반영. 개인 사업자 주소지 변동을 배송·청구서 발송 주소 자동 갱신에 활용.
세무대행·세무 SaaS 수임처 현황 파악에 MY 홈택스 API를 어떻게 활용하나요?
종합소득세 신고서 제출 상태로 수임처별 신고 진행률 대시보드 구성. 업종·업태 변경 시점을 감지해 적용 세목·가산세 규칙을 자동 재계산. 휴업·폐업 이력을 조기에 탐지해 수임 관리·청구 중단에 연결.
핀테크·여신 심사 보조 정보에 MY 홈택스 API를 어떻게 활용하나요?
여신 차주의 사업자 기본 사항과 업종 변경 이력을 신용 리스크 모델에 편입. 발행주식수·액면가 같은 자본 구조 변동을 법인 신용 평가에 반영. 개인사업자 주소지 정합성으로 온라인 본인 주소 검증 보조 지표로 활용.
MY 홈택스 데이터는 어디에서 가져오나요?
홈택스에서 조회한 결과를 수집해 단일 스키마로 정규화합니다. 원천 공개 여부와 수집 방식, 법적 검토는 상담 접수 후 타당성 회신 단계에서 확인합니다.
비용과 기간은 어떻게 정해지나요?
상담 접수 후 2~5영업일 내 타당성과 범위를 회신하고, 견적 단계에서 응답 스키마(필드명·필터·요약 가공)를 합의합니다. 비용과 기간은 이 합의 범위에 따라 견적으로 안내합니다.
목록에 없는 새 API도 요청 가능한가요?
가능합니다. 원천 공개 여부·수집 방식·법적 검토가 선행되며, 상담 접수 후 2~5영업일 내 타당성 회신을 드립니다.
RECOMMENDED