국민연금_연금산정용 가입내역 확인서 발급(간편인증)

홈 > 개인서비스 > 증명서 등 발급 > 연금산정용 가입내역 확인서(국문)

METHOD

POST

URI

/scrap/common/mnps/NationalPensionTotalPeriodSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2021-10-21

Request Fields

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

LOGINOPTION

간편인증로그인방법

STRING

5:카카오페이

REGNUMBER

사용자주민번호

true

STRING

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

USERNAME

비회원로그인용 성명

STRING

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

HPNUMBER

휴대폰번호

STRING

간편인증 로그인시 필수필드. "-"없이 휴대폰번호 입력.

FAXNUM

팩스번호

STRING

팩스발급 시 숫자만 입력

FAXTYPE

팩스발급용도

STRING

1: 개인확인용, 2: 공공기관 제출용
3: 금융기관 제출용, 4: 기타

팩스발급 시 해당입력값은 필수

PRINTTYPE

프린트출력발급용도

STRING

1: 개인확인용, 2: 공공기관 제출용
3: 금융기관 제출용, 4: 기타

-

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

에러코드

STRING

data.ETRACK

에러추적번호

STRING

data.ERRDOC

에러 문서 메시지

STRING

-

data.PREMIUMTOTMONTH

납부한 연금보험료 월수

STRING

data.PREMIUMTOTAMT

납부한 연금보험료 금액

STRING

data.PREMIUMTOTNOTMONTH

납부하지 않은 연금보험료 월수

STRING

data.PREMIUMTOTNOTAMT

납부하지 않은 연금보험료 금액

STRING

data.PREMIUMTOTCNOTMONTH

납부할 수 없는 연금보험료 월수

STRING

data.PREMIUMTOTCNOTAMT

납부할 수 없는 연금보험료 금액

STRING

data.PREMIUMTOTRETURNAMT

반납금 납부액

STRING

data.PREMIUMTOTPAYMONTH

추납보험료 납부 개월

STRING

data.PREMIUMTOTPAYAMT

추납보험료 납부액

STRING

data.INSUPERIMONTH

보험료 납부기간 월수

STRING

data.INSUPERIAMT

보험료 납부기간 금액

STRING

data.LUMPSUMMONTH

일시금 지급기간 월수

STRING

data.LUMPSUMAMT

일시금 지급기간 금액

STRING

data.RETURNPERIMONTH

반납금 납부기간 월수

STRING

data.RETURNPERIAMT

반납금 납부기간 금액

STRING

data.TOTPERIMONTH

총 가입기간 월수

STRING

data.TOTPERIAMT

총 가입기간 금액

STRING

data.CREDITMONTH

실업크레딧 납부기간 월수

STRING

data.CREDITAMT

실업크레딧 납부기간 금액

STRING

data.PREMIUMDETAILDATE

기간

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILDATE값

data.PREMIUMDETAILINCOM

기준소득월액

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILINCOM값

data.PREMIUMDETAILMONTH

납부한 보험료 월수

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILMONTH값

data.PREMIUMDETAILAMT

납부한 보험료 금액

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILAMT값

data.PREMIUMDETAILNOTMONTH

납부하지 않은 보험료 월수

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILNOTMONTH값

data.PREMIUMDETAILNOTAMT

납부하지 않은 보험료 금액

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILNOTAMT값

data.PREMIUMDETAILCLASS

종별

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILCLASS값

data.PREMIUMDETAILBIGO

비고

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILBIGO값

data.PREMIUMINCOM

연소득금액

STRING

기준소득월액(PREMIUMDETAILINCOM) * 12

data.PRINTNUM

발급번호

STRING

입력값 PRINTTYPE 세팅시 출력되는 항목

data.PRINTDATE

발급일자

STRING

입력값 PRINTTYPE 세팅시 출력되는 항목

data.VERIFYNUM

검증번호

STRING

입력값 PRINTTYPE 세팅시 출력되는 항목

data.PREMIUMLIST[].PREMIUMDETAILDATE

기간

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILDATE값

data.PREMIUMLIST[].PREMIUMDETAILINCOM

기준소득월액

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILINCOM값

data.PREMIUMLIST[].PREMIUMDETAILMONTH

납부한 보험료 월수

