홈택스_세무사 수임등록(인증서)

홈택스_세무사 수임등록(인증서)

METHOD

POST

URI

/scrap/common/hometax/TaxAccountantRetrieveRegCert

Content Type

application/json

Charset

UTF-8

Last Updated

2023-05-26

Request Fields

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

TXAGNTMGMTNO

세무대리인관리번호

true

STRING

TXAGNTMGMTPW

세무대리인관리비밀번호

true

true

STRING

USERGUBUN

사용자구분

true

STRING

4:세무사

REGNUMBER

등록할 사업자등록번호

true

STRING

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

SAUPJAGUBUN : 3
비사업자인 경우 미입력

SAUPJAGUBUN

유형구분

true

STRING

1:개인사업자
2:법인사업자
3:비사업자

CMJUMIN

대표자 주민등록번호

true

true

STRING

TELNUMBER

신청자전화번호

true

STRING

-

HPNUMBER

대표자 휴대전화번호

true

STRING

-빼고 입력

EMAIL

이메일

STRING

TAXINFOALWHP

국세정보수신동의(휴대전화)

STRING

Y:동의
그외:동의하지않음

TAXINFOALWEM

국세정보수신동의(이메일)

STRING

Y:동의
그외:동의하지않음

APPODATE

수임일자

true

STRING

YYYYMMDD (예)20181027

INFOACCRO

정보제공범위

true

STRING

1:타소득포함
2:해당사업장

P_CERTNAME

인증서이름

true

STRING

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

true

STRING

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

true

STRING

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

true

STRING

BASE64

개별인증서를 위한 CERT 정보

Response Fields

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

errCode

errCode

STRING

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

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

성공/실패 여부

STRING

SUCCESS:성공, FAILURE:실패

data.ERRMSG

에러메세지

STRING

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

data.ERRDOC

에러 문서 메시지

STRING

-

data.ECODE

에러코드

STRING

data.ETRACK

에러추적번호

STRING

HTTP Request

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

{
  "TXAGNTMGMTNO" : "P22828",
  "TXAGNTMGMTPW" : "pO1sJ0RLq0tQV7aJQdoyEQ==\n",
  "USERGUBUN" : "4",
  "REGNUMBER" : "x52HL7Qo3QJW/9kj0XcZWQ==\n",
  "SAUPJAGUBUN" : "1",
  "CMJUMIN" : "29Tvk41FoNSX7YwTcCOcSw==\n",
  "TELNUMBER" : "01022223333",
  "HPNUMBER" : "01022223333",
  "EMAIL" : "abc123@gmail.com",
  "TAXINFOALWHP" : null,
  "TAXINFOALWEM" : null,
  "APPODATE" : "20230215",
  "INFOACCRO" : "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
Date:Fri, 26 May 2023 02:26:39 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 190

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/TaxAccountantRetrieveRegCert' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "TXAGNTMGMTNO" : "P22828",
  "TXAGNTMGMTPW" : "pO1sJ0RLq0tQV7aJQdoyEQ==\n",
  "USERGUBUN" : "4",
  "REGNUMBER" : "x52HL7Qo3QJW/9kj0XcZWQ==\n",
  "SAUPJAGUBUN" : "1",
  "CMJUMIN" : "29Tvk41FoNSX7YwTcCOcSw==\n",
  "TELNUMBER" : "01022223333",
  "HPNUMBER" : "01022223333",
  "EMAIL" : "abc123@gmail.com",
  "TAXINFOALWHP" : null,
  "TAXINFOALWEM" : null,
  "APPODATE" : "20230215",
  "INFOACCRO" : "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=="
}'