홈택스 전자세금계산서 조회 오류코드

팝빌 SDK 함수 호출이 정상적으로 처리되지 않은 경우 함수 리턴으로 오류코드(code)와 오류메시지(message)가 반환됩니다. 팝빌 SDK 함수 호출시 발생하는 오류의 원인파악이 어려운 경우, 반환되는 오류정보를 확인하여 기술지원센터( 1600-9854 / code@linkhub.co.kr )로 문의하여 주시기 바랍니다.

오류코드 분류

팝빌 SDK 함수 호출이 정상적으로 처리된 경우 code는 1이 반환되며, 오류 발생시 -로 시작하는 8자리 숫자값이 반환됩니다.

  • -111* 홈택스 연동 서비스 오류코드
  • -100* 팝빌 서비스 공통 오류코드

오류코드 테이블

오류코드 오류메시지
-11100001 홈택스 로그인 실패
-11100002 수집 태스크 초기화 실패
-11100003 세금계산서 세션 레인지 체크 오류
-11100004 현금영수증 세션 레인지 체크 오류
-11100005 SSO 토큰 생성 실패
-11100006 홈택스 세션 확인 실패
-11100007 홈택스 세금계산서 자료 수신 실패
-11100008 홈택스의 이중로그인 방지에 의해 로그아웃되었습니다.
-11100009 홈택스의 응답이 올바르지 않습니다.
-11100010 홈택스 현금영수증 자료 수신 실패
-11100011 홈택스 응답의 필수정보가 부족합니다.
-11100012 세금계산서 XML 수집 실패
-11100013 수집한 XML 파일의 형식이 올바르지 않습니다.
-11100014 공급자, 공급받는자 사업자 번호 추출 실패
-11100015 XML 파일 요청에 대한 홈택스의 응답이 올바르지 않습니다.
-11100016 홈택스 로그인 과정에서 알수 없는 오류가 발생하였습니다.
-11100017 홈택스 자료수집 과정에서 알수 없는 오류가 발생하였습니다.
-11100018 Invalid SessionID
-11100019 Invalid CorpNum
-11100020 Invalid NTSConfirmNum
-11101001 작업ID에 해당하는 수집작업이 존재하지 않습니다.
-11101002 작업ID에 해당하는 XML 수집작업이 존재하지 않습니다.
-11101003 해당 세션아이디의 회원이 존재하지 않습니다.
-10002016 등록된 홈택스 인증서가 없습니다.
-11101005 등록된 홈택스 인증서를 로드할 수 없습니다.
-11101006 등록된 홈택스 인증서로 서명하는 도중 오류가 발생하였습니다.
-11101007 수집유형이 입력되지 않았습니다.
-11101008 수집기간이 입력되지 않았습니다.
-11101009 수깁기간의 유형이 올바르지 않습니다.
-11101010 수집기간이 올바르게 입력되지 않았습니다.
-11101011 작업ID가 입력되지 않았습니다.
-11101012 수집할 국세청 승인번호가 입력되지 않았습니다.
-11101013 작업ID에 해당하는 휴폐업조회 작업이 존재하지 않습니다.
-11101014 세금계산서 부서사용자 정보가 등록되어 있지 않습니다.
-11101015 현금영수증 부서사용자 정보가 등록되어 있지 않습니다.
-11101016 부서사용자 정보를 확인할 수 없습니다.
-11101017 홈택스 부서사용자 비밀번호 암호화 실패
-11101018 검색기간은 1년 이내로 입력하여 주십시오.
-11101019 검색기간은 2개월 이내로 입력하여 주십시오.
-11101020 검색기간의 시작일자는 종료일자보다 작아야 합니다.
-11101021 미래일자에 대해서는 작업을 지원하지 않습니다.
-11110001 문서 유형이 올바르게 입력되지 않았습니다.
-11110002 검색일자 유형이 입력되지 않았습니다.
-11110003 검색일자 유형이 올바르게 입력되지 않았습니다.
-11110004 검색일자 형식이 올바르지 않습니다.
-11110005 수집작업이 진행중입니다.
-11110006 Invalid CorpNumType
-11110007 조회기간 유형이 입력되지 않았습니다.
-11110008 종사업장 식별번호 유형이 올바르지 않습니다.
-11110009 수집작업이 실패하였습니다. 
-11110010 부서사용자 아이디가 입력되지 않았습니다.
-11110011 부서사용자 비밀번호가 입력되지 않았습니다.
-10000000 NOT YET IMPLEMENTED
-10000001 CHECKSTATE IS FAIL [ ... ]
-10000002 검색조건의 상태값은 반드시 1개 이상 지정하여야 합니다.
-10000003 검색할 수 있는 지사가 아닙니다.
-10000004 세션 정보가 존재하지 않습니다.
-10000005 Role 분류가 입력되지 않았습니다.
-10000006 아이디가 입력되지 않았습니다.
-10000007 비밀번호 형식이 올바르지 않습니다.
-10000008 해당 아이디 정보가 존재하지 않습니다.
-10000009 비밀번호가 일치하지 않습니다.
-10000010 인증키 정보가 존재하지 않습니다.
-10000011 해당 사업자의 연동회원 정보가 존재하지 않습니다.
-10000012 파트너아이디와 사업자번호로 사용자를 식별할 수 없습니다.
-10000013 기존 비밀번호와 일치하지 않습니다.
-10000014 해당 사업자번호의 회원가입 정보가 존재하지 않습니다.
-10000015 확인할 사업자번호가 입력되지 않았습니다.
-10000016 이메일 구성중 오류가 발생하였습니다.
-10000017 관리자 승인을 대기중입니다.
-10000018 관리자에 의해 사용이 중지되었습니다.
-10000019 탈퇴한 사용자입니다.
-10000020 삭제된 사용자입니다.
-10000021 사용이 중지된 아이디입니다.
-10000022 비밀번호를 재설정 하시기 바랍니다.
-10000023 토큰 암호화를 실패 하였습니다.
-10000024 비밀번호 암호화를 실패 하였습니다.
-10000025 비밀번호가 초기화 되었습니다.
-10000026 비밀번호가 설정되지 않았습니다.
-10000027 비밀번호 확인중 오류가 발생하였습니다.
-10000028 비밀번호 변경이 실패하였습니다. (해쉬값 생성 오류)
-10000029 접근 IP에 대한 정보가 존재하지 않습니다.
-10000030 Fail To Retry Lock
-10000031 중복처리 방지를 위한 잠금이 실패하였습니다. 잠시후 재시도 하시기 바랍니다.
-10000032 토큰 생성을 실패하였습니다.
-10000033 토큰 해석을 실패하였습니다.
-10000034 인증정보가 입력되지 않았습니다.
-10000035 첨부파일 처리중 오류가 발생하였습니다.
-10000036 회원코드가 존재하지 않습니다.
-10000037 확인할 회원코드가 입력되지 않았습니다.
-10000038 인증키와 사용자아이디로 사용자를 식별할 수 없습니다.
-10000039 해당 사업자의 사용자가 아닙니다.
-10000040 확인할 파트너아이디가 입력되지 않았습니다.
-10000041 아이디의 최대길이는 20자입니다.
-10000042 아이디는 4~20자의 영문 대소문자, 숫자와 특수문자(-,_)만 사용 가능합니다.
-10001000 해당 사업자번호는 가입된 회원입니다.
-10001001 가입정보가 입력되지 않았습니다.
-10001002 비밀번호가 입력되지 않았습니다.
-10001003 해당 아이디는 사용중입니다.
-10001004 사업자번호가 입력되지 않았습니다.
-10001005 대표자명이 입력되지 않았습니다.
-10001006 상호가 입력되지 않았습니다.
-10001007 사업자 주소가 입력되지 않았습니다.
-10001008 업태가 입력되지 않았습니다.
-10001009 종목이 입력되지 않았습니다.
-10001010 담당자 정보가 입력되지 않았습니다.
-10001011 담당자 이메일이 입력되지 않았습니다.
-10001012 담당자 전화번호가 입력되지 않았습니다.
-10001013 담당자명이 입력되지 않았습니다.
-10001014 해당 사업자의 담당자가 존재하지 않습니다.
-10001015 관리자를 변경할 권한이 없습니다.
-10001016 회원사의 담당자 아이디가 아니거나, 미등록 아이디입니다.
-10001017 담당자 상태를 변경할 권한이 없습니다.
-10001018 담당자코드가 입력되지 않았습니다.
-10001019 담당자 정보가 존재하지 않습니다.
-10001020 회원코드가 입력되지 않았습니다.
-10001021 회원코드 정보가 존재하지 않습니다.
-10001022 등록된 아이디가 아니거나, 탈퇴한 아이디입니다.
-10001023 동록된 공인인증서는 관리자만 삭제할 수 있습니다.
-10001024 해당 회원에 대한 정보가 존재하지 않습니다.
-10001025 수정할 담당자 정보가 입력되지 않았습니다.
-10001026 수정할 회원사의 담당자가 아닙니다.
-10001027 회원정보 수정이 제한되어 있습니다.
-10001028 담당자명이 입력되지 않았습니다.
-10001029 이메일이 입력되지 않았습니다.
-10001030 비밀번호 재설정 정보가 일치하지 않습니다.
-10001031 등록된 인감이 없습니다.
-10001032 등록된 사업자등록증이 없습니다.
-10001033 등록된 통장사본이 없습니다.
-10001034 사업자번호가 입력되지 않았습니다.
-10001035 보안토큰이 입력되지 않았습니다.
-10001036 보안토큰 확인을 실패하였습니다.
-10001037 보안토큰 타겟이 입력되지 않았습니다.
-10001038 채널 아이디가 입력되지 않았습니다.
-10001039 토큰발행을 위한 고유번호 확인을 실패하였습니다.
-10001040 보안토큰 발행중 오류가 발생하였습니다.
-10001041 만료된 보안토큰입니다.
-10001042 정상적인 보안토큰이 아닙니다.
-10001043 아이디가 입력되지 않았습니다.
-10001044 해당 사용자는 구 팝빌 회원이 아닙니다.
-10001045 우편번호의 길이는 10자리를 넘을 수 없습니다.
-10001046 사업자번호의 형식이 맞지 않습니다.
-10001047 회원가입 세션이 준비되지 않았습니다.
-10001048 비밀번호 재설정 메일 전송은 관리자만 가능합니다.
-10001049 비밀번호 재설정 메일 전송을 할 담당자 정보가 존재하지 않습니다.
-10001050 잔여포인트 알림 한도가 입력되지 않았습니다.
-10001051 임시저장 알림 일자가 입력되지 않았습니다.
-10001052 발행대기 알림일자가 입력되지 않았습니다.
-10001053 알림문자를 수신할 번호가 설정되어 있지 않습니다.
-10001054 업태의 길이는 100자를 넘을 수 없습니다.
-10001055 종목의 길이는 100자를 넘을 수 없습니다.
-10001056 대표자성명의 길이는 100자를 넘을 수 없습니다.
-10001057 상호의 길이는 200자를 넘을 수 없습니다.
-10001058 주소의 길이는 300자를 넘을 수 없습니다.
-10001059 유효한 사업자번호가 아닙니다.
-10001060 부서사용자 아이디가 입력되지 않았습니다.
-10001061 부서사용자 비밀번호가 입력되지 않았습니다.
-10001062 등록된 부서사용자는 관리자만 삭제할 수 있습니다.
-10001063 부서사용자가 등록되어 있지 않습니다.
-10002000 거래처 정보가 입력되지 않았습니다.
-10002001 거래처 구분이 지정되니 않았습니다.
-10002002 거래처 등록번호가 입력되지 않았습니다.
-10002003 거래처명이 입력되지 않았습니다.
-10002004 거래처 대표자명이 입력되지 않았습니다.
-10002005 거래처 담당자 이메일 주소가 입력되지 않았습니다.
-10002006 거래처 담당자명이 입력되지 않았습니다.
-10002007 거래처 담당자 이메일 주소가 입력되지 않았습니다.
-10002008 해당 거래처 정보가 존재하지 않거나, 회원의 거래처가 아닙니다.
-10002009 등록된 공인인증서가 없습니다.
-10002010 거래처 담당자 정보가 입력되지 않았습니다.
-10002011 담당자 추가는 사업자 거래처만 가능합니다.
-10002012 해당 거래처 담당자 정보가 존재하지 않습니다.
-10002013 거래처 종사업장번호는 4자리 숫자입니다.
-10002014 품목코드가 입력되지 않았습니다.
-10002015 품목명이 입력되지 않았습니다.
-10002016 등록된 홈택스 공인인증서가 없습니다.
-10002020 품목 정보가 입력되지 않았습니다.
-10002021 해당 품목 정보가 존재하지 않거나, 회원의 품목이 아닙니다.
-10002022 거래처명의 최대길이는 200자를 넘을 수 없습니다.
-10002023 거래처 대표자명의 최대길이는 100자를 넘을 수 없습니다.
-10002024 거래처 종목의 길이는 100자를 넘을 수 없습니다.
-10002025 거래처 업태의 길이는 100자를 넘을 수 없습니다.
-10002026 거래처 담당자명의 최대길이는 100자를 넘을 수 없습니다.
-10002027 거래처 담당자 직책의 최대길이는 20자를 넘을 수 없습니다.
-10002030 문자메시지 구성에 실패하였습니다.
-10003000 과금 세션이 준비되지 않았습니다.
-10004000 발행에 필요한 공인인증서가 등록되어 있지 않습니다.
-10004001 공인인증서 로딩에 실패하였습니다.
-10004002 등록된 공인인증서의 해쉬 알고리즘을 확인할 수 없습니다.
-10004003 만료된 공인인증서입니다.
-10004004 아직 유효하지 않은 공인인증서입니다.
-10004005 유효하지 않은 공인인증서입니다.
-10004006 해당 인증서는 서명용 인증서가 아닙니다.
-10005001 사용이 중지된 관리자입니다.
-10005002 결제처리 결과가 존재하지 않습니다.
-10005003 결제코드 정보가 존재하지 않습니다.
-10005004 결제 회원정보가 존재하지 않습니다.
-10005005 결제 담당자 정보가 존재하지 않습니다.
-10005006 조회된 결제내역이 없습니다.
-10005007 파트너결제 회원이 아닙니다.
-10006001 신규 비밀번호가 입력되지 않았습니다.
-10006002 비밀번호 길이는 최소 6자 이상, 최대 20자 이하 입니다.
-10006003 비밀번호는 최소 1개 이상의 영문, 숫자, 특수기호가 조합되어야 합니다.
-10006004 관리자만 사용 가능합니다.
-10006005 관리자 정보가 존재하지 않습니다.
-10006006 담당자 정보가 존재하지 않습니다.
-10006007 티켓 발급 권한이 없습니다.
-10006008 티켓 암호화를 실패하였습니다.
-10006009 상담내역이 존재하지 않습니다.
-10006010 게시판 종류 정보가 존재하지 않습니다.
-10006011 해당 게시글의 작성자가 아닙니다.
-10006012 해당 게시글 수정 권한이 없습니다.
-10006013 해당 게시글 삭제 권한이 없습니다.
-10006014 수정할 세금계산서 설정정보가 입력되지 않았습니다.
-10006015 변경할 SMS 템플릿 설정이 입력되지 않았습니다.
-10006016 명세서 종류가 입력되지 않았습니다.
-10006017 양식이름이 입력되지 않았습니다.
-10006018 첫페이지 상세 갯수가 입력되지 않았습니다.
-10006019 뒷페이지 상세 갯수가 입력되지 않았습니다.
-10006020 해당 링크허브파트너 정보가 없습니다.
-10006021 수정할 파트너 설정정보가 입력되지 않았습니다.
-10006022 등록할 맞춤양식 정보가 입력되지 않았습니다.
-10006023 해당 맞춤양식 정보가 존재하지 않습니다.
-10006024 수정할 맞춤양식 정보가 입력되지 않았습니다.
-10006025 유효한 발신번호 상태가 아닙니다.
-10006026 해당 발신번호는 등록되어 있지 않습니다.
-10006027 발신번호가 입력되지 않았습니다.
-10006028 이미 등록되어 있는 발신번호 입니다.
-10006029 등록 가능한 발신번호가 모두 등록되었습니다.
-10006030 수정할 전자명세서 설정정보가 입력되지 않았습니다.
-10007001 Invalid PDF Document
-10007002 PDF 생성기 초기화에 실패하였습니다.
-10007003 PDF 생성을 위한 URL확인에 실패하였습니다.
-10007004 PDf 생성에 실패하였습니다.
-10010001 파트너 아이디가 입력되지 않았습니다.
-10010002 사용자아이디가 입력되지 않았습니다.
-10010003 Fail to read uploaded file.
-10010004 Fail to issue Ticket.
-10010005 회원가입정보 파싱실패. [Malformed JSON]
-10010006 사업자번호(권한정보)가 입력되지 않았습니다.
-10010007 회원가입정보가 입력되지 않았습니다.
-10010008 회사 정보 파싱실패[Malformed JSON]
-10010009 담당자 추가 정보 파싱실패[Malformed Json]
-10010010 당당자 수정 정보 파싱실패[Malformed Json]
-10010011 검색일자 유형이 입력되지 않았습니다.
-10010012 검색일자 유형이 올바르게 입력되지 않았습니다.
-10010013 검색일자 형식이 올바르지 않습니다.
-10010014 APIKey가 입력되지 않았습니다.
-10010015 ItemCode가 입력되지 않았습니다.
-10010016 회원사업자번호가 입력되지 않았습니다.
-10011001 극동시스템 회원이 아닙니다.
-10011002 해당 회원코드의 극동시스템 회원이 존재하지 않습니다.
-10011003 해당 연결 문자열이 존재하지 않습니다.
-10011004 수정할 연결설정이 존재하지 않습니다.
-10011005 삭제할 연결설정이 존재하지 않습니다.
-10011006 변경할 연결설정이 존재하지 않습니다.
-10011007 회원코드가 입력되지 않았습니다.
-10011008 ConnID가 입력되지 않았습니다.
-10012001 링크아이디 미입력
-10012002 파트너코드 미입력
-10012003 전환 사업자번호 미입력
-10012004 이미 등록되어 있는 파트너 이관정보입니다.
-10012005 해당 이관결과 정보가 존재하지 않습니다.
-10012006 해당 파트너의 이관 준비가 완료되지 않았습니다.
-10012007 해당 회원은 이관 대상이 아닙니다.
-10012008 해당 사업자의 이관내역이 없습니다.
-10012009 이관 결과상태를 변경 할 수 없습니다.
-10012010 등록할 파트너의 링크아이디가 입력되지 않았습니다.
-10013001 메시지 템플릿 정보가 입력되지 않았습니다.
-10013002 해당 메시지 템플릿이 존재하지 않거나, 회원의 템플릿이 아닙니다.
-10014001 주소그룹 코드가 입력되지 않았습니다.
-10014002 주소그룹이 존재하지 않습니다.
-10014003 주소그룹 정보가 입력되지 않았습니다.
-10014004 그룹코드가 입력되지 않았습니다.
-10014005 수정할 그룹명이 입력되지 않았습니다.
-10014006 삭제할 주소그룹 정보가 입력되지 않았습니다.
-10014007 주소정보가 존재하지 않습니다.
-10014008 주소정보가 입력되지 않았습니다.
-10014009 주소코드가 입력되지 않았습니다.
-10014010 삭제할 주소정보가 입력되지 않았습니다.
-99005001 파트너 잔여포인트가 부족합니다.
-99005002 후불 월한도를 초과하였습니다.
-99005003 차감할 충전포인트가 부족합니다.
-99005004 차감할 보너스포인트가 부족합니다.
-99005005 잔여포인트가 부족합니다.
-99005006 환불 가능한 건수가 없습니다.
-99005007 과금위치를 확인할 수 없습니다.
-99005008 일반SITE 과금이 제한되어 있습니다.
-99005009 연동API 과금이 제한되어 있습니다.
-99005010 파트너과금 방식이 아닙니다.
-99005011 회원정보가 필요한 서비스입니다.
-99005012 파트너과금 전용 서비스입니다.
-99005013 후불 일한도를 초과하였습니다.
-99005014 완충금 한도를 초과하였습니다.
-99005015 일 사용건수 한도를 초과하였습니다.
-99005016 월 사용건수 한도를 초과하였습니다.
-99005017 파트너 완충금 한도를 초과하였습니다.

기술지원센터

팝빌 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.

T. 1600-9854   E. code@linkhub.co.kr

연동문의