HTAX_사업자등록증명원 발급

홈택스 사업자등록증명원 발급/신청 업무 (인증서로그인)

METHOD

POST

URI

/scrap/common/hometax/BusinessLicense

Content Type

application/json

Charset

UTF-8

Last Updated

2022-11-15

Request Fields

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

REGNUMBER

사업자번호 또는 주민번호

true

NUMBER

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

USERGUBUN

사용자구분

STRING

2:개인사업자, 3:법인

개인은 신청불가능함.

TELNUMBER

전화번호

STRING

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

HPNUMBER

휴대전화번호

STRING

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

EMAIL

이메일

STRING

JUMINYN

주민번호공개

STRING

1: 공개, 2: 비공개

P_CERTNAME

인증서이름

STRING

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

STRING

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

STRING

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

STRING

BASE64

개별인증서를 위한 CERT 정보

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

법인등록번호

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

data.CVARRESNO

주민등록번호

true

STRING

법인사업자의 경우 대표자주민번호X

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[]

목록 반복부

입력필드 FILEINFOGUBUN "Y" 일 경우 출력됨.

data.LIST[].TXPRNM

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

STRING

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

data.LIST[].TXPRDSCMNOENCCNTN

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

true

STRING

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

HTTP Request

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

{
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "USERGUBUN" : "3",
  "TELNUMBER" : "02-1234-1234",
  "HPNUMBER" : "010-1234-1234",
  "EMAIL" : "abc123@gmail.com",
  "JUMINYN" : "N",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 15 Nov 2022 04:26:37 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 903

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "CVACHRGOGZFRMYNM" : "금천세무서",
    "ETRACK" : "",
    "BMANCLNM" : "( 법인사업자 )",
    "BMANRGTDT" : "19930909",
    "CVACHRGDPRTNM" : "민원봉사실",
    "RPRSTXPRNM" : "홍길동",
    "CERCVAISNNO" : "3829-504-6610-839",
    "CVARRESNO" : "8SxYL+DffMfIOWng==",
    "CVARROADNMADR" : "서울특별시 금천구 가산디지털2로 98",
    "TXPRNM" : "홍두깨",
    "ERRMSG" : "",
    "CRPNO" : "1101110933518",
    "RCATDTM" : "20221115132634",
    "CVACHRGFNM" : "김담당",
    "ECODE" : "",
    "RCATNO" : "501179945631",
    "ERRDOC" : "",
    "BCNM" : "도매업|제조|통신업|서비스　　　　　　　|서비스",
    "CVACHRGTELNO" : "02-850-4225",
    "ITMNM" : "전자제품및컴퓨터주변기기　　　　　　/|전자제품및정보통신기기|부가통신사업(VAN)|소프트웨어자문，개발，공급|컴퓨터설비자문，정보통신관련업",
    "TFBCD" : "515070",
    "TXPRDSCMDT" : "19930426",
    "TXPRDSCMNOENCCNTN" : "8SxJ+GDfTfMfIOWng==",
    "RESULT" : "SUCCESS",
    "LIST" : [ ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/BusinessLicense' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "USERGUBUN" : "3",
  "TELNUMBER" : "02-1234-1234",
  "HPNUMBER" : "010-1234-1234",
  "EMAIL" : "abc123@gmail.com",
  "JUMINYN" : "N",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}'