홈택스_부가가치세과세표준증명원

홈택스:홈 > 로그인 > 민원증명 > 민원증명발급신청 > 부가가치세 과세표준증명

METHOD

POST

URI

/scrap/common/hometax/CertificateOfVATTaxBase

Request fields

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

USERGUBUN

사용자구분

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

개인은 신청불가능함.

REGNUMBER

사업자번호 또는 주민번호

TRUE

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

TELNUMBER

전화번호

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

HPNUMBER

휴대전화번호

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

EMAIL

이메일

STARTTAXPERIOD

부가가치세 시작과세기간

ex. 20181

부가가치세법에는 1월1일부터 6월 30일까지를 제1기 과세기간으로, 7월1일부터 12월31일까지를 제2기 과세기간으로 규정

ENDTAXPERIOD

부가가치세 종료과세기간

ex. 20182

부가가치세법에는 1월1일부터 6월 30일까지를 제1기 과세기간으로, 7월1일부터 12월31일까지를 제2기 과세기간으로 규정

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

에러 문서 메시지

data.ECODE

에러코드

data.ETRACK

에러추적번호

data.CERCVAISNNO

발급번호

data.RPRSTXPRNM

성명(대표자)

data.CVARTNM

상호(법인명)

data.CVARBCNM

업태

data.CVARCPRNO

법인등록번호

data.CVARRPRSRESNO

주민등록번호

TRUE

data.CVARBSNO

사업자등록번호

data.CVARITMNM

종목

data.ROADADR

사업장소재지

data.RCATNO

접수번호

data.CVACHRGDPRTNM

담당부서

data.CVACHRGFNM

담당자

data.CVACHRGTELNO

연락처

data.RCATDTM

발급년월일시분초

data.CVACHRGOGZFRMYNM

발급기관

data.LIST[].TXNRMSTRTDT

과세기간부터

data.LIST[].TXNRMENDDT

과세기간까지

data.LIST[].TOTALAMT

매출과세표준(수입금액) 계

data.LIST[].ICMAMT1

매출과세표준(수입금액) 과세분

data.LIST[].ICMAMT2

매출과세표준(수입금액) 면세분

data.LIST[].OGNTXSBTRSCPMTXAMT

납부세액

HTTP request

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

{
  "USERGUBUN" : "3",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "TELNUMBER" : "02-1234-1234",
  "HPNUMBER" : "010-1234-1234",
  "EMAIL" : "abc123@gmail.com",
  "STARTTAXPERIOD" : "201812",
  "ENDTAXPERIOD" : "201812",
  "JUMINYN" : "2",
  "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: 1082
Date: Fri, 07 May 2021 07:32:37 GMT
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "CVARRPRSRESNO" : "nHgtV9kn6KTrIqCHXwiq/ZPeuNM=",
    "CVACHRGOGZFRMYNM" : "금천세무서",
    "CVARITMNM" : "전자제품및컴퓨터주변기기　　　　　　/",
    "ETRACK" : "",
    "CVARBSNO" : "123-45-67890",
    "CVARCPRNO" : "110111-1234567",
    "CVACHRGDPRTNM" : "민원봉사실",
    "RPRSTXPRNM" : "홍길동",
    "CERCVAISNNO" : "1111-111-1111-111",
    "CVACHRGTELNO" : "02-1234-1234",
    "ROADADR" : "서울특별시 금천구 가산디지털2로 98 , 2동 613호(가산동, 롯데아이티캐슬)",
    "CVARBCNM" : "도매업",
    "CVARTNM" : "기웅정보통신",
    "ERRMSG" : "",
    "RCATDTM" : "20210507163222",
    "CVACHRGFNM" : "김담당",
    "ECODE" : "",
    "RCATNO" : "501179945631",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "LIST" : [ {
      "TXNRMSTRTDT" : "20180101",
      "OGNTXSBTRSCPMTXAMT" : "1000000",
      "TXNRMENDDT" : "20180630",
      "TOTALAMT" : "10000000",
      "ICMAMT2" : "0",
      "ICMAMT1" : "10000000"
    } ]
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/CertificateOfVATTaxBase' -i -X POST \
    -H 'Authorization: Token ******************************' \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "USERGUBUN" : "3",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "TELNUMBER" : "02-1234-1234",
  "HPNUMBER" : "010-1234-1234",
  "EMAIL" : "abc123@gmail.com",
  "STARTTAXPERIOD" : "201812",
  "ENDTAXPERIOD" : "201812",
  "JUMINYN" : "2",
  "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=="
}'