사업장 기본정보 조회

활용 시나리오

• 온보딩 시 사업장 프로필 동기화 — 신규 고객사 연동 시 사업장명 관리번호 대시보드 위젯을 내부 마스터에 매핑해 이후 모든 EDI Job의 기준 컨텍스트로 사용합니다.
• 신고 납부 화면 진입 전 컨텍스트 확보 — declaration_page_auxiliary를 읽어 당월 신고 가능 여부 안내 문구를 사용자 포털에 그대로 반영해 클릭 수를 줄입니다.
• 제조 사업장 HR — 사업장 기본정보 대시보드 조회로 사업장관리번호별 급여 가입 데이터를 급여 시스템과 동기화합니다.
• IT 스타트업 인사 — 입 퇴사 이벤트에 사업장 기본정보 대시보드 조회를 연결해 국민연금 신고 누락을 사전에 차단합니다.

연동 절차

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