ERP·거래처 마스터 관리
- 거래처 등록 후 사업자 등록사항과 주업종·업태를 주기 스캔해 변경분을 감지
- 정정 신고 정보로 법인 대표·주소·발행주식 변동을 자동 반영
- 개인 사업자 주소지 변동을 배송·청구서 발송 주소 자동 갱신에 활용
기업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 유형입니다.
세무대행·세무 SaaS 수임처 현황 파악
- 종합소득세 신고서 제출 상태로 수임처별 신고 진행률 대시보드 구성
- 업종·업태 변경 시점을 감지해 적용 세목·가산세 규칙을 자동 재계산
- 휴업·폐업 이력을 조기에 탐지해 수임 관리·청구 중단에 연결
핀테크·여신 심사 보조 정보
- 여신 차주의 사업자 기본 사항과 업종 변경 이력을 신용 리스크 모델에 편입
- 발행주식수·액면가 같은 자본 구조 변동을 법인 신용 평가에 반영
- 개인사업자 주소지 정합성으로 온라인 본인 주소 검증 보조 지표로 활용
ONBOARDING
도입 절차
상담부터 연동·검수까지 네 단계로 진행합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 01
상담 신청
필요한 데이터와 사용 목적을 알려주시면 접수합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 02
타당성·범위 회신
원천 공개 여부와 수집 방식, 법적 검토를 거쳐 상담 접수 후 2~5영업일 내 타당성을 회신드립니다.
STEP 03
응답 스키마 합의
견적 단계에서 응답 스키마를 합의합니다. 필드명·필터·요약 가공은 정규화 레이어에서 조정합니다.
STEP 04
연동·검수
인증키를 발급하고 연동합니다. 필요한 원천을 병렬 호출해 단일 응답으로 정규화한 결과를 함께 검수합니다.
RECOMMENDED