개발자 문서
API 레퍼런스

급여·고지 - 국민건강보험공단 EDI

1. 전자고지 조회 규칙nhis_edi.hr_payroll.edi_electronic_notices.contract

MCP 도구 이름 nhis_edi__hr_payroll__edi_electronic_notices__contract

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

연동 계정으로 부르면 전자고지를 검색해 한 건을 고르는 순서와 고를 때 쓰는 다섯 항목을 받습니다.

  • 로그인을 먼저 호출합니다. 이 API 는 세션만 있으면 되고 업무 화면 진입은 필요하지 않습니다. [국민건강보험공단 EDI 로그인]
  • params 는 빈 객체로 보내도 호출됩니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.edi_electronic_notices.contract이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.edi_electronic_notices.contract

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

추가 파라미터가 없습니다. params 는 {} 로 보냅니다.

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: contract-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.edi_electronic_notices.contract",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • search_popup·detail_transactions·selection_contract·safety(query_only)를 확인합니다.
순번변수명타입설명
search_popupobject검색팝업 계약 정보 객체
detail_transactionsarray상세 트랜잭션 계약 배열
selection_contractobject선택 계약 정보 객체
safetyobject안전 플래그 (query_only)
json
// result.data
{
  "search_popup": {},
  "detail_transactions": [],
  "selection_contract": {},
  "safety": {}
}

2. 전자고지 상세 조회nhis_edi.hr_payroll.edi_electronic_notices.detail

MCP 도구 이름 nhis_edi__hr_payroll__edi_electronic_notices__detail

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

검색해 고른 전자고지 한 건의 고지서 상세 행과 총 납부보험료, 총 체납액, 납부마감일 요약을 받습니다.

  • 대상을 먼저 선택하거나, 선택 조건을 함께 보냅니다. [국민건강보험공단 EDI 로그인]
  • result.data.error_code=EDI_ELECTRONIC_NOTICE_DETAIL_EMPTY.
  • result.data 의 success 는 false, error_code 는 EDI_ELECTRONIC_NOTICE_OPTIONS_EMPTY 이고 message_ko 에 조회 기간을 넓혀 다시 시도하라는 안내가 옵니다.
  • 선택을 먼저 하면 params 를 빈 객체로 보낼 수 있습니다. 선택 조건을 주면 내부에서 선택을 다시 수행합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.edi_electronic_notices.detail이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.edi_electronic_notices.detail

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-N전자고지 검색 결과에서 선택할 행 번호
row_keystring-N전자고지 검색 결과 row 식별키
goji_yyyymmstring6N고지연월

형식 : YYYYMM

goji_chasustring-N고지차수 GOJI_CHASU
wrt_chasustring-N작성 차수 WRT_CHASU
wrt_dup_seqstring-N작성 중복순번 WRT_DUP_SEQ
unb_nostring-N통합납부번호 UNB_NO
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 선택할 행을 찾지 못해 안에서 다시 검색할 때 쓴다

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘

형식 : YYYYMMDD

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.edi_electronic_notices.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • combo·rows·summary·business_datasets를 확인합니다.
순번변수명타입설명
comboobject콤보 데이터 객체
rowsarray전자고지 행 데이터 배열
summaryobject요약 정보 객체
business_datasetsobject데이터셋 객체 (키=데이터셋명)
selected_optionobject조회한 고지 행 정보
detail_sql_idstring | null기관 상세 조회에 쓰인 조회 id
row_countnumber상세 행 수
message_kostring선택할 전자고지가 없어 상세를 조회하지 못했을 때 이유와 다음 행동을 알려 주는 한국어 안내입니다(조회 기간을 넓혀 다시 시도하라는 뜻). 상세를 조회했을 때는 비어 있거나 없습니다
json
// result.data
{
  "combo": {},
  "rows": [],
  "summary": {},
  "business_datasets": {},
  "selected_option": {},
  "detail_sql_id": "...",
  "row_count": 1
}
순번오류 코드발생 조건
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.

3. 전자고지 검색옵션 조회nhis_edi.hr_payroll.edi_electronic_notices.search_options

MCP 도구 이름 nhis_edi__hr_payroll__edi_electronic_notices__search_options

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

조회 기간을 넣어 부르면 전자고지마다 고지 연월과 차수, 작성 차수, 납부자번호, 문서 이름과 행 키를 받습니다.

  • 로그인을 먼저 호출합니다. 이 API 는 세션만 있으면 되고 업무 화면 진입은 필요하지 않습니다. [국민건강보험공단 EDI 로그인]
  • implementation_status=edi_electronic_notice_search_empty, error_code=null.
  • params 는 빈 객체로 보내도 호출됩니다. from_date 와 to_date 를 지정하지 않으면 3개월 전부터 오늘까지 조회합니다. doc_id 는 기본값이 BMBB_400 입니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.edi_electronic_notices.search_options이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.edi_electronic_notices.search_options

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘

형식 : YYYYMMDD

doc_idstring-N문서 ID. 미입력 시 BMBB_400
insurance_type_codestring-N보험종류 INSU_TYPE_CD
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: search_options-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.edi_electronic_notices.search_options",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • options·filters·selection_contract를 확인합니다.
순번변수명타입설명
optionsarray조회 가능한 전자고지 행 배열
filtersobject검색 필터 정보 객체
selection_contractobject선택 계약 정보 객체
row_countnumber옵션 행 수
datasetsobject기관 응답 데이터셋 원본 (ds_List)
json
// result.data
{
  "options": [],
  "filters": {},
  "selection_contract": {},
  "row_count": 1,
  "datasets": {}
}
순번오류 코드발생 조건
VALIDATION_INVALID_FIELD날짜 오류 — from_date · to_date 가 YYYYMMDD(또는 YYYY-MM-DD) 형식이 아니거나, from_date 가 to_date 보다 늦습니다.

4. 전자고지 검색행 선택nhis_edi.hr_payroll.edi_electronic_notices.select

MCP 도구 이름 nhis_edi__hr_payroll__edi_electronic_notices__select

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

전자고지 검색 결과에서 행 번호나 행 키, 고지 연월과 차수로 한 건을 골라 로그인 세션에 남기고 그 고지의 값을 받습니다.

  • 조회 옵션을 먼저 확인하고 호출합니다. 생략하면 내부에서 자동으로 조회합니다. [국민건강보험공단 EDI 로그인]
  • result.data 의 success 는 false, error_code 는 EDI_ELECTRONIC_NOTICE_OPTIONS_EMPTY 이고 message_ko 에 조회 기간을 넓혀 다시 시도하라는 안내가 옵니다. 작업은 실패로 끝나지 않습니다.
  • selector 생략 시 options 첫 행을 자동 선택합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.edi_electronic_notices.select이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.edi_electronic_notices.select

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-N전자고지 검색 결과에서 선택할 행 번호
row_keystring-N전자고지 검색 결과 row 식별키
goji_yyyymmstring6N고지연월

형식 : YYYYMM

goji_chasustring-N고지차수 GOJI_CHASU
wrt_chasustring-N작성 차수 WRT_CHASU
wrt_dup_seqstring-N작성 중복순번 WRT_DUP_SEQ
unb_nostring-N통합납부번호 UNB_NO
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 선택할 행을 찾지 못해 안에서 다시 검색할 때 쓴다

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘

형식 : YYYYMMDD

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: select-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.edi_electronic_notices.select",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • selected_option·detail_selection·next_steps를 확인합니다.
순번변수명타입설명
selected_optionobject선택된 전자고지 옵션 객체
detail_selectionobject상세 조회용 선택 키 (세션에 저장됨)
next_stepsarray다음 단계 힌트 배열
selection_contractobject선택 호출 계약 (다음 호출에 넘길 값)
message_kostring선택할 전자고지가 없을 때 이유와 다음 행동을 알려 주는 한국어 안내입니다(조회 기간을 넓혀 다시 시도하라는 뜻). 전자고지를 찾았을 때는 비어 있거나 없습니다
json
// result.data
{
  "selected_option": {},
  "detail_selection": {},
  "next_steps": [],
  "selection_contract": {}
}
순번오류 코드발생 조건
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.

5. 건강보험료 개인별 상세 조회nhis_edi.hr_payroll.health_premiums.employee_details

MCP 도구 이름 nhis_edi__hr_payroll__health_premiums__employee_details

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

고지 연월과 차수를 넣으면 가입자고지내역서(건강)를 열어 가입자마다 보수월액과 건강보험, 장기요양보험의 산출, 조정, 당월 보험료와 합계를 받습니다.

  • 보험료 요약 조회나 고지 선택을 먼저 호출합니다. [국민건강보험공단 EDI 로그인]
  • result.data.error_code=HEALTH_INSURANCE_NOTICE_DATASET_EMPTY.
  • row_index·row_key 생략 시 총괄 고지 행과 페어링된 가입자고지 행을 자동 선택합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.health_premiums.employee_details이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.health_premiums.employee_details

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-N이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-N선택할 행의 텍스트 포함값
cell_text_containsstring-N선택할 행 셀 텍스트 포함값
row_keystring-N이전 목록/검색 결과 row 식별키
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

output_formatsarray-N이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: employee_details-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.health_premiums.employee_details",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • members·summary·rows를 확인합니다.
  • 아래 표의 members[] 줄은 엑셀 파일(params 의 output_formats 에 ["xlsx"])의 열로 내보내는 칸이고, 열 이름은 엑셀 파일 맨 윗줄의 머리글입니다.
  • 아래 표의 줄은 엑셀로 내보내는 열이라 응답 행의 칸 전부가 아닐 수 있습니다.
  • 여러 JSON 타입이 함께 표시된 칸은 서버가 세부 타입을 고정하지 않는 기관 원문 또는 동적 값입니다.
