NHIS_건강보험료 납부내역조회(전체)

국민건강보험공단 전체가입자 기준 건강보험료 납부내역 조회 업무

METHOD

POST

URI

/scrap/common/nhis/HealthInsurePaymentInquiry

Content Type

application/json

Charset

UTF-8

Last Updated

2021-10-20

Request Fields

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

JUMIN

주민등록번호(암호화)

true

STRING

"-"를 제외한 13자리

토큰 발행 시 전달받은 암복호화 정보로 진행.

STARTDATE

조회시작년월

STRING

yyyyMM

ENDDATE

조회종료년월

STRING

yyyyMM

FAXNUM

팩스번호

STRING

팩스발급 시 숫자만 입력

TAXPARSEYN

연말정산추가파싱여부

STRING

Y: 연말정산납부내역파싱
N: 연말정산납부내역파싱X

CERTREGOPTION

인증서등록구분

STRING

1: 인증서로그인,
2: 인증서 자동등록 후 로그인,
3: 인증서로그인 실패 시 인증서 자동등록 후 로그인.

P_CERTNAME

인증서이름

STRING

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

STRING

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

STRING

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

STRING

BASE64

개별인증서를 위한 CERT 정보

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.INCOMELIST[].NABBUNUMBER

납부자번호

STRING

data.INCOMELIST[].JOINGUBUN

가입자구분

STRING

data.INCOMELIST[].PERNAME

가입자 성명

STRING

data.INCOMELIST[].CORPNAME

직장명

STRING

data.INCOMELIST[].REGDATE

등록일

STRING

data.INCOMELIST[].UNREGDATE

상실일

STRING

data.INCOMELIST[].REGBRANCH

소속지사

STRING

data.INCOMELIST[].STATEMSG

상태메시지

STRING

data.INCOMELIST[].INFOLIST[].YEAR

납부년도

STRING

data.INCOMELIST[].INFOLIST[].MONTH

납부월

STRING

data.INCOMELIST[].INFOLIST[].PRINTNUM

발급번호

STRING

-

data.INCOMELIST[].INFOLIST[].BIRTH

생년월일

STRING

(건강보험)yyyyMMdd

(건강보험)대표자 생년월일 입니다. / ex. 19691019

data.INCOMELIST[].INFOLIST[].PURPOSE

발급목적

STRING

data.INCOMELIST[].INFOLIST[].CORPNAME

직장명

STRING

data.INCOMELIST[].INFOLIST[].REGNUM

사업자번호

STRING

data.INCOMELIST[].INFOLIST[].JGHEALTHGOJI

직장고지건강보험료

STRING

data.INCOMELIST[].INFOLIST[].JGHEALTHNABBU

직장납부건강보험료

STRING

data.INCOMELIST[].INFOLIST[].JGJANGGIGOJI

직장고지장기요양보험료

STRING

data.INCOMELIST[].INFOLIST[].JGJANGGINABBU

직장납부장기요양보험료

STRING

data.INCOMELIST[].INFOLIST[].SDHEALTHGOJI

소득고지건강보험료

STRING

data.INCOMELIST[].INFOLIST[].SDHEALTHNABBU

소득납부건강보험료

STRING

data.INCOMELIST[].INFOLIST[].SDJANGGIGOJI

소득고지장기요양보험료

STRING

data.INCOMELIST[].INFOLIST[].SDJANGGINABBU

소득납부장기요양보험료

STRING

data.INCOMELIST[].INFOLIST[].JIHEALTHGOJI

지역고지건강보험료

STRING

data.INCOMELIST[].INFOLIST[].JIHEALTHNABBU

지역납부건강보험료

STRING

data.INCOMELIST[].INFOLIST[].JIJANGGIGOJI

지역고지장기요양보험료

STRING

data.INCOMELIST[].INFOLIST[].JIJANGGINABBU

지역납부장기요양보험료

STRING

HTTP Request

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

{
  "JUMIN" : "8SxYL+DffMfIOWng==",
  "STARTDATE" : "201603",
  "ENDDATE" : "201603",
  "FAXNUM" : null,
  "TAXPARSEYN" : "Y",
  "CERTREGOPTION" : "3",
  "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:Tue, 19 Oct 2021 23:03:47 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 1931

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ERRMSG" : "",
    "ERRDOC" : "",
    "INCOMELIST" : [ {
      "PERNAME" : "홍길동",
      "CORPNAME" : "기웅정보통신",
      "UNREGDATE" : "20160404",
      "JOINGUBUN" : "직장피부양자",
      "REGDATE" : "20071001",
      "INFOLIST" : [ ],
      "NABBUNUMBER" : "80051135058",
      "STATEMSG" : "피부양자는 출력할 수 없습니다.",
      "REGBRANCH" : "용인동부지사"
    }, {
      "PERNAME" : "홍길동",
      "CORPNAME" : "기웅정보통신",
      "UNREGDATE" : "",
      "JOINGUBUN" : "직장가입자",
      "REGDATE" : "20160404",
      "INFOLIST" : [ {
        "SDHEALTHNABBU" : "10000",
        "MONTH" : "3",
        "JGHEALTHNABBU" : "10000",
        "JIJANGGIGOJI" : "10000",
        "REGNUM" : "2148159394",
        "JGJANGGIGOJI" : "10000",
        "SDJANGGINABBU" : "10000",
        "SDHEALTHGOJI" : "10000",
        "YEAR" : "2016",
        "JGHEALTHGOJI" : "10000",
        "JIHEALTHNABBU" : "10000",
        "PRINTNUM" : "11202110204072850",
        "PURPOSE" : "납부확인용",
        "JGJANGGINABBU" : "10000",
        "BIRTH" : "19880705",
        "SDJANGGIGOJI" : "10000",
        "JIHEALTHGOJI" : "10000",
        "JIJANGGINABBU" : "10000"
      }, {
        "SDHEALTHNABBU" : "10000",
        "MONTH" : "연말정산",
        "JGHEALTHNABBU" : "10000",
        "JIJANGGIGOJI" : "10000",
        "REGNUM" : "2148159394",
        "JGJANGGIGOJI" : "10000",
        "SDJANGGINABBU" : "10000",
        "SDHEALTHGOJI" : "10000",
        "YEAR" : "2016",
        "JGHEALTHGOJI" : "10000",
        "JIHEALTHNABBU" : "10000",
        "PRINTNUM" : "11202110204072850",
        "PURPOSE" : "null",
        "JGJANGGINABBU" : "10000",
        "BIRTH" : "19880705",
        "SDJANGGIGOJI" : "10000",
        "JIHEALTHGOJI" : "10000",
        "JIJANGGINABBU" : "10000"
      } ],
      "NABBUNUMBER" : "80632804815",
      "STATEMSG" : "",
      "REGBRANCH" : "금천지사"
    } ],
    "RESULT" : "SUCCESS"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/nhis/HealthInsurePaymentInquiry' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "JUMIN" : "8SxYL+DffMfIOWng==",
  "STARTDATE" : "201603",
  "ENDDATE" : "201603",
  "FAXNUM" : null,
  "TAXPARSEYN" : "Y",
  "CERTREGOPTION" : "3",
  "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=="
}'