홈택스

홈택스 세션 로그인(연동)

홈택스 연동에 등록해 둔 공인인증서로 로그인해 이후 조회와 발행에 쓸 세션을 만듭니다. 담당자가 인증서 파일을 직접 열거나 옮기지 않아도 되고, 법인과 개인 중 어느 자격으로 접속할지만 정하면 됩니다.

API 목록

이 상품에 포함된 API와 각 API가 돌려주는 데이터입니다.

MCP 도구: hometax__session__login

API	정보출처	데이터	개발가이드
홈택스 세션 로그인	국세청 홈택스	로그인 성공 여부, 법인과 개인 자격 구분, 등록된 세션 정보, 결과 메시지

회원가입하면 결제 수단 없이 바로 데모 환경에서 30일 동안 하루 10 사용 토큰으로 실제 기관 연결을 확인할 수 있습니다. 자격증명을 등록하면 연결할 수 있는 상품이 늘어납니다.요금제 보기

쓰는 AI를 고르면 연결 방법을 보여 드립니다. 연결한 뒤 AI에게 「홈택스 세션 로그인(연동)」을 요청하세요.

활용 시나리오

인증서와 비밀번호를 담당자 컴퓨터나 메신저로 주고받지 않고, 등록해 둔 자격으로 로그인해 사람이 인증서를 만질 일을 줄입니다.

밤사이 도는 계산서 수집이나 증명 신청 작업의 맨 앞에 로그인을 두어, 세션이 준비된 뒤에야 뒤따르는 업무가 시작되게 합니다.

조회 중 세션이 만료됐다는 오류를 받으면 이 로그인을 다시 불러 같은 인증서로 새 세션을 만들고, 실패한 조회만 다시 보냅니다. 신청과 발행은 다시 보내기 전에 홈택스 처리 내역부터 확인합니다.

같은 담당자가 법인 업무와 개인 사업자 업무를 함께 볼 때 어느 자격으로 접속할지 명시해, 엉뚱한 사업장 자료를 다루는 일을 막습니다.

연동 절차