순번변수명타입설명
membersarray가입자별 보험료 상세 배열
members[].sequencestring | number | boolean | object | array | null순번
members[].namestring | number | boolean | object | array | null성명
members[].notice_year_monthstring | number | boolean | object | array | null고지년월
members[].notice_roundstring | number | boolean | object | array | null고지차수
members[].write_roundstring | number | boolean | object | array | null작성차수
members[].monthly_wagenumber보수월액
members[].health.producednumber건강보험 산출보험료
members[].health.adjustmentnumber건강보험 정산/조정보험료
members[].health.year_endnumber건강보험 연말정산보험료
members[].health.refund_interestnumber건강보험 환급이자
members[].health.monthlynumber건강보험 당월보험료
members[].long_term_care.producednumber장기요양 산출보험료
members[].long_term_care.adjustmentnumber장기요양 정산/조정보험료
members[].long_term_care.year_endnumber장기요양 연말정산보험료
members[].long_term_care.refund_interestnumber장기요양 환급이자
members[].long_term_care.monthlynumber장기요양 당월보험료
members[].finance_codestring | number | boolean | object | array | null회계코드
summaryobject요약 정보 객체
noticeobject고지 기본정보 객체
workplaceobject사업장 정보 객체
json
// result.data
{
  "members": [
    {
      "sequence": "...",
      "name": "...",
      "notice_token": "...",
      "notice_year_month": "...",
      "notice_round": "...",
      "write_round": "...",
      "monthly_wage": 0,
      "health": {},
      "long_term_care": {},
      "finance_code": "...",
      "identifiers": {},
      "source": {}
    }
  ],
  "summary": {},
  "notice": {},
  "workplace": {}
}
순번오류 코드발생 조건
PROVIDER_UPSTREAM_ERROR읽기 미완료 — 행은 찾았지만 그 행의 내용을 끝까지 불러오지 못했습니다. 잠시 뒤 다시 시도합니다.
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 가입자 고지 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.
RESOURCE_NOT_FOUND기간에 자료 없음 — 행 키로 지정했거나 고지 월 같은 필터 없이 행 번호로 지정했는데 조회 기간에 자료가 하나도 없을 때입니다. error.message 는 조회 기간에 해당하는 문서가 없다는 안내이고 from_date 와 to_date 를 넓히라고 합니다. 같은 기간으로 다시 요청해도 같은 결과이니 기간을 넓혀 목록 조회부터 다시 합니다.
PROVIDER_VALIDATION_ERROR행 불일치 — 고른 행이 가입자 고지 행이 아닙니다.

6. 건강보험료 총괄 요약 조회nhis_edi.hr_payroll.health_premiums.summary

MCP 도구 이름 nhis_edi__hr_payroll__health_premiums__summary

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

고지 연월과 차수를 넣으면 사업장고지내역서(건강)를 열어 고지 인원과 건강보험, 장기요양보험의 산출, 조정, 고지 총액, 납부 마감일, 미납 금액을 받습니다.

  • 건강보험 총괄 고지를 먼저 선택하거나, 선택 조건을 함께 보냅니다. [국민건강보험공단 EDI 로그인]
  • result.data.error_code=HEALTH_PREMIUM_SUMMARY_DATASET_EMPTY.
  • 선택을 먼저 하면 params 를 빈 객체로 보낼 수 있습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.health_premiums.summary이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.health_premiums.summary

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-N이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-N선택할 행의 텍스트 포함값
cell_text_containsstring-N선택할 행 셀 텍스트 포함값
row_keystring-N이전 목록/검색 결과 row 식별키
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: summary-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.health_premiums.summary",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • summary·rows·business_datasets를 확인합니다.
순번변수명타입설명
summaryobject건강보험료 총괄 요약 객체
noticeobject고지 기본정보 객체
workplaceobject사업장 정보 객체
selected_optionobject선택된 고지 행 정보
json
// result.data
{
  "summary": {},
  "notice": {},
  "workplace": {},
  "selected_option": {}
}
순번오류 코드발생 조건
PROVIDER_UPSTREAM_ERROR읽기 미완료 — 행은 찾았지만 그 행의 내용을 끝까지 불러오지 못했습니다. 잠시 뒤 다시 시도합니다.
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 총괄 요약 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.
RESOURCE_NOT_FOUND기간에 자료 없음 — 행 키로 지정했거나 고지 월 같은 필터 없이 행 번호로 지정했는데 조회 기간에 자료가 하나도 없을 때입니다. error.message 는 조회 기간에 해당하는 문서가 없다는 안내이고 from_date 와 to_date 를 넓히라고 합니다. 같은 기간으로 다시 요청해도 같은 결과이니 기간을 넓혀 목록 조회부터 다시 합니다.
PROVIDER_VALIDATION_ERROR행 불일치 — 고른 행이 총괄 요약 행이 아닙니다.

7. 보험료 납부와 미납 내역 조회nhis_edi.hr_payroll.payment_status.list

MCP 도구 이름 nhis_edi__hr_payroll__payment_status__list

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

연동 계정으로 부르면 기본으로 올해 건강보험의 달마다 고지금액, 납부마감일, 납부일, 낸 보험료와 연체금, 미납 금액을 장기요양보험 몫과 함께 받습니다.

  • 로그인을 먼저 호출합니다. 세션에 회계·차수 정보가 남아 있으면 params 를 빈 객체로 보낼 수 있습니다. [국민건강보험공단 EDI 로그인]
  • implementation_status=premium_payment_status_empty, error_code=null.
  • insurance_code 기본 1(건강). search_year 기본 당해. goji_chasu·nation_finance_cd·unb_no는 세션 firm info에서 fallback.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.payment_status.list이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.payment_status.list

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
insurance_codestring-N보험종류 SEARCH_GUBUN. 기본 1(건강보험)
search_yearstring4N조회 연도. 미입력 시 당해

형식 : YYYY

goji_chasustring-N고지 차수. 미입력 시 세션 ds_Si4nFirmInfo 또는 1
nation_finance_cdstring-N회계코드. 미입력 시 세션 FINANCE_CD 또는 00
unb_nostring-N통합납부번호. 미입력 시 세션 UNB_NO
output_formatsarray-N이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: list-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.payment_status.list",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • rows·filters·row_count를 확인합니다.
  • 아래 표의 rows[] 줄은 엑셀 파일(params 의 output_formats 에 ["xlsx"])의 열로 내보내는 칸이고, 열 이름은 엑셀 파일 맨 윗줄의 머리글입니다.
  • 아래 표의 줄은 엑셀로 내보내는 열이라 응답 행의 칸 전부가 아닐 수 있습니다.
  • 여러 JSON 타입이 함께 표시된 칸은 서버가 세부 타입을 고정하지 않는 기관 원문 또는 동적 값입니다.
순번변수명타입설명
rowsarray납부·미납 내역 행 배열(월별 한 행). 금액 칸은 정수이고 기관이 비워 보낸 칸은 금액이면 0, 그 밖은 빈 글입니다
rows[].YYYYMMstring | number | boolean | object | array | null월
rows[].GOJI_CTRBstring | number | boolean | object | array | null고지금액
rows[].NABBU_MAGAM_DTstring | number | boolean | object | array | null납부마감일
rows[].RECP_DTstring | number | boolean | object | array | null납부일
rows[].NABBU_AMT_Astring | number | boolean | object | array | null수납내역 보험료
rows[].NABBU_AMT_Bstring | number | boolean | object | array | null수납내역 연체금
rows[].MINAP_CTRBstring | number | boolean | object | array | null미납내역 보험료
rows[].MINAP_ADD_AMTstring | number | boolean | object | array | null미납내역 연체금
rows[].NY_GOJI_CTRBstring | number | boolean | object | array | null장기요양 고지금액
rows[].RECP_DT_NYstring | number | boolean | object | array | null장기요양 납부일
rows[].NY_NABBU_AMT_Astring | number | boolean | object | array | null장기요양 수납내역 보험료
rows[].NY_NABBU_AMT_Bstring | number | boolean | object | array | null장기요양 수납내역 연체금
rows[].NY_MINAP_CTRBstring | number | boolean | object | array | null장기요양 미납내역 보험료
rows[].NY_MINAP_ADD_AMTstring | number | boolean | object | array | null장기요양 미납내역 연체금
filtersobject적용된 필터 정보 객체
row_countnumber결과 건수
datasetsobject기관 데이터셋 (ds_List) - columns 와 rows. rows 는 위 rows 와 같습니다
json
// result.data
{
  "success": true,
  "feature_name": "...",
  "phase": "list",
  "workflow_step": "payment_status_queried",
  "screen_id": "...",
  "route_kind": "live",
  "filters": {},
  "row_count": 1,
  "rows": [
    {
      "YYYYMM": "...",
      "GUBUN": "",
      "GOJI_CTRB": 0,
      "NABBU_MAGAM_DT": "...",
      "RECP_DT": "...",
      "RECP_DT_NY": "...",
      "NABBU_AMT_A": 0,
      "NABBU_AMT_B": 0,
      "MINAP_CTRB": 0,
      "MINAP_ADD_AMT": 0,
      "NY_GOJI_CTRB": 0,
      "NY_NABBU_AMT_A": 0,
      "NY_NABBU_AMT_B": 0,
      "NY_MINAP_CTRB": 0,
      "NY_MINAP_ADD_AMT": 0
    }
  ],
  "datasets": {
    "...": {}
  },
  "source_evidence": {},
  "error_code": null,
  "implementation_status": null
}
순번오류 코드발생 조건
VALIDATION_INVALID_FIELD필터 부족 — insurance_code=1(기본값) 조회인데 goji_chasu 나 nation_finance_cd 가 빈 값입니다. 두 값은 보내지 않으면 사업장 정보나 기본값으로 채워집니다.

8. 보수월액 보험료 고지 상세 조회nhis_edi.hr_payroll.premium_notices.detail

MCP 도구 이름 nhis_edi__hr_payroll__premium_notices__detail

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

탐색 결과의 행 키나 고지 연월과 문서 이름으로 고지내역서 하나를 열어 고지 연월과 차수, 보험 종류, 기관이 준 고지 항목 행을 받습니다.

  • 보험료 고지 선택을 먼저 호출하거나, 선택 조건을 함께 보냅니다. [국민건강보험공단 EDI 로그인]
  • result.data.error_code=PREMIUM_NOTICE_DETAIL_DATASET_EMPTY (business_datasets 비어 있음).
  • 선택을 먼저 하면 params 를 빈 객체로 보낼 수 있습니다. 세션에 남은 선택 행을 사용합니다.
  • 이번 요청에 row_text_contains, cell_text_contains, notice_year_month, goji_round 를 보냈는데 남은 선택 행과 맞지 않으면 그 행을 버리고 보낸 조건으로 다시 고릅니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.premium_notices.detail이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.premium_notices.detail

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-조건부작업 파라미터입니다. 아래 params 파라미터 표의 row_index, row_key, row_text_contains, cell_text_contains, notice_year_month 또는 goji_round 중 하나 이상을 보냅니다. 앞 단계에서 고른 항목이 같은 연동 계정의 세션에 남아 있으면 빈 객체로 보내 그 항목을 씁니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-조건부이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-조건부선택할 행의 텍스트 포함값
cell_text_containsstring-조건부선택할 행 셀 텍스트 포함값
row_keystring-조건부이전 목록/검색 결과 row 식별키
notice_year_monthstring6조건부고지연월

형식 : YYYYMM

goji_roundstring-조건부고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.premium_notices.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "row_index": "<필수: number>"
  }
}'

Response

  • business_datasets·rows·summary를 확인합니다.
