홈택스 휴폐업조회

국세청홈택스 홈페이지 > 조회/발급 > 사업자상태 > 사업자등록번호로 조회 업무

METHOD

POST

URI

/scrap/common/nts/ClosedBusinessInquiry

Content Type

application/json

Charset

UTF-8

Last Updated

2023-04-07

Request Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

REGNUMBER

사업자등록번호

true

STRING

사업자등록번호

"-" 제외 10자리 숫자 입력

Response Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

errCode

errCode

STRING

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

STRING

RESULT값이 FAIL일 경우 스크래핑 서비스 오류 메세지 출력

data.ERRDOC

에러 문서 메시지

STRING

data.ECODE

에러코드

STRING

data.ETRACK

에러추적번호

STRING

data.CORPREGNUMBER

사업자등록번호

STRING

"-"없이 사업자등록번호 10자리 출력

data.CHECKDATE

확인일자/시간

STRING

YYYYMMDDHHNNSS

data.CORPSTATE

기업상태

STRING

1:정상,
2:폐업,
3:휴업,
9:기타

data.TAXDATE

휴폐업일자

STRING

계속사업자는 해당출력값이 출력안됨.

data.TAXKIND

과세유형

STRING

1:일반과세자,
2:간이과세자(세금계산서 미발급 사업자),
3:면세과세자,
6: 비영리 법인,
7:간이과세자(세금계산서 발급 사업자),
9:기타

data.CHANGEDATE

전환일자

STRING

휴폐업 전환일자를 표시

HTTP Request

POST /scrap/common/nts/ClosedBusinessInquiry
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 32
Content-Type: application/json;charset=UTF-8

{
  "REGNUMBER" : "1234567890"
}

HTTP Response

HTTP/1.1 200 OK
Date:Thu, 6 Apr 2023 23:49:51 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 349

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "CHANGEDATE" : "",
    "ETRACK" : "",
    "ERRMSG" : "",
    "CORPSTATE" : "1",
    "CORPREGNUMBER" : "1234567890",
    "CHECKDATE" : "20210201144611",
    "TAXDATE" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "TAXKIND" : "1"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/nts/ClosedBusinessInquiry' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "REGNUMBER" : "1234567890"
}'