국민연금 EDI

사업장 가입자 현황 조회

사업장 소속 국민연금 가입자 현황 자격 상태 화면 계약을 조회합니다. EDI 세션 연결을 통해 급여, 고지, 증명서 조회 업무에 활용할 수 있습니다.

활용 시나리오

  • 인사 마스터 정합 검사 — EDI 가입자 현황과 HR 명부를 대조해 누락 취득 상실 신고를 방지합니다.
  • 온보딩 퇴사 자동 체크 — 신규 입사 퇴사 이벤트 후 가입자 현황을 재조회해 후속 신고 Job을 트리거합니다.
  • 제조 사업장 HR — 사업장 가입자 현황 조회로 사업장관리번호별 급여 가입 데이터를 급여 시스템과 동기화합니다.
  • IT 스타트업 인사 — 입 퇴사 이벤트에 사업장 가입자 현황 조회를 연결해 국민연금 신고 누락을 사전에 차단합니다.

연동 절차

  1. 1. 사업장 세션 확인 — account_link_id로 국민연금 EDI 인증 세션을 등록하고 cookie/storage 상태를 확인합니다.
  2. 2. 가입자 현황 API 호출 — 사업장관리번호 조회기간 등 API별 필수값을 검증한 뒤 POST 본문을 구성합니다.
  3. 3. 자격 상태 파싱 — XDATA 게이트웨이를 통해 국민연금 EDI 화면 데이터를 구조화 JSON으로 수신합니다.
  4. 4. HR 대사 신고 연계 — success row_count workplace 필드를 검증하고 ERP/급여 시스템에 저장합니다.

API 상품 목록 보기

사업장 가입자 현황 조회 상세 페이지