개발자 문서
API 레퍼런스

문서함 - 국민건강보험공단 EDI

1. 문서함 보낸문서 상세 조회nhis_edi.document_box.sent_documents.detail

MCP 도구 이름 nhis_edi__document_box__sent_documents__detail

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

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

보낸문서 목록의 행 번호나 행 키로 고른 4대보험 기준소득월액, 보수월액, 월평균보수 변경신청서 한 건의 대상자와 보험별 신고 내용을 받습니다.

  • 보낸 문서 목록을 먼저 조회하고 호출합니다. 생략하면 내부에서 자동으로 목록을 가져옵니다. [국민건강보험공단 EDI 로그인]
  • list 후 selector 생략 시 첫 list_rows 행을 자동 선택합니다.

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.document_box.sent_documents.detail이 API 고정값 (기본값)

예시 : nhis_edi.document_box.sent_documents.detail

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보낸문서 목록 조회기간 시작일. 미입력 시 화면 기본 범위

형식 : YYYYMMDD

to_datestring8N보낸문서 목록 조회기간 종료일. 미입력 시 화면 기본 범위

형식 : YYYYMMDD

form_namestring-N상단 서식명 선택값. 예: 전체 또는 4대보험 기준소득월액/보수월액/월평균보수 변경신청서
gubunstring-N상단 구분 선택값. 미입력 시 전체
ykihostring-N상단 요양기관기호/대상기관 필터
jumin_nostring-N주민등록번호 13자리로 목록을 다시 조회할 때 좁힙니다. 이 값은 params 에 입력하지 않고 encrypted_fields.jumin_no 에 공개키로 암호화해 입력합니다. params 에 입력하면 작업을 만들지 않고 400 VALIDATION_INVALID_FIELD 로 거절합니다
row_indexnumber-N보낸문서 목록에서 선택할 행 번호
row_keystring-N보낸문서 목록 row 식별키
wrt_chasustring-N작성 차수 WRT_CHASU
wrt_dup_seqstring-N작성 중복순번 WRT_DUP_SEQ
form_codestring-N양식 DOCID. 현재 상세 지원은 BMAB_020만
firm_symstring-N사업장기호 FIRM_SYM
unit_firm_symstring-N단위사업장기호
efirm_symstring-N요양기관기호 EFIRM_SYM
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.document_box.sent_documents.detail",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • detail·datasets·visible_fields·screen를 확인합니다.
  • 기관이 상세를 비워 보내면 선택한 행과 로그인 정보로 상세를 만들어 성공으로 돌려줍니다. 이때 synthesized 가 true 이고 synthesized_reason 에 까닭이 담깁니다.
