기업5 APIs

홈택스 나의세무대리인

#나의세무대리인#수임동의#수임해지#신고대리인#정보제공범위#세무ERP#홈택스

OVERVIEW

상품요약

홈택스의 '나의 세무대리인·나의 신고대리인' 영역을 자동화해 납세자 관점에서 세무대리인·신고대리인 수임에 대한 동의·해지·재동의를 일관되게 처리하는 유형의 API입니다. 나의 세무대리인 수임 동의·해지·해지 후 재동의 엔드포인트와 수임 해지 목록(납세자번호·세무대리인 사업자번호·수임 일자·정보 제공 범위), 그리고 나의 신고대리인 수임 동의 엔드포인트까지 포함되어, 납세자가 여러 대리인과의 수임 관계를 변경할 때 수작업 대신 API로 처리할 수 있습니다. 세무용 ERP, 개인사업자 관리 앱, 경영관리 SaaS가 고객에게 대리인 수임 동의를 일괄 요청하거나 이미 수임 중인 대리인을 한 곳에서 정리·통합 관리할 때 자주 선택되는 카테고리입니다.

SYSTEM FLOW

시스템 흐름

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

ENDPOINTS

제공 API (5종)

API명	제공 정보	자료 출처
나의 세무대리인 수임 동의	입력세무대리인 사업자번호·정보제공 범위 반환동의 처리 결과	홈택스
나의 세무대리인 수임 해지	입력세무대리인 사업자번호·해지 사유 반환해지 처리 결과	홈택스
나의 세무대리인 수임해지 후 동의	입력세무대리인 사업자번호·정보제공 범위 반환재동의 처리 결과	홈택스
나의 세무대리인 수임해지 목록	반환나의 납세자번호·세무대리인 사업자번호·수임 일자·정보 제공 범위	홈택스
나의 신고대리인 수임 동의	입력신고대리인 사업자번호·세목 반환동의 처리 결과	홈택스

USE CASES

이용사례

세무용 ERP·개인사업자 관리 앱·경영관리 SaaS가 납세자 관점에서 대리인 수임 동의·해지·재동의를 한 번에 정리·관리하려 할 때 자주 선택되는 나의 세무대리인 API 유형입니다.

세무용 ERP·경영관리 SaaS의 대리인 통합 관리

고객이 한 화면에서 여러 세무대리인과의 수임 상태를 조회·정리
정보 제공 범위를 주기적으로 재확인해 불필요한 정보 노출을 축소
대리인 교체 시 해지→재동의를 한 번에 처리하는 연속 플로우 구성

개인사업자·프리랜서 세무 앱

앱 가입 단계에서 신규 세무대리인 수임 동의를 원클릭으로 안내
연말·분기별 대리인 수임 상태 점검을 리마인드 알림으로 제공
해지 이력으로 재계약·리텐션 전략을 기획할 때 근거 데이터로 활용

신고대리인 운영·세목 관리

특정 세목(종합소득세·부가세)에 한정한 신고대리 동의를 자동화해 책임 범위를 명확히
다수 대리인을 세목별로 분산 운영하는 고객의 관리 복잡도를 낮춤
세무 사건·감사 시 수임 동의 이력으로 법적 책임 근거를 확보

RECOMMENDED