세무대행 SaaS의 수임처 계정 관리
- 신규 수임처 온보딩 시 회원가입·아이디 발급·인증서 등록까지 한 플로우로 처리
- 수임처 비밀번호 만료·인증서 갱신 알림을 자동화해 업무 중단을 줄이는 구조
- 부서사용자 신청·승인으로 세무대리인 내부 역할 분리 관리
OVERVIEW
홈택스 접속에 필수적인 회원 가입·인증서 등록·로그인 자격 관리·아이디/비밀번호 찾기와 부서사용자 신청·승인을 묶어 관리하는 유형의 API입니다. 회원정보 조회로 주민(사업자) 등록번호·성명·대표자명·개업일자·상호명·사업자 상태 같은 개인·개인사업자·법인사업자의 기본 회원 정보를 확보할 수 있고, 인증서 등록·비밀번호 변경·재발급·아이디 중복 체크 엔드포인트로 홈택스 접근 권한의 수명주기를 일관되게 관리할 수 있습니다. 세무대행·ERP·경영관리 SaaS가 수임처 계정 생애주기, 다중 사용자(부서) 권한, 인증서 만료 대응을 자동화하거나 고객이 홈택스 계정을 처음 만드는 온보딩 플로우를 설계할 때 자주 선택되는 카테고리입니다.
SYSTEM FLOW
클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 9개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.
ENDPOINTS
| API명 | 제공 정보 | 자료 출처 |
|---|---|---|
| 회원정보 조회 | 반환주민(사업자)등록번호·성명·대표자명·개업일자·상호명·사업자 상태 등 개인·개인사업자·법인사업자의 회원 기본 정보 | 홈택스 |
| 홈택스 인증서 등록 | 입력인증서·비밀번호 반환등록 처리 결과 | 홈택스 |
| 홈택스 회원가입 | 입력회원 기본 정보·약관 동의 반환회원 가입 결과·회원ID | 홈택스 |
| 홈택스 회원가입 아이디 중복 체크 | 입력희망 아이디 반환중복 여부(Y/N) | 홈택스 |
| 부서사용자 신청 | 입력대표 계정 권한·부서원 정보 반환신청 결과 (법인·다중 사용자 계정용) | 홈택스 |
| 부서사용자 조회 및 승인 | 반환부서사용자 목록·승인 상태 입력승인/반려 처리 | 홈택스 |
| 홈택스 아이디 찾기 | 입력본인인증 정보 반환가입된 아이디 | 홈택스 |
| 홈택스 비밀번호 재발급 | 입력아이디·본인인증 정보 반환재발급 토큰 | 홈택스 |
| 홈택스 비밀번호 변경 | 입력현재/변경 비밀번호 반환변경 결과 | 홈택스 |
USE CASES
세무대행·ERP·경영관리 SaaS가 수임처 계정 생애주기·부서 권한·인증서 만료 대응을 자동화하려 할 때 자주 선택되는 홈택스 계정 관리 API 유형입니다.
ONBOARDING
상담부터 연동·검수까지 네 단계로 진행합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 01
필요한 데이터와 사용 목적을 알려주시면 접수합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 02
원천 공개 여부와 수집 방식, 법적 검토를 거쳐 상담 접수 후 2~5영업일 내 타당성을 회신드립니다.
STEP 03
견적 단계에서 응답 스키마를 합의합니다. 필드명·필터·요약 가공은 정규화 레이어에서 조정합니다.
STEP 04
인증키를 발급하고 연동합니다. 필요한 원천을 병렬 호출해 단일 응답으로 정규화한 결과를 함께 검수합니다.
FAQ
회원정보 조회, 홈택스 인증서 등록, 홈택스 회원가입, 홈택스 회원가입 아이디 중복 체크, 부서사용자 신청, 부서사용자 조회 및 승인 등 총 9종의 엔드포인트를 제공합니다. 반환: 주민(사업자)등록번호·성명·대표자명·개업일자·상호명·사업자 상태 등 개인·개인사업자·법인사업자의 회원 기본 정보
신규 수임처 온보딩 시 회원가입·아이디 발급·인증서 등록까지 한 플로우로 처리. 수임처 비밀번호 만료·인증서 갱신 알림을 자동화해 업무 중단을 줄이는 구조. 부서사용자 신청·승인으로 세무대리인 내부 역할 분리 관리.
경리팀·재무팀·대표이사 등 역할별 홈택스 권한 분리에 부서사용자 기능 활용. 인증서 등록·비밀번호 변경 이력을 사내 보안 감사 로그에 편입. 직원 퇴사·보직 변경 시 부서사용자 승인을 자동 반려·권한 회수.
홈택스 처음 사용자를 위한 가입 가이드를 앱 내에서 end-to-end로 제공. 아이디 찾기·비밀번호 재발급을 고객센터 단축 기능으로 노출. 회원정보 조회를 초기 대시보드 요약 데이터로 활용.
홈택스에서 조회한 결과를 수집해 단일 스키마로 정규화합니다. 원천 공개 여부와 수집 방식, 법적 검토는 상담 접수 후 타당성 회신 단계에서 확인합니다.
상담 접수 후 2~5영업일 내 타당성과 범위를 회신하고, 견적 단계에서 응답 스키마(필드명·필터·요약 가공)를 합의합니다. 비용과 기간은 이 합의 범위에 따라 견적으로 안내합니다.
가능합니다. 원천 공개 여부·수집 방식·법적 검토가 선행되며, 상담 접수 후 2~5영업일 내 타당성 회신을 드립니다.
RECOMMENDED