WETAX_지방세 납부서(가상계좌)조회(간편인증)

Wetax 로그인 >납부하기 > 지방세 > 검색클릭 > 금액클릭 > 가상계좌조회

METHOD

POST

URI

/scrap/common/wetax/VirtualAcctLocalTaxPaymentSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2022-11-29

Request Fields

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

LOGINOPTION

간편인증로그인방법

true

STRING

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

간편인증 로그인시 필수필드

TELECOMGUBUN

통신사구분

STRING

1 : SKT
2 : KT
3 : LG U+

JUMINNUM

로그인용 주민번호

true

true

STRING

"-"없이 주민번호13자리

간편인증 로그인시 필수필드

USERNAME

로그인용 성명

true

STRING

간편인증 로그인시 필수필드

HPNUMBER

휴대전화번호

true

STRING

간편인증 로그인시 필수필드

STARTDATE

조회시작일

true

STRING

yyyyMMdd

예) 20180801

ENDDATE

조회종료일

true

STRING

yyyyMMdd

예) 20180830

CHKJEONGGI

정기선택

STRING

Y:선택, N:선택안함

입력이 없으면 "선택"을 기본값으로 합니다

CHKSUSI

수시선택

STRING

Y:선택, N:선택안함

입력이 없으면 "선택"을 기본값으로 합니다.

CHKSINGO

신고선택

STRING

Y:선택, N:선택안함

입력이 없으면 "선택"을 기본값으로 합니다.

CHKCHESU

체납/수납확인중선택

STRING

Y:선택, N:선택안함

입력이 없으면 "선택"을 기본값으로 합니다

CHKYEONDAE

연대납세자선택

STRING

Y:선택, N:선택안함

입력이 없으면 "선택안함"을 기본값으로 합니다

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

성명

STRING

휴대폰 본인인증 시 필수입력값

data.BIRTHDAY

생년월일

STRING

data.LIST[]

목록 반복부

조회결과 목록 반복부

data.LIST[].TXPRNMNM

상호

STRING

data.LIST[].NROMAMT

납부금액(계)

STRING

data.LIST[].ACCTLIST[]

리스트반복부

data.LIST[].ACCTLIST[].ACCTBANKNAME

은행명

STRING

data.LIST[].ACCTLIST[].ACCTNUMBER

가상계좌번호

STRING

HTTP Request

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

{
  "LOGINOPTION" : "0",
  "TELECOMGUBUN" : "2",
  "JUMINNUM" : "8ExJVfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "STARTDATE" : "202001",
  "ENDDATE" : "202005",
  "CHKJEONGGI" : null,
  "CHKSUSI" : null,
  "CHKSINGO" : null,
  "CHKCHESU" : null,
  "CHKYEONDAE" : null
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 29 Nov 2022 10:00:43 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 517

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "USERNAME" : "홍길동",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "LIST" : [ {
      "ACCTLIST" : [ {
        "ACCTNUMBER" : "001-9652-9987-63-9",
        "ACCTBANKNAME" : "KEB하나"
      }, {
        "ACCTNUMBER" : "191-3256-9865-75-3",
        "ACCTBANKNAME" : "국민"
      } ],
      "TXPRNMNM" : "홍길동",
      "NROMAMT" : "91400"
    } ],
    "BIRTHDAY" : "910123"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/wetax/VirtualAcctLocalTaxPaymentSimple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "LOGINOPTION" : "0",
  "TELECOMGUBUN" : "2",
  "JUMINNUM" : "8ExJVfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "STARTDATE" : "202001",
  "ENDDATE" : "202005",
  "CHKJEONGGI" : null,
  "CHKSUSI" : null,
  "CHKSINGO" : null,
  "CHKCHESU" : null,
  "CHKYEONDAE" : null
}'

참고자료

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’일 경우에만 해당.