홈택스

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

홈택스에 로그인해 API 연동용 세션(쿠키)을 생성합니다. 홈택스 연동 데이터를 내부 업무 흐름에 연결해 활용할 수 있습니다.

활용 시나리오

  • 연동 최초 로그인 — 신규 고객이 account_link 등록 후 첫 Job으로 세션을 만들고 이후 조회 신청 API를 연쇄 호출합니다.
  • 세션 만료 재로그인 — 세션 TTL 만료 로그아웃 후 동일 action으로 세션을 재생성합니다.
  • user_info 전처리 — 로그인 직후 session.user_info로 TIN 상호를 확인해 잘못된 사업자 연동을 조기에 발견합니다.
  • 파이프라인 선행 단계 — 배치 스케줄 워크플로의 맨 앞에 login Job을 두고 실패 시 후속 Job을 중단합니다.

연동 절차

  1. 1. account_link 자격 증명 — Console에서 홈택스 account_link와 로그인 자격(user_credentials KMS)을 준비합니다.
  2. 2. 로그인 유형 지정 — params.user로 법인(01) 또는 개인(02)을 선택합니다.
  3. 3. 세션 로그인 실행 — POST .../s1/login Job(hometax.session.login)을 호출합니다.
  4. 4. 후속 Job 연계 — 성공 후 조회 신청 발행 Job에 동일 account_link_id를 사용합니다.

API 상품 목록 보기

홈택스 세션 로그인(연동) 상세 페이지