기업8 APIs

홈택스 수임처 신고

#수임납세자#신고대리납세자#수임등록#수임해지#세무대행#홈택스

OVERVIEW

상품요약

홈택스 세무대리 서비스에서 수임납세자·신고대리 납세자를 등록·해지하고 등록 상태를 확인하는 전용 유형의 API입니다. 수임납세자 목록에서는 계속사업자 여부·대표자명·개업/폐업 일자·수임/해임 일자·해임 사유가, 수임처 등록 여부 확인(단건·그룹)에서는 대표자명·상호·개업/폐업일·주소·업종·업태가 반환되고, 신고대리 납세자 목록·등록·해지 엔드포인트는 사업자등록번호·상호·수임/동의/해임 일자·사업자 유형·세목 정보를 함께 제공합니다. 세무대행 SaaS·경영관리 솔루션이 수임 계약 체결부터 연말 해지·세목 변경까지의 라이프사이클을 일관되게 자동 관리하고 수임처 포트폴리오를 실시간으로 파악할 때 자주 선택되는 카테고리입니다.

SYSTEM FLOW

시스템 흐름

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

ENDPOINTS

제공 API (8종)

API명제공 정보자료 출처
수임납세자 목록
반환계속사업자 여부·대표자명·개업/폐업 일자·수임/해임 일자·해임 사유
홈택스
수임처 등록 여부 확인
입력사업자번호
반환계속사업자 여부·대표자명·상호·개업/폐업일·주소·업종·업태
홈택스
수임처 등록 여부 확인(그룹조회)
입력사업자번호 다건
반환계속사업자 여부·대표자명·상호·개업/폐업일·주소·업종·업태
홈택스
수임납세자 등록
입력수임 대상 사업자 정보·정보제공 범위
반환등록 처리 결과
홈택스
수임납세자 해지
입력수임 해지 대상·해지 사유
반환해지 처리 결과
홈택스
신고대리 납세자 목록
반환사업자등록번호·상호·수임/동의/해임 일자·사업자 유형·세목
홈택스
신고대리 납세자 등록
입력신고대리 대상·세목
반환등록 처리 결과
홈택스
신고대리 납세자 해지
입력신고대리 해지 대상·해지 사유
반환해지 처리 결과
홈택스

USE CASES

이용사례

세무대행 SaaS·경영관리 솔루션이 수임납세자·신고대리 납세자의 등록·해지·세목 변경 라이프사이클을 일관되게 자동 관리하려 할 때 자주 선택되는 홈택스 수임처 관리 API 유형입니다.

세무대행 SaaS의 수임 계약 자동화

  • 신규 수임 체결 시 수임납세자 등록을 계약 시스템과 연동해 자동 처리
  • 수임 포트폴리오를 실시간으로 파악해 담당자·팀 배정을 최적화
  • 계약 만료·해지 시 자동 해지 처리와 감사 추적 로그 보관

신고 대리 업무·세목별 관리

  • 신고대리 납세자 목록으로 세목(부가세·법인세·소득세)별 대상 고객을 분리 관리
  • 세목 변경·추가 시 등록 엔드포인트로 업무 범위를 즉시 반영
  • 동의 일자·수임 일자를 분리해 법적 책임 범위를 명확히 구분

경영관리·KPI 대시보드

  • 수임처 수·세목별 비중을 주기적으로 수집해 경영 지표로 시각화
  • 해임 사유 분석으로 이탈 원인을 역추적하고 서비스 개선에 활용
  • 수임처 휴업·폐업 신호를 조기 감지해 청구 중단·리텐션 캠페인에 연결

RECOMMENDED

추천 API