NUMBER

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILMONTH값

data.PREMIUMLIST[].PREMIUMDETAILAMT

납부한 보험료 금액

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILAMT값

data.PREMIUMLIST[].PREMIUMDETAILNOTMONTH

납부하지 않은 보험료 월수

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILNOTMONTH값

data.PREMIUMLIST[].PREMIUMDETAILNOTAMT

납부하지 않은 보험료 금액

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILNOTAMT값

data.PREMIUMLIST[].PREMIUMDETAILCLASS

종별

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILCLASS값

data.PREMIUMLIST[].PREMIUMDETAILBIGO

비고

STRING

PREMIUMLIST()리스트 맨마지막 PREMIUMDETAILBIGO값

HTTP Request

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

{
  "LOGINOPTION" : "5",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "FAXNUM" : null,
  "FAXTYPE" : null,
  "PRINTTYPE" : "4"
}

HTTP Response

HTTP/1.1 200 OK
Date:Thu, 21 Oct 2021 05:15:41 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 1898

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "PREMIUMDETAILDATE" : "2021-10~2021-10",
    "PREMIUMTOTPAYMONTH" : "0",
    "INSUPERIMONTH" : "65",
    "ETRACK" : "",
    "PREMIUMDETAILBIGO" : "기웅정보통신",
    "CREDITAMT" : "1,000,000",
    "PREMIUMTOTRETURNAMT" : "1,850,000",
    "PREMIUMDETAILCLASS" : "사업장",
    "CREDITMONTH" : "0",
    "PREMIUMTOTMONTH" : "65",
    "VERIFYNUM" : "289M",
    "TOTPERIAMT" : "10,000,000",
    "ERRMSG" : "",
    "PRINTNUM" : "20211021-H431-123456",
    "ECODE" : "",
    "PREMIUMDETAILAMT" : "100,000",
    "ERRDOC" : "null",
    "PREMIUMDETAILNOTMONTH" : "1",
    "PREMIUMINCOM" : "100,000",
    "LUMPSUMMONTH" : "0",
    "PREMIUMTOTNOTAMT" : "1,000,000",
    "TOTPERIMONTH" : "65",
    "PREMIUMTOTNOTMONTH" : "1",
    "RETURNPERIAMT" : "1,000,000",
    "PREMIUMDETAILNOTAMT" : "100,000",
    "PREMIUMLIST" : [ {
      "PREMIUMDETAILDATE" : "2016-04~2016-04",
      "PREMIUMDETAILBIGO" : "기웅정보통신",
      "PREMIUMDETAILCLASS" : "사업장",
      "PREMIUMDETAILAMT" : "100,000",
      "PREMIUMDETAILMONTH" : "0",
      "PREMIUMDETAILNOTAMT" : "100,000",
      "PREMIUMDETAILNOTMONTH" : "0",
      "PREMIUMDETAILINCOM" : "100,000"
    }, {
      "PREMIUMDETAILDATE" : "2016-05~2017-06",
      "PREMIUMDETAILBIGO" : "기웅정보통신",
      "PREMIUMDETAILCLASS" : "사업장",
      "PREMIUMDETAILAMT" : "100,000",
      "PREMIUMDETAILMONTH" : "14",
      "PREMIUMDETAILNOTAMT" : "100,000",
      "PREMIUMDETAILNOTMONTH" : "0",
      "PREMIUMDETAILINCOM" : "100,000"
    } ],
    "PREMIUMTOTCNOTMONTH" : "0",
    "LUMPSUMAMT" : "1,000,000",
    "INSUPERIAMT" : "1,000,000",
    "PREMIUMTOTAMT" : "1,000,000",
    "RETURNPERIMONTH" : "0",
    "PREMIUMTOTCNOTAMT" : "1,250,000",
    "PREMIUMTOTPAYAMT" : "2,152,000",
    "PRINTDATE" : "20211021",
    "PREMIUMDETAILMONTH" : "0",
    "RESULT" : "SUCCESS",
    "PREMIUMDETAILINCOM" : "100,000"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/mnps/NationalPensionTotalPeriodSimple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "LOGINOPTION" : "5",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "FAXNUM" : null,
  "FAXTYPE" : null,
  "PRINTTYPE" : "4"
}'

참고자료

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