건강보험 EDI
보수월액 수신문서 목록 조회
인사급여 수신문서 화면에서 선택 가능한 고지 안내 문서 행을 목록으로 조회합니다. EDI에 연결된 데이터를 사업장 급여, 고지, 문서 업무 흐름에 활용할 수 있습니다.
활용 시나리오
- 월별 고지문 목록 자동 수집 — notice_year_month 기준으로 list_rows를 저장해 월별 고지문 인덱스를 만들고 후속 상세 조회를 순차 배치로 연결할 수 있습니다.
- 문서 누락 조기 감지 모니터링 — row_count 변화를 월별 기준선과 비교해 고지문 수신 이상을 감지하고 운영팀에 즉시 확인 알림을 보낼 수 있습니다.
- 제조 물류 HR — 보수월액 수신문서 목록 조회 응답을 입 퇴사 자격변동 배치에 연결해 건강보험 고지 누락을 줄입니다.
- 병원 요양 인사팀 — 다수 사업장 부서의 보수월액 수신문서 목록 조회 결과를 표준 포맷으로 모아 마감 전 검증합니다.
연동 절차
- 1. 조회 연월과 회차 지정 — API_KEY 세션과 대상 사업장 컨텍스트를 확인해 호출 실패 가능성을 먼저 줄입니다.
- 2. 수신문서 목록 API 호출 — 조회 기간 문서 키 행 선택값 등 엔드포인트별 필수 입력을 점검합니다.
- 3. 행 키와 데이터셋 파싱 — 국민건강보험 EDI 화면 데이터를 구조화 JSON으로 수신하고 원천 단서를 함께 확보합니다.
- 4. 상세 조회 큐 자동 생성 — 핵심 필드와 상태값을 검증해 인사 급여 문서 시스템에 저장하고 후속 작업을 연결합니다.