오픈API 상세

XML

국민연금공단_국민연금 가입 사업장 내역

(국민연금가입수급정보) 법정동단위 지역별, 국민연금 가입 사업장 정보<br/>* 단, 개인사업장 및 2인 이하 법인 사업장 정보 미제공<br/><br/>*사업장 컬럼별 상세설명<br/>○ 자료생성년월 → 자격마감일(사유발생일이 속하는 달의 다음달 15일)까지 신고분 반영<br/>○ 가입자 수 → 가입자수 (고지인원 수 포함)<br/>○ 당월고지금액 → 국민연금법 시행령 제5조에 의거 기준소득월액 상한액 적용으로 실제소득과 고지금액은 상이할 수 있음<br/>■ 상한액 2019.7.~2020.6. 4,860,000원(2019.7.1.기준)<br/>■ 상한액 2020.7.~2021.6. 5,030,000원(2020.7.1.기준)<br/>○ 신규취득자수 → 납부재개 포함 : ※ 전달 고지대상자와 비교하므로 실제 취득자와 상이할 수 있음 (초일취득 (고지)초일이 아닌경우 (당월 미고지되며 다음달 취득자수에 반영)<br/>○ 상실가입자수 → 납부예외 포함 : ※ 전달 고지대상자와 비교하므로 실제 퇴사자와 상이할 수 있음 (초일이 아닌 상실자는 다음달 상실자수에 반영)<br/>※ 국민연금법 제6조, 8조, 동법 시행령 제18조에 의거 60세 도달하거나 퇴직연금수급자, 조기노령연금 수급권을 취득한 자는 가입대상에서 제외되며, 18세미만, 기초수급자는 본인희망에 의해 제외될 수 있음<br/>

※ 활용신청은 PC버전에서만 가능합니다.

OpenAPI 정보

분류체계
사회복지 - 공적연금
제공기관
국민연금공단
관리부서명
가입지원실
관리부서 전화번호
보유근거
수집방법
API 유형
REST
데이터포맷
XML
활용신청
2753
데이터한계
키워드
국민연금,자격,사업장
등록
2015-12-23
수정
2018-06-14
심의유형
개발단계 : 허용 / 운영단계 : 허용
비용부과유무
무료

상세기능

사업장 기본정보 조회 * 3인이상 법인사업장 정보만 개방되므로 요청항목 중 불필요한 'wkpl_styl_dvcd 사업장형태구분코드 (1:법인, 2:개인)' 삭제 (2018.01.25.)

  • 활용승인 절차 개발단계 : 허용 / 운영단계 : 허용
  • 신청가능 트래픽 1000000 / 운영계정은 활용사례 등록시 신청하면 트래픽 증가 가능
  • 요청주소 http://apis.data.go.kr/B552015/NpsBplcInfoInqireService/getBassInfoSearch
  • 서비스URL http://apis.data.go.kr/B552015/NpsBplcInfoInqireService

미리보기

<?xml version="1.0" encoding="UTF-8"?> <message><error><resultCode>703</resultCode> <resultMsg>java.net.SocketTimeoutException: Read timed out</resultMsg> </error></message>

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
법정동주소광역시도코드 ldong_addr_mgpl_dg_cd 2 옵션 41 시도(행정자치부 법정동 주소코드 참조)
법정동주소시군구코드 ldong_addr_mgpl_sggu_cd 5 옵션 117 시군구(행정자치부 법정동 주소코드 참조)
법정동주소읍면동코드 ldong_addr_mgpl_sggu_emd_cd 8 옵션 101 읍면동(행정자치부 법정동 주소코드 참조)
사업장명 wkpl_nm 100 필수 삼성전자 사업장명
사업자등록번호 bzowr_rgst_no 10 옵션 124815 사업자등록번호(앞에서 6자리)
페이지번호 pageNo 옵션 10 페이지번호
행갯수 numOfRows 옵션 1 행갯수

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
자료생성년월 dataCrtYm 6 필수 201510 자료생성년월
식별번호 seq 4 필수 784911 식별번호
사업장명 wkplNm 100 필수 삼성전자로지텍주식회사 사업장명
사업자등록번호 bzowrRgstNo 10 필수 124815**** 사업자등록번호(앞에서 6자리)
사업장도로명상세주소 wkplRoadNmDtlAddr 300 필수 경기도 수원시 영통구 삼성로 사업장도로명상세주소
사업장가입상태코드 wkplJnngStcd 1 필수 1 1:등록, 2:탈퇴
사업장형태구분코드 wkplStylDvcd 1 필수 1 1:법인, 2:개인
법정동주소광역시도코드 ldongAddrMgplDgCd 2 필수 41 시도(행정자치부 법정동 주소코드 참조)
법정동주소시군구코드 ldongAddrMgplSgguCd 5 필수 117 시군구(행정자치부 법정동 주소코드 참조)
법정동주소읍면동코드 ldongAddrMgplSgguEmdCd 8 필수 101 읍면동(행정자치부 법정동 주소코드 참조)

샘플코드

샘플코드는 PC에서 확인해주세요.

  • jkplan

    2020-07-14 20:14

    식별번호가 키인가요? detail에서는 seq 하나만 넘기는데 month는 dataCrtYm까지 두개를 넘기네요?
  • 1351342765

    2020-05-11 13:47

    상세 정보조회 API 이용중인데 아직 3월 이후의 데이터는 적용되지 않은거 같아서요. 혹시 적용해주실 수 있나요?
  • itearth

    2020-04-02 23:58

    정말 고맙습니다.