세무용 ERP·경영관리 SaaS의 대리인 통합 관리
- 고객이 한 화면에서 여러 세무대리인과의 수임 상태를 조회·정리
- 정보 제공 범위를 주기적으로 재확인해 불필요한 정보 노출을 축소
- 대리인 교체 시 해지→재동의를 한 번에 처리하는 연속 플로우 구성
기업5 APIs
홈택스 나의세무대리인
#나의세무대리인#수임동의#수임해지#신고대리인#정보제공범위#세무ERP#홈택스
OVERVIEW
상품요약
홈택스의 '나의 세무대리인·나의 신고대리인' 영역을 자동화해 납세자 관점에서 세무대리인·신고대리인 수임에 대한 동의·해지·재동의를 일관되게 처리하는 유형의 API입니다. 나의 세무대리인 수임 동의·해지·해지 후 재동의 엔드포인트와 수임 해지 목록(납세자번호·세무대리인 사업자번호·수임 일자·정보 제공 범위), 그리고 나의 신고대리인 수임 동의 엔드포인트까지 포함되어, 납세자가 여러 대리인과의 수임 관계를 변경할 때 수작업 대신 API로 처리할 수 있습니다. 세무용 ERP, 개인사업자 관리 앱, 경영관리 SaaS가 고객에게 대리인 수임 동의를 일괄 요청하거나 이미 수임 중인 대리인을 한 곳에서 정리·통합 관리할 때 자주 선택되는 카테고리입니다.
SYSTEM FLOW
시스템 흐름
클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 5개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.
ENDPOINTS
제공 API (5종)
| API명 | 제공 정보 | 자료 출처 |
|---|---|---|
| 나의 세무대리인 수임 동의 | 입력세무대리인 사업자번호·정보제공 범위 반환동의 처리 결과 | 홈택스 |
| 나의 세무대리인 수임 해지 | 입력세무대리인 사업자번호·해지 사유 반환해지 처리 결과 | 홈택스 |
| 나의 세무대리인 수임해지 후 동의 | 입력세무대리인 사업자번호·정보제공 범위 반환재동의 처리 결과 | 홈택스 |
| 나의 세무대리인 수임해지 목록 | 반환나의 납세자번호·세무대리인 사업자번호·수임 일자·정보 제공 범위 | 홈택스 |
| 나의 신고대리인 수임 동의 | 입력신고대리인 사업자번호·세목 반환동의 처리 결과 | 홈택스 |
USE CASES
이용사례
세무용 ERP·개인사업자 관리 앱·경영관리 SaaS가 납세자 관점에서 대리인 수임 동의·해지·재동의를 한 번에 정리·관리하려 할 때 자주 선택되는 나의 세무대리인 API 유형입니다.
개인사업자·프리랜서 세무 앱
- 앱 가입 단계에서 신규 세무대리인 수임 동의를 원클릭으로 안내
- 연말·분기별 대리인 수임 상태 점검을 리마인드 알림으로 제공
- 해지 이력으로 재계약·리텐션 전략을 기획할 때 근거 데이터로 활용
신고대리인 운영·세목 관리
- 특정 세목(종합소득세·부가세)에 한정한 신고대리 동의를 자동화해 책임 범위를 명확히
- 다수 대리인을 세목별로 분산 운영하는 고객의 관리 복잡도를 낮춤
- 세무 사건·감사 시 수임 동의 이력으로 법적 책임 근거를 확보
ONBOARDING
도입 절차
상담부터 연동·검수까지 네 단계로 진행합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 01
상담 신청
필요한 데이터와 사용 목적을 알려주시면 접수합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 02
타당성·범위 회신
원천 공개 여부와 수집 방식, 법적 검토를 거쳐 상담 접수 후 2~5영업일 내 타당성을 회신드립니다.
STEP 03
응답 스키마 합의
견적 단계에서 응답 스키마를 합의합니다. 필드명·필터·요약 가공은 정규화 레이어에서 조정합니다.
STEP 04
연동·검수
인증키를 발급하고 연동합니다. 필요한 원천을 병렬 호출해 단일 응답으로 정규화한 결과를 함께 검수합니다.
RECOMMENDED