순번변수명타입설명
detailobject문서 상세 메타 객체
datasetsobject데이터셋 배열
visible_fieldsarray화면 표시 필드 배열
screenobject화면 정보 객체
row_indexnumber행 번호
row_keystring행 키
form_codestring서식 코드
document_idstring기관 화면 문서 id
document_namestring문서 이름
selected_rowobject선택한 행 원본
detail_requestobject상세 조회 요청 값
typedobject형식을 맞춰 정리한 상세 값
form_contractobject화면 입력 계약 (항목 정의). 화면 버튼 이름 visible_buttons 와 안내 문구 notice_texts 가 이 안쪽에 있습니다
screen_sectionsarray화면 구역 구성
business_infoobject사업장 정보 항목
form_headerobject화면 머리 정보
insurance_sectionsobject보험별 구역 구성
target_tableobject대상 표 이름
excel_readyobject엑셀 내려받기 준비 여부
fieldsarray입력 필드 정의 배열
grid_columnsarray표 열 목록
rowsarray조회 행
bootstrap_datasetsobject화면 초기 로딩 데이터셋
processing_datasetsobject처리 데이터셋
processing_detail_rowsarray처리 상세 행
processing_resultobject처리 결과
support_datasetsobject보조 데이터셋
support_detail_rowsarray보조 상세 행
response_dataset_row_countsobject데이터셋별 행 수
detail_sourcestring상세 데이터를 가져온 전략 이름
synthesizedboolean기관이 상세를 비워 보내 선택한 행과 로그인 정보로 만든 합성본이면 true 이고 기관이 준 상세이면 false 입니다. 합성본은 기관이 준 기록이 아니니 증빙으로 보관할 때는 이 값을 먼저 확인합니다
synthesized_reasonstring | null합성본일 때 합성한 까닭을 알리는 코드 문자열입니다. 기관이 준 상세이면 null 입니다
detail_source_attemptsarray상세 조회 전략별 시도 결과
transport_evidenceobject기관 통신 근거(요청·응답 URL, 크기, 상태 코드)
visible_textstring화면에 표시된 값을 합친 텍스트
json
// result.data
{
  "rows": [
    {
      "name": "홍길동",
      "sequence": 1,
      "health_report": "Y",
      "worker_agreement": "",
      "employment_report": "Y",
      "job_stability_request": "N",
      "national_pension_report": "N",
      "health_insurance_card_no": "00000000000",
      "health_salary_change_month": "2026/07",
      "industrial_accident_report": "Y",
      "employment_salary_change_month": "2026/07",
      "industrial_salary_change_month": "2026/07",
      "employment_changed_average_wage": "2216667",
      "industrial_changed_average_wage": "2216667",
      "health_changed_salary_monthly_amount": "2216667",
      "pension_changed_standard_monthly_income": "",
      "pension_current_standard_monthly_income": ""
    }
  ],
  "phase": "detail",
  "typed": {
    "member": {
      "name": "홍길동",
      "jung_no": "12345678901",
      "jumin_no_masked": "000000-*******"
    },
    "contact": {
      "workplace_fax": "",
      "workplace_tel": "010-1234-5678",
      "charge_person_mobile": ""
    },
    "document": {
      "user_id": "user01",
      "wrt_chasu": "20260730ZZ",
      "wrt_dup_seq": "01",
      "reported_date": "20260730"
    },
    "workplace": {
      "name": "예시 주식회사",
      "firm_sym": "12345678",
      "unit_firm_sym": "000",
      "npc_bslc_mgmt_no": "12345678901",
      "hrdk_bslc_mgmt_no": "12345678901",
      "klwc_bslc_mgmt_no": "12345678901",
      "nhic_bslc_mgmt_no": "12345678901"
    },
    "change_months": {
      "health": "123456",
      "employment": "123456",
      "industrial_accident": "123456"
    },
    "monthly_amounts": {
      "health": "1234567",
      "employment": "1234567",
      "national_pension": "",
      "industrial_accident": "1234567",
      "previous_national_pension": ""
    },
    "insurance_acceptance": {
      "health": "Y",
      "employment": "Y",
      "national_pension": "N",
      "industrial_accident": "Y"
    }
  },
  "detail": {
    "NM": "홍길동",
    "DOCID": "BMAB_020",
    "RPT_DT": "20260730",
    "JUNG_NO": "12345678901",
    "REPR_NM": "홍길동",
    "USER_ID": "user01",
    "FIRM_SYM": "12345678",
    "BSBR_NAME": "예시 주식회사",
    "WRT_CHASU": "20260730ZZ",
    "BSLC_FAXNO1": "",
    "BSLC_FAXNO2": "",
    "BSLC_FAXNO3": "",
    "BSLC_TELNO1": "123",
    "BSLC_TELNO2": "1234",
    "BSLC_TELNO3": "1234",
    "MBR_AGRE_YN": "",
    "WRT_DUP_SEQ": "01",
    "CHNG_CD_KLWC": "1",
    "CHNG_CD_INSPS": "1",
    "UNIT_FIRM_SYM": "000",
    "FEE_MM_AMT_NPC": "",
    "HRDK_ASCT_NAME": "",
    "HRDK_ASCT_SYMB": "",
    "UNIT_BSLC_SYMB": "000",
    "CHRG_PRSN_HPNO1": "",
    "CHRG_PRSN_HPNO2": "",
    "CHRG_PRSN_HPNO3": "",
    "FEE_MM_AMT_KLWC": "2216667",
    "FEE_MM_AMT_NHIC": "2216667",
    "INSU_ACPT_YN_GG": "Y",
    "INSU_ACPT_YN_GY": "Y",
    "INSU_ACPT_YN_SJ": "Y",
    "INSU_ACPT_YN_YG": "N",
    "FEE_MM_AMT_INSPS": "2216667",
    "JOB_STBL_RQST_YN": "N",
    "NPC_BSLC_MGMT_NO": "12345678901",
    "NPC_CTRL_BROF_CD": "1124",
    "BF_FEE_MM_AMT_NPC": "",
    "HRDK_BSLC_MGMT_NO": "12345678901",
    "HRDK_CTRL_BROF_CD": "2040",
    "KLWC_BSLC_MGMT_NO": "12345678901",
    "KLWC_CTRL_BROF_CD": "2040",
    "NHIC_BSLC_MGMT_NO": "12345678901",
    "NHIC_CTRL_BROF_CD": "0131",
    "FEE_CHG_YYYYMM_KLWC": "202607",
    "FEE_CHG_YYYYMM_NHIC": "202607",
    "FEE_CHG_YYYYMM_INSPS": "202607",
    "_processing_result_source": "WETC_101S19",
    "_processing_result_dataset": "...",
    "_processing_result_message": "보수변경이 정상처리되었습니다"
  },
  "fields": [
    {
      "label": "문서명",
      "value": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "section": "문서"
    },
    {
      "label": "화면ID",
      "value": "...",
      "section": "문서"
    },
    {
      "label": "사업장관리번호/사업장명 건강보험",
      "value": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "건강보험"
      },
      "section": "사업장관리번호(사업장명)"
    },
    {
      "label": "사업장관리번호/사업장명 국민연금",
      "value": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "국민연금"
      },
      "section": "사업장관리번호(사업장명)"
    },
    {
      "label": "사업장관리번호/사업장명 고용보험",
      "value": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "고용보험"
      },
      "section": "사업장관리번호(사업장명)"
    },
    {
      "label": "사업장관리번호/사업장명 산재보험",
      "value": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "산재보험"
      },
      "section": "사업장관리번호(사업장명)"
    },
    {
      "label": "보험사무 대행기관",
      "value": {
        "name": "",
        "number": ""
      },
      "section": "보험사무 대행기관"
    },
    {
      "label": "단위기관(영업소)",
      "value": {
        "code": "000",
        "name": "예시 주식회사"
      },
      "section": "단위기관(영업소)"
    },
    {
      "label": "작성일",
      "value": {
        "raw": "20260914",
        "display": "2026-09-14"
      },
      "section": "작성정보"
    },
    {
      "label": "일련번호",
      "value": "",
      "section": "작성정보"
    },
    {
      "label": "신청구분",
      "value": {
        "all": "N",
        "health": "N",
        "source": "BMAB_020 화면의 체크박스 기본값",
        "employment": "N",
        "national_pension": "N",
        "industrial_accident": "N"
      },
      "section": "작성정보"
    },
    {
      "label": "대상자 조회입력",
      "value": {
        "name": "",
        "health_insurance_card_no": "",
        "health_card_change_checked": "N"
      },
      "section": "대상자 입력"
    },
    {
      "label": "국민연금 입력구역",
      "value": {
        "checked": "0",
        "worker_agreement": "",
        "changed_standard_monthly_income": "",
        "current_standard_monthly_income": ""
      },
      "section": "국민연금"
    },
    {
      "label": "건강보험 입력구역",
      "value": {
        "checked": "0",
        "salary_change_month": "",
        "changed_health_premium": "",
        "changed_salary_monthly_amount": "",
        "changed_long_term_care_premium": ""
      },
      "section": "건강보험"
    },
    {
      "label": "고용보험 입력구역",
      "value": {
        "checked": "0",
        "change_reason": "",
        "salary_change_month": "",
        "changed_monthly_average_wage": ""
      },
      "section": "고용보험"
    },
    {
      "label": "산재보험 입력구역",
      "value": {
        "checked": "0",
        "change_reason": "",
        "salary_change_month": "",
        "changed_monthly_average_wage": ""
      },
      "section": "산재보험"
    },
    {
      "label": "대상자 목록",
      "value": [
        {
          "name": "홍길동",
          "sequence": 1,
          "health_report": "Y",
          "worker_agreement": "",
          "employment_report": "Y",
          "job_stability_request": "N",
          "national_pension_report": "N",
          "health_insurance_card_no": "00000000000",
          "health_salary_change_month": "2026/07",
          "industrial_accident_report": "Y",
          "employment_salary_change_month": "2026/07",
          "industrial_salary_change_month": "2026/07",
          "employment_changed_average_wage": "2216667",
          "industrial_changed_average_wage": "2216667",
          "health_changed_salary_monthly_amount": "2216667",
          "pension_changed_standard_monthly_income": "",
          "pension_current_standard_monthly_income": ""
        }
      ],
      "section": "대상자 목록"
    }
  ],
  "screen": {
    "grid": {
      "name": "Grid_0",
      "rows": [
        {
          "name": "홍길동",
          "sequence": 1,
          "health_report": "Y",
          "worker_agreement": "",
          "employment_report": "Y",
          "job_stability_request": "N",
          "national_pension_report": "N",
          "health_insurance_card_no": "00000000000",
          "health_salary_change_month": "2026/07",
          "industrial_accident_report": "Y",
          "employment_salary_change_month": "2026/07",
          "industrial_salary_change_month": "2026/07",
          "employment_changed_average_wage": "2216667",
          "industrial_changed_average_wage": "2216667",
          "health_changed_salary_monthly_amount": "2216667",
          "pension_changed_standard_monthly_income": "",
          "pension_current_standard_monthly_income": ""
        }
      ],
      "columns": [
        {
          "key": "sequence",
          "label": "순번"
        },
        {
          "key": "national_pension_report",
          "label": "국민연금 Y:신고 N:미신고"
        },
        {
          "key": "health_report",
          "label": "건강보험 Y:신고 N:미신고"
        },
        {
          "key": "employment_report",
          "label": "고용보험 Y:신고 N:미신고"
        },
        {
          "key": "industrial_accident_report",
          "label": "산재보험 Y:신고 N:미신고"
        },
        {
          "key": "name",
          "label": "성명"
        },
        {
          "key": "resident_no",
          "label": "주민등록번호"
        },
        {
          "key": "health_insurance_card_no",
          "label": "건강보험증번호"
        },
        {
          "key": "pension_current_standard_monthly_income",
          "label": "[연금]현재 기준소득월액"
        },
        {
          "key": "pension_changed_standard_monthly_income",
          "label": "[연금]변경 후 기준소득월액"
        },
        {
          "key": "health_salary_change_month",
          "label": "[건강]보수월액 변경월"
        },
        {
          "key": "health_changed_salary_monthly_amount",
          "label": "[건강]변경후보수월액"
        },
        {
          "key": "employment_salary_change_month",
          "label": "[고용]보수월액 변경월"
        },
        {
          "key": "employment_changed_average_wage",
          "label": "[고용]변경후월평균보수"
        },
        {
          "key": "industrial_salary_change_month",
          "label": "[산재]보수월액 변경월"
        },
        {
          "key": "industrial_changed_average_wage",
          "label": "[산재]변경후월평균보수"
        },
        {
          "key": "worker_agreement",
          "label": "근로자 동의"
        },
        {
          "key": "job_stability_request",
          "label": "직장 안정 여부"
        }
      ],
      "raw_rows": [
        {
          "NM": "홍길동",
          "DOCID": "BMAB_020",
          "RPT_DT": "20260730",
          "JUNG_NO": "12345678901",
          "REPR_NM": "홍길동",
          "USER_ID": "user01",
          "FIRM_SYM": "12345678",
          "BSBR_NAME": "예시 주식회사",
          "WRT_CHASU": "20260730ZZ",
          "BSLC_FAXNO1": "",
          "BSLC_FAXNO2": "",
          "BSLC_FAXNO3": "",
          "BSLC_TELNO1": "123",
          "BSLC_TELNO2": "1234",
          "BSLC_TELNO3": "1234",
          "MBR_AGRE_YN": "",
          "WRT_DUP_SEQ": "01",
          "CHNG_CD_KLWC": "1",
          "CHNG_CD_INSPS": "1",
          "UNIT_FIRM_SYM": "000",
          "FEE_MM_AMT_NPC": "",
          "HRDK_ASCT_NAME": "",
          "HRDK_ASCT_SYMB": "",
          "UNIT_BSLC_SYMB": "000",
          "CHRG_PRSN_HPNO1": "",
          "CHRG_PRSN_HPNO2": "",
          "CHRG_PRSN_HPNO3": "",
          "FEE_MM_AMT_KLWC": "2216667",
          "FEE_MM_AMT_NHIC": "2216667",
          "INSU_ACPT_YN_GG": "Y",
          "INSU_ACPT_YN_GY": "Y",
          "INSU_ACPT_YN_SJ": "Y",
          "INSU_ACPT_YN_YG": "N",
          "FEE_MM_AMT_INSPS": "2216667",
          "JOB_STBL_RQST_YN": "N",
          "NPC_BSLC_MGMT_NO": "12345678901",
          "NPC_CTRL_BROF_CD": "1124",
          "BF_FEE_MM_AMT_NPC": "",
          "HRDK_BSLC_MGMT_NO": "12345678901",
          "HRDK_CTRL_BROF_CD": "2040",
          "KLWC_BSLC_MGMT_NO": "12345678901",
          "KLWC_CTRL_BROF_CD": "2040",
          "NHIC_BSLC_MGMT_NO": "12345678901",
          "NHIC_CTRL_BROF_CD": "0131",
          "FEE_CHG_YYYYMM_KLWC": "202607",
          "FEE_CHG_YYYYMM_NHIC": "202607",
          "FEE_CHG_YYYYMM_INSPS": "202607",
          "_processing_result_source": "WETC_101S19",
          "_processing_result_dataset": "...",
          "_processing_result_message": "보수변경이 정상처리되었습니다"
        }
      ],
      "row_count": 1,
      "bind_dataset": "..."
    },
    "title": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "source": {
      "main_detail_sql_id": "...",
      "main_detail_dataset": "...",
      "additional_sql_calls": [
        {
          "note": "실제 상세 진입 직후 함께 호출되는 보조 상세 SQL",
          "sql_id": "...",
          "dataset": "...",
          "row_count": 0
        }
      ]
    },
    "screen_id": "...",
    "menu_title": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "form_fields": {
      "contact": {
        "charge_person": "홍길동",
        "workplace_fax": "",
        "workplace_tel": "010-1234-5678"
      },
      "serial_no": "",
      "write_date": {
        "raw": "20260914",
        "display": "2026-09-14"
      },
      "search_inputs": {
        "name": "",
        "health_insurance_card_no": "",
        "health_card_change_checked": "N"
      },
      "health_section": {
        "checked": "0",
        "salary_change_month": "",
        "changed_health_premium": "",
        "changed_salary_monthly_amount": "",
        "changed_long_term_care_premium": ""
      },
      "representative": {
        "name": "홍길동"
      },
      "unit_workplace": {
        "code": "000",
        "name": "예시 주식회사"
      },
      "application_type": {
        "all": "N",
        "health": "N",
        "source": "BMAB_020 화면의 체크박스 기본값",
        "employment": "N",
        "national_pension": "N",
        "industrial_accident": "N"
      },
      "insurance_agency": {
        "name": "",
        "number": ""
      },
      "employment_section": {
        "checked": "0",
        "change_reason": "",
        "salary_change_month": "",
        "changed_monthly_average_wage": ""
      },
      "national_pension_section": {
        "checked": "0",
        "worker_agreement": "",
        "changed_standard_monthly_income": "",
        "current_standard_monthly_income": ""
      },
      "business_management_numbers": {
        "health": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "건강보험"
        },
        "employment": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "고용보험"
        },
        "national_pension": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "국민연금"
        },
        "industrial_accident": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "산재보험"
        }
      },
      "industrial_accident_section": {
        "checked": "0",
        "change_reason": "",
        "salary_change_month": "",
        "changed_monthly_average_wage": ""
      }
    },
    "form_contract": {
      "screen_id": "...",
      "notice_texts": [
        "국민연금공단 콜센터 1355, 근로복지공단 콜센터 1588-0075",
        "국민연금 : 기준소득월액 변경 신청은 근로자와 사용자가 원하는 경우에만 신청(의무가 아님)하며, 근로자는 근로자동의서(서명 또는 인)와 증빙서류를 반드시 제출 해야 처리됩니다.",
        "기준소득월액 변경 적용기간은 신청일이 속하는 달의 다음 달부터 적용(소급적용 불가) 다음해 6월까지 적용되며, 과세자료 등을 통한 사후정산을 통해 1만원 이상 차액이 있는 경우 추가징수 또는 과오납금 충당 및 반환처리합니다.",
        "고용/산재보험 : 월평균보수 변경신청은 당해연도에 한정 합니다.",
        "당해연도 이전 고용종료자에 대한 월평균보수 변경신청은 해당근로자에 대한 보수총액수정 신고서를 근로복지공단으로 제출하여 주시기 바랍니다.",
        "보수인상, 보수인하 : 신고서를 제출한 날이 속하는 달의 다음 달부터 적용",
        "착오정정 : 정정 월부터 소급하여 적용"
      ],
      "screen_title": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "contract_kind": "source_form_screen_contract",
      "grid_contract": {
        "name": "Grid_0",
        "columns": [
          {
            "key": "sequence",
            "label": "순번"
          },
          {
            "key": "national_pension_report",
            "label": "국민연금 Y:신고 N:미신고"
          },
          {
            "key": "health_report",
            "label": "건강보험 Y:신고 N:미신고"
          },
          {
            "key": "employment_report",
            "label": "고용보험 Y:신고 N:미신고"
          },
          {
            "key": "industrial_accident_report",
            "label": "산재보험 Y:신고 N:미신고"
          },
          {
            "key": "name",
            "label": "성명"
          },
          {
            "key": "resident_no",
            "label": "주민등록번호"
          },
          {
            "key": "health_insurance_card_no",
            "label": "건강보험증번호"
          },
          {
            "key": "pension_current_standard_monthly_income",
            "label": "[연금]현재 기준소득월액"
          },
          {
            "key": "pension_changed_standard_monthly_income",
            "label": "[연금]변경 후 기준소득월액"
          },
          {
            "key": "health_salary_change_month",
            "label": "[건강]보수월액 변경월"
          },
          {
            "key": "health_changed_salary_monthly_amount",
            "label": "[건강]변경후보수월액"
          },
          {
            "key": "employment_salary_change_month",
            "label": "[고용]보수월액 변경월"
          },
          {
            "key": "employment_changed_average_wage",
            "label": "[고용]변경후월평균보수"
          },
          {
            "key": "industrial_salary_change_month",
            "label": "[산재]보수월액 변경월"
          },
          {
            "key": "industrial_changed_average_wage",
            "label": "[산재]변경후월평균보수"
          },
          {
            "key": "worker_agreement",
            "label": "근로자 동의"
          },
          {
            "key": "job_stability_request",
            "label": "직장 안정 여부"
          }
        ],
        "source_note": "화면에 보이는 컬럼과 하단 가로스크롤 뒤 업무 컬럼까지 API 컬럼 계약으로 유지",
        "horizontal_scroll_present": true
      },
      "top_navigation": [
        "새문서",
        "임시저장",
        "신고(전송)/신청",
        "조회",
        "출력",
        "서식닫기",
        "도움말",
        "전체메뉴 열기"
      ],
      "visible_buttons": [
        "대상자등록",
        "대상자삭제",
        "파일내리기",
        "파일올리기",
        "파일사양서",
        "보수월액변경신청파일변환"
      ],
      "visible_sections": [
        {
          "id": "workplace_management_numbers",
          "title": "사업장관리번호(사업장명)",
          "controls": [
            {
              "kind": "readonly_text",
              "label": "건강보험",
              "value": {
                "code": "12345678901",
                "name": "예시 주식회사",
                "label": "건강보험"
              }
            },
            {
              "kind": "select_and_readonly_text",
              "label": "국민연금",
              "value": {
                "code": "12345678901",
                "name": "예시 주식회사",
                "label": "국민연금"
              }
            },
            {
              "kind": "select_and_readonly_text",
              "label": "고용보험",
              "value": {
                "code": "12345678901",
                "name": "예시 주식회사",
                "label": "고용보험"
              }
            },
            {
              "kind": "select_and_readonly_text",
              "label": "산재보험",
              "value": {
                "code": "12345678901",
                "name": "예시 주식회사",
                "label": "산재보험"
              }
            }
          ]
        },
        {
          "id": "agency_and_unit_workplace",
          "title": "보험사무 대행기관 / 단위기관(영업소)",
          "controls": [
            {
              "kind": "text",
              "label": "보험사무 대행기관 번호",
              "value": ""
            },
            {
              "kind": "text",
              "label": "보험사무 대행기관 명칭",
              "value": ""
            },
            {
              "kind": "text",
              "label": "단위기관(영업소) 기호",
              "value": "000"
            },
            {
              "kind": "text",
              "label": "단위기관(영업소) 명칭",
              "value": "예시 주식회사"
            }
          ]
        },
        {
          "id": "application_header",
          "title": "작성정보 / 신청구분",
          "controls": [
            {
              "kind": "date",
              "label": "작성일",
              "value": {
                "raw": "20260914",
                "display": "2026-09-14"
              }
            },
            {
              "kind": "text",
              "label": "일련번호",
              "value": ""
            },
            {
              "kind": "checkbox",
              "label": "신청구분 전체",
              "value": "N"
            },
            {
              "kind": "checkbox",
              "label": "신청구분 국민연금",
              "value": "N"
            },
            {
              "kind": "checkbox",
              "label": "신청구분 건강보험",
              "value": "N"
            },
            {
              "kind": "checkbox",
              "label": "신청구분 고용보험",
              "value": "N"
            },
            {
              "kind": "checkbox",
              "label": "신청구분 산재보험",
              "value": "N"
            }
          ]
        },
        {
          "id": "person_lookup",
          "title": "대상자 입력",
          "controls": [
            {
              "kind": "split_text",
              "label": "주민등록번호",
              "value": ""
            },
            {
              "kind": "text",
              "label": "성명",
              "value": ""
            },
            {
              "kind": "text",
              "label": "건강보험증번호",
              "value": ""
            },
            {
              "kind": "checkbox",
              "label": "증번호 변경시 체크 후 입력해 주시기 바랍니다.",
              "value": "N"
            },
            {
              "kind": "checkbox",
              "label": "국민연금",
              "value": "0"
            },
            {
              "kind": "checkbox",
              "label": "건강보험",
              "value": "0"
            },
            {
              "kind": "checkbox",
              "label": "고용보험",
              "value": "0"
            },
            {
              "kind": "checkbox",
              "label": "산재보험",
              "value": "0"
            }
          ]
        },
        {
          "id": "national_pension_section",
          "title": "국민연금",
          "controls": [
            {
              "kind": "number_text",
              "label": "현재 기준소득월액",
              "value": ""
            },
            {
              "kind": "number_text",
              "label": "변경 후 기준소득월액",
              "value": ""
            },
            {
              "kind": "select",
              "label": "근로자 동의",
              "value": ""
            }
          ]
        },
        {
          "id": "health_section",
          "title": "건강보험",
          "controls": [
            {
              "kind": "month",
              "label": "보수월액 변경월",
              "value": ""
            },
            {
              "kind": "number_text",
              "label": "변경후보수월액",
              "value": ""
            },
            {
              "kind": "number_text",
              "label": "변경 후 건강보험료",
              "value": ""
            },
            {
              "kind": "number_text",
              "label": "변경 후 요양보험료",
              "value": ""
            }
          ]
        },
        {
          "id": "employment_section",
          "title": "고용보험",
          "controls": [
            {
              "kind": "month",
              "label": "보수월액 변경월",
              "value": ""
            },
            {
              "kind": "number_text",
              "label": "변경후월평균보수",
              "value": ""
            },
            {
              "kind": "select",
              "label": "변경사유",
              "value": ""
            }
          ]
        },
        {
          "id": "industrial_accident_section",
          "title": "산재보험",
          "controls": [
            {
              "kind": "month",
              "label": "보수월액 변경월",
              "value": ""
            },
            {
              "kind": "number_text",
              "label": "변경후월평균보수",
              "value": ""
            },
            {
              "kind": "select",
              "label": "변경사유",
              "value": ""
            }
          ]
        }
      ]
    },
    "runtime_datasets": {
      "...": {
        "DOCID": "BMBB_033",
        "YKIHO": "wfnWmE85zPOelR3cgwM1ajjrAJNRZJHQMxock5TuFE8=",
        "FIRM_NM": "예시 주식회사",
        "FIRM_SYM": "12345678",
        "EFIRM_SYM": "[REDACTED]",
        "WRT_CHASU": "",
        "UNIT_FIRM_SYM": "000",
        "__xui_globals__": {
          "GV_YKIHO": "wfnWmE85zPOelR3cgwM1ajjrAJNRZJHQMxock5TuFE8="
        },
        "NHIC_BSLC_MGMT_NO": "12345678901"
      },
      "...2": {},
      "...3": {
        "YKIHO": "wfnWmE85zPOelR3cgwM1ajjrAJNRZJHQMxock5TuFE8=",
        "FIRM_NM": "예시 주식회사",
        "FIRM_SYM": "12345678",
        "EFIRM_SYM": "[REDACTED]",
        "FIRM_MGMT_NO": "12345678901",
        "UNIT_FIRM_SYM": "000"
      }
    }
  },
  "row_key": "sent:20260730ZZ:01:BMAB_020",
  "success": true,
  "datasets": {
    "...": {
      "rows": [
        {
          "NM": "홍길동",
          "RPT_DT": "20260730",
          "JUNG_NO": "12345678901",
          "REPR_NM": "홍길동",
          "USER_ID": "user01",
          "FIRM_SYM": "12345678",
          "BSBR_NAME": "예시 주식회사",
          "WRT_CHASU": "20260730ZZ",
          "BSLC_FAXNO1": "\u0003",
          "BSLC_FAXNO2": "\u0003",
          "BSLC_FAXNO3": "\u0003",
          "BSLC_TELNO1": "123",
          "BSLC_TELNO2": "1234",
          "BSLC_TELNO3": "1234",
          "MBR_AGRE_YN": "\u0003",
          "WRT_DUP_SEQ": "01",
          "CHNG_CD_KLWC": "1",
          "CHNG_CD_INSPS": "1",
          "UNIT_FIRM_SYM": "000",
          "FEE_MM_AMT_NPC": "",
          "HRDK_ASCT_NAME": "\u0003",
          "HRDK_ASCT_SYMB": "\u0003",
          "UNIT_BSLC_SYMB": "000",
          "CHRG_PRSN_HPNO1": "\u0003",
          "CHRG_PRSN_HPNO2": "\u0003",
          "CHRG_PRSN_HPNO3": "\u0003",
          "FEE_MM_AMT_KLWC": "2216667",
          "FEE_MM_AMT_NHIC": "2216667",
          "INSU_ACPT_YN_GG": "Y",
          "INSU_ACPT_YN_GY": "Y",
          "INSU_ACPT_YN_SJ": "Y",
          "INSU_ACPT_YN_YG": "N",
          "FEE_MM_AMT_INSPS": "2216667",
          "JOB_STBL_RQST_YN": "N",
          "NPC_BSLC_MGMT_NO": "12345678901",
          "NPC_CTRL_BROF_CD": "1124",
          "BF_FEE_MM_AMT_NPC": "",
          "HRDK_BSLC_MGMT_NO": "12345678901",
          "HRDK_CTRL_BROF_CD": "2040",
          "KLWC_BSLC_MGMT_NO": "12345678901",
          "KLWC_CTRL_BROF_CD": "2040",
          "NHIC_BSLC_MGMT_NO": "12345678901",
          "NHIC_CTRL_BROF_CD": "0131",
          "FEE_CHG_YYYYMM_KLWC": "202607",
          "FEE_CHG_YYYYMM_NHIC": "202607",
          "FEE_CHG_YYYYMM_INSPS": "202607"
        }
      ],
      "columns": [
        "WRT_CHASU",
        "WRT_DUP_SEQ",
        "FIRM_SYM",
        "UNIT_FIRM_SYM",
        "JUMIN_NO",
        "JUNG_NO",
        "NM",
        "RPT_DT",
        "USER_ID",
        "NHIC_BSLC_MGMT_NO",
        "NPC_BSLC_MGMT_NO",
        "HRDK_BSLC_MGMT_NO",
        "KLWC_BSLC_MGMT_NO",
        "HRDK_ASCT_NAME",
        "HRDK_ASCT_SYMB",
        "NHIC_CTRL_BROF_CD",
        "NPC_CTRL_BROF_CD",
        "HRDK_CTRL_BROF_CD",
        "KLWC_CTRL_BROF_CD",
        "BSLC_TELNO1",
        "BSLC_TELNO2",
        "BSLC_TELNO3",
        "BSLC_FAXNO1",
        "BSLC_FAXNO2",
        "BSLC_FAXNO3",
        "CHRG_PRSN_HPNO1",
        "CHRG_PRSN_HPNO2",
        "CHRG_PRSN_HPNO3",
        "REPR_NM",
        "REPR_JUMIN_NO",
        "UNIT_BSLC_SYMB",
        "BSBR_NAME",
        "INSU_ACPT_YN_YG",
        "INSU_ACPT_YN_GG",
        "INSU_ACPT_YN_GY",
        "INSU_ACPT_YN_SJ",
        "FEE_MM_AMT_NPC",
        "FEE_MM_AMT_NHIC",
        "FEE_MM_AMT_INSPS",
        "FEE_MM_AMT_KLWC",
        "BF_FEE_MM_AMT_NPC",
        "FEE_CHG_YYYYMM_NHIC",
        "MBR_AGRE_YN",
        "CHNG_CD_INSPS",
        "CHNG_CD_KLWC",
        "JOB_STBL_RQST_YN",
        "FEE_CHG_YYYYMM_INSPS",
        "FEE_CHG_YYYYMM_KLWC"
      ]
    },
    "...2": {
      "rows": [
        {
          "MSG": "",
          "EXEC": "Y",
          "FAIL": "",
          "TYPE": "N",
          "SQL_ID": "...",
          "PAGE_NO": "0",
          "TX_NAME": "",
          "BIZ_NAME": "",
          "EXEC_CNT": "1",
          "FAIL_MSG": "",
          "READ_ALL": "",
          "EXEC_TYPE": "B",
          "PAGE_SIZE": "0",
          "USE_INPUT": "",
          "USE_ORDER": "",
          "KEY_SQL_ID": "",
          "KEY_ZERO_LEN": "0",
          "DELETE_SQL_ID": "",
          "INSERT_SQL_ID": "",
          "KEY_INCREMENT": "0",
          "UPDATE_SQL_ID": "",
          "CALLBACK_SQL_ID": "",
          "SAVE_FLAG_COLUMN": ""
        }
      ],
      "columns": [
        "TX_NAME",
        "TYPE",
        "SQL_ID",
        "KEY_SQL_ID",
        "KEY_INCREMENT",
        "CALLBACK_SQL_ID",
        "INSERT_SQL_ID",
        "UPDATE_SQL_ID",
        "DELETE_SQL_ID",
        "SAVE_FLAG_COLUMN",
        "USE_INPUT",
        "USE_ORDER",
        "KEY_ZERO_LEN",
        "BIZ_NAME",
        "PAGE_NO",
        "PAGE_SIZE",
        "READ_ALL",
        "EXEC_TYPE",
        "EXEC",
        "FAIL",
        "FAIL_MSG",
        "EXEC_CNT",
        "MSG"
      ]
    }
  },
  "form_code": "BMAB_020",
  "row_index": 0,
  "screen_id": "...",
  "route_kind": "live",
  "document_id": "BMAB_020",
  "excel_ready": {
    "fields": [
      {
        "label": "문서명",
        "value": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
        "section": "문서"
      },
      {
        "label": "화면ID",
        "value": "...",
        "section": "문서"
      },
      {
        "label": "사업장관리번호/사업장명 건강보험",
        "value": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "건강보험"
        },
        "section": "사업장관리번호(사업장명)"
      },
      {
        "label": "사업장관리번호/사업장명 국민연금",
        "value": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "국민연금"
        },
        "section": "사업장관리번호(사업장명)"
      },
      {
        "label": "사업장관리번호/사업장명 고용보험",
        "value": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "고용보험"
        },
        "section": "사업장관리번호(사업장명)"
      },
      {
        "label": "사업장관리번호/사업장명 산재보험",
        "value": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "산재보험"
        },
        "section": "사업장관리번호(사업장명)"
      },
      {
        "label": "보험사무 대행기관",
        "value": {
          "name": "",
          "number": ""
        },
        "section": "보험사무 대행기관"
      },
      {
        "label": "단위기관(영업소)",
        "value": {
          "code": "000",
          "name": "예시 주식회사"
        },
        "section": "단위기관(영업소)"
      },
      {
        "label": "작성일",
        "value": {
          "raw": "20260914",
          "display": "2026-09-14"
        },
        "section": "작성정보"
      },
      {
        "label": "일련번호",
        "value": "",
        "section": "작성정보"
      },
      {
        "label": "신청구분",
        "value": {
          "all": "N",
          "health": "N",
          "source": "BMAB_020 화면의 체크박스 기본값",
          "employment": "N",
          "national_pension": "N",
          "industrial_accident": "N"
        },
        "section": "작성정보"
      },
      {
        "label": "대상자 조회입력",
        "value": {
          "name": "",
          "health_insurance_card_no": "",
          "health_card_change_checked": "N"
        },
        "section": "대상자 입력"
      },
      {
        "label": "국민연금 입력구역",
        "value": {
          "checked": "0",
          "worker_agreement": "",
          "changed_standard_monthly_income": "",
          "current_standard_monthly_income": ""
        },
        "section": "국민연금"
      },
      {
        "label": "건강보험 입력구역",
        "value": {
          "checked": "0",
          "salary_change_month": "",
          "changed_health_premium": "",
          "changed_salary_monthly_amount": "",
          "changed_long_term_care_premium": ""
        },
        "section": "건강보험"
      },
      {
        "label": "고용보험 입력구역",
        "value": {
          "checked": "0",
          "change_reason": "",
          "salary_change_month": "",
          "changed_monthly_average_wage": ""
        },
        "section": "고용보험"
      },
      {
        "label": "산재보험 입력구역",
        "value": {
          "checked": "0",
          "change_reason": "",
          "salary_change_month": "",
          "changed_monthly_average_wage": ""
        },
        "section": "산재보험"
      },
      {
        "label": "대상자 목록",
        "value": [
          {
            "name": "홍길동",
            "sequence": 1,
            "health_report": "Y",
            "worker_agreement": "",
            "employment_report": "Y",
            "job_stability_request": "N",
            "national_pension_report": "N",
            "health_insurance_card_no": "00000000000",
            "health_salary_change_month": "2026/07",
            "industrial_accident_report": "Y",
            "employment_salary_change_month": "2026/07",
            "industrial_salary_change_month": "2026/07",
            "employment_changed_average_wage": "2216667",
            "industrial_changed_average_wage": "2216667",
            "health_changed_salary_monthly_amount": "2216667",
            "pension_changed_standard_monthly_income": "",
            "pension_current_standard_monthly_income": ""
          }
        ],
        "section": "대상자 목록"
      }
    ],
    "screen_id": "...",
    "form_header": {
      "작성일": {
        "raw": "20260914",
        "display": "2026-09-14"
      },
      "신청구분": {
        "all": "N",
        "health": "N",
        "source": "BMAB_020 화면의 체크박스 기본값",
        "employment": "N",
        "national_pension": "N",
        "industrial_accident": "N"
      },
      "일련번호": "",
      "대상자_조회입력": {
        "name": "",
        "health_insurance_card_no": "",
        "health_card_change_checked": "N"
      }
    },
    "notice_texts": [
      "국민연금공단 콜센터 1355, 근로복지공단 콜센터 1588-0075",
      "국민연금 : 기준소득월액 변경 신청은 근로자와 사용자가 원하는 경우에만 신청(의무가 아님)하며, 근로자는 근로자동의서(서명 또는 인)와 증빙서류를 반드시 제출 해야 처리됩니다.",
      "기준소득월액 변경 적용기간은 신청일이 속하는 달의 다음 달부터 적용(소급적용 불가) 다음해 6월까지 적용되며, 과세자료 등을 통한 사후정산을 통해 1만원 이상 차액이 있는 경우 추가징수 또는 과오납금 충당 및 반환처리합니다.",
      "고용/산재보험 : 월평균보수 변경신청은 당해연도에 한정 합니다.",
      "당해연도 이전 고용종료자에 대한 월평균보수 변경신청은 해당근로자에 대한 보수총액수정 신고서를 근로복지공단으로 제출하여 주시기 바랍니다.",
      "보수인상, 보수인하 : 신고서를 제출한 날이 속하는 달의 다음 달부터 적용",
      "착오정정 : 정정 월부터 소급하여 적용"
    ],
    "target_table": {
      "rows": [
        {
          "name": "홍길동",
          "sequence": 1,
          "health_report": "Y",
          "worker_agreement": "",
          "employment_report": "Y",
          "job_stability_request": "N",
          "national_pension_report": "N",
          "health_insurance_card_no": "00000000000",
          "health_salary_change_month": "2026/07",
          "industrial_accident_report": "Y",
          "employment_salary_change_month": "2026/07",
          "industrial_salary_change_month": "2026/07",
          "employment_changed_average_wage": "2216667",
          "industrial_changed_average_wage": "2216667",
          "health_changed_salary_monthly_amount": "2216667",
          "pension_changed_standard_monthly_income": "",
          "pension_current_standard_monthly_income": ""
        }
      ],
      "표명": "대상자 목록",
      "columns": [
        {
          "key": "sequence",
          "label": "순번"
        },
        {
          "key": "national_pension_report",
          "label": "국민연금 Y:신고 N:미신고"
        },
        {
          "key": "health_report",
          "label": "건강보험 Y:신고 N:미신고"
        },
        {
          "key": "employment_report",
          "label": "고용보험 Y:신고 N:미신고"
        },
        {
          "key": "industrial_accident_report",
          "label": "산재보험 Y:신고 N:미신고"
        },
        {
          "key": "name",
          "label": "성명"
        },
        {
          "key": "resident_no",
          "label": "주민등록번호"
        },
        {
          "key": "health_insurance_card_no",
          "label": "건강보험증번호"
        },
        {
          "key": "pension_current_standard_monthly_income",
          "label": "[연금]현재 기준소득월액"
        },
        {
          "key": "pension_changed_standard_monthly_income",
          "label": "[연금]변경 후 기준소득월액"
        },
        {
          "key": "health_salary_change_month",
          "label": "[건강]보수월액 변경월"
        },
        {
          "key": "health_changed_salary_monthly_amount",
          "label": "[건강]변경후보수월액"
        },
        {
          "key": "employment_salary_change_month",
          "label": "[고용]보수월액 변경월"
        },
        {
          "key": "employment_changed_average_wage",
          "label": "[고용]변경후월평균보수"
        },
        {
          "key": "industrial_salary_change_month",
          "label": "[산재]보수월액 변경월"
        },
        {
          "key": "industrial_changed_average_wage",
          "label": "[산재]변경후월평균보수"
        },
        {
          "key": "worker_agreement",
          "label": "근로자 동의"
        },
        {
          "key": "job_stability_request",
          "label": "직장 안정 여부"
        }
      ],
      "raw_rows": [
        {
          "NM": "홍길동",
          "DOCID": "BMAB_020",
          "RPT_DT": "20260730",
          "JUNG_NO": "12345678901",
          "REPR_NM": "홍길동",
          "USER_ID": "user01",
          "FIRM_SYM": "12345678",
          "BSBR_NAME": "예시 주식회사",
          "WRT_CHASU": "20260730ZZ",
          "BSLC_FAXNO1": "",
          "BSLC_FAXNO2": "",
          "BSLC_FAXNO3": "",
          "BSLC_TELNO1": "123",
          "BSLC_TELNO2": "1234",
          "BSLC_TELNO3": "1234",
          "MBR_AGRE_YN": "",
          "WRT_DUP_SEQ": "01",
          "CHNG_CD_KLWC": "1",
          "CHNG_CD_INSPS": "1",
          "UNIT_FIRM_SYM": "000",
          "FEE_MM_AMT_NPC": "",
          "HRDK_ASCT_NAME": "",
          "HRDK_ASCT_SYMB": "",
          "UNIT_BSLC_SYMB": "000",
          "CHRG_PRSN_HPNO1": "",
          "CHRG_PRSN_HPNO2": "",
          "CHRG_PRSN_HPNO3": "",
          "FEE_MM_AMT_KLWC": "2216667",
          "FEE_MM_AMT_NHIC": "2216667",
          "INSU_ACPT_YN_GG": "Y",
          "INSU_ACPT_YN_GY": "Y",
          "INSU_ACPT_YN_SJ": "Y",
          "INSU_ACPT_YN_YG": "N",
          "FEE_MM_AMT_INSPS": "2216667",
          "JOB_STBL_RQST_YN": "N",
          "NPC_BSLC_MGMT_NO": "12345678901",
          "NPC_CTRL_BROF_CD": "1124",
          "BF_FEE_MM_AMT_NPC": "",
          "HRDK_BSLC_MGMT_NO": "12345678901",
          "HRDK_CTRL_BROF_CD": "2040",
          "KLWC_BSLC_MGMT_NO": "12345678901",
          "KLWC_CTRL_BROF_CD": "2040",
          "NHIC_BSLC_MGMT_NO": "12345678901",
          "NHIC_CTRL_BROF_CD": "0131",
          "FEE_CHG_YYYYMM_KLWC": "202607",
          "FEE_CHG_YYYYMM_NHIC": "202607",
          "FEE_CHG_YYYYMM_INSPS": "202607",
          "_processing_result_source": "WETC_101S19",
          "_processing_result_dataset": "...",
          "_processing_result_message": "보수변경이 정상처리되었습니다"
        }
      ],
      "row_count": 1
    },
    "business_info": {
      "화면ID": "...",
      "문서명": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "단위기관_영업소": {
        "code": "000",
        "name": "예시 주식회사"
      },
      "보험사무_대행기관": {
        "name": "",
        "number": ""
      },
      "사업장관리번호_사업장명": {
        "건강보험": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "건강보험"
        },
        "고용보험": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "고용보험"
        },
        "국민연금": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "국민연금"
        },
        "산재보험": {
          "code": "12345678901",
          "name": "예시 주식회사",
          "label": "산재보험"
        }
      }
    },
    "document_title": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "insurance_sections": {
      "건강보험": {
        "checked": "0",
        "salary_change_month": "",
        "changed_health_premium": "",
        "changed_salary_monthly_amount": "",
        "changed_long_term_care_premium": ""
      },
      "고용보험": {
        "checked": "0",
        "change_reason": "",
        "salary_change_month": "",
        "changed_monthly_average_wage": ""
      },
      "국민연금": {
        "checked": "0",
        "worker_agreement": "",
        "changed_standard_monthly_income": "",
        "current_standard_monthly_income": ""
      },
      "산재보험": {
        "checked": "0",
        "change_reason": "",
        "salary_change_month": "",
        "changed_monthly_average_wage": ""
      }
    }
  },
  "form_header": {
    "작성일": {
      "raw": "20260914",
      "display": "2026-09-14"
    },
    "신청구분": {
      "all": "N",
      "health": "N",
      "source": "BMAB_020 화면의 체크박스 기본값",
      "employment": "N",
      "national_pension": "N",
      "industrial_accident": "N"
    },
    "일련번호": "",
    "대상자_조회입력": {
      "name": "",
      "health_insurance_card_no": "",
      "health_card_change_checked": "N"
    }
  },
  "feature_name": "...",
  "grid_columns": [
    {
      "key": "sequence",
      "label": "순번"
    },
    {
      "key": "national_pension_report",
      "label": "국민연금 Y:신고 N:미신고"
    },
    {
      "key": "health_report",
      "label": "건강보험 Y:신고 N:미신고"
    },
    {
      "key": "employment_report",
      "label": "고용보험 Y:신고 N:미신고"
    },
    {
      "key": "industrial_accident_report",
      "label": "산재보험 Y:신고 N:미신고"
    },
    {
      "key": "name",
      "label": "성명"
    },
    {
      "key": "resident_no",
      "label": "주민등록번호"
    },
    {
      "key": "health_insurance_card_no",
      "label": "건강보험증번호"
    },
    {
      "key": "pension_current_standard_monthly_income",
      "label": "[연금]현재 기준소득월액"
    },
    {
      "key": "pension_changed_standard_monthly_income",
      "label": "[연금]변경 후 기준소득월액"
    },
    {
      "key": "health_salary_change_month",
      "label": "[건강]보수월액 변경월"
    },
    {
      "key": "health_changed_salary_monthly_amount",
      "label": "[건강]변경후보수월액"
    },
    {
      "key": "employment_salary_change_month",
      "label": "[고용]보수월액 변경월"
    },
    {
      "key": "employment_changed_average_wage",
      "label": "[고용]변경후월평균보수"
    },
    {
      "key": "industrial_salary_change_month",
      "label": "[산재]보수월액 변경월"
    },
    {
      "key": "industrial_changed_average_wage",
      "label": "[산재]변경후월평균보수"
    },
    {
      "key": "worker_agreement",
      "label": "근로자 동의"
    },
    {
      "key": "job_stability_request",
      "label": "직장 안정 여부"
    }
  ],
  "selected_row": {
    "raw": {
      "TBL": "TBBMCB03",
      "DOCID": "BMAB_020",
      "DOCNM": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "RMK_1": "",
      "RMK_2": "",
      "RMK_3": "",
      "YKIHO": "",
      "RET_CNT": "0",
      "TOT_CNT": "1",
      "CRE_DTTM": "2026-07-30",
      "FIRM_SYM": "12345678",
      "JUMINCNT": "1",
      "NORM_CNT": "0",
      "PROG_STAT": "2",
      "WRT_CHASU": "20260730ZZ",
      "BAN_NPC_CNT": "0",
      "BAN_ORG_CNT": "0",
      "BAN_WRK_CNT": "0",
      "CRE_DTTM_MI": "13:29:43",
      "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": "1",
      "KLWC_NORM_CNT": "1",
      "NHIC_NORM_CNT": "1",
      "UNIT_FIRM_SYM": "000"
    },
    "ykiho": "",
    "row_key": "sent:20260730ZZ:01:BMAB_020",
    "category": "4대서식",
    "firm_sym": "12345678",
    "row_text": "4대서식 1 4대보험 기준소득월액/보수월액/월평균보수 변경신청서 2026-07-30 01 13:29:43 접수 1 정상 4대공통 0 건강 1 국민연금 0 고용 1 산재 1 반송 4대공통 0 건강 0 국민연금 0 고용 0 산재 0",
    "form_code": "BMAB_020",
    "form_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "row_index": 0,
    "wrt_chasu": "20260730ZZ",
    "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": "20260730ZZ",
      "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-07-30 13:29:43",
    "category_code": "1",
    "document_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "normal_counts": {
      "health": 1,
      "employment": 1,
      "national_pension": 0,
      "four_major_common": 0,
      "industrial_accident": 1
    },
    "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:20260730ZZ:01:BMAB_020",
      "firm_sym": "12345678",
      "form_code": "BMAB_020",
      "row_index": 0,
      "wrt_chasu": "20260730ZZ",
      "wrt_dup_seq": "01",
      "unit_firm_sym": "000"
    },
    "submitted_date": "2026-07-30",
    "submitted_time": "13:29:43",
    "program_status_code": "2",
    "attachment_file_present": false
  },
  "target_table": {
    "rows": [
      {
        "name": "홍길동",
        "sequence": 1,
        "health_report": "Y",
        "worker_agreement": "",
        "employment_report": "Y",
        "job_stability_request": "N",
        "national_pension_report": "N",
        "health_insurance_card_no": "00000000000",
        "health_salary_change_month": "2026/07",
        "industrial_accident_report": "Y",
        "employment_salary_change_month": "2026/07",
        "industrial_salary_change_month": "2026/07",
        "employment_changed_average_wage": "2216667",
        "industrial_changed_average_wage": "2216667",
        "health_changed_salary_monthly_amount": "2216667",
        "pension_changed_standard_monthly_income": "",
        "pension_current_standard_monthly_income": ""
      }
    ],
    "표명": "대상자 목록",
    "columns": [
      {
        "key": "sequence",
        "label": "순번"
      },
      {
        "key": "national_pension_report",
        "label": "국민연금 Y:신고 N:미신고"
      },
      {
        "key": "health_report",
        "label": "건강보험 Y:신고 N:미신고"
      },
      {
        "key": "employment_report",
        "label": "고용보험 Y:신고 N:미신고"
      },
      {
        "key": "industrial_accident_report",
        "label": "산재보험 Y:신고 N:미신고"
      },
      {
        "key": "name",
        "label": "성명"
      },
      {
        "key": "resident_no",
        "label": "주민등록번호"
      },
      {
        "key": "health_insurance_card_no",
        "label": "건강보험증번호"
      },
      {
        "key": "pension_current_standard_monthly_income",
        "label": "[연금]현재 기준소득월액"
      },
      {
        "key": "pension_changed_standard_monthly_income",
        "label": "[연금]변경 후 기준소득월액"
      },
      {
        "key": "health_salary_change_month",
        "label": "[건강]보수월액 변경월"
      },
      {
        "key": "health_changed_salary_monthly_amount",
        "label": "[건강]변경후보수월액"
      },
      {
        "key": "employment_salary_change_month",
        "label": "[고용]보수월액 변경월"
      },
      {
        "key": "employment_changed_average_wage",
        "label": "[고용]변경후월평균보수"
      },
      {
        "key": "industrial_salary_change_month",
        "label": "[산재]보수월액 변경월"
      },
      {
        "key": "industrial_changed_average_wage",
        "label": "[산재]변경후월평균보수"
      },
      {
        "key": "worker_agreement",
        "label": "근로자 동의"
      },
      {
        "key": "job_stability_request",
        "label": "직장 안정 여부"
      }
    ],
    "raw_rows": [
      {
        "NM": "홍길동",
        "DOCID": "BMAB_020",
        "RPT_DT": "20260730",
        "JUNG_NO": "12345678901",
        "REPR_NM": "홍길동",
        "USER_ID": "user01",
        "FIRM_SYM": "12345678",
        "BSBR_NAME": "예시 주식회사",
        "WRT_CHASU": "20260730ZZ",
        "BSLC_FAXNO1": "",
        "BSLC_FAXNO2": "",
        "BSLC_FAXNO3": "",
        "BSLC_TELNO1": "123",
        "BSLC_TELNO2": "1234",
        "BSLC_TELNO3": "1234",
        "MBR_AGRE_YN": "",
        "WRT_DUP_SEQ": "01",
        "CHNG_CD_KLWC": "1",
        "CHNG_CD_INSPS": "1",
        "UNIT_FIRM_SYM": "000",
        "FEE_MM_AMT_NPC": "",
        "HRDK_ASCT_NAME": "",
        "HRDK_ASCT_SYMB": "",
        "UNIT_BSLC_SYMB": "000",
        "CHRG_PRSN_HPNO1": "",
        "CHRG_PRSN_HPNO2": "",
        "CHRG_PRSN_HPNO3": "",
        "FEE_MM_AMT_KLWC": "2216667",
        "FEE_MM_AMT_NHIC": "2216667",
        "INSU_ACPT_YN_GG": "Y",
        "INSU_ACPT_YN_GY": "Y",
        "INSU_ACPT_YN_SJ": "Y",
        "INSU_ACPT_YN_YG": "N",
        "FEE_MM_AMT_INSPS": "2216667",
        "JOB_STBL_RQST_YN": "N",
        "NPC_BSLC_MGMT_NO": "12345678901",
        "NPC_CTRL_BROF_CD": "1124",
        "BF_FEE_MM_AMT_NPC": "",
        "HRDK_BSLC_MGMT_NO": "12345678901",
        "HRDK_CTRL_BROF_CD": "2040",
        "KLWC_BSLC_MGMT_NO": "12345678901",
        "KLWC_CTRL_BROF_CD": "2040",
        "NHIC_BSLC_MGMT_NO": "12345678901",
        "NHIC_CTRL_BROF_CD": "0131",
        "FEE_CHG_YYYYMM_KLWC": "202607",
        "FEE_CHG_YYYYMM_NHIC": "202607",
        "FEE_CHG_YYYYMM_INSPS": "202607",
        "_processing_result_source": "WETC_101S19",
        "_processing_result_dataset": "...",
        "_processing_result_message": "보수변경이 정상처리되었습니다"
      }
    ],
    "row_count": 1
  },
  "visible_text": "...",
  "business_info": {
    "화면ID": "...",
    "문서명": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "단위기관_영업소": {
      "code": "000",
      "name": "예시 주식회사"
    },
    "보험사무_대행기관": {
      "name": "",
      "number": ""
    },
    "사업장관리번호_사업장명": {
      "건강보험": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "건강보험"
      },
      "고용보험": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "고용보험"
      },
      "국민연금": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "국민연금"
      },
      "산재보험": {
        "code": "12345678901",
        "name": "예시 주식회사",
        "label": "산재보험"
      }
    }
  },
  "detail_source": "bmab020_s02_without_doc_id",
  "document_name": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
  "form_contract": {
    "screen_id": "...",
    "notice_texts": [
      "국민연금공단 콜센터 1355, 근로복지공단 콜센터 1588-0075",
      "국민연금 : 기준소득월액 변경 신청은 근로자와 사용자가 원하는 경우에만 신청(의무가 아님)하며, 근로자는 근로자동의서(서명 또는 인)와 증빙서류를 반드시 제출 해야 처리됩니다.",
      "기준소득월액 변경 적용기간은 신청일이 속하는 달의 다음 달부터 적용(소급적용 불가) 다음해 6월까지 적용되며, 과세자료 등을 통한 사후정산을 통해 1만원 이상 차액이 있는 경우 추가징수 또는 과오납금 충당 및 반환처리합니다.",
      "고용/산재보험 : 월평균보수 변경신청은 당해연도에 한정 합니다.",
      "당해연도 이전 고용종료자에 대한 월평균보수 변경신청은 해당근로자에 대한 보수총액수정 신고서를 근로복지공단으로 제출하여 주시기 바랍니다.",
      "보수인상, 보수인하 : 신고서를 제출한 날이 속하는 달의 다음 달부터 적용",
      "착오정정 : 정정 월부터 소급하여 적용"
    ],
    "screen_title": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
    "contract_kind": "source_form_screen_contract",
    "grid_contract": {
      "name": "Grid_0",
      "columns": [
        {
          "key": "sequence",
          "label": "순번"
        },
        {
          "key": "national_pension_report",
          "label": "국민연금 Y:신고 N:미신고"
        },
        {
          "key": "health_report",
          "label": "건강보험 Y:신고 N:미신고"
        },
        {
          "key": "employment_report",
          "label": "고용보험 Y:신고 N:미신고"
        },
        {
          "key": "industrial_accident_report",
          "label": "산재보험 Y:신고 N:미신고"
        },
        {
          "key": "name",
          "label": "성명"
        },
        {
          "key": "resident_no",
          "label": "주민등록번호"
        },
        {
          "key": "health_insurance_card_no",
          "label": "건강보험증번호"
        },
        {
          "key": "pension_current_standard_monthly_income",
          "label": "[연금]현재 기준소득월액"
        },
        {
          "key": "pension_changed_standard_monthly_income",
          "label": "[연금]변경 후 기준소득월액"
        },
        {
          "key": "health_salary_change_month",
          "label": "[건강]보수월액 변경월"
        },
        {
          "key": "health_changed_salary_monthly_amount",
          "label": "[건강]변경후보수월액"
        },
        {
          "key": "employment_salary_change_month",
          "label": "[고용]보수월액 변경월"
        },
        {
          "key": "employment_changed_average_wage",
          "label": "[고용]변경후월평균보수"
        },
        {
          "key": "industrial_salary_change_month",
          "label": "[산재]보수월액 변경월"
        },
        {
          "key": "industrial_changed_average_wage",
          "label": "[산재]변경후월평균보수"
        },
        {
          "key": "worker_agreement",
          "label": "근로자 동의"
        },
        {
          "key": "job_stability_request",
          "label": "직장 안정 여부"
        }
      ],
      "source_note": "화면에 보이는 컬럼과 하단 가로스크롤 뒤 업무 컬럼까지 API 컬럼 계약으로 유지",
      "horizontal_scroll_present": true
    },
    "top_navigation": [
      "새문서",
      "임시저장",
      "신고(전송)/신청",
      "조회",
      "출력",
      "서식닫기",
      "도움말",
      "전체메뉴 열기"
    ],
    "visible_buttons": [
      "대상자등록",
      "대상자삭제",
      "파일내리기",
      "파일올리기",
      "파일사양서",
      "보수월액변경신청파일변환"
    ],
    "visible_sections": [
      {
        "id": "workplace_management_numbers",
        "title": "사업장관리번호(사업장명)",
        "controls": [
          {
            "kind": "readonly_text",
            "label": "건강보험",
            "value": {
              "code": "12345678901",
              "name": "예시 주식회사",
              "label": "건강보험"
            }
          },
          {
            "kind": "select_and_readonly_text",
            "label": "국민연금",
            "value": {
              "code": "12345678901",
              "name": "예시 주식회사",
              "label": "국민연금"
            }
          },
          {
            "kind": "select_and_readonly_text",
            "label": "고용보험",
            "value": {
              "code": "12345678901",
              "name": "예시 주식회사",
              "label": "고용보험"
            }
          },
          {
            "kind": "select_and_readonly_text",
            "label": "산재보험",
            "value": {
              "code": "12345678901",
              "name": "예시 주식회사",
              "label": "산재보험"
            }
          }
        ]
      },
      {
        "id": "agency_and_unit_workplace",
        "title": "보험사무 대행기관 / 단위기관(영업소)",
        "controls": [
          {
            "kind": "text",
            "label": "보험사무 대행기관 번호",
            "value": ""
          },
          {
            "kind": "text",
            "label": "보험사무 대행기관 명칭",
            "value": ""
          },
          {
            "kind": "text",
            "label": "단위기관(영업소) 기호",
            "value": "000"
          },
          {
            "kind": "text",
            "label": "단위기관(영업소) 명칭",
            "value": "예시 주식회사"
          }
        ]
      },
      {
        "id": "application_header",
        "title": "작성정보 / 신청구분",
        "controls": [
          {
            "kind": "date",
            "label": "작성일",
            "value": {
              "raw": "20260914",
              "display": "2026-09-14"
            }
          },
          {
            "kind": "text",
            "label": "일련번호",
            "value": ""
          },
          {
            "kind": "checkbox",
            "label": "신청구분 전체",
            "value": "N"
          },
          {
            "kind": "checkbox",
            "label": "신청구분 국민연금",
            "value": "N"
          },
          {
            "kind": "checkbox",
            "label": "신청구분 건강보험",
            "value": "N"
          },
          {
            "kind": "checkbox",
            "label": "신청구분 고용보험",
            "value": "N"
          },
          {
            "kind": "checkbox",
            "label": "신청구분 산재보험",
            "value": "N"
          }
        ]
      },
      {
        "id": "person_lookup",
        "title": "대상자 입력",
        "controls": [
          {
            "kind": "split_text",
            "label": "주민등록번호",
            "value": ""
          },
          {
            "kind": "text",
            "label": "성명",
            "value": ""
          },
          {
            "kind": "text",
            "label": "건강보험증번호",
            "value": ""
          },
          {
            "kind": "checkbox",
            "label": "증번호 변경시 체크 후 입력해 주시기 바랍니다.",
            "value": "N"
          },
          {
            "kind": "checkbox",
            "label": "국민연금",
            "value": "0"
          },
          {
            "kind": "checkbox",
            "label": "건강보험",
            "value": "0"
          },
          {
            "kind": "checkbox",
            "label": "고용보험",
            "value": "0"
          },
          {
            "kind": "checkbox",
            "label": "산재보험",
            "value": "0"
          }
        ]
      },
      {
        "id": "national_pension_section",
        "title": "국민연금",
        "controls": [
          {
            "kind": "number_text",
            "label": "현재 기준소득월액",
            "value": ""
          },
          {
            "kind": "number_text",
            "label": "변경 후 기준소득월액",
            "value": ""
          },
          {
            "kind": "select",
            "label": "근로자 동의",
            "value": ""
          }
        ]
      },
      {
        "id": "health_section",
        "title": "건강보험",
        "controls": [
          {
            "kind": "month",
            "label": "보수월액 변경월",
            "value": ""
          },
          {
            "kind": "number_text",
            "label": "변경후보수월액",
            "value": ""
          },
          {
            "kind": "number_text",
            "label": "변경 후 건강보험료",
            "value": ""
          },
          {
            "kind": "number_text",
            "label": "변경 후 요양보험료",
            "value": ""
          }
        ]
      },
      {
        "id": "employment_section",
        "title": "고용보험",
        "controls": [
          {
            "kind": "month",
            "label": "보수월액 변경월",
            "value": ""
          },
          {
            "kind": "number_text",
            "label": "변경후월평균보수",
            "value": ""
          },
          {
            "kind": "select",
            "label": "변경사유",
            "value": ""
          }
        ]
      },
      {
        "id": "industrial_accident_section",
        "title": "산재보험",
        "controls": [
          {
            "kind": "month",
            "label": "보수월액 변경월",
            "value": ""
          },
          {
            "kind": "number_text",
            "label": "변경후월평균보수",
            "value": ""
          },
          {
            "kind": "select",
            "label": "변경사유",
            "value": ""
          }
        ]
      }
    ]
  },
  "workflow_step": "sent_document_detail_loaded",
  "detail_request": {
    "DOC_ID": "",
    "FIRM_SYM": "12345678",
    "EFIRM_SYM": "[REDACTED]",
    "WRT_CHASU": "20260730ZZ",
    "WRT_DUP_SEQ": "01",
    "UNIT_FIRM_SYM": "000",
    "DOC_ID_ATTEMPTS": [
      "",
      "BMAB_020"
    ],
    "efirm_sym_present": true,
    "selected_form_code": "BMAB_020"
  },
  "source_summary": {
    "mode": "http_main_no_xecure",
    "sql_ids": [
      "...",
      "...",
      "...",
      "...",
      "...",
      "...",
      "...",
      "..."
    ],
    "data_source": "upstream_response",
    "efirm_sym_source": "[REDACTED]",
    "bmab020_entry_url": "https://..."
  },
  "visible_fields": [
    {
      "key": "WRT_CHASU",
      "value": "20260730ZZ"
    },
    {
      "key": "WRT_DUP_SEQ",
      "value": "01"
    },
    {
      "key": "FIRM_SYM",
      "value": "12345678"
    },
    {
      "key": "UNIT_FIRM_SYM",
      "value": "000"
    },
    {
      "key": "JUMIN_NO",
      "value": "000000*******"
    },
    {
      "key": "JUNG_NO",
      "value": "12345678901"
    },
    {
      "key": "NM",
      "value": "홍길동"
    },
    {
      "key": "RPT_DT",
      "value": "20260730"
    },
    {
      "key": "USER_ID",
      "value": "user01"
    },
    {
      "key": "NHIC_BSLC_MGMT_NO",
      "value": "12345678901"
    },
    {
      "key": "NPC_BSLC_MGMT_NO",
      "value": "12345678901"
    },
    {
      "key": "HRDK_BSLC_MGMT_NO",
      "value": "12345678901"
    },
    {
      "key": "KLWC_BSLC_MGMT_NO",
      "value": "12345678901"
    },
    {
      "key": "HRDK_ASCT_NAME",
      "value": ""
    },
    {
      "key": "HRDK_ASCT_SYMB",
      "value": ""
    },
    {
      "key": "NHIC_CTRL_BROF_CD",
      "value": "0131"
    },
    {
      "key": "NPC_CTRL_BROF_CD",
      "value": "1124"
    },
    {
      "key": "HRDK_CTRL_BROF_CD",
      "value": "2040"
    },
    {
      "key": "KLWC_CTRL_BROF_CD",
      "value": "2040"
    },
    {
      "key": "BSLC_TELNO1",
      "value": "123"
    },
    {
      "key": "BSLC_TELNO2",
      "value": "1234"
    },
    {
      "key": "BSLC_TELNO3",
      "value": "1234"
    },
    {
      "key": "BSLC_FAXNO1",
      "value": ""
    },
    {
      "key": "BSLC_FAXNO2",
      "value": ""
    },
    {
      "key": "BSLC_FAXNO3",
      "value": ""
    },
    {
      "key": "CHRG_PRSN_HPNO1",
      "value": ""
    },
    {
      "key": "CHRG_PRSN_HPNO2",
      "value": ""
    },
    {
      "key": "CHRG_PRSN_HPNO3",
      "value": ""
    },
    {
      "key": "REPR_NM",
      "value": "홍길동"
    },
    {
      "key": "REPR_JUMIN_NO",
      "value": "000000*******"
    },
    {
      "key": "UNIT_BSLC_SYMB",
      "value": "000"
    },
    {
      "key": "BSBR_NAME",
      "value": "예시 주식회사"
    },
    {
      "key": "INSU_ACPT_YN_YG",
      "value": "N"
    },
    {
      "key": "INSU_ACPT_YN_GG",
      "value": "Y"
    },
    {
      "key": "INSU_ACPT_YN_GY",
      "value": "Y"
    },
    {
      "key": "INSU_ACPT_YN_SJ",
      "value": "Y"
    },
    {
      "key": "FEE_MM_AMT_NPC",
      "value": ""
    },
    {
      "key": "FEE_MM_AMT_NHIC",
      "value": "2216667"
    },
    {
      "key": "FEE_MM_AMT_INSPS",
      "value": "2216667"
    },
    {
      "key": "FEE_MM_AMT_KLWC",
      "value": "2216667"
    },
    {
      "key": "BF_FEE_MM_AMT_NPC",
      "value": ""
    },
    {
      "key": "FEE_CHG_YYYYMM_NHIC",
      "value": "202607"
    },
    {
      "key": "MBR_AGRE_YN",
      "value": ""
    },
    {
      "key": "CHNG_CD_INSPS",
      "value": "1"
    },
    {
      "key": "CHNG_CD_KLWC",
      "value": "1"
    },
    {
      "key": "JOB_STBL_RQST_YN",
      "value": "N"
    },
    {
      "key": "FEE_CHG_YYYYMM_INSPS",
      "value": "202607"
    },
    {
      "key": "FEE_CHG_YYYYMM_KLWC",
      "value": "202607"
    },
    {
      "key": "DOCID",
      "value": "BMAB_020"
    },
    {
      "key": "_processing_result_source",
      "value": "WETC_101S19"
    },
    {
      "key": "_processing_result_dataset",
      "value": "..."
    },
    {
      "key": "_processing_result_message",
      "value": "보수변경이 정상처리되었습니다"
    }
  ],
  "screen_sections": [
    {
      "id": "workplace_management_numbers",
      "title": "사업장관리번호(사업장명)",
      "controls": [
        {
          "kind": "readonly_text",
          "label": "건강보험",
          "value": {
            "code": "12345678901",
            "name": "예시 주식회사",
            "label": "건강보험"
          }
        },
        {
          "kind": "select_and_readonly_text",
          "label": "국민연금",
          "value": {
            "code": "12345678901",
            "name": "예시 주식회사",
            "label": "국민연금"
          }
        },
        {
          "kind": "select_and_readonly_text",
          "label": "고용보험",
          "value": {
            "code": "12345678901",
            "name": "예시 주식회사",
            "label": "고용보험"
          }
        },
        {
          "kind": "select_and_readonly_text",
          "label": "산재보험",
          "value": {
            "code": "12345678901",
            "name": "예시 주식회사",
            "label": "산재보험"
          }
        }
      ]
    },
    {
      "id": "agency_and_unit_workplace",
      "title": "보험사무 대행기관 / 단위기관(영업소)",
      "controls": [
        {
          "kind": "text",
          "label": "보험사무 대행기관 번호",
          "value": ""
        },
        {
          "kind": "text",
          "label": "보험사무 대행기관 명칭",
          "value": ""
        },
        {
          "kind": "text",
          "label": "단위기관(영업소) 기호",
          "value": "000"
        },
        {
          "kind": "text",
          "label": "단위기관(영업소) 명칭",
          "value": "예시 주식회사"
        }
      ]
    },
    {
      "id": "application_header",
      "title": "작성정보 / 신청구분",
      "controls": [
        {
          "kind": "date",
          "label": "작성일",
          "value": {
            "raw": "20260914",
            "display": "2026-09-14"
          }
        },
        {
          "kind": "text",
          "label": "일련번호",
          "value": ""
        },
        {
          "kind": "checkbox",
          "label": "신청구분 전체",
          "value": "N"
        },
        {
          "kind": "checkbox",
          "label": "신청구분 국민연금",
          "value": "N"
        },
        {
          "kind": "checkbox",
          "label": "신청구분 건강보험",
          "value": "N"
        },
        {
          "kind": "checkbox",
          "label": "신청구분 고용보험",
          "value": "N"
        },
        {
          "kind": "checkbox",
          "label": "신청구분 산재보험",
          "value": "N"
        }
      ]
    },
    {
      "id": "person_lookup",
      "title": "대상자 입력",
      "controls": [
        {
          "kind": "split_text",
          "label": "주민등록번호",
          "value": ""
        },
        {
          "kind": "text",
          "label": "성명",
          "value": ""
        },
        {
          "kind": "text",
          "label": "건강보험증번호",
          "value": ""
        },
        {
          "kind": "checkbox",
          "label": "증번호 변경시 체크 후 입력해 주시기 바랍니다.",
          "value": "N"
        },
        {
          "kind": "checkbox",
          "label": "국민연금",
          "value": "0"
        },
        {
          "kind": "checkbox",
          "label": "건강보험",
          "value": "0"
        },
        {
          "kind": "checkbox",
          "label": "고용보험",
          "value": "0"
        },
        {
          "kind": "checkbox",
          "label": "산재보험",
          "value": "0"
        }
      ]
    },
    {
      "id": "national_pension_section",
      "title": "국민연금",
      "controls": [
        {
          "kind": "number_text",
          "label": "현재 기준소득월액",
          "value": ""
        },
        {
          "kind": "number_text",
          "label": "변경 후 기준소득월액",
          "value": ""
        },
        {
          "kind": "select",
          "label": "근로자 동의",
          "value": ""
        }
      ]
    },
    {
      "id": "health_section",
      "title": "건강보험",
      "controls": [
        {
          "kind": "month",
          "label": "보수월액 변경월",
          "value": ""
        },
        {
          "kind": "number_text",
          "label": "변경후보수월액",
          "value": ""
        },
        {
          "kind": "number_text",
          "label": "변경 후 건강보험료",
          "value": ""
        },
        {
          "kind": "number_text",
          "label": "변경 후 요양보험료",
          "value": ""
        }
      ]
    },
    {
      "id": "employment_section",
      "title": "고용보험",
      "controls": [
        {
          "kind": "month",
          "label": "보수월액 변경월",
          "value": ""
        },
        {
          "kind": "number_text",
          "label": "변경후월평균보수",
          "value": ""
        },
        {
          "kind": "select",
          "label": "변경사유",
          "value": ""
        }
      ]
    },
    {
      "id": "industrial_accident_section",
      "title": "산재보험",
      "controls": [
        {
          "kind": "month",
          "label": "보수월액 변경월",
          "value": ""
        },
        {
          "kind": "number_text",
          "label": "변경후월평균보수",
          "value": ""
        },
        {
          "kind": "select",
          "label": "변경사유",
          "value": ""
        }
      ]
    }
  ],
  "support_datasets": {
    "...": {
      "rows": [],
      "columns": []
    },
    "...2": {
      "rows": [
        {
          "MSG": "",
          "EXEC": "Y",
          "FAIL": "",
          "TYPE": "N",
          "SQL_ID": "...",
          "PAGE_NO": "0",
          "TX_NAME": "",
          "BIZ_NAME": "",
          "EXEC_CNT": "0",
          "FAIL_MSG": "",
          "READ_ALL": "",
          "EXEC_TYPE": "B",
          "PAGE_SIZE": "0",
          "USE_INPUT": "",
          "USE_ORDER": "",
          "KEY_SQL_ID": "",
          "KEY_ZERO_LEN": "0",
          "DELETE_SQL_ID": "",
          "INSERT_SQL_ID": "",
          "KEY_INCREMENT": "0",
          "UPDATE_SQL_ID": "",
          "CALLBACK_SQL_ID": "",
          "SAVE_FLAG_COLUMN": ""
        }
      ],
      "columns": [
        "TX_NAME",
        "TYPE",
        "SQL_ID",
        "KEY_SQL_ID",
        "KEY_INCREMENT",
        "CALLBACK_SQL_ID",
        "INSERT_SQL_ID",
        "UPDATE_SQL_ID",
        "DELETE_SQL_ID",
        "SAVE_FLAG_COLUMN",
        "USE_INPUT",
        "USE_ORDER",
        "KEY_ZERO_LEN",
        "BIZ_NAME",
        "PAGE_NO",
        "PAGE_SIZE",
        "READ_ALL",
        "EXEC_TYPE",
        "EXEC",
        "FAIL",
        "FAIL_MSG",
        "EXEC_CNT",
        "MSG"
      ]
    }
  },
  "processing_result": {
    "rows": [
      {
        "RMK_1": "2216667",
        "RMK_2": "202607",
        "RMK_3": "",
        "RMK_4": "12345678901",
        "RMK_5": "01",
        "RMK_6": "",
        "RMK_7": "",
        "RMK_8": "BMAB_020_01",
        "DOC_ID": "BMAB_020",
        "DOC_NM": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
        "SUB_NM": "",
        "TGT_NM": "홍길동",
        "PROC_DT": "20260730",
        "PROG_NM": "정상 처리 되었습니다.(C)",
        "FIRM_SYM": "12345678",
        "SINGO_NM": "홍길동",
        "SUB_RRNO": "",
        "PROG_TYPE": "C",
        "WRT_CHASU": "20260730ZZ",
        "ACPT_ORG_CD": "GG",
        "RTN_ERR_MSG": "보수변경이 정상처리되었습니다",
        "WRT_DUP_SEQ": "01",
        "BSLC_MGMT_NO": "12345678901",
        "RTN_ERR_CODE": "",
        "PUBAP_ACPT_NO": "EGN12345678901234",
        "UNIT_FIRM_SYM": "000"
      }
    ],
    "sql_id": "...",
    "dataset": "...",
    "request": {
      "GUBUN": "C",
      "YKIHO": "wfnWmE85zPOelR3cgwM1ajjrAJNRZJHQMxock5TuFE8=",
      "DOC_ID": "BMAB_020",
      "FIRM_SYM": "12345678",
      "WRT_CHASU": "20260730ZZ",
      "ACPT_ORG_CD": "GG",
      "WRT_DUP_SEQ": "01",
      "UNIT_FIRM_SYM": "000"
    },
    "row_count": 1,
    "program_id": "..."
  },
  "bootstrap_datasets": {},
  "insurance_sections": {
    "건강보험": {
      "checked": "0",
      "salary_change_month": "",
      "changed_health_premium": "",
      "changed_salary_monthly_amount": "",
      "changed_long_term_care_premium": ""
    },
    "고용보험": {
      "checked": "0",
      "change_reason": "",
      "salary_change_month": "",
      "changed_monthly_average_wage": ""
    },
    "국민연금": {
      "checked": "0",
      "worker_agreement": "",
      "changed_standard_monthly_income": "",
      "current_standard_monthly_income": ""
    },
    "산재보험": {
      "checked": "0",
      "change_reason": "",
      "salary_change_month": "",
      "changed_monthly_average_wage": ""
    }
  },
  "transport_evidence": {
    "url": "https://...",
    "support": {
      "url": "https://...",
      "status_code": 200,
      "content_type": "text/html; charset=UTF-8",
      "request_body_len": 2088,
      "response_body_len": 3376
    },
    "bootstrap": {
      "url": "https://...",
      "status_code": 200,
      "content_type": "text/html; charset=UTF-8",
      "request_body_len": 2098,
      "response_body_len": 138
    },
    "processing": {
      "url": "https://...",
      "status_code": 200,
      "content_type": "text/html; charset=UTF-8",
      "request_body_len": 2131,
      "response_body_len": 1459
    },
    "status_code": 200,
    "content_type": "text/html; charset=UTF-8",
    "bmab020_entry": {
      "entry_url": "https://...",
      "index_url": "https://...",
      "entry_final_url": "https://...",
      "entry_status_code": 200,
      "entry_content_length": 5421,
      "index_content_length": 11946
    },
    "efirm_evidence": {
      "source": "request_or_cached_context",
      "efirm_sym_present": true
    },
    "request_body_len": 2079,
    "response_body_len": 2181
  },
  "processing_datasets": {
    "...": {
      "rows": [
        {
          "RMK_1": "2216667",
          "RMK_2": "202607",
          "RMK_3": "\u0003",
          "RMK_4": "12345678901",
          "RMK_5": "01",
          "RMK_6": "\u0003",
          "RMK_7": "\u0003",
          "RMK_8": "BMAB_020_01",
          "DOC_ID": "BMAB_020",
          "DOC_NM": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
          "SUB_NM": "\u0003",
          "TGT_NM": "홍길동",
          "PROC_DT": "20260730",
          "PROG_NM": "정상 처리 되었습니다.(C)",
          "FIRM_SYM": "12345678",
          "SINGO_NM": "홍길동",
          "SUB_RRNO": "***",
          "PROG_TYPE": "C",
          "WRT_CHASU": "20260730ZZ",
          "ACPT_ORG_CD": "GG",
          "RTN_ERR_MSG": "보수변경이 정상처리되었습니다",
          "WRT_DUP_SEQ": "01",
          "BSLC_MGMT_NO": "12345678901",
          "RTN_ERR_CODE": "\u0003",
          "PUBAP_ACPT_NO": "EGN12345678901234",
          "UNIT_FIRM_SYM": "000"
        }
      ],
      "columns": [
        "WRT_CHASU",
        "WRT_DUP_SEQ",
        "PUBAP_ACPT_NO",
        "ACPT_ORG_CD",
        "BSLC_MGMT_NO",
        "FIRM_SYM",
        "UNIT_FIRM_SYM",
        "DOC_ID",
        "DOC_NM",
        "SINGO_NM",
        "TGT_RRNO",
        "TGT_NM",
        "SUB_RRNO",
        "SUB_NM",
        "PROG_TYPE",
        "PROC_DT",
        "RTN_ERR_CODE",
        "RTN_ERR_MSG",
        "RMK_1",
        "RMK_2",
        "RMK_3",
        "RMK_4",
        "RMK_5",
        "RMK_6",
        "RMK_7",
        "RMK_8",
        "PROG_NM"
      ]
    },
    "...2": {
      "rows": [
        {
          "MSG": "",
          "EXEC": "Y",
          "FAIL": "",
          "TYPE": "N",
          "SQL_ID": "...",
          "PAGE_NO": "0",
          "TX_NAME": "",
          "BIZ_NAME": "",
          "EXEC_CNT": "1",
          "FAIL_MSG": "",
          "READ_ALL": "",
          "EXEC_TYPE": "B",
          "PAGE_SIZE": "0",
          "USE_INPUT": "",
          "USE_ORDER": "",
          "KEY_SQL_ID": "",
          "KEY_ZERO_LEN": "0",
          "DELETE_SQL_ID": "",
          "INSERT_SQL_ID": "",
          "KEY_INCREMENT": "0",
          "UPDATE_SQL_ID": "",
          "CALLBACK_SQL_ID": "",
          "SAVE_FLAG_COLUMN": ""
        }
      ],
      "columns": [
        "TX_NAME",
        "TYPE",
        "SQL_ID",
        "KEY_SQL_ID",
        "KEY_INCREMENT",
        "CALLBACK_SQL_ID",
        "INSERT_SQL_ID",
        "UPDATE_SQL_ID",
        "DELETE_SQL_ID",
        "SAVE_FLAG_COLUMN",
        "USE_INPUT",
        "USE_ORDER",
        "KEY_ZERO_LEN",
        "BIZ_NAME",
        "PAGE_NO",
        "PAGE_SIZE",
        "READ_ALL",
        "EXEC_TYPE",
        "EXEC",
        "FAIL",
        "FAIL_MSG",
        "EXEC_CNT",
        "MSG"
      ]
    }
  },
  "support_detail_rows": [],
  "implementation_status": "http_sent_document_detail_loaded",
  "detail_source_attempts": [
    {
      "gubun": "C",
      "sql_id": "...",
      "dataset": "...",
      "success": true,
      "strategy": "wetc101_processing_detail",
      "program_id": "...",
      "acpt_org_cd": "GG",
      "response_dataset_names": [
        "...",
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 1,
        "...2": 1
      }
    },
    {
      "success": true,
      "strategy": "bmab020_open_page_prime",
      "entry_url": "https://...",
      "index_content_length": 11116
    },
    {
      "sql_id": "...",
      "success": true,
      "strategy": "bmab020_init_bmcz_260s04",
      "program_id": "...",
      "response_dataset_names": [
        "...",
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 1,
        "...2": 1
      }
    },
    {
      "sql_id": "...",
      "success": true,
      "strategy": "bmab020_get_base_data",
      "program_id": "...",
      "response_dataset_names": [
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 47
      }
    },
    {
      "sql_id": "...",
      "success": true,
      "strategy": "bmab020_init_bmcz_020s08",
      "program_id": "...",
      "response_dataset_names": [
        "...",
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 1,
        "...2": 1
      }
    },
    {
      "sql_id": "...",
      "success": true,
      "strategy": "bmab020_init_wetz_910s01",
      "program_id": "...",
      "response_dataset_names": [
        "...",
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 3,
        "...2": 1
      }
    },
    {
      "cmd": "LogIns",
      "action": "COMMONAction",
      "success": true,
      "strategy": "bmab020_commonaction_logins",
      "program_id": "...",
      "efirm_sym_present": true,
      "response_dataset_names": [],
      "response_dataset_row_counts": {}
    },
    {
      "doc_id": "",
      "sql_id": "...",
      "success": true,
      "strategy": "bmab020_s02_after_logins",
      "program_id": "...",
      "efirm_sym_present": true,
      "response_dataset_names": [
        "...",
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 1,
        "...2": 1
      }
    },
    {
      "sql_id": "...",
      "success": true,
      "strategy": "bmab020_support_wetz_600s03",
      "program_id": "...",
      "response_dataset_names": [
        "...",
        "..."
      ],
      "response_dataset_row_counts": {
        "...": 0,
        "...2": 1
      }
    }
  ],
  "processing_detail_rows": [
    {
      "RMK_1": "2216667",
      "RMK_2": "202607",
      "RMK_3": "",
      "RMK_4": "12345678901",
      "RMK_5": "01",
      "RMK_6": "",
      "RMK_7": "",
      "RMK_8": "BMAB_020_01",
      "DOC_ID": "BMAB_020",
      "DOC_NM": "4대보험 기준소득월액/보수월액/월평균보수 변경신청서",
      "SUB_NM": "",
      "TGT_NM": "홍길동",
      "PROC_DT": "20260730",
      "PROG_NM": "정상 처리 되었습니다.(C)",
      "FIRM_SYM": "12345678",
      "SINGO_NM": "홍길동",
      "SUB_RRNO": "",
      "PROG_TYPE": "C",
      "WRT_CHASU": "20260730ZZ",
      "ACPT_ORG_CD": "GG",
      "RTN_ERR_MSG": "보수변경이 정상처리되었습니다",
      "WRT_DUP_SEQ": "01",
      "BSLC_MGMT_NO": "12345678901",
      "RTN_ERR_CODE": "",
      "PUBAP_ACPT_NO": "EGN12345678901234",
      "UNIT_FIRM_SYM": "000"
    }
  ],
  "response_dataset_names": [
    "...",
    "..."
  ],
  "response_dataset_row_counts": {
    "...": 1,
    "...2": 1
  },
  "synthesized": false,
  "synthesized_reason": null
}
순번오류 코드발생 조건
RESOURCE_NOT_FOUND행 없음 — 조건에 맞는 행을 찾지 못했습니다. error.message 에 목록 조회로 항목을 먼저 확인하라는 안내가 오고, 다시 시도해도 같은 결과이니 목록 조회 결과의 row_index 나 row_key 로 다시 요청합니다.
PROVIDER_VALIDATION_ERROR양식 미지원 — 상세 조회는 BMAB_020 양식만 지원합니다.
VALIDATION_INVALID_FIELD키 부족 — 상세 조회에 필요한 값(WRT_CHASU · WRT_DUP_SEQ · FIRM_SYM)을 요청과 선택한 행에서 찾지 못했습니다.

