HTAX_사업자등록증명원 발급(회원)(간편인증)

HTAX_사업자등록증명원 발급(간편인증) 회원

METHOD

POST

URI

/scrap/common/hometax/BusinessLicenseSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2022-06-24

Request Fields

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

REGNUMBER

사업자번호 또는 주민번호

NUMBER

"-" 구분 없이 숫자만 입력

TELNUMBER

전화번호

STRING

예)00-1234-1234 또는 00-123-1234

HPNUMBER

휴대전화번호

STRING

예)000-1234-1234 또는 000-123-1234

EMAIL

이메일

STRING

JUMINYN

주민번호공개

STRING

1: 공개, 2: 비공개

LOGINOPTION

간편인증로그인방법

STRING

0 :카카오톡
1:삼성패스
2:페이코
3:통신사
4:KB모바일인증서

USERNAME

신청자명

STRING

JUMINNUM

신청자 주민번호

true

STRING

"-"없이 숫자만 입력

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.RCATNO

접수번호

STRING

data.CVARROADNMADR

사업장소재지

STRING

data.RCATDTM

발급년월일시분초

STRING

data.TXPRNM

상호(법인명)

STRING

data.CRPNO

법인등록번호

STRING

개인사업자의 경우 법인등록번호X

data.CVARRESNO

주민등록번호

true

STRING

암호화필드

data.TXPRDSCMDT

개업일자

NUMBER

data.TXPRDSCMNOENCCNTN

사업자등록번호

STRING

data.RPRSTXPRNM

성명(대표자)

STRING

data.ITMNM

종목

STRING

data.BMANRGTDT

사업자등록일

STRING

data.BCNM

업태

STRING

data.TFBCD

업종코드

STRING

data.BMANCLNM

사업자유형

STRING

data.CVACHRGDPRTNM

담당부서

STRING

data.CERCVAISNNO

발급번호

STRING

data.CVACHRGTELNO

연락처

STRING

data.CVACHRGOGZFRMYNM

발급기관

STRING

data.CVACHRGFNM

담당자

STRING

data.LIST[].TXPRNM

공동대표자성명(법인명)

STRING

공동사업자 미존재시 필드 출력 안함

data.LIST[].TXPRDSCMNOENCCNTN

공동사업자주민(사업자)등록번호

STRING

공동사업자 미존재시 필드 출력 안함

HTTP Request

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

{
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "TELNUMBER" : "02-1234-1234",
  "HPNUMBER" : "010-1234-1234",
  "EMAIL" : "abc123@gmail.com",
  "JUMINYN" : "2",
  "LOGINOPTION" : "0",
  "USERNAME" : "홍길동",
  "JUMINNUM" : "8SxYL+DfTfMfIOWng=="
}

HTTP Response

HTTP/1.1 200 OK
Date:Fri, 24 Jun 2022 05:53:39 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 809

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "CVACHRGOGZFRMYNM" : "구로세무서",
    "ETRACK" : "",
    "BMANCLNM" : "( 일반과세자 )",
    "BMANRGTDT" : "20161206",
    "CVACHRGDPRTNM" : "민원봉사실",
    "RPRSTXPRNM" : "홍길동",
    "CERCVAISNNO" : "6504-431-0396-456",
    "CVARRESNO" : "8SxYL+DffMfIOWng==",
    "CVARROADNMADR" : "서울특별시 금천구 가산디지털2로 98",
    "TXPRNM" : "홍두깨",
    "ERRMSG" : "",
    "CRPNO" : "",
    "RCATDTM" : "20220624133711",
    "CVACHRGFNM" : "김담당",
    "ECODE" : "",
    "RCATNO" : "501179945631",
    "ERRDOC" : "",
    "BCNM" : "도매 및 소매업",
    "CVACHRGTELNO" : "02-2630-7225",
    "ITMNM" : "상품종합 중개업",
    "TFBCD" : "511119",
    "TXPRDSCMDT" : "20161212",
    "TXPRDSCMNOENCCNTN" : "8SxJ+GDfTfMfIOWng==",
    "RESULT" : "SUCCESS",
    "LIST" : [ ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/BusinessLicenseSimple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "TELNUMBER" : "02-1234-1234",
  "HPNUMBER" : "010-1234-1234",
  "EMAIL" : "abc123@gmail.com",
  "JUMINYN" : "2",
  "LOGINOPTION" : "0",
  "USERNAME" : "홍길동",
  "JUMINNUM" : "8SxYL+DfTfMfIOWng=="
}'

참고자료

2 Path Fields

Response

errCode 값이 '0001' 인 경우 다음의 응답 데이터가 리턴됨.

필드명(영문) 필드명(한글) 양식 설명

data.callbackId

콜백ID

data.callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'

data.callbackData

구분 값

Base64 Image.

data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.

data.timeout

타임아웃

해당시간까지 입력 가능

Request

다음의 API 로 요청

METHOD

POST

URI

/scrap/captcha
필드명(영문) 필드명(한글) 양식 설명

callbackId

콜백ID

data.callbackId 필드로 응답받은 콜백ID 입력

callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'

data.callbackType 필드로 응답 받은 구분 입력

callbackResponse

구분 값

callbackType(구분)이 'SMS', 'CAPTCHA', 'OTP', 'SINGLE’일 경우 인증문자 입력.

callbackResponse1

임시 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당. 요청 시 입력한 Email로 받은 임시 비밀번호.

callbackResponse2

변경할 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당.

retry

캡챠이미지 갱신여부

'Y':이미지 갱신

callbackType(구분)이 'CAPTCHA’일 경우에만 해당.