홈택스_국세완납증명서

홈택스: 홈 > 로그인 > 민원증명 > 민원증명발급신청 > 납세증명서(국세완납증명)

METHOD

POST

URI

/scrap/common/hometax/TaxClearanceCertificate

Request fields

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

REGNUMBER

사업자번호 또는 주민번호

TRUE

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

USERGUBUN

사용자구분

1:개인, 3:법인, 4:세무사

TELNUMBER

전화번호

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

HPNUMBER

휴대전화번호

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

EMAIL

이메일

JUMINYN

주민번호공개

1: 공개, 2: 비공개

P_CERTNAME

인증서이름

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

TRUE

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

BASE64

개별인증서를 위한 CERT 정보

Response fields

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

errCode

errCode

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

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

SUCCESS : 성공 FAIL :실패

data.ERRMSG

에러메세지

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

data.ERRDOC

에러 문서 메시지

(주민등록등본, 주민등록초본, 지방세납세증명) CANCEL:캡챠입력취소

data.ECODE

에러코드

data.ETRACK

에러추적번호

data.CERCVAISNNO

발급번호

data.CVARTNM

상호(법인명)

data.CVARBSNO

사업자등록번호

data.CVARFNM

성명(대표자)

data.CVARRESNO

주민등록번호

TRUE

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

data.CVARROADNMADR

주소(본점)

data.CVAKNDNM

증명서의 사용목적

data.RCATNO

접수번호

data.CVACHRGDPRTNM

담당부서

data.CVACHRGFNM

담당자

data.CVACHRGTELNO

연락처

data.RCATDTM

발급년월일시분초

data.VLDTTERMENDDT

증명서유효기간

data.LIST[].RPCLCLCD

유예종류

미존재시 필드 출력 안함.

data.LIST[].RPCLSTRTDT

유예기간 시작일

미존재시 필드 출력 안함

data.LIST[].RPCLENDDT

유예기간 종료일

미존재시 필드 출력 안함

data.LIST[].ATTRYR

과세기간

미존재시 필드 출력 안함

data.LIST[].ITRFNM

세목

미존재시 필드 출력 안함

data.LIST[].LSTPMTDDT

납부기한

미존재시 필드 출력 안함

data.LIST[].TXAMT

세액

미존재시 필드 출력 안함

data.LIST[].ATCH

가산금

미존재시 필드 출력 안함

HTTP request

POST /scrap/common/hometax/TaxClearanceCertificate HTTP/1.1
Host: datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 479
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" : "1",
  "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
Content-Length: 768
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Date: Wed, 12 May 2021 08:16:32 GMT
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "CVARBSNO" : "123-45-67890",
    "CVAKNDNM" : "납세증명서(기타용)",
    "CVACHRGDPRTNM" : "민원봉사실",
    "CERCVAISNNO" : "1111-111-1111-111",
    "CVARRESNO" : "8SxYL+DffMfIOWng==",
    "CVACHRGTELNO" : "02-1234-1234",
    "CVARROADNMADR" : "서울특별시 금천구 가산디지털2로 98, 2동 6층 613~615호(가산동, 롯데IT캐슬)",
    "VLDTTERMENDDT" : "20210611",
    "CVARTNM" : "기웅정보통신",
    "ERRMSG" : "",
    "RCATDTM" : "20210512171208",
    "CVACHRGFNM" : "김담당",
    "ECODE" : "",
    "RCATNO" : "501179945631",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "CVARFNM" : "홍길동",
    "LIST" : [ ]
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/TaxClearanceCertificate' -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" : "1",
  "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=="
}'