순번변수명타입설명
business_datasetsobject사업장 고지 데이터셋 객체 (키=데이터셋명)
rowsarray행 데이터 배열
summaryobject고지 요약 정보 객체
workplaceobject사업장 정보 (사업장관리번호, 사업자번호, 사업장명 등)
noticeobject선택한 고지 정보
selected_optionobject선택한 행 정보
json
// result.data
{
  "rows": [
    {
      "D2_BCD": "A123456789012345678901234567890123456789012        34567        8901234567890123엑스보스 주식회사   4567890                    사회보험료          국민건강보험공단    1234567890123456789 0123456789012",
      "UNB_NO": "12345678901",
      "FIRM_NM": "예시 주식회사",
      "BANK_NM1": "카카오뱅크",
      "BANK_NM2": "케이뱅크",
      "BANK_NM3": "토스뱅크",
      "BANK_NM4": "기업",
      "BANK_NM5": "KB국민",
      "BANK_NM6": "우체국",
      "BANK_NM7": "NH농협",
      "BANK_NM8": "신한",
      "BANK_NM9": "우리",
      "CEN_TYPE": "01",
      "FIRM_SYM": "12345678901",
      "ANMT_COMT": "\u0003",
      "BANK_NM10": "하나",
      "BANK_NM11": "\u0003",
      "NPAY_CTRB": "123030",
      "PTTN_TYPE": "1",
      "SEND_TYPE": "2",
      "WRT_CHASU": "2026052001",
      "AD_PAY_AMT": "37820",
      "E_NABBU_NO": "000000-0000000",
      "FILE_CHASU": "2026052019",
      "NPAY_M_CNT": "3",
      "OCCUR_TYPE": "I",
      "WD_PAY_AMT": "37820",
      "AD_PAY_LMTN": "20260610",
      "EAI_SEND_YN": "Y",
      "GOJI_YYYYMM": "202605",
      "WRT_DUP_SEQ": "01",
      "IDWC_ADD_AMT": "0",
      "SEND_RECV_FG": "R",
      "WEB_EDI_FLAG": "1",
      "EAI_SEND_DATE": "20260521015131000",
      "IDWC_APRP_AMT": "0",
      "SUM_GOJI_CTRB": "37820",
      "VRTL_ACT_NO_1": "000000-0000000",
      "VRTL_ACT_NO_2": "12345678901234",
      "VRTL_ACT_NO_3": "123456789012",
      "VRTL_ACT_NO_4": "12345678901234",
      "VRTL_ACT_NO_5": "12345678901234",
      "VRTL_ACT_NO_6": "12345678901234",
      "VRTL_ACT_NO_7": "12345678901234",
      "VRTL_ACT_NO_8": "12345678901234",
      "VRTL_ACT_NO_9": "12345678901234",
      "IDWC_CORR_CTRB": "0",
      "IDWC_GOJI_CTRB": "37820",
      "NABBU_MAGAM_DT": "20260610",
      "NPAY_FR_YYYYMM": "202602",
      "NPAY_TO_YYYYMM": "202604",
      "VRTL_ACT_NO_10": "12345678901234",
      "VRTL_ACT_NO_11": "\u0003",
      "source_dataset": "...",
      "DECS_NPAY_M_CNT": "0",
      "EMAIL_RDAMT_AMT": "0",
      "IDWC_CORR_CTRB2": "0",
      "SUM_DMGE_ADD_AMT": "0",
      "ABST_DMGE_ADD_AMT": "0",
      "IDWC_T_MONTH_CTRB": "37820",
      "SAL_CRDIT_ADD_AMT": "0",
      "SUM_DMGE_APRP_AMT": "0",
      "ABST_DMGE_APRP_AMT": "0",
      "P_MONTH_NABBU_CTRB": "0",
      "SAL_CRDIT_APRP_AMT": "0",
      "SUM_DMGE_CORR_CTRB": "0",
      "ABST_DMGE_CORR_CTRB": "0",
      "ABST_DMGE_GOJI_CTRB": "0",
      "DECS_NPAY_FR_YYYYMM": "\u0003",
      "DECS_NPAY_TO_YYYYMM": "\u0003",
      "EMAIL_RDAMT_TYPE_CD": "0",
      "P_MONTH_GOJI_YYYYMM": "202604",
      "SAL_CRDIT_CORR_CTRB": "0",
      "SAL_CRDIT_GOJI_CTRB": "0",
      "ABST_DMGE_CORR_CTRB2": "0",
      "FIRM_T_MONTH_TGT_NOP": "2",
      "IDWC_JINGSU_DECS_AMT": "37820",
      "SAL_CRDIT_CORR_CTRB2": "0",
      "SUM_DMGE_T_MONTH_CTRB": "37820",
      "ABST_DMGE_T_MONTH_CTRB": "0",
      "SAL_CRDIT_T_MONTH_CTRB": "4530",
      "DECS_NPAY_GOJI_ARAR_AMT": "0",
      "FEE_TOT_AMT_E_DCLT_REDU": "0",
      "UNITY_GOJISEO_ISSUE_TYPE_CD": "1"
    }
  ],
  "phase": "detail",
  "notice": {
    "round": "1",
    "scope": "workplace",
    "insurance": "industrial_accident",
    "year_month": "202605",
    "document_id": "BMBB_033",
    "notice_kind": "regular",
    "write_round": "2026052001",
    "document_name": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00",
    "document_title": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1"
  },
  "success": true,
  "summary": {
    "business_row_count": 1,
    "dataset_row_counts": {
      "...": 1,
      "...2": 1
    },
    "business_dataset_count": 1
  },
  "workplace": {
    "unb_no": "12345678901",
    "firm_sym": "12345678901",
    "unit_firm_sym": "000",
    "nation_finance_cd": "00"
  },
  "error_code": null,
  "route_kind": "live",
  "feature_name": "...",
  "workflow_step": "premium_notice_detail_loaded",
  "selected_option": {
    "scope": "workplace",
    "title": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
    "row_key": "row:0",
    "insurance": "industrial_accident",
    "row_index": 0,
    "selection": {
      "row_key": "row:0",
      "row_index": 0,
      "row_text_contains": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00"
    },
    "goji_round": "1",
    "document_id": "BMBB_033",
    "notice_kind": "regular",
    "write_round": "2026052001",
    "finance_code": "00",
    "document_name": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00",
    "received_date": null,
    "notice_year_month": "202605",
    "selectable_dom_id": null,
    "selectable_selector": null
  },
  "source_evidence": {
    "sql_id": "...",
    "program_id": "...",
    "document_id": "...",
    "template_id": "...",
    "detail_source": "...",
    "document_title": "...",
    "dataset_row_counts": {
      "...": 1,
      "...2": 1
    },
    "selected_row_index": 0,
    "business_dataset_names": [
      "..."
    ],
    "response_dataset_names": [
      "...",
      "..."
    ]
  },
  "business_datasets": {
    "...": {
      "rows": [
        {
          "D2_BCD": "A123456789012345678901234567890123456789012        34567        8901234567890123엑스보스 주식회사   4567890                    사회보험료          국민건강보험공단    1234567890123456789 0123456789012",
          "UNB_NO": "12345678901",
          "FIRM_NM": "예시 주식회사",
          "BANK_NM1": "카카오뱅크",
          "BANK_NM2": "케이뱅크",
          "BANK_NM3": "토스뱅크",
          "BANK_NM4": "기업",
          "BANK_NM5": "KB국민",
          "BANK_NM6": "우체국",
          "BANK_NM7": "NH농협",
          "BANK_NM8": "신한",
          "BANK_NM9": "우리",
          "CEN_TYPE": "01",
          "FIRM_SYM": "12345678901",
          "ANMT_COMT": "\u0003",
          "BANK_NM10": "하나",
          "BANK_NM11": "\u0003",
          "NPAY_CTRB": "123030",
          "PTTN_TYPE": "1",
          "SEND_TYPE": "2",
          "WRT_CHASU": "2026052001",
          "AD_PAY_AMT": "37820",
          "E_NABBU_NO": "000000-0000000",
          "FILE_CHASU": "2026052019",
          "NPAY_M_CNT": "3",
          "OCCUR_TYPE": "I",
          "WD_PAY_AMT": "37820",
          "AD_PAY_LMTN": "20260610",
          "EAI_SEND_YN": "Y",
          "GOJI_YYYYMM": "202605",
          "WRT_DUP_SEQ": "01",
          "IDWC_ADD_AMT": "0",
          "SEND_RECV_FG": "R",
          "WEB_EDI_FLAG": "1",
          "EAI_SEND_DATE": "20260521015131000",
          "IDWC_APRP_AMT": "0",
          "SUM_GOJI_CTRB": "37820",
          "VRTL_ACT_NO_1": "000000-0000000",
          "VRTL_ACT_NO_2": "12345678901234",
          "VRTL_ACT_NO_3": "123456789012",
          "VRTL_ACT_NO_4": "12345678901234",
          "VRTL_ACT_NO_5": "12345678901234",
          "VRTL_ACT_NO_6": "12345678901234",
          "VRTL_ACT_NO_7": "12345678901234",
          "VRTL_ACT_NO_8": "12345678901234",
          "VRTL_ACT_NO_9": "12345678901234",
          "IDWC_CORR_CTRB": "0",
          "IDWC_GOJI_CTRB": "37820",
          "NABBU_MAGAM_DT": "20260610",
          "NPAY_FR_YYYYMM": "202602",
          "NPAY_TO_YYYYMM": "202604",
          "VRTL_ACT_NO_10": "12345678901234",
          "VRTL_ACT_NO_11": "\u0003",
          "DECS_NPAY_M_CNT": "0",
          "EMAIL_RDAMT_AMT": "0",
          "IDWC_CORR_CTRB2": "0",
          "SUM_DMGE_ADD_AMT": "0",
          "ABST_DMGE_ADD_AMT": "0",
          "IDWC_T_MONTH_CTRB": "37820",
          "SAL_CRDIT_ADD_AMT": "0",
          "SUM_DMGE_APRP_AMT": "0",
          "ABST_DMGE_APRP_AMT": "0",
          "P_MONTH_NABBU_CTRB": "0",
          "SAL_CRDIT_APRP_AMT": "0",
          "SUM_DMGE_CORR_CTRB": "0",
          "ABST_DMGE_CORR_CTRB": "0",
          "ABST_DMGE_GOJI_CTRB": "0",
          "DECS_NPAY_FR_YYYYMM": "\u0003",
          "DECS_NPAY_TO_YYYYMM": "\u0003",
          "EMAIL_RDAMT_TYPE_CD": "0",
          "P_MONTH_GOJI_YYYYMM": "202604",
          "SAL_CRDIT_CORR_CTRB": "0",
          "SAL_CRDIT_GOJI_CTRB": "0",
          "ABST_DMGE_CORR_CTRB2": "0",
          "FIRM_T_MONTH_TGT_NOP": "2",
          "IDWC_JINGSU_DECS_AMT": "37820",
          "SAL_CRDIT_CORR_CTRB2": "0",
          "SUM_DMGE_T_MONTH_CTRB": "37820",
          "ABST_DMGE_T_MONTH_CTRB": "0",
          "SAL_CRDIT_T_MONTH_CTRB": "4530",
          "DECS_NPAY_GOJI_ARAR_AMT": "0",
          "FEE_TOT_AMT_E_DCLT_REDU": "0",
          "UNITY_GOJISEO_ISSUE_TYPE_CD": "1"
        }
      ],
      "columns": [
        "WRT_CHASU",
        "WRT_DUP_SEQ",
        "FIRM_SYM",
        "GOJI_YYYYMM",
        "UNB_NO",
        "FIRM_NM",
        "FIRM_T_MONTH_TGT_NOP",
        "IDWC_JINGSU_DECS_AMT",
        "IDWC_T_MONTH_CTRB",
        "SAL_CRDIT_T_MONTH_CTRB",
        "SUM_DMGE_T_MONTH_CTRB",
        "ABST_DMGE_T_MONTH_CTRB",
        "IDWC_CORR_CTRB",
        "SAL_CRDIT_CORR_CTRB",
        "SUM_DMGE_CORR_CTRB",
        "ABST_DMGE_CORR_CTRB",
        "IDWC_ADD_AMT",
        "SAL_CRDIT_ADD_AMT",
        "SUM_DMGE_ADD_AMT",
        "ABST_DMGE_ADD_AMT",
        "IDWC_APRP_AMT",
        "SAL_CRDIT_APRP_AMT",
        "SUM_DMGE_APRP_AMT",
        "ABST_DMGE_APRP_AMT",
        "IDWC_GOJI_CTRB",
        "SAL_CRDIT_GOJI_CTRB",
        "SUM_GOJI_CTRB",
        "ABST_DMGE_GOJI_CTRB",
        "WD_PAY_AMT",
        "NABBU_MAGAM_DT",
        "AD_PAY_AMT",
        "AD_PAY_LMTN",
        "NPAY_CTRB",
        "NPAY_FR_YYYYMM",
        "NPAY_TO_YYYYMM",
        "NPAY_M_CNT",
        "P_MONTH_GOJI_YYYYMM",
        "P_MONTH_NABBU_CTRB",
        "E_NABBU_NO",
        "UNITY_GOJISEO_ISSUE_TYPE_CD",
        "ANMT_COMT",
        "CEN_TYPE",
        "SEND_TYPE",
        "VRTL_ACT_NO_1",
        "VRTL_ACT_NO_2",
        "VRTL_ACT_NO_3",
        "VRTL_ACT_NO_4",
        "VRTL_ACT_NO_5",
        "VRTL_ACT_NO_6",
        "VRTL_ACT_NO_7",
        "VRTL_ACT_NO_8",
        "VRTL_ACT_NO_9",
        "VRTL_ACT_NO_10",
        "VRTL_ACT_NO_11",
        "BANK_NM1",
        "BANK_NM2",
        "BANK_NM3",
        "BANK_NM4",
        "BANK_NM5",
        "BANK_NM6",
        "BANK_NM7",
        "BANK_NM8",
        "BANK_NM9",
        "BANK_NM10",
        "BANK_NM11",
        "D2_BCD",
        "FILE_CHASU",
        "WEB_EDI_FLAG",
        "SEND_RECV_FG",
        "OCCUR_TYPE",
        "EAI_SEND_YN",
        "EAI_SEND_DATE",
        "EMAIL_RDAMT_TYPE_CD",
        "EMAIL_RDAMT_AMT",
        "DECS_NPAY_FR_YYYYMM",
        "DECS_NPAY_TO_YYYYMM",
        "DECS_NPAY_M_CNT",
        "DECS_NPAY_GOJI_ARAR_AMT",
        "IDWC_CORR_CTRB2",
        "SAL_CRDIT_CORR_CTRB2",
        "ABST_DMGE_CORR_CTRB2",
        "FEE_TOT_AMT_E_DCLT_REDU",
        "PTTN_TYPE"
      ],
      "row_count": 1
    }
  },
  "implementation_status": null
}
순번오류 코드발생 조건
PROVIDER_UPSTREAM_ERROR읽기 미완료 — 행은 찾았지만 그 행의 내용을 끝까지 불러오지 못했습니다. 잠시 뒤 다시 시도합니다.
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 보험료 고지 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.
RESOURCE_NOT_FOUND기간에 자료 없음 — 행 키로 지정했거나 고지 월 같은 필터 없이 행 번호로 지정했는데 조회 기간에 자료가 하나도 없을 때입니다. error.message 는 조회 기간에 해당하는 문서가 없다는 안내이고 from_date 와 to_date 를 넓히라고 합니다. 같은 기간으로 다시 요청해도 같은 결과이니 기간을 넓혀 목록 조회부터 다시 합니다.
VALIDATION_INVALID_FIELD신호 없음 — 앞서 고른 행이 없는데 row_index, row_key, row_text_contains, cell_text_contains, notice_year_month, goji_round 도 하나도 보내지 않으면 「고지 문서를 먼저 골라 주세요」 로 시작하는 문장으로 거절하고 첫 고지를 대신 고르지 않습니다.

