건강보험_직장보험료조회(간편인증)

건강보험 직장보험료조회 간편인증

METHOD

POST

URI

/scrap/common/nhis/EmployeeHealthInsureSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2022-08-11

Request Fields

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

LOGINOPTION

간편인증로그인방법

STRING

0: 카카오톡
1: 삼성패스
2: 페이코
3: 통신사
4: KB모바일인증서
5: 네이버인증서
6: 신한인증서
7: 토스 인증서

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

JUMIN

생년월일

true

STRING

yyyyMMdd

ex) 19801020

STARTDATE

조회시작년월

STRING

yyyyMM

ENDDATE

조회종료년월

STRING

yyyyMM

USERNAME

성명

STRING

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

HPNUMBER

휴대폰번호

STRING

TELECOMGUBUN

통신사구분

STRING

1: SKT,
2: KT,
3: LGU+

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

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

건강보험증 번호

STRING

data.INCOMELIST[].CORPNAME

사업장명

STRING

data.INCOMELIST[].REGDATE

등록일

STRING

data.INCOMELIST[].UNREGDATE

상실일

STRING

data.INCOMELIST[].PAYMON

조회년월

STRING

data.INCOMELIST[].AVGPAY

평균 보수월액

STRING

data.INCOMELIST[].JSHCOMPAMT

직장산정건강보험료

STRING

data.INCOMELIST[].JSCCOMPAMT

직장산정요양보험료

STRING

data.INCOMELIST[].JJHCALCRSN

직장건강정산사유

STRING

data.INCOMELIST[].JJCCOMPRSN

직장요양정산사유

STRING

data.INCOMELIST[].JJHCALCAMT

직장정산건강보험료

STRING

data.INCOMELIST[].JJCCALCAMT

직장정산요양보험료

STRING

data.INCOMELIST[].JGHNOTIAMT

직장고지건강보험료

STRING

data.INCOMELIST[].JGCNOTIAMT

직장고지요양보험료

STRING

data.INCOMELIST[].HTHINSUTAX

건강연말정산보험료

STRING

data.INCOMELIST[].LTMINSUTAX

요양연말정산보험료

STRING

data.INCOMELIST[].MEMBERSPAY

가입자 부담금

STRING

HTTP Request

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

{
  "LOGINOPTION" : "0",
  "JUMIN" : "qRN9vdgppaI92CRk8nDo0g==",
  "STARTDATE" : "201801",
  "ENDDATE" : "201812",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01067377044",
  "TELECOMGUBUN" : null
}

HTTP Response

HTTP/1.1 200 OK
Date:Thu, 11 Aug 2022 04:30:51 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 1205

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "INCOMELIST" : [ {
      "CORPNAME" : "기웅정보통신(주)",
      "JJHCALCRSN" : "",
      "HTHINSUTAX" : "0",
      "INSUNUM" : "80361811111",
      "PAYMON" : "201801",
      "REGDATE" : "20160404",
      "JGHNOTIAMT" : "50000",
      "JSHCOMPAMT" : "100000",
      "MEMBERSPAY" : "110000",
      "LTMINSUTAX" : "0",
      "UNREGDATE" : "",
      "JSCCOMPAMT" : "10000",
      "JGCNOTIAMT" : "2000",
      "JJHCALCAMT" : "100000",
      "JJCCALCAMT" : "10000",
      "AVGPAY" : "1850000",
      "JJCCOMPRSN" : ""
    }, {
      "CORPNAME" : "기웅정보통신(주)",
      "JJHCALCRSN" : "",
      "HTHINSUTAX" : "0",
      "INSUNUM" : "80361811111",
      "PAYMON" : "201802",
      "REGDATE" : "20160404",
      "JGHNOTIAMT" : "50000",
      "JSHCOMPAMT" : "100000",
      "MEMBERSPAY" : "110000",
      "LTMINSUTAX" : "0",
      "UNREGDATE" : "",
      "JSCCOMPAMT" : "10000",
      "JGCNOTIAMT" : "2000",
      "JJHCALCAMT" : "100000",
      "JJCCALCAMT" : "10000",
      "AVGPAY" : "1850000",
      "JJCCOMPRSN" : ""
    } ],
    "RESULT" : "SUCCESS"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/nhis/EmployeeHealthInsureSimple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "LOGINOPTION" : "0",
  "JUMIN" : "qRN9vdgppaI92CRk8nDo0g==",
  "STARTDATE" : "201801",
  "ENDDATE" : "201812",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01067377044",
  "TELECOMGUBUN" : 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’일 경우에만 해당.