2. 문서함 보낸문서 목록 조회nhis_edi.document_box.sent_documents.list

MCP 도구 이름 nhis_edi__document_box__sent_documents__list

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.document_box.sent_documents.list이 API 고정값 (기본값)

예시 : nhis_edi.document_box.sent_documents.list

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

form_codestring-N양식 DOCID. 미입력 시 00000000(전체)
form_namestring-N양식명으로 form_code 자동 해석
gubunstring-N문서 구분. 미입력 시 0(전체)
ykihostring-N요양기관기호(EFIRM_SYM/YKIHO)
jumin_nostring-N주민등록번호 13자리로 목록을 좁힙니다. 이 값은 params 에 입력하지 않고 encrypted_fields.jumin_no 에 공개키로 암호화해 입력합니다. params 에 입력하면 작업을 만들지 않고 400 VALIDATION_INVALID_FIELD 로 거절합니다
include_form_optionsboolean-N양식 옵션 목록 포함 여부
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.document_box.sent_documents.list",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • list_rows·form_options·category_options·filters를 확인합니다.
  • 아래 표의 list_rows[] 줄은 엑셀 파일(params 의 output_formats 에 ["xlsx"])의 열로 내보내는 칸이고, 열 이름은 엑셀 파일 맨 윗줄의 머리글입니다.
  • 아래 표의 줄은 엑셀로 내보내는 열이라 응답 행의 칸 전부가 아닐 수 있습니다.