MCP 도구 이름 nhis_edi__hr_payroll__premium_notices__search

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

문서를 받은 기간이나 고지 연월을 넣으면 건강과 연금, 고용, 산재 보험료의 고지내역서 목록을 받습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • result.data.error_code=PREMIUM_NOTICE_SEARCH_EMPTY.
  • params 는 빈 객체로 보내도 호출됩니다. 날짜와 필터 규칙은 수신 문서 조회와 같습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.premium_notices.search이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.premium_notices.search

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_text_containsstring-N선택 후보 고지 행 텍스트 포함값. 검색 결과 후처리 필터
cell_text_containsstring-N선택 후보 고지 셀 텍스트 포함값. 검색 결과 후처리 필터
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: search-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.premium_notices.search",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • options·selection_contract·workflow_contract를 확인합니다.
순번변수명타입설명
optionsarray고지내역서 행 배열
selection_contractobject선택 계약 정보 객체
workflow_contractobject워크플로우 계약 정보 객체
row_countnumber고지 옵션 행 수
json
// result.data
{
  "phase": "notice_search_popup",
  "options": [
    {
      "scope": "workplace",
      "title": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:0",
      "insurance": "industrial_accident",
      "row_index": 0,
      "selection": {
        "row_key": "row:0",
        "row_index": 0,
        "row_text_contains": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_033",
      "notice_kind": "regular",
      "write_round": "2026052001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(고용) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:1",
      "insurance": "employment",
      "row_index": 1,
      "selection": {
        "row_key": "row:1",
        "row_index": 1,
        "row_text_contains": "사업장고지내역서(고용) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_032",
      "notice_kind": "regular",
      "write_round": "2026052001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(고용) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(연금) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:2",
      "insurance": "pension",
      "row_index": 2,
      "selection": {
        "row_key": "row:2",
        "row_index": 2,
        "row_text_contains": "사업장고지내역서(연금) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_031",
      "notice_kind": "regular",
      "write_round": "2026052001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(연금) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:3",
      "insurance": "health",
      "row_index": 3,
      "selection": {
        "row_key": "row:3",
        "row_index": 3,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026052001",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:4",
      "insurance": "health",
      "row_index": 4,
      "selection": {
        "row_key": "row:4",
        "row_index": 4,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026052001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:5",
      "insurance": "health",
      "row_index": 5,
      "selection": {
        "row_key": "row:5",
        "row_index": 5,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026051801",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:6",
      "insurance": "health",
      "row_index": 6,
      "selection": {
        "row_key": "row:6",
        "row_index": 6,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026051801",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(산재) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:9",
      "insurance": "industrial_accident",
      "row_index": 9,
      "selection": {
        "row_key": "row:9",
        "row_index": 9,
        "row_text_contains": "사업장고지내역서(산재) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_033",
      "notice_kind": "regular",
      "write_round": "2026042101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(산재) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(고용) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:10",
      "insurance": "employment",
      "row_index": 10,
      "selection": {
        "row_key": "row:10",
        "row_index": 10,
        "row_text_contains": "사업장고지내역서(고용) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_032",
      "notice_kind": "regular",
      "write_round": "2026042101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(고용) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(연금) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:11",
      "insurance": "pension",
      "row_index": 11,
      "selection": {
        "row_key": "row:11",
        "row_index": 11,
        "row_text_contains": "사업장고지내역서(연금) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_031",
      "notice_kind": "regular",
      "write_round": "2026042101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(연금) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:12",
      "insurance": "health",
      "row_index": 12,
      "selection": {
        "row_key": "row:12",
        "row_index": 12,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026042101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:13",
      "insurance": "health",
      "row_index": 13,
      "selection": {
        "row_key": "row:13",
        "row_index": 13,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026042101",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:14",
      "insurance": "health",
      "row_index": 14,
      "selection": {
        "row_key": "row:14",
        "row_index": 14,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026041601",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:15",
      "insurance": "health",
      "row_index": 15,
      "selection": {
        "row_key": "row:15",
        "row_index": 15,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026041601",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(산재) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:17",
      "insurance": "industrial_accident",
      "row_index": 17,
      "selection": {
        "row_key": "row:17",
        "row_index": 17,
        "row_text_contains": "사업장고지내역서(산재) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_033",
      "notice_kind": "regular",
      "write_round": "2026032001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(산재) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(고용) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:18",
      "insurance": "employment",
      "row_index": 18,
      "selection": {
        "row_key": "row:18",
        "row_index": 18,
        "row_text_contains": "사업장고지내역서(고용) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_032",
      "notice_kind": "regular",
      "write_round": "2026032001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(고용) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(연금) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:19",
      "insurance": "pension",
      "row_index": 19,
      "selection": {
        "row_key": "row:19",
        "row_index": 19,
        "row_text_contains": "사업장고지내역서(연금) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_031",
      "notice_kind": "regular",
      "write_round": "2026032001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(연금) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:20",
      "insurance": "health",
      "row_index": 20,
      "selection": {
        "row_key": "row:20",
        "row_index": 20,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026032001",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:21",
      "insurance": "health",
      "row_index": 21,
      "selection": {
        "row_key": "row:21",
        "row_index": 21,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026032001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:23",
      "insurance": "health",
      "row_index": 23,
      "selection": {
        "row_key": "row:23",
        "row_index": 23,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026031701",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:24",
      "insurance": "health",
      "row_index": 24,
      "selection": {
        "row_key": "row:24",
        "row_index": 24,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026031701",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(산재) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:25",
      "insurance": "industrial_accident",
      "row_index": 25,
      "selection": {
        "row_key": "row:25",
        "row_index": 25,
        "row_text_contains": "사업장고지내역서(산재) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_033",
      "notice_kind": "regular",
      "write_round": "2026022001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(산재) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(고용) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:26",
      "insurance": "employment",
      "row_index": 26,
      "selection": {
        "row_key": "row:26",
        "row_index": 26,
        "row_text_contains": "사업장고지내역서(고용) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_032",
      "notice_kind": "regular",
      "write_round": "2026022001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(고용) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(연금) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:27",
      "insurance": "pension",
      "row_index": 27,
      "selection": {
        "row_key": "row:27",
        "row_index": 27,
        "row_text_contains": "사업장고지내역서(연금) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_031",
      "notice_kind": "regular",
      "write_round": "2026022001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(연금) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:28",
      "insurance": "health",
      "row_index": 28,
      "selection": {
        "row_key": "row:28",
        "row_index": 28,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026022001",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:29",
      "insurance": "health",
      "row_index": 29,
      "selection": {
        "row_key": "row:29",
        "row_index": 29,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026022001",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:30",
      "insurance": "health",
      "row_index": 30,
      "selection": {
        "row_key": "row:30",
        "row_index": 30,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026021901",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:31",
      "insurance": "health",
      "row_index": 31,
      "selection": {
        "row_key": "row:31",
        "row_index": 31,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026021901",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(산재) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:32",
      "insurance": "industrial_accident",
      "row_index": 32,
      "selection": {
        "row_key": "row:32",
        "row_index": 32,
        "row_text_contains": "사업장고지내역서(산재) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_033",
      "notice_kind": "regular",
      "write_round": "2026012101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(산재) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(고용) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:33",
      "insurance": "employment",
      "row_index": 33,
      "selection": {
        "row_key": "row:33",
        "row_index": 33,
        "row_text_contains": "사업장고지내역서(고용) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_032",
      "notice_kind": "regular",
      "write_round": "2026012101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(고용) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(연금) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:34",
      "insurance": "pension",
      "row_index": 34,
      "selection": {
        "row_key": "row:34",
        "row_index": 34,
        "row_text_contains": "사업장고지내역서(연금) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_031",
      "notice_kind": "regular",
      "write_round": "2026012101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(연금) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:35",
      "insurance": "health",
      "row_index": 35,
      "selection": {
        "row_key": "row:35",
        "row_index": 35,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026012101",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:36",
      "insurance": "health",
      "row_index": 36,
      "selection": {
        "row_key": "row:36",
        "row_index": 36,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026012101",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:37",
      "insurance": "health",
      "row_index": 37,
      "selection": {
        "row_key": "row:37",
        "row_index": 37,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2026011601",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:38",
      "insurance": "health",
      "row_index": 38,
      "selection": {
        "row_key": "row:38",
        "row_index": 38,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2026011601",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(산재) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:39",
      "insurance": "industrial_accident",
      "row_index": 39,
      "selection": {
        "row_key": "row:39",
        "row_index": 39,
        "row_text_contains": "사업장고지내역서(산재) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_033",
      "notice_kind": "regular",
      "write_round": "2025121901",
      "finance_code": "00",
      "document_name": "사업장고지내역서(산재) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(고용) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:40",
      "insurance": "employment",
      "row_index": 40,
      "selection": {
        "row_key": "row:40",
        "row_index": 40,
        "row_text_contains": "사업장고지내역서(고용) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_032",
      "notice_kind": "regular",
      "write_round": "2025121901",
      "finance_code": "00",
      "document_name": "사업장고지내역서(고용) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(연금) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:41",
      "insurance": "pension",
      "row_index": 41,
      "selection": {
        "row_key": "row:41",
        "row_index": 41,
        "row_text_contains": "사업장고지내역서(연금) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_031",
      "notice_kind": "regular",
      "write_round": "2025121901",
      "finance_code": "00",
      "document_name": "사업장고지내역서(연금) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:42",
      "insurance": "health",
      "row_index": 42,
      "selection": {
        "row_key": "row:42",
        "row_index": 42,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2025121901",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:43",
      "insurance": "health",
      "row_index": 43,
      "selection": {
        "row_key": "row:43",
        "row_index": 43,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2025121901",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "subscriber",
      "title": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:44",
      "insurance": "health",
      "row_index": 44,
      "selection": {
        "row_key": "row:44",
        "row_index": 44,
        "row_text_contains": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_020",
      "notice_kind": "regular",
      "write_round": "2025121601",
      "finance_code": "00",
      "document_name": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    },
    {
      "scope": "workplace",
      "title": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:45",
      "insurance": "health",
      "row_index": 45,
      "selection": {
        "row_key": "row:45",
        "row_index": 45,
        "row_text_contains": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00"
      },
      "goji_round": "1",
      "document_id": "BMBB_030",
      "notice_kind": "regular",
      "write_round": "2025121601",
      "finance_code": "00",
      "document_name": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "selectable_dom_id": null,
      "selectable_selector": null
    }
  ],
  "success": true,
  "row_count": 42,
  "error_code": null,
  "route_kind": "live",
  "feature_name": "...",
  "workflow_step": "premium_notice_search_popup",
  "source_evidence": {
    "source_summary": {
      "mode": "...",
      "data_source": "..."
    },
    "response_dataset_names": [
      "...",
      "..."
    ]
  },
  "workflow_contract": {
    "recorded_sets": [
      "보험료 고지내역서 -> 조회 팝업",
      "row 선택",
      "총괄 확인",
      "개인별내역 보기 -> 개인별 데이터"
    ],
    "supported_document_ids": [
      "BMBB_020",
      "BMBB_021",
      "BMBB_022",
      "BMBB_023",
      "BMBB_030",
      "BMBB_031",
      "BMBB_032",
      "BMBB_033",
      "BMBB_040",
      "BMBB_050",
      "BMBB_051",
      "BMBB_060"
    ],
    "workplace_document_ids": [
      "BMBB_030",
      "BMBB_050",
      "BMBB_031",
      "BMBB_051",
      "BMBB_032",
      "BMBB_033",
      "BMBB_060"
    ],
    "subscriber_document_ids": [
      "BMBB_020",
      "BMBB_040",
      "BMBB_021",
      "BMBB_022",
      "BMBB_023"
    ],
    "health_summary_document_ids": [
      "BMBB_030",
      "BMBB_050"
    ],
    "health_employee_detail_document_ids": [
      "BMBB_020",
      "BMBB_040"
    ]
  },
  "selection_contract": {
    "recorded_step": "received_document_grid_row_activation",
    "recorded_action": "dblclick",
    "selector_source": "visible_grid_dom_id",
    "supported_selectors": [
      "row_index",
      "row_key",
      "row_text_contains",
      "cell_text_contains",
      "notice_year_month",
      "goji_round"
    ]
  },
  "implementation_status": null
}

10. 보수월액 보험료 고지 선택nhis_edi.hr_payroll.premium_notices.select

MCP 도구 이름 nhis_edi__hr_payroll__premium_notices__select

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

탐색 결과의 행 키나 고지 연월, 문서 이름으로 고지내역서 하나를 골라 같은 연동 계정의 다음 조회가 쓰도록 남기고, 고른 문서 정보와 이어 부를 조회 목록을 받습니다.

  • 목록 조회로 선택 가능한 옵션을 먼저 확인한 뒤 호출합니다. [국민건강보험공단 EDI 로그인]
  • row_index 와 row_key 를 보내지 않으면 row_text_contains, cell_text_contains, notice_year_month, goji_round 가운데 하나 이상으로 목록을 거르고 그중 처음 나오는 보험료 고지 행을 선택합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.premium_notices.select이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.premium_notices.select

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 row_index, row_key, row_text_contains, cell_text_contains, notice_year_month 또는 goji_round 중 하나 이상을 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-조건부이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-조건부선택할 행의 텍스트 포함값
cell_text_containsstring-조건부선택할 행 셀 텍스트 포함값
row_keystring-조건부이전 목록/검색 결과 row 식별키
notice_year_monthstring6조건부고지연월

형식 : YYYYMM

goji_roundstring-조건부고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: select-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.premium_notices.select",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "row_index": "<필수: number>"
  }
}'

Response

  • selected_option·next_steps를 확인합니다. 이후 detail·health_premiums에 params {} 가능.
순번변수명타입설명
selected_optionobject선택된 고지 행 정보 객체
selectionobject선택 컨텍스트 (이후 상세 API에서 재사용)
next_stepsarray다음 단계 힌트 배열
selection_contractobject선택 호출 계약 (다음 호출에 넘길 값)
json
// result.data
{
  "selected_option": {},
  "selection": {},
  "next_steps": [],
  "selection_contract": {}
}
순번오류 코드발생 조건
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 보험료 고지 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.
RESOURCE_NOT_FOUND기간에 자료 없음 — 행 키로 지정했거나 고지 월 같은 필터 없이 행 번호로 지정했는데 조회 기간에 자료가 하나도 없을 때입니다. error.message 는 조회 기간에 해당하는 문서가 없다는 안내이고 from_date 와 to_date 를 넓히라고 합니다. 같은 기간으로 다시 요청해도 같은 결과이니 기간을 넓혀 목록 조회부터 다시 합니다.
PROVIDER_VALIDATION_ERROR행 불일치 — 고른 행이 보험료 고지 행이 아닙니다.
VALIDATION_INVALID_FIELD신호 없음 — row_index, row_key, row_text_contains, cell_text_contains, notice_year_month, goji_round 를 하나도 보내지 않으면 「고지 문서를 먼저 골라 주세요」 로 시작하는 문장으로 거절하고 첫 고지를 대신 고르지 않습니다. 목록 조회 결과를 보고 신호를 정해 다시 보냅니다.

11. 인사급여 처리결과 목록 조회nhis_edi.hr_payroll.processing_results.list

MCP 도구 이름 nhis_edi__hr_payroll__processing_results__list

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

기간이나 고지 연월을 넣으면 받은 문서와 보낸 문서의 행을 한 목록으로 받습니다.

  • 로그인을 먼저 호출합니다. 이 API 는 세션만 있으면 되고 업무 화면 진입은 필요하지 않습니다. [국민건강보험공단 EDI 로그인]
  • params 는 빈 객체로 보내도 호출됩니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.processing_results.list이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.processing_results.list

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

output_formatsarray-N이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: list-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.processing_results.list",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • rows·received_count·sent_count·row_count 확인.
  • 아래 표의 rows[] 줄은 엑셀 파일(params 의 output_formats 에 ["xlsx"])의 열로 내보내는 칸이고, 열 이름은 엑셀 파일 맨 윗줄의 머리글입니다.
  • 아래 표의 줄은 엑셀로 내보내는 열이라 응답 행의 칸 전부가 아닐 수 있습니다.
순번변수명타입설명
successboolean처리 성공 여부
feature_namestring기능 식별자
phasestring단계(이 액션은 list)
workflow_stepstring워크플로 단계
screen_idstring화면 식별자
route_kindstring라우트 종류
row_countnumber전체 건수
received_countnumber수신 건수
sent_countnumber발신 건수
rowsarray처리결과 행 배열 (box=received|sent 포함)
rows[].document_namestring문서명
rows[].document_idstring문서 ID (받은문서 행에만 있는 칸)
rows[].notice_year_monthstring | null고지년월 (받은문서 행에만 있는 칸)
rows[].goji_roundstring | null고지차수 (받은문서 행에만 있는 칸)
rows[].wrt_chasustring작성차수
rows[].categorystring서식 분류 (보낸문서 행에만 있는 칸)
rows[].form_codestring서식코드 (보낸문서 행에만 있는 칸)
rows[].submitted_datestring제출 일자 (보낸문서 행에만 있는 칸)
rows[].submitted_timestring제출 시각 (보낸문서 행에만 있는 칸)
rows[].wrt_dup_seqstring작성중복순번 (보낸문서 행에만 있는 칸)
rows[].receipt_countnumber접수 건수 (보낸문서 행에만 있는 칸)
rows[].jumin_countnumber대상 인원 수 (보낸문서 행에만 있는 칸)
rows[].normal_counts.four_major_commonnumber정상 4대공통 (보낸문서 행에만 있는 칸)
rows[].normal_counts.healthnumber정상 건강 (보낸문서 행에만 있는 칸)
rows[].normal_counts.national_pensionnumber정상 국민연금 (보낸문서 행에만 있는 칸)
rows[].normal_counts.employmentnumber정상 고용 (보낸문서 행에만 있는 칸)
rows[].normal_counts.industrial_accidentnumber정상 산재 (보낸문서 행에만 있는 칸)
rows[].return_counts.four_major_commonnumber반송 4대공통 (보낸문서 행에만 있는 칸)
rows[].return_counts.healthnumber반송 건강 (보낸문서 행에만 있는 칸)
rows[].return_counts.national_pensionnumber반송 국민연금 (보낸문서 행에만 있는 칸)
rows[].return_counts.employmentnumber반송 고용 (보낸문서 행에만 있는 칸)
rows[].return_counts.industrial_accidentnumber반송 산재 (보낸문서 행에만 있는 칸)
rows[].ban_counts.organizationnumber반려 기관 (보낸문서 행에만 있는 칸)
rows[].ban_counts.healthnumber반려 건강 (보낸문서 행에만 있는 칸)
rows[].ban_counts.national_pensionnumber반려 국민연금 (보낸문서 행에만 있는 칸)
rows[].ban_counts.employmentnumber반려 고용 (보낸문서 행에만 있는 칸)
rows[].ban_counts.industrial_accidentnumber반려 산재 (보낸문서 행에만 있는 칸)
rows[].program_status_codestring처리 상태 (보낸문서 행에만 있는 칸)
rows[].attachment_file_presentboolean첨부파일 유무 (값: true = Y, false = N) (보낸문서 행에만 있는 칸)
source_evidenceobject출처 증적 객체
error_codenull오류 코드(문제가 없으면 null)
implementation_statusnull구현 상태(문제가 없으면 null)
json
// result.data
{
  "rows": [
    {
      "box": "received",
      "title": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:0",
      "row_text": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 0,
      "wrt_chasu": "2026052001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_033",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026052001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_033",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(산재) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(고용) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:1",
      "row_text": "사업장고지내역서(고용) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 1,
      "wrt_chasu": "2026052001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_032",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026052001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_032",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(고용) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(연금) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:2",
      "row_text": "사업장고지내역서(연금) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 2,
      "wrt_chasu": "2026052001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_031",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026052001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_031",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(연금) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:3",
      "row_text": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 3,
      "wrt_chasu": "2026052001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026052001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:4",
      "row_text": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 4,
      "wrt_chasu": "2026052001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026052001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:5",
      "row_text": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 5,
      "wrt_chasu": "2026051801",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026051801",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_key": "row:6",
      "row_text": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00 | 고지년월: 202605 | 고지차수: 1",
      "row_index": 6,
      "wrt_chasu": "2026051801",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026051801",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202605",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202605 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202605",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "직장가입자 보수총액 통보서 | 고지년월: 999912 | 고지차수: 1",
      "row_key": "row:7",
      "row_text": "직장가입자 보수총액 통보서 | 고지년월: 999912 | 고지차수: 1",
      "row_index": 7,
      "wrt_chasu": "2026050609",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMCB_070",
        "UNB_NO": "\u0003",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026050609",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "999912",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMCB_070",
      "insu_type_cd": null,
      "document_name": "직장가입자 보수총액 통보서",
      "received_date": null,
      "notice_year_month": "999912",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "건강검진 대상자 | 고지년월: 000000 | 고지차수: 0",
      "row_key": "row:8",
      "row_text": "건강검진 대상자 | 고지년월: 000000 | 고지차수: 0",
      "row_index": 8,
      "wrt_chasu": "20260504ZZ",
      "goji_round": "0",
      "detail_keys": {
        "DOC_ID": "GGAB_020",
        "UNB_NO": "\u0003",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "20260504ZZ",
        "GOJI_CHASU": "0",
        "GOJI_YYYYMM": "000000",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "GGAB_020",
      "insu_type_cd": null,
      "document_name": "건강검진 대상자",
      "received_date": null,
      "notice_year_month": "000000",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(산재) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:9",
      "row_text": "사업장고지내역서(산재) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 9,
      "wrt_chasu": "2026042101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_033",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026042101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_033",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(산재) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(고용) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:10",
      "row_text": "사업장고지내역서(고용) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 10,
      "wrt_chasu": "2026042101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_032",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026042101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_032",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(고용) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(연금) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:11",
      "row_text": "사업장고지내역서(연금) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 11,
      "wrt_chasu": "2026042101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_031",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026042101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_031",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(연금) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:12",
      "row_text": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 12,
      "wrt_chasu": "2026042101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026042101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:13",
      "row_text": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 13,
      "wrt_chasu": "2026042101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026042101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:14",
      "row_text": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 14,
      "wrt_chasu": "2026041601",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026041601",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_key": "row:15",
      "row_text": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00 | 고지년월: 202604 | 고지차수: 1",
      "row_index": 15,
      "wrt_chasu": "2026041601",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026041601",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202604",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202604 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202604",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "직장가입자 보험료 연말정산 산출내역서 | 고지년월: 999912 | 고지차수: 1",
      "row_key": "row:16",
      "row_text": "직장가입자 보험료 연말정산 산출내역서 | 고지년월: 999912 | 고지차수: 1",
      "row_index": 16,
      "wrt_chasu": "2026032609",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMCB_060",
        "UNB_NO": "\u0003",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026032609",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "999912",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMCB_060",
      "insu_type_cd": null,
      "document_name": "직장가입자 보험료 연말정산 산출내역서",
      "received_date": null,
      "notice_year_month": "999912",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(산재) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:17",
      "row_text": "사업장고지내역서(산재) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 17,
      "wrt_chasu": "2026032001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_033",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026032001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_033",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(산재) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(고용) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:18",
      "row_text": "사업장고지내역서(고용) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 18,
      "wrt_chasu": "2026032001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_032",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026032001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_032",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(고용) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(연금) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:19",
      "row_text": "사업장고지내역서(연금) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 19,
      "wrt_chasu": "2026032001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_031",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026032001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_031",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(연금) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:20",
      "row_text": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 20,
      "wrt_chasu": "2026032001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026032001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:21",
      "row_text": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 21,
      "wrt_chasu": "2026032001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026032001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "직장가입자 보수총액 통보서 | 고지년월: 999912 | 고지차수: 1",
      "row_key": "row:22",
      "row_text": "직장가입자 보수총액 통보서 | 고지년월: 999912 | 고지차수: 1",
      "row_index": 22,
      "wrt_chasu": "2026031710",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMCB_070",
        "UNB_NO": "\u0003",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026031710",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "999912",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMCB_070",
      "insu_type_cd": null,
      "document_name": "직장가입자 보수총액 통보서",
      "received_date": null,
      "notice_year_month": "999912",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:23",
      "row_text": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 23,
      "wrt_chasu": "2026031701",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026031701",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_key": "row:24",
      "row_text": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00 | 고지년월: 202603 | 고지차수: 1",
      "row_index": 24,
      "wrt_chasu": "2026031701",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026031701",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202603",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202603 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202603",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(산재) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:25",
      "row_text": "사업장고지내역서(산재) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 25,
      "wrt_chasu": "2026022001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_033",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026022001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_033",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(산재) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(고용) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:26",
      "row_text": "사업장고지내역서(고용) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 26,
      "wrt_chasu": "2026022001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_032",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026022001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_032",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(고용) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(연금) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:27",
      "row_text": "사업장고지내역서(연금) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 27,
      "wrt_chasu": "2026022001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_031",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026022001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_031",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(연금) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:28",
      "row_text": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 28,
      "wrt_chasu": "2026022001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026022001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:29",
      "row_text": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 29,
      "wrt_chasu": "2026022001",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026022001",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:30",
      "row_text": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 30,
      "wrt_chasu": "2026021901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026021901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_key": "row:31",
      "row_text": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00 | 고지년월: 202602 | 고지차수: 1",
      "row_index": 31,
      "wrt_chasu": "2026021901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "1",
        "WRT_CHASU": "2026021901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202602",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202602 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202602",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(산재) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:32",
      "row_text": "사업장고지내역서(산재) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 32,
      "wrt_chasu": "2026012101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_033",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026012101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_033",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(산재) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(고용) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:33",
      "row_text": "사업장고지내역서(고용) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 33,
      "wrt_chasu": "2026012101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_032",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026012101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_032",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(고용) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(연금) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:34",
      "row_text": "사업장고지내역서(연금) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 34,
      "wrt_chasu": "2026012101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_031",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026012101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_031",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(연금) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:35",
      "row_text": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 35,
      "wrt_chasu": "2026012101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026012101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:36",
      "row_text": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 36,
      "wrt_chasu": "2026012101",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026012101",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:37",
      "row_text": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 37,
      "wrt_chasu": "2026011601",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026011601",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_key": "row:38",
      "row_text": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00 | 고지년월: 202601 | 고지차수: 1",
      "row_index": 38,
      "wrt_chasu": "2026011601",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2026011601",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202601",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202601 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202601",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(산재) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:39",
      "row_text": "사업장고지내역서(산재) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 39,
      "wrt_chasu": "2025121901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_033",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_033",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(산재) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(고용) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:40",
      "row_text": "사업장고지내역서(고용) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 40,
      "wrt_chasu": "2025121901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_032",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_032",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(고용) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(연금) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:41",
      "row_text": "사업장고지내역서(연금) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 41,
      "wrt_chasu": "2025121901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_031",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678901",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_031",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(연금) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:42",
      "row_text": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 42,
      "wrt_chasu": "2025121901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:43",
      "row_text": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 43,
      "wrt_chasu": "2025121901",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121901",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:44",
      "row_text": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 44,
      "wrt_chasu": "2025121601",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_020",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121601",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_020",
      "insu_type_cd": null,
      "document_name": "가입자고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "received",
      "title": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_key": "row:45",
      "row_text": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00 | 고지년월: 202512 | 고지차수: 1",
      "row_index": 45,
      "wrt_chasu": "2025121601",
      "goji_round": "1",
      "detail_keys": {
        "DOC_ID": "BMBB_030",
        "UNB_NO": "12345678901",
        "FIRM_SYM": "12345678",
        "PROG_STAT": "0",
        "WRT_CHASU": "2025121601",
        "GOJI_CHASU": "1",
        "GOJI_YYYYMM": "202512",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000",
        "NATION_FINANCE_CD": "00"
      },
      "document_id": "BMBB_030",
      "insu_type_cd": null,
      "document_name": "사업장고지내역서(건강) 고지년월: 202512 고지차수: 1 회계코드: 00",
      "received_date": null,
      "notice_year_month": "202512",
      "primary_state_token": "[REDACTED]"
    },
    {
      "box": "sent",
      "raw": {
        "TBL": "TBBMCB03",
        "DOCID": "BMAB_020",
        "DOCNM": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
        "RMK_1": "",
        "RMK_2": "",
        "RMK_3": "",
        "YKIHO": "",
        "RET_CNT": "0",
        "TOT_CNT": "1",
        "CRE_DTTM": "2026-04-28",
        "FIRM_SYM": "12345678",
        "JUMINCNT": "1",
        "NORM_CNT": "0",
        "PROG_STAT": "2",
        "WRT_CHASU": "20260428ZZ",
        "BAN_NPC_CNT": "0",
        "BAN_ORG_CNT": "0",
        "BAN_WRK_CNT": "0",
        "CRE_DTTM_MI": "09:14:28",
        "NPC_RET_CNT": "0",
        "WRK_RET_CNT": "0",
        "WRT_DUP_SEQ": "02",
        "ATMT_FILE_YN": "",
        "BAN_KLWC_CNT": "0",
        "BAN_NHIC_CNT": "0",
        "KLWC_RET_CNT": "0",
        "NHIC_RET_CNT": "0",
        "NPC_NORM_CNT": "0",
        "WRK_NORM_CNT": "0",
        "KLWC_NORM_CNT": "0",
        "NHIC_NORM_CNT": "1",
        "UNIT_FIRM_SYM": "000"
      },
      "ykiho": "",
      "row_key": "sent:20260428ZZ:02:BMAB_020",
      "category": "4대서식",
      "firm_sym": "12345678",
      "row_text": "4대서식 1 4대보험 기준소득월액/보수월액/월평균보수 변경신청서 2026-04-28 02 09:14:28 접수 1 정상 4대공통 0 건강 1 국민연금 0 고용 0 산재 0 반송 4대공통 0 건강 0 국민연금 0 고용 0 산재 0",
      "form_code": "BMAB_020",
      "form_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "row_index": 0,
      "wrt_chasu": "20260428ZZ",
      "ban_counts": {
        "health": 0,
        "employment": 0,
        "organization": 0,
        "national_pension": 0,
        "industrial_accident": 0
      },
      "table_name": "TBBMCB03",
      "detail_keys": {
        "TBL": "TBBMCB03",
        "DOCID": "BMAB_020",
        "YKIHO": "",
        "FIRM_SYM": "12345678",
        "EFIRM_SYM": "",
        "WRT_CHASU": "20260428ZZ",
        "WRT_DUP_SEQ": "02",
        "UNIT_FIRM_SYM": "000"
      },
      "document_id": "BMAB_020",
      "jumin_count": 1,
      "sequence_no": "02",
      "wrt_dup_seq": "02",
      "submitted_at": "2026-04-28 09:14:28",
      "category_code": "1",
      "document_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "normal_counts": {
        "health": 1,
        "employment": 0,
        "national_pension": 0,
        "four_major_common": 0,
        "industrial_accident": 0
      },
      "receipt_count": 1,
      "return_counts": {
        "health": 0,
        "employment": 0,
        "national_pension": 0,
        "four_major_common": 0,
        "industrial_accident": 0
      },
      "unit_firm_sym": "000",
      "detail_request": {
        "row_key": "sent:20260428ZZ:02:BMAB_020",
        "firm_sym": "12345678",
        "form_code": "BMAB_020",
        "row_index": 0,
        "wrt_chasu": "20260428ZZ",
        "wrt_dup_seq": "02",
        "unit_firm_sym": "000"
      },
      "submitted_date": "2026-04-28",
      "submitted_time": "09:14:28",
      "program_status_code": "2",
      "attachment_file_present": false
    },
    {
      "box": "sent",
      "raw": {
        "TBL": "TBBMCB03",
        "DOCID": "BMAB_020",
        "DOCNM": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
        "RMK_1": "",
        "RMK_2": "",
        "RMK_3": "",
        "YKIHO": "",
        "RET_CNT": "0",
        "TOT_CNT": "1",
        "CRE_DTTM": "2026-04-28",
        "FIRM_SYM": "12345678",
        "JUMINCNT": "1",
        "NORM_CNT": "0",
        "PROG_STAT": "2",
        "WRT_CHASU": "20260428ZZ",
        "BAN_NPC_CNT": "0",
        "BAN_ORG_CNT": "0",
        "BAN_WRK_CNT": "0",
        "CRE_DTTM_MI": "09:04:39",
        "NPC_RET_CNT": "0",
        "WRK_RET_CNT": "0",
        "WRT_DUP_SEQ": "01",
        "ATMT_FILE_YN": "",
        "BAN_KLWC_CNT": "0",
        "BAN_NHIC_CNT": "0",
        "KLWC_RET_CNT": "0",
        "NHIC_RET_CNT": "0",
        "NPC_NORM_CNT": "0",
        "WRK_NORM_CNT": "0",
        "KLWC_NORM_CNT": "0",
        "NHIC_NORM_CNT": "1",
        "UNIT_FIRM_SYM": "000"
      },
      "ykiho": "",
      "row_key": "sent:20260428ZZ:01:BMAB_020",
      "category": "4대서식",
      "firm_sym": "12345678",
      "row_text": "4대서식 2 4대보험 기준소득월액/보수월액/월평균보수 변경신청서 2026-04-28 01 09:04:39 접수 1 정상 4대공통 0 건강 1 국민연금 0 고용 0 산재 0 반송 4대공통 0 건강 0 국민연금 0 고용 0 산재 0",
      "form_code": "BMAB_020",
      "form_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "row_index": 1,
      "wrt_chasu": "20260428ZZ",
      "ban_counts": {
        "health": 0,
        "employment": 0,
        "organization": 0,
        "national_pension": 0,
        "industrial_accident": 0
      },
      "table_name": "TBBMCB03",
      "detail_keys": {
        "TBL": "TBBMCB03",
        "DOCID": "BMAB_020",
        "YKIHO": "",
        "FIRM_SYM": "12345678",
        "EFIRM_SYM": "",
        "WRT_CHASU": "20260428ZZ",
        "WRT_DUP_SEQ": "01",
        "UNIT_FIRM_SYM": "000"
      },
      "document_id": "BMAB_020",
      "jumin_count": 1,
      "sequence_no": "01",
      "wrt_dup_seq": "01",
      "submitted_at": "2026-04-28 09:04:39",
      "category_code": "1",
      "document_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "normal_counts": {
        "health": 1,
        "employment": 0,
        "national_pension": 0,
        "four_major_common": 0,
        "industrial_accident": 0
      },
      "receipt_count": 1,
      "return_counts": {
        "health": 0,
        "employment": 0,
        "national_pension": 0,
        "four_major_common": 0,
        "industrial_accident": 0
      },
      "unit_firm_sym": "000",
      "detail_request": {
        "row_key": "sent:20260428ZZ:01:BMAB_020",
        "firm_sym": "12345678",
        "form_code": "BMAB_020",
        "row_index": 1,
        "wrt_chasu": "20260428ZZ",
        "wrt_dup_seq": "01",
        "unit_firm_sym": "000"
      },
      "submitted_date": "2026-04-28",
      "submitted_time": "09:04:39",
      "program_status_code": "2",
      "attachment_file_present": false
    }
  ],
  "phase": "list",
  "success": true,
  "row_count": 48,
  "screen_id": "...",
  "error_code": null,
  "route_kind": "live",
  "sent_count": 2,
  "feature_name": "...",
  "workflow_step": "processing_results_loaded",
  "received_count": 46,
  "source_evidence": {
    "sent_documents": {
      "mode": "...",
      "sql_ids": [
        "...",
        "...",
        "..."
      ],
      "data_source": "..."
    },
    "received_documents": {
      "mode": "...",
      "data_source": "..."
    }
  },
  "implementation_status": null
}

12. 보수월액 수신문서 일괄 상세 조회nhis_edi.hr_payroll.received_documents.batch_details

MCP 도구 이름 nhis_edi__hr_payroll__received_documents__batch_details

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

보수월액 수신문서 목록 조회가 돌려준 행 번호를 넣으면 행마다 상세를 열어 결과 목록으로 받습니다.

  • 로그인을 먼저 호출합니다. 조회 옵션으로 행 번호를 확인한 뒤 row_index 를 지정합니다. [국민건강보험공단 EDI 로그인]
  • 실패한 행은 results[] 항목의 success 가 false 이고 실패 사유는 detail_source_attempts[].reason 에 옵니다(예: DETAIL_STRATEGY_UNRESOLVED).
  • row_indexes 배열 필수. notice_year_month·from_date/to_date는 options와 동일 규칙.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.received_documents.batch_details이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.received_documents.batch_details

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexesarray-Y상세 조회할 행 번호 배열
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

form_namestring-N서식명. 받은문서 목록과 동일한 서식명 필터
document_statusstring-N문서상태. 전체/all, 신규/new, 열람/viewed 중 하나
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: batch_details-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.received_documents.batch_details",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "row_indexes": "<필수: array>"
  }
}'

Response

  • results[]에 요청한 행마다 결과가 하나씩 옵니다.
순번변수명타입설명
resultsarray행별 결과 배열(성공한 행은 datasets 등 상세, 실패한 행은 success=false 와 detail_source_attempts)
requested_countnumber요청한 행 수
succeeded_countnumber성공한 행 수
failed_countnumber실패한 행 수
json
// result.data
{
  "results": [],
  "requested_count": 1
}

13. 보수월액 수신문서 상세 조회nhis_edi.hr_payroll.received_documents.detail

MCP 도구 이름 nhis_edi__hr_payroll__received_documents__detail

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

수신문서 목록에서 고른 행 한 건을 열어 문서 제목과 기관의 문서 코드, 표 이름별 열과 행을 받습니다.

  • 로그인을 먼저 호출합니다. 조회 옵션으로 행을 확인한 뒤 row_index 또는 row_key 로 지정하면 정확합니다. [국민건강보험공단 EDI 로그인]
  • row_index·row_key 또는 row_text_contains·notice_year_month 등 필터로 1건 지정.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.received_documents.detail이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.received_documents.detail

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-조건부작업 파라미터입니다. 아래 params 파라미터 표의 row_index, row_key, row_text_contains, cell_text_contains, notice_year_month, goji_round, form_name 또는 document_status 중 하나 이상을 보냅니다. 앞 단계에서 고른 항목이 같은 연동 계정의 세션에 남아 있으면 빈 객체로 보내 그 항목을 씁니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-조건부이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-조건부선택할 행의 텍스트 포함값
cell_text_containsstring-조건부선택할 행 셀 텍스트 포함값
row_keystring-조건부이전 목록/검색 결과 row 식별키
notice_year_monthstring6조건부고지연월

형식 : YYYYMM

goji_roundstring-조건부고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

form_namestring-조건부서식명. 받은문서 목록과 동일한 서식명 필터
document_statusstring-조건부문서상태. 전체/all, 신규/new, 열람/viewed 중 하나
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.received_documents.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "row_index": "<필수: number>"
  }
}'

Response

  • datasets·visible_fields·detail_source를 확인합니다.
순번변수명타입설명
datasetsobject문서 데이터셋 객체 (키=데이터셋명)
visible_fieldsarray화면 표시 필드 배열
detail_sourcestring | null상세 조회 소스 정보 객체
row_indexnumber행 번호
document_idstring | null기관 화면 문서 id
document_titlestring | null문서 제목
primary_rowobject대표 행
typedobject형식을 맞춰 정리한 상세 값
detail_source_attemptsarray상세 조회 전략별 시도 결과
network_evidencearray기관 화면이 호출한 SQL·프로그램 내역(요청 본문은 길이만)
visible_textstring화면에 표시된 값을 합친 텍스트
json
// result.data
{
  "datasets": {},
  "visible_fields": [],
  "detail_source": "...",
  "row_index": 0,
  "document_id": "...",
  "document_title": "...",
  "primary_row": {},
  "typed": {},
  "detail_source_attempts": [],
  "network_evidence": [],
  "visible_text": "..."
}
순번오류 코드발생 조건
PROVIDER_UPSTREAM_ERROR상세 미해결 — 행은 찾았지만 그 행의 내용을 끝까지 불러오지 못했습니다. error.message 에 그 안내가 오고 잠시 뒤 다시 시도합니다.
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.
RESOURCE_NOT_FOUND기간에 자료 없음 — 행 키로 지정했거나 고지 월 같은 필터 없이 행 번호로 지정했는데 조회 기간에 자료가 하나도 없을 때입니다. error.message 는 조회 기간에 해당하는 문서가 없다는 안내이고 from_date 와 to_date 를 넓히라고 합니다. 같은 기간으로 다시 요청해도 같은 결과이니 기간을 넓혀 목록 조회부터 다시 합니다.

14. 보수월액 수신문서 목록 조회nhis_edi.hr_payroll.received_documents.options

MCP 도구 이름 nhis_edi__hr_payroll__received_documents__options

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

기간이나 고지 연월을 넣으면 수신문서 목록의 행마다 행 번호, 문서 이름, 고지 연월과 차수, 작성 차수를 받습니다.

  • 로그인을 먼저 호출한 뒤 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • row_count=0 — 별도 error_code 없음.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.received_documents.options이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.received_documents.options

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_text_containsstring-N선택할 문서/고지 행 텍스트 포함값. 받은문서 화면 row_text 후처리 필터
cell_text_containsstring-N선택할 문서 행의 셀 텍스트 포함값. 받은문서 화면 후처리 필터
notice_year_monthstring6N고지연월. 받은문서 row를 고지연월 기준으로 좁힐 때 사용

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

form_namestring-N서식명. 받은문서 목록에서 특정 서식명만 후처리 필터
document_statusstring-N문서상태. 전체/all, 신규/new, 열람/viewed 중 하나
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: options-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.received_documents.options",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • list_rows·row_count·response_dataset_names를 확인합니다.
순번변수명타입설명
list_rowsarray수신문서 행 배열
row_countnumber목록 건수
response_dataset_namesarray반환된 데이터셋 이름 배열
json
// result.data
{
  "list_rows": [
    {
      "row_index": 0,
      "row_key": "...",
      "row_text": "...",
      "received_date": "2026-06-01"
    }
  ],
  "row_count": 1,
  "response_dataset_names": [
    "..."
  ]
}
순번오류 코드발생 조건
VALIDATION_INVALID_FIELD날짜 오류 — from_date · to_date 가 YYYYMMDD(또는 YYYY-MM-DD) 형식이 아니거나, from_date 가 to_date 보다 늦거나, 시작일이 종료일의 6개월 전보다 이릅니다.

15. 보수총액 통보서 상세 조회nhis_edi.hr_payroll.salary_total_notice.detail

MCP 도구 이름 nhis_edi__hr_payroll__salary_total_notice__detail

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

보수총액 통보서 화면의 상세 데이터와 요약 정보를 조회합니다.

  • 로그인을 먼저 호출합니다. 수신 문서 조회 옵션을 먼저 확인하면 조건을 정확히 지정할 수 있습니다. [국민건강보험공단 EDI 로그인]
  • success=false. result.data.error_code=BMCB_070_ROW_NOT_FOUND.
  • success=false. result.data.error_code=BMCB_070_DATASET_EMPTY (business_datasets 비어 있음).
  • selector 생략 시 row_text_contains 기본 보수총액.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.salary_total_notice.detail이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.salary_total_notice.detail

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-N이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-N선택할 행의 텍스트 포함값
cell_text_containsstring-N선택할 행 셀 텍스트 포함값
row_keystring-N이전 목록/검색 결과 row 식별키
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.salary_total_notice.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • rows·business_datasets 확인.
  • 여러 JSON 타입이 함께 표시된 칸은 서버가 세부 타입을 고정하지 않는 기관 원문 또는 동적 값입니다.
순번변수명타입설명
successboolean상세를 읽어 업무 dataset 을 받았는지 여부(찾는 항목이 없거나 응답에 업무 dataset 이 하나도 없으면 false)
feature_namestring기능 식별자
phasestring단계(이 액션은 detail)
workflow_stepstring워크플로 단계
screen_idstring화면 식별자
route_kindstring라우트 종류
row_countnumber결과 행 수
rowsarray업무 dataset 의 결과 행 목록
business_datasetsobject시스템 dataset을 제외한 업무 dataset
summaryobject찾았는지와 dataset 별 행 수 요약 객체(matched, document_id, business_dataset_count, business_row_count, dataset_row_counts)
source_evidenceobject출처 증적 객체
error_codestring | number | boolean | object | array | null오류 코드(문제가 없으면 null, 항목을 못 찾으면 문서 번호가 앞에 붙은 ROW_NOT_FOUND 코드, 업무 dataset 이 없으면 문서 번호가 앞에 붙은 DATASET_EMPTY 코드)
implementation_statusstring | number | boolean | object | array | null구현 상태(문제가 없으면 null, 항목을 못 찾으면 lookup_row_not_found, 업무 dataset 이 없으면 lookup_dataset_empty)
json
// result.data
{
  "success": true,
  "feature_name": "...",
  "phase": "detail",
  "workflow_step": "salary_total_notice_statement_loaded",
  "screen_id": "...",
  "route_kind": "live",
  "row_count": 0,
  "rows": [],
  "business_datasets": {
    "...": {
      "rows": []
    }
  },
  "summary": {
    "matched": true,
    "document_id": "BMCB_070",
    "business_dataset_count": 1,
    "business_row_count": 0,
    "dataset_row_counts": {
      "...": 0
    }
  },
  "source_evidence": {
    "screenshot": "...",
    "xfdl": "...",
    "sql_id": "...",
    "page_link_id": "...",
    "selected_row": {},
    "detail_source": "...",
    "detail_source_attempts": [],
    "response_dataset_names": [
      "..."
    ],
    "dataset_row_counts": {
      "...": 0
    },
    "source_summary": {}
  },
  "error_code": null,
  "implementation_status": null
}
순번오류 코드발생 조건
PROVIDER_UPSTREAM_ERROR읽기 미완료 — 행은 찾았지만 그 행의 내용을 끝까지 불러오지 못했습니다. 잠시 뒤 다시 시도합니다.
PROVIDER_VALIDATION_ERROR양식 불일치 — 고른 행이 이 조회의 서식이 아닙니다.

16. 연말정산 산출내역서 조회nhis_edi.hr_payroll.year_end_settlement.detail

MCP 도구 이름 nhis_edi__hr_payroll__year_end_settlement__detail

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

수신문서 목록에서 직장가입자 보험료 연말정산 산출내역서 행을 찾아 열면 가입자별 행과 열을 받습니다.

  • 로그인을 먼저 호출합니다. 수신 문서 조회 옵션에서 해당 서식(BMCB_060) 행을 먼저 확인하면 정확합니다. [국민건강보험공단 EDI 로그인]
  • success=false. result.data.error_code=YEAR_END_SETTLEMENT_ROW_NOT_FOUND — 연말정산 서식(BMCB_060) 행을 찾지 못했을 때이고, 작업은 실패로 끝나지 않고 성공으로 끝납니다.
  • 행을 지정하지 않으면 이 로그인 세션에서 앞서 고른 연말정산 행을 열고, 없으면 목록의 첫 연말정산 산출내역서를 엽니다. 날짜와 필터는 received_documents 와 같습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • nhis_edi이 API 고정값 (기본값)

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.hr_payroll.year_end_settlement.detail이 API 고정값 (기본값)

예시 : nhis_edi.hr_payroll.year_end_settlement.detail

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
row_indexnumber-N이전 목록/검색 결과에서 선택할 행 번호
row_text_containsstring-N선택할 행의 텍스트 포함값
cell_text_containsstring-N선택할 행 셀 텍스트 포함값
row_keystring-N이전 목록/검색 결과 row 식별키
notice_year_monthstring6N고지연월

형식 : YYYYMM

goji_roundstring-N고지차수 GOJI_CHASU
from_datestring8N조회기간 시작일. 미입력 시 오늘 기준 3개월 전. 시작일은 종료일의 6개월 전까지

형식 : YYYYMMDD

to_datestring8N조회기간 종료일. 미입력 시 오늘. 조회 기간은 최대 6개월(시작일은 종료일의 6개월 전까지)

형식 : YYYYMMDD

form_namestring-N서식명. 기본값은 직장가입자 보험료 연말정산 산출내역서
document_statusstring-N받은문서 상태 필터. 전체/all, 신규/new, 열람/viewed
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: detail-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "nhis_edi",
  "action": "nhis_edi.hr_payroll.year_end_settlement.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • rows·business_datasets·summary 확인.
순번변수명타입설명
rowsarray연말정산 행 데이터 배열
business_datasetsobject데이터셋 객체 (키=데이터셋명)
summaryobject산출내역 요약 객체
selected_optionobject선택한 행 정보
filtersobject이번 조회에 쓰인 필터
json
// result.data
{
  "rows": [],
  "business_datasets": {},
  "summary": {},
  "selected_option": {},
  "filters": {}
}
순번오류 코드발생 조건
PROVIDER_UPSTREAM_ERROR읽기 미완료 — 행은 찾았지만 그 행의 내용을 끝까지 불러오지 못했습니다. 잠시 뒤 다시 시도합니다.