홈택스 자료 수집을 위한 사전 점검 사항부터 로그인 방식별 권장 설정, 오류 발생 시 해결 방법까지 안내합니다.
자료 수집 전 아래 기본 실행 환경이 충족되어 있는지 확인해 주세요.
자동수집 PC 환경: 수집을 실행하는 PC의 전원이 켜져 있고, 절전모드 및 최대절전모드가 해제되어 있어야 합니다.
인증서 설치 여부: 자동 수집에 사용하는 유효한 공동인증서가 실제로 등록된 PC에서 저장되어 있어야 합니다.
수임 정보 정확도: 홈택스 수임동의 상태, 로그인 아이디·비밀번호, 세무대리인 관리번호가 올바르게 입력되어 있는지 점검합니다.
중복 로그인 여부: 동일한 아이디로 다른 사용자가 홈택스에 동시 로그인 중이지 않은지 확인합니다.
조회 권한 확인: 등록한 계정 또는 인증서가 조회 대상 거래처의 자료를 열람할 수 있는 권한이 있는지 확인합니다.
수집 결과에 차이가 발생할 때는 등록된 수집 방식과 계정에 부여된 권한을 확인해야 합니다.
인증서 방식 (전체 수집 권장)
여러 업무용 아이디로 각각 신고한 거래처의 자료를 한 번에 수집할 때 적합합니다.
인증서의 유효기간 및 등록 상태를 점검해야 하며, 홈택스 기장대리 수임동의가 선행되어 있어야 조회가 가능합니다.
부서사용자 방식 (계정 권한 기준)
등록한 부서사용자 계정의 권한 범위에 따라 수집 대상이 달라집니다.
기본적으로 해당 계정으로 직접 접수한 내역 중심으로 수집되므로, 전체 거래처 수집을 위해서는 홈택스 대표자 계정에서 '전체 거래처 조회 권한'이 부여되어 있는지 확인해야 합니다.
반드시 담당자 개인 아이디일 필요는 없으며, 핵심은 해당 아이디에 필요한 조회 권한이 매핑되어 있는가입니다.
홈택스 신고용 아이디와 위멤버스 수집용 아이디를 분리하여 사용하는 것을 적극 권장합니다.
분리 목적 (중복 로그인 방지): 자동 수집이 진행되는 도중 직원이 동일한 업무용 ID로 홈택스에 접속하면 중복 로그인으로 인식되어 수집 세션이 강제 종료됩니다.
역할 분담
업무용 ID: 홈택스 사이트 직접 접속 및 전자신고 업무 전용
수집 전용 ID: 위멤버스 수집 전용으로 등록하여 백그라운드 스크래핑에 활용
설정 경로: [수임처 > 환경설정() > 부서사용자계정 등록]
주의: [부서사용자계정 등록] 메뉴에 대표세무사(대표자) 본인의 ID를 입력하면 인증 오류가 발생합니다. 대표자 ID는 삭제하고, 홈택스 대표자 계정에서 '전체 권한을 부여한 별도의 수집 전용 부서사용자 ID'를 생성해 등록해 주세요.
부서사용자 신고 귀속 확인: 등록된 부서사용자 ID로 직접 신고한 내역만 가져온 상태인지 확인합니다.
조회 권한 범위: 해당 부서사용자 계정에 사무소 전체 거래처 권한이 부여되어 있는지 점검합니다.
홈택스 원본 대조: 실제 홈택스 웹사이트에서 해당 거래처의 신고서·납부서가 정상 접수 및 고지되어 있는지 먼저 대조합니다.
재조회 반영: 홈택스에서 권한을 수정한 후 위멤버스에서 다시 조회를 실행하여 최신 데이터를 동기화합니다.
동시 접속 점검: 다른 직원이나 타 세무 프로그램(백그라운드 스크래핑)이 동일 계정으로 홈택스에 접속 중인지 확인합니다.
계정 분리: 상단의 안내에 따라 '수집 전용 부서사용자 계정'을 생성하여 실무용 계정과 분리합니다.
시간차 조회: 자동 수집 작업이 완료된 후 수동 조회를 진행하거나, 이용 집중 시간대(10~12시, 14시경)를 피해 시도합니다.
PC 절전 상태: 예약 실행 시간에 수집 PC의 전원이 켜져 있었는지, 절전모드로 전환되지 않았는지 확인합니다.
모듈 정상 구동: 스크래핑 모듈(NXiSAS, NXiBASE)이 정상 설치되어 백그라운드에서 실행 중인지 점검합니다.
🔗 '스크래핑 모듈 설치 후 이용하시기 바랍니다.' 안내창이 생성되는 경우 조치 방법
계정/인증서 변경 여부: 최근 홈택스 비밀번호가 변경되었거나 인증서가 만료·갱신되지 않았는지 확인합니다.
1) 신고 업무: 실제 담당자의 업무용 홈택스 계정으로 진행합니다.
2) 위멤버스 수집: 세션 충돌을 방지하기 위해 인증서 방식 또는 '수집 전용 부서사용자 계정'을 활용합니다.
3) 권한 확인: 전체 거래처 수집이 목적이라면 등록 계정에 전체 조회 권한이 활성화되어 있는지 확인합니다.
4) 환경 일원화: 자동 수집 스케줄러 PC와 인증서가 설치된 PC 환경을 동일하게 유지합니다.
5) 단계적 검증: 최초 설정 시 1~2개 거래처를 먼저 수집하여 데이터 정합성을 확인한 후 전체 거래처로 확대합니다.
위 항목(PC/모듈 상태, 수임동의, 계정 정보, 권한 설정)을 모두 점검했음에도 동일 오류가 지속된다면 채팅 상담으로 아래 정보를 남겨주세요. 전문 상담사가 수집 환경을 점검해 드립니다.
[홈택스 수집 오류 확인 요청 양식]
사용한 수집 방식: (인증서 / 부서사용자 중 선택)
문제가 발생한 거래처명 및 사업자등록번호:
수집 대상 자료 종류: (원천세 납부서, 부가세 통합자료, 지급명세서 등)
오류 코드 및 메시지 내용: (예: 80003720, 중복 로그인 등)
오류 발생 시각 및 최근 계정·권한 변경 여부: