홈택스 휴폐업조회

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

METHOD

POST

URI

/scrap/common/nts/ClosedBusinessInquiry

Request fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

REGNUMBER

사업자등록번호

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

Response fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

data.RESULT

전체 성공/실패 여부

SUCCESS : 성공 FAIL :실패

data.ERRMSG

에러메세지

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

data.ERRDOC

에러 문서 메시지

data.ECODE

에러코드

data.ETRACK

에러추적번호

data.CORPREGNUMBER

사업자등록번호

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

data.CHECKDATE

확인일자/시간

YYYYMMDDHHNNSS

data.CORPSTATE

기업상태

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

data.TAXDATE

휴폐업일자

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

data.TAXKIND

과세유형

1:일반,2:간이,3:면세,9:기타

data.CHANGEDATE

전환일자

휴폐업 전환일자를 표시

errCode

errCode

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

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

HTTP request

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

{
  "REGNUMBER" : "1234567890"
}

HTTP response

HTTP/1.1 200 OK
Date: Mon, 24 Aug 2020 05:21:11 GMT
Connection: keep-alive
Content-Length: 349
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "CHANGEDATE" : "",
    "ETRACK" : "",
    "ERRMSG" : "",
    "CORPSTATE" : "1",
    "CORPREGNUMBER" : "2148159394",
    "CHECKDATE" : "20200824141041",
    "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"
}'