순번변수명타입설명
list_rowsarray보낸문서 행 배열
list_rows[].categorystring서식 분류
list_rows[].document_namestring신고서 이름
list_rows[].form_codestring서식코드
list_rows[].submitted_datestring제출 일자
list_rows[].submitted_timestring제출 시각
list_rows[].wrt_chasustring작성차수
list_rows[].wrt_dup_seqstring작성중복순번
list_rows[].receipt_countnumber접수 건수
list_rows[].jumin_countnumber대상 인원 수
list_rows[].normal_counts.four_major_commonnumber정상 4대공통
list_rows[].normal_counts.healthnumber정상 건강
list_rows[].normal_counts.national_pensionnumber정상 국민연금
list_rows[].normal_counts.employmentnumber정상 고용
list_rows[].normal_counts.industrial_accidentnumber정상 산재
list_rows[].return_counts.four_major_commonnumber반송 4대공통
list_rows[].return_counts.healthnumber반송 건강
list_rows[].return_counts.national_pensionnumber반송 국민연금
list_rows[].return_counts.employmentnumber반송 고용
list_rows[].return_counts.industrial_accidentnumber반송 산재
list_rows[].ban_counts.organizationnumber반려 기관
list_rows[].ban_counts.healthnumber반려 건강
list_rows[].ban_counts.national_pensionnumber반려 국민연금
list_rows[].ban_counts.employmentnumber반려 고용
list_rows[].ban_counts.industrial_accidentnumber반려 산재
list_rows[].program_status_codestring처리 상태
list_rows[].attachment_file_presentboolean첨부파일 유무 (값: true = Y, false = N)
form_optionsarray양식 옵션 배열
category_optionsarray카테고리 옵션 배열
filtersobject필터 정보 객체
resolved_selectionobject실제로 선택된 문서 값
row_countnumber반환 행 수
response_dataset_row_countsobject데이터셋별 행 수
transport_evidenceobject기관 통신 근거(요청·응답 URL, 크기, 상태 코드)
json
// result.data
{
  "list_rows": [
    {
      "row_index": 0,
      "row_key": "...",
      "category": "...",
      "category_code": "...",
      "wrt_chasu": "...",
      "wrt_dup_seq": "...",
      "sequence_no": "...",
      "form_code": "...",
      "document_id": "...",
      "form_name": "...",
      "document_name": "...",
      "submitted_date": "...",
      "submitted_time": "...",
      "submitted_at": "...",
      "receipt_count": 0,
      "normal_counts": {},
      "return_counts": {},
      "ban_counts": {},
      "program_status_code": "...",
      "attachment_file_present": false,
      "jumin_count": 0,
      "table_name": "...",
      "firm_sym": "...",
      "unit_firm_sym": "...",
      "ykiho": "...",
      "detail_keys": {},
      "detail_request": {},
      "row_text": "...",
      "raw": {}
    }
  ],
  "form_options": [],
  "category_options": [],
  "filters": {},
  "resolved_selection": {},
  "row_count": 1,
  "response_dataset_row_counts": {},
  "transport_evidence": {}
}
순번오류 코드발생 조건
PROVIDER_UNAVAILABLE사업장 정보 없음 — 세션에서 사업장 정보를 불러오지 못했습니다.
PROVIDER_VALIDATION_ERROR양식명 오류 — form_name 에 해당하는 양식을 찾지 못했습니다.