자격 - 국민건강보험공단 EDI
1. 자격취득 신고 입력 초안 검증nhis_ edi. qualification. acquisition. draft_ validate
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
입사자 성명과 주민등록번호, 고른 보험별 취득 값, 피부양자 행을 넣으면 빠진 항목과 오류, 첨부서류 안내, 대상자 등록 가능 여부를 돌려줍니다.
- 로그인을 먼저 호출합니다. 이 API 는 세션만 있으면 되고 업무 화면 진입은 필요하지 않습니다. [국민건강보험공단 EDI 로그인]
- safety.input_only 는 true 이고 target_register_executed, temporary_save_executed, submit_executed 는 모두 false 입니다.
- JGBA_020I_1/I_2 는 blocked_transaction_cmds 에만 기록되며 실행되지 않습니다.
- target_register_gate.can_submit_report 는 늘 false 입니다.
- params 는 빈 객체로 보내도 호출됩니다. 비워 보내면 채우지 않은 필수 항목이 missing_required_fields 로 돌아옵니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
- 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| selected_ | array | N | 선택한 보험 구분. 예: national_pension, health_insurance, employment_insurance, workers_compensation | |
| applicant_ | string | N | 성명 | |
| resident_ | string | N | 주민등록번호 | |
| nationality_ | string | N | 국적 코드 | |
| stay_ | string | N | 체류자격 코드 | |
| representative_ | string | N | 대표자 여부 | |
| unit_ | string | N | 단위기관(영업소) 기호 | |
| unit_ | string | N | 단위기관(영업소) 명칭 | |
| agency_ | string | N | 보험사무 대행기관 번호 | |
| agency_ | string | N | 보험사무 대행기관 명칭 | |
| national_ | object | N | 국민연금 | |
| national_ | string | number | N | 국민연금 소득월액 생략 시 기본값: null | |
| national_ | string | N | 국민연금 취득일 생략 시 기본값: null | |
| national_ | string | N | 국민연금 취득부호 생략 시 기본값: null | |
| national_ | string | N | 취득월 납부 여부 생략 시 기본값: null | |
| national_ | string | N | 특수직종 코드 생략 시 기본값: null | |
| national_ | string | N | 직역연금부호 생략 시 기본값: null | |
| national_ | string | N | 소득월액 차이 확인 사유 생략 시 기본값: null | |
| health_ | object | N | 건강보험 | |
| health_ | string | number | N | 건강보험 보수월액 생략 시 기본값: null | |
| health_ | string | N | 건강보험 취득일 생략 시 기본값: null | |
| health_ | string | N | 건강보험 취득부호 생략 시 기본값: null | |
| health_ | string | N | 피부양자 신청 여부 생략 시 기본값: null | |
| health_ | string | N | 보험료 감면 코드 생략 시 기본값: null | |
| health_ | string | N | 회계/계정 구분 코드 생략 시 기본값: null | |
| health_ | string | N | 직종부호 생략 시 기본값: null | |
| health_ | string | N | 건강보험증 발송 방식 생략 시 기본값: null | |
| employment_ | object | N | 고용보험 | |
| employment_ | string | number | N | 고용보험 월평균보수 생략 시 기본값: null | |
| employment_ | string | N | 고용보험 취득일 생략 시 기본값: null | |
| employment_ | string | N | 고용보험 직종부호 생략 시 기본값: null | |
| employment_ | string | number | N | 1주 소정근로시간 생략 시 기본값: null | |
| employment_ | string | N | 계약직 여부 생략 시 기본값: null | |
| employment_ | string | N | 계약종료월 생략 시 기본값: null | |
| employment_ | string | N | 보험료 부과구분 부호 생략 시 기본값: null | |
| employment_ | string | N | 보험료 부과구분 사유 생략 시 기본값: null | |
| employment_ | string | N | 비고 코드 생략 시 기본값: null | |
| employment_ | string | N | 일자리안정자금 신청 여부 생략 시 기본값: null | |
| workers_ | object | N | 산재보험 | |
| workers_ | string | number | N | 산재보험 월평균보수 생략 시 기본값: null | |
| workers_ | string | N | 산재보험 취득일 생략 시 기본값: null | |
| workers_ | string | N | 산재보험 직종부호 생략 시 기본값: null | |
| workers_ | string | number | N | 1주 소정근로시간 생략 시 기본값: null | |
| workers_ | string | N | 계약직 여부 생략 시 기본값: null | |
| workers_ | string | N | 계약종료월 생략 시 기본값: null | |
| workers_ | string | N | 보험료 부과구분 부호 생략 시 기본값: null | |
| workers_ | string | N | 보험료 부과구분 사유 생략 시 기본값: null | |
| workers_ | string | N | 비고 코드 생략 시 기본값: null | |
| dependents | array | N | 피부양자 입력 행 | |
| dependents[]. | string | N | 피부양자 성명 생략 시 기본값: null | |
| dependents[]. | string | N | 피부양자 주민등록번호 생략 시 기본값: null | |
| dependents[]. | string | N | 피부양자 관계 코드 생략 시 기본값: null | |
| dependents[]. | string | N | 피부양자 국적 코드 생략 시 기본값: null | |
| dependents[]. | string | N | 피부양자 체류자격 코드 생략 시 기본값: null | |
| dependents[]. | string | N | 피부양자 체류 시작일 생략 시 기본값: null | |
| dependents[]. | string | N | 피부양자 체류 종료일 생략 시 기본값: null | |
| dependents[]. | string | N | 장애인/국가유공자 종류 생략 시 기본값: null | |
| dependents[]. | string | N | 장애 등급 생략 시 기본값: null | |
| dependents[]. | string | N | 장애 등록일 생략 시 기본값: null | |
| dependents[]. | string | N | 첨부서류 여부 생략 시 기본값: null |
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: draft_validate-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "nhis_edi",
"action": "nhis_edi.qualification.acquisition.draft_validate",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- missing_required_fields · field_errors · warnings 로 고칠 항목을, target_register_gate.ready 로 대상자등록 전 준비가 끝났는지 확인합니다.implementation_status=implemented_input_only_draft_validation.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| required_ | array | 화면 규칙 기준 필수 입력 항목 배열 (field_key · label · section · required_when) | |
| missing_ | array | 빠진 필수 입력 항목 배열 (required_fields 와 같은 모양) | |
| field_ | array | 입력 형식 오류 배열 | |
| warnings | array | 주의 메시지 배열 | |
| screen_ | array | 화면 확인 메모 배열 | |
| field_ | object | 입력 키와 화면 필드의 대응 맵 (화면 대응이 확인되기 전에는 빈 객체) | |
| required_ | array | 필요한 첨부 서류 배열 | |
| dependent_ | object | 피부양자 요건 객체 (required · reason) | |
| normalized_ | object | 정규화한 입력값 객체 | |
| draft_ | object | 대상자 행 미리보기 객체 | |
| dependent_ | array | 피부양자 행 미리보기 배열 | |
| target_ | object | 대상자등록 판정 객체 (ready · blocking_issue_count · can_register_target · can_submit_report=false · blocked_reason) | |
| safety | object | 안전 플래그 객체 (input_only=true) | |
| business_ | object | 사업장 컨텍스트 객체 | |
| form_ | string | 기관 화면 폼 id | |
| document_ | string | 기관 화면 문서 id | |
| default_ | object | 화면 기본값 | |
| selected_ | array | 선택된 보험 종류 | |
| enabled_ | array | 입력할 수 있는 구역 | |
| script_ | string | 화면 XFDL JavaScript URL | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 |
// result.data
{
"required_fields": [],
"missing_required_fields": [],
"field_errors": [],
"warnings": [],
"required_attachments": [],
"dependent_requirement": {},
"normalized_input": {},
"draft_row_preview": {},
"dependent_rows_preview": [],
"target_register_gate": {},
"safety": {},
"business_context": {},
"form_id": "...",
"document_id": "...",
"default_values": {},
"selected_insurances": [],
"enabled_sections": [],
"script_url": "...",
"source_url": "...",
"target_ready": true
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
2. 자격취득 신고 입력 서식 조회nhis_ edi. qualification. acquisition. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연동 계정 하나로 자격취득 신고서의 입력 항목 70개와, 대상자와 네 보험, 피부양자 등 구역 아홉의 목록을 받습니다. 신고 저장·전송은 하지 않습니다.
- 로그인을 먼저 호출합니다. 이 API 는 세션만 있으면 되고 업무 화면 진입은 필요하지 않습니다. [국민건강보험공단 EDI 로그인]
- safety.init_only=true, mutating_actions_executed=false. JGBA_020I_1/I_2(임시저장·전송)는 blocked_transactions에만 기록되며 실행되지 않습니다.
- params 는 빈 객체로 보내도 호출됩니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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: init-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "nhis_edi",
"action": "nhis_edi.qualification.acquisition.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- fields·sections·grid·dependent_grid·blocked_transactions·safety·business_context를 확인합니다.implementation_status=implemented_init_form_contract_only.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| fields | array | 입력 필드 정의 배열 | |
| sections | array | 섹션(탭·그룹) 정의 배열 | |
| grid | object | 그리드 행 데이터 | |
| dependent_ | object | 종속 그리드 데이터 | |
| blocked_ | array | 차단된 트랜잭션 목록 (실행 안 됨) | |
| safety | object | 안전 플래그 객체 (init_only=true) | |
| business_ | object | 사업장 컨텍스트 객체 | |
| form_ | string | 기관 화면 폼 id | |
| document_ | string | 기관 화면 문서 id | |
| default_ | object | 화면 기본값 | |
| datasets | array | 기관 응답 데이터셋 원본 | |
| dataset_ | number | 데이터셋 수 | |
| field_ | number | 입력 필드 수 | |
| combo_ | array | 화면이 부르는 콤보 조회 목록 | |
| init_ | array | 화면 초기 트랜잭션 목록 | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 |
// result.data
{
"grid": {
"name": "Grid0",
"columns": [
"NAME",
"RRNO",
"NATION_CD",
"STAY_CRTF_CD",
"REPPS_YN",
"MTH_INCM_AMT_NPC",
"OBTN_MTH_PAY_YN_NPC",
"CRTF_OBTN_CD_NPC",
"CRTF_OBTN_DT_NPC",
"SPCL_OBPTYP_CD_NPC",
"SPQU_PNSN_CD_NPC",
"INCM_DIFF_RSN_NPC",
"NHIC_FEE_MTH_AMT_NPC",
"FEE_MTH_AMT",
"CRTF_OBTN_CD_NHIC",
"CRTF_OBTN_DT_NHIC",
"PSSP_OBTN_YN_NHIC",
"ISUFE_RDCT_DT_NHIC",
"ACNT_NAME_CD_NHIC",
"OCPTYP_CD_NHIC",
"NHIC_CARD_BSLC_SEND_YN",
"ARMY_NO",
"CRTF_OBTN_DT_HRDK",
"MTH_AVRG_SLRY_HRDK",
"OCPTYP_CD_HRDK",
"WEEK_WORK_TIME_HRDK",
"CNTR_WRKR_YN",
"CNTR_END_YYMM",
"INSUFE_LEVY_CD_HRDK",
"INSUFE_LEVY_RSN_HRDK",
"ADD_MSG_CD_HRDK",
"CRTF_OBTN_DT_KLWC",
"MTH_AVRG_SLRY_KLWC",
"OCPTYP_CD_KLWC",
"WEEK_WORK_TIME_KLWC",
"CNTR_WRKR_YN_KLWC",
"CNTR_END_YYMM_KLWC",
"INSUFE_LEVY_CD_KLWC",
"INSUFE_LEVY_RSN_KLWC",
"ADD_MSG_CD_KLWC",
"ATT_FILE_CNT",
"FRNR_NATL_CD_NHIC",
"PSSP_RRNO",
"PSSP_NAME",
"PSSP_RELT",
"OBST_MERT_KIND_CD",
"OBST_MERT_GRD",
"OBST_MERT_RGST_DT",
"STAY_PERD_FROM",
"STAY_PERD_TO",
"APP_DOCU_YN"
],
"dataset": "...",
"nodatatext": "데이타가 없습니다.",
"column_count": 51
},
"phase": "init",
"fields": [
{
"name": "edt_Name",
"type": "Edit",
"label": "성명",
"column": "NAME",
"dataset": "..."
},
{
"mask": "###### - #######",
"name": "mdt_Rrno",
"type": "MaskEdit",
"label": "주민등록번호",
"column": "RRNO",
"dataset": "..."
},
{
"name": "cbo_NationCd",
"type": "Combo",
"label": "국적",
"column": "NATION_CD",
"dataset": "...",
"innerdataset": "..."
},
{
"name": "cbo_StayQlf",
"type": "Combo",
"label": "체류자격",
"column": "STAY_CRTF_CD",
"dataset": "...",
"innerdataset": "..."
},
{
"mask": "@@@@-@@-@@",
"name": "mdt_ToDay",
"type": "MaskEdit",
"label": "작성일",
"column": "WRT_CHASU",
"dataset": "...",
"readonly": true
},
{
"name": "edt_WrtDupSeq",
"type": "Edit",
"label": "일련번호",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"readonly": true
},
{
"name": "cbx_SinGubun1",
"type": "CheckBox",
"label": "전체"
},
{
"name": "cbx_SinGubun2",
"type": "CheckBox",
"label": "국민연금",
"dataset": "..."
},
{
"name": "cbx_SinGubun3",
"type": "CheckBox",
"label": "건강보험",
"dataset": "..."
},
{
"name": "cbx_SinGubun4",
"type": "CheckBox",
"label": "고용보험",
"dataset": "..."
},
{
"name": "cbx_SinGubun5",
"type": "CheckBox",
"label": "산재보험",
"dataset": "..."
},
{
"name": "cbx_NpcTm",
"type": "CheckBox",
"label": "국민연금",
"enabled": false
},
{
"mask": "#,###,###,###",
"name": "mdt_MthIncmAmtNpc",
"type": "MaskEdit",
"label": "국민연금 보수월액/소득월액",
"column": "MTH_INCM_AMT_NPC",
"dataset": "...",
"enabled": false
},
{
"name": "cal_CrtfObtnDtNpc",
"type": "Calendar",
"label": "국민연금 취득일",
"column": "CRTF_OBTN_DT_NPC",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_CrtfObtnCdNpc",
"type": "Combo",
"label": "국민연금 취득부호",
"column": "CRTF_OBTN_CD_NPC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_ObtnMthPayYnNpc",
"type": "Combo",
"label": "국민연금 취득월납부여부",
"column": "OBTN_MTH_PAY_YN_NPC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_SpclObptypCdNpc",
"type": "Combo",
"label": "국민연금 특수직종",
"column": "SPCL_OBPTYP_CD_NPC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_SpquPnsnCdNpc",
"type": "Combo",
"label": "국민연금 직역연금부호",
"column": "SPQU_PNSN_CD_NPC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_IncmDiffRsnNpc",
"type": "Combo",
"label": "국민연금 소득월액확인 사유",
"column": "INCM_DIFF_RSN_NPC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "mdt_NhicFeeMthAmtNpc",
"type": "MaskEdit",
"label": "국민연금 건강보험 보수월액 비교값",
"column": "NHIC_FEE_MTH_AMT_NPC",
"dataset": "...",
"enabled": false
},
{
"name": "cbx_NhicTm",
"type": "CheckBox",
"label": "건강보험",
"enabled": false
},
{
"mask": "#,###,###,###",
"name": "mdt_FeeMthAmt",
"type": "MaskEdit",
"label": "건강보험 보수월액",
"column": "FEE_MTH_AMT",
"dataset": "...",
"enabled": false
},
{
"name": "cal_CrtfObtnDtNhic",
"type": "Calendar",
"label": "건강보험 취득일",
"column": "CRTF_OBTN_DT_NHIC",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_CrtfObtnCdNhic",
"type": "Combo",
"label": "건강보험 취득부호",
"column": "CRTF_OBTN_CD_NHIC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "rb_PiSinGubun",
"type": "Radio",
"label": "피부양자신청",
"column": "PSSP_OBTN_YN_NHIC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_IsufeRdctDtNhic",
"type": "Combo",
"label": "건강보험 보험료감면부호",
"column": "ISUFE_RDCT_DT_NHIC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_AcntNameCdNhic",
"type": "Combo",
"label": "건강보험 회계부호",
"column": "ACNT_NAME_CD_NHIC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_OcptypCdNhic",
"type": "Combo",
"label": "건강보험 직종부호",
"column": "OCPTYP_CD_NHIC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "rb_NhicCardBslcSendYn",
"type": "Radio",
"label": "건강보험증 발송희망",
"column": "NHIC_CARD_BSLC_SEND_YN",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "edt_armyNo",
"type": "Edit",
"label": "군번",
"column": "ARMY_NO",
"dataset": "..."
},
{
"name": "cbx_HrdkTm",
"type": "CheckBox",
"label": "고용보험",
"enabled": false
},
{
"name": "cal_CrthObtnDtHrdk",
"type": "Calendar",
"label": "고용보험 취득일",
"column": "CRTF_OBTN_DT_HRDK",
"dataset": "...",
"enabled": false
},
{
"mask": "#,###,###,###",
"name": "mdt_MthAvrgSlryHrdk",
"type": "MaskEdit",
"label": "고용보험 월평균보수",
"column": "MTH_AVRG_SLRY_HRDK",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_OcptypCdHrdk",
"type": "Combo",
"label": "고용보험 직종부호",
"column": "OCPTYP_CD_HRDK",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"mask": "##",
"name": "mdk_WeekWorkTimeHrdk",
"type": "MaskEdit",
"label": "고용보험 1주 소정근로시간",
"column": "WEEK_WORK_TIME_HRDK",
"dataset": "...",
"enabled": false
},
{
"name": "rb_CntrYn",
"type": "Radio",
"label": "고용보험 계약직 여부",
"column": "CNTR_WRKR_YN",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"mask": "####/##",
"name": "mdk_CntrEndYymm",
"type": "MaskEdit",
"label": "고용보험 계약종료월",
"column": "CNTR_END_YYMM",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_InsufeLevyCdHrdk",
"type": "Combo",
"label": "고용보험 보험료 부과구분 부호",
"column": "INSUFE_LEVY_CD_HRDK",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_InsufeLevyRsnHrdk",
"type": "Combo",
"label": "고용보험 보험료 부과구분 사유",
"column": "INSUFE_LEVY_RSN_HRDK",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_AddMsgCdHrdk",
"type": "Combo",
"label": "고용보험 비고",
"column": "ADD_MSG_CD_HRDK",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_SchlHrdk",
"type": "Combo",
"label": "고용보험 학교/직종 보조",
"column": "SCHL_HRDK",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbx_JobHrdk",
"type": "CheckBox",
"label": "일자리안정자금신청",
"enabled": false
},
{
"name": "cbx_KlwcTm",
"type": "CheckBox",
"label": "산재보험",
"enabled": false
},
{
"name": "cal_CrthObtnDtKlwc",
"type": "Calendar",
"label": "산재보험 취득일",
"column": "CRTF_OBTN_DT_KLWC",
"dataset": "...",
"enabled": false
},
{
"mask": "#,###,###,###",
"name": "mdt_MthAvrgSlryKlwc",
"type": "MaskEdit",
"label": "산재보험 월평균보수",
"column": "MTH_AVRG_SLRY_KLWC",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_OcptypCdKlwc",
"type": "Combo",
"label": "산재보험 직종부호",
"column": "OCPTYP_CD_KLWC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"mask": "##",
"name": "mdk_WeekWorkTimeKlwc",
"type": "MaskEdit",
"label": "산재보험 1주 소정근로시간",
"column": "WEEK_WORK_TIME_KLWC",
"dataset": "...",
"enabled": false
},
{
"name": "rb_CntrYnKlwc",
"type": "Radio",
"label": "산재보험 계약직 여부",
"column": "CNTR_WRKR_YN_KLWC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"mask": "####/##",
"name": "mdk_CntrEndYymmKlwc",
"type": "MaskEdit",
"label": "산재보험 계약종료월",
"column": "CNTR_END_YYMM_KLWC",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_InsufeLevyCdKlwc",
"type": "Combo",
"label": "산재보험 보험료 부과구분 부호",
"column": "INSUFE_LEVY_CD_KLWC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_InsufeLevyRsnKlwc",
"type": "Combo",
"label": "산재보험 보험료 부과구분 사유",
"column": "INSUFE_LEVY_RSN_KLWC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_AddMshCdKlwc",
"type": "Combo",
"label": "산재보험 비고",
"column": "ADD_MSG_CD_KLWC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_SchlKlwc",
"type": "Combo",
"label": "산재보험 학교/직종 보조",
"column": "SCHL_KLWC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"mask": "######-#######",
"name": "mdt_PsspRrno",
"type": "MaskEdit",
"label": "피부양자 주민등록번호",
"column": "PSSP_RRNO",
"dataset": "..."
},
{
"name": "edt_PsspName",
"type": "Edit",
"label": "피부양자 성명",
"column": "PSSP_NAME",
"dataset": "..."
},
{
"name": "cbo_PsspRelt",
"type": "Combo",
"label": "피부양자 관계",
"column": "PSSP_RELT",
"dataset": "...",
"innerdataset": "..."
},
{
"name": "cbo_FrnrNatlCdNhic",
"type": "Combo",
"label": "피부양자 국적",
"column": "FRNR_NATL_CD_NHIC",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_StayCrtfCd",
"type": "Combo",
"label": "피부양자 체류자격",
"column": "STAY_CRTF_CD",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "mdt_StayPerdFrom",
"type": "Calendar",
"label": "피부양자 체류시작일",
"column": "STAY_PERD_FROM",
"dataset": "...",
"enabled": false
},
{
"name": "mdt_StayPerdTo",
"type": "Calendar",
"label": "피부양자 체류종료일",
"column": "STAY_PERD_TO",
"dataset": "...",
"enabled": false
},
{
"name": "cbo_ObstMertKindCd",
"type": "Combo",
"label": "피부양자 장애인/국가유공자 종별",
"column": "OBST_MERT_KIND_CD",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "cbo_ObstMertGrd",
"type": "Combo",
"label": "피부양자 장애 등급",
"column": "OBST_MERT_GRD",
"dataset": "...",
"enabled": false,
"innerdataset": "..."
},
{
"name": "mdt_ObstMertRgstDt",
"type": "Calendar",
"label": "피부양자 장애 등록일",
"column": "OBST_MERT_RGST_DT",
"dataset": "...",
"enabled": false
},
{
"name": "rb_AppDocuYn",
"type": "Radio",
"label": "피부양자 첨부서류여부",
"column": "APP_DOCU_YN",
"dataset": "...",
"innerdataset": "..."
},
{
"name": "chk_handicapped",
"type": "CheckBox",
"label": "장애인/국가유공자"
},
{
"mask": "###",
"name": "mdt_unitBslcSymb",
"type": "MaskEdit",
"label": "단위기관 기호",
"column": "UNIT_BSLC_SYMB",
"dataset": "..."
},
{
"name": "edt_bsbrName",
"type": "Edit",
"label": "단위기관 명칭",
"column": "BSBR_NAME",
"dataset": "..."
},
{
"mask": "##########",
"name": "mdt_HrdkAsctSymb",
"type": "MaskEdit",
"label": "보험사무 대행기관 번호",
"column": "HRDK_ASCT_SYMB",
"dataset": "..."
},
{
"name": "edt_HrdkAsctName",
"type": "Edit",
"label": "보험사무 대행기관 명칭",
"column": "HRDK_ASCT_NAME",
"dataset": "..."
},
{
"name": "rb_ReppsYn",
"type": "Radio",
"label": "대표자여부",
"column": "REPPS_YN",
"dataset": "...",
"innerdataset": "..."
}
],
"safety": {
"warning": "이 API는 form contract/init 응답만 제공하며 임시저장, 대상자등록, 신고 전송을 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"noticeAlert",
"GetCommCombo",
"WETB_013S"
],
"blocked_transaction_cmds": [
"JGBA_020I_1",
"JGBA_020I_2"
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_JGBA_020",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"..."
],
"sections": [
{
"key": "applicant",
"label": "신청자/대상자 기본",
"field_names": [
"edt_Name",
"mdt_Rrno",
"cbo_NationCd",
"cbo_StayQlf",
"mdt_ToDay",
"edt_WrtDupSeq"
]
},
{
"key": "selection",
"label": "신청구분",
"field_names": [
"cbx_SinGubun1",
"cbx_SinGubun2",
"cbx_SinGubun3",
"cbx_SinGubun4",
"cbx_SinGubun5"
]
},
{
"key": "national_pension",
"label": "국민연금",
"column_suffix": "_NPC"
},
{
"key": "health_insurance",
"label": "건강보험",
"column_suffix": "_NHIC"
},
{
"key": "employment_insurance",
"label": "고용보험",
"column_suffix": "_HRDK"
},
{
"key": "workers_compensation",
"label": "산재보험",
"column_suffix": "_KLWC"
},
{
"key": "dependent",
"label": "피부양자",
"dataset": "..."
},
{
"key": "agency",
"label": "보험사무 대행기관/단위기관",
"field_names": [
"mdt_unitBslcSymb",
"edt_bsbrName",
"mdt_HrdkAsctSymb",
"edt_HrdkAsctName"
]
},
{
"key": "target_grid",
"label": "대상자 등록 그리드",
"dataset": "...",
"column_count": 51
}
],
"shortcut": "pageLinkPopup1('101')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "JGBA_020",
"field_count": 70,
"feature_name": "...",
"page_link_id": "101",
"target_ready": true,
"dataset_count": 61,
"workflow_step": "qualification_acquisition_form_contract_loaded",
"combo_requests": [
{
"sql": "...",
"label": "국적",
"dataset": "..."
},
{
"sql": "...",
"label": "직종부호",
"dataset": "..."
},
{
"sql": "...",
"label": "체류자격",
"dataset": "..."
},
{
"sql": "...",
"label": "국민연금 취득부호",
"dataset": "..."
},
{
"sql": "...",
"label": "국민연금 특수직종",
"dataset": "..."
},
{
"sql": "...",
"label": "직역연금부호",
"dataset": "..."
},
{
"sql": "...",
"label": "소득월액확인 사유",
"dataset": "..."
},
{
"sql": "...",
"label": "건강보험 취득부호",
"dataset": "..."
},
{
"sql": "...",
"label": "장애인/국가유공자 종별",
"dataset": "..."
},
{
"sql": "...",
"label": "장애 등급",
"dataset": "..."
},
{
"sql": "...",
"label": "건강보험 직종부호",
"dataset": "..."
},
{
"sql": "...",
"label": "학교/직종 보조",
"dataset": "..."
},
{
"sql": "...",
"label": "피부양자 관계",
"dataset": "..."
},
{
"sql": "...",
"label": "비고",
"dataset": "..."
},
{
"sql": "...",
"label": "고용보험 부과구분부호",
"dataset": "..."
},
{
"sql": "...",
"label": "고용보험 부과구분사유",
"dataset": "..."
},
{
"sql": "...",
"label": "산재보험 부과구분부호",
"dataset": "..."
},
{
"sql": "...",
"label": "산재보험 부과구분사유",
"dataset": "..."
}
],
"default_values": {
"DOCID": "JGBA_020",
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"대표자여부": "2",
"피부양자신청": "0",
"건강보험증발송희망": "2"
},
"dependent_grid": {
"columns": [
"PSSP_RRNO",
"PSSP_NAME",
"PSSP_RELT",
"OBST_MERT_KIND_CD",
"OBST_MERT_GRD",
"OBST_MERT_RGST_DT",
"FRNR_NATL_CD_NHIC",
"STAY_CRTF_CD",
"STAY_PERD_FROM",
"STAY_PERD_TO",
"APP_DOCU_YN"
],
"dataset": "...",
"registered_dataset": "..."
},
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": null,
"npc_bslc_mgmt_no": null,
"hrdk_bslc_mgmt_no": null,
"klwc_bslc_mgmt_no": null,
"nhic_bslc_mgmt_no": "",
"firm_management_no": null,
"target_context_ready": false,
"session_cookie_context_ready": false
},
"init_transactions": [
{
"cmd": "noticeAlert",
"action": "COMMONAction",
"effect": "화면 알림/공지 조회",
"mutates": false
},
{
"cmd": "GetCommCombo",
"action": "COMMONAction",
"effect": "공통 콤보 데이터 로드",
"mutates": false
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "JGBA_020Action",
"effect": "임시저장 유무 조회",
"out_ds": "...",
"mutates": false
},
{
"cmd": "WETB_013S",
"action": "JGBA_020Action",
"effect": "초기 화면에서만 허용되는 조회성 카운트 확인",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "JGBA_020I_1",
"action": "JGBA_020Action",
"button": "save",
"reason": "임시저장 데이터 생성"
},
{
"cmd": "JGBA_020I_2",
"action": "JGBA_020Action",
"button": "send",
"reason": "실제 자격취득 신고 접수"
},
{
"button": "대상자등록",
"reason": "입력 데이터 검증/등록 후 신고 가능 상태로 전환"
},
{
"button": "파일올리기/첨부파일 전송",
"reason": "첨부 파일 업로드 및 신고 연계"
}
],
"implementation_status": "implemented_init_form_contract_only"
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
3. 자격내용 변경신고 입력 서식 조회nhis_ edi. qualification. change. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
로그인한 연동 계정으로 부르면 자격 내역변경 신고서의 대상자, 신청구분, 내역변경, 보험별 구역 칸과 변경부호 같은 목록 이름을 받습니다. 신고 저장·전송은 하지 않습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- JGCC_050I_1/I_2(임시저장·전송) 미실행. nameCheck·UserChk·JungNoChk는 init_transactions 계약 정보만 노출.
- params 는 빈 객체로 보내도 호출됩니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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: init-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "nhis_edi",
"action": "nhis_edi.qualification.change.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- sections·fields·grid·combo_requests·observed_callservices·blocked_transactions를 확인합니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| sections | array | 섹션 정의 배열 | |
| fields | array | 입력 필드 정의 배열 | |
| grid | object | 그리드 행 데이터 | |
| combo_ | array | 콤보 요청 목록 | |
| observed_ | array | 관찰된 callservice 목록 | |
| blocked_ | array | 차단된 트랜잭션 목록 (실행 안 됨) | |
| form_ | string | 기관 화면 폼 id | |
| document_ | string | 기관 화면 문서 id | |
| business_ | object | 사업장 기본 맥락 값 | |
| default_ | object | 화면 기본값 | |
| datasets | array | 기관 응답 데이터셋 원본 | |
| dataset_ | number | 데이터셋 수 | |
| field_ | number | 입력 필드 수 | |
| init_ | array | 화면 초기 트랜잭션 목록 | |
| safety | object | 안전 플래그 | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"name": "Grid0",
"columns": [
"ATT_FILE_CNT",
"BSLC_MGMT_NO_INSPS",
"BSLC_MGMT_NO_NHIC",
"BSLC_MGMT_NO_NPC",
"CHGAF_OCPTYPYN_NPC",
"CHNG_CD",
"CHNG_CDNM",
"CHNG_DT",
"CHNG_NM",
"FIRM_SYM",
"GAIB_NAME",
"HRDK_ASCT_NAME",
"HRDK_ASCT_SYMB",
"HRDK_SBCT_MGMT_NO",
"INSU_ACPT_YN_GG",
"INSU_ACPT_YN_GY",
"INSU_ACPT_YN_SJ",
"INSU_ACPT_YN_YG",
"NAME",
"RRNO",
"UNIT_FIRM_SYM",
"WRT_CHASU",
"WRT_DUP_SEQ"
],
"dataset": "...",
"nodatatext": "데이타가 없습니다.",
"column_count": 23
},
"phase": "init",
"fields": [
{
"mask": null,
"name": "edt_HrdkAsctName",
"text": null,
"type": "Edit",
"column": "HRDK_ASCT_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_Name",
"text": null,
"type": "Edit",
"column": "NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "######-#######",
"name": "mdt_Rrno",
"text": null,
"type": "MaskEdit",
"column": "RRNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_WrtDupSeq",
"text": null,
"type": "Edit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "cbx_SinGubun1",
"text": "전체",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_SinGubun2",
"text": "국민연금",
"type": "CheckBox",
"column": "INSU_ACPT_YN_YG",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_SinGubun3",
"text": "건강보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_GG",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_SinGubun4",
"text": "고용보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_GY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "####-##-##",
"name": "mdt_ToDay",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": "######-#######",
"name": "mdt_ChgafRrno",
"text": null,
"type": "MaskEdit",
"column": "CHGAF_RRNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#",
"name": "mdt_ChgafOcptypynNpc",
"text": null,
"type": "MaskEdit",
"column": "CHGAF_OCPTYPYN_NPC",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "##########",
"name": "mdt_HrdkAsctSymb",
"text": null,
"type": "MaskEdit",
"column": "HRDK_ASCT_SYMB",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "###############",
"name": "mdt_HrdkSbctMgmtNo",
"text": null,
"type": "MaskEdit",
"column": "HRDK_SBCT_MGMT_NO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_ChgafName",
"text": null,
"type": "Edit",
"column": "CHGAF_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_CrtfObtnDt",
"text": null,
"type": "Calendar",
"column": "CHNG_DT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_ChgafCrtfObtnDt",
"text": null,
"type": "Calendar",
"column": "CHGAF_CRTF_OBTN_DT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_SinGubun5",
"text": "산재보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_SJ",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rb_NhicCardRecv",
"text": null,
"type": "Radio",
"column": "NHIC_CARD_RECV",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rb_obtMthPayYn",
"text": null,
"type": "Radio",
"column": "OBTN_MTH_PAY_YN",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_ChgafOcptypynNpc",
"text": null,
"type": "Combo",
"column": "CHGAF_OCPTYPYN_NPC",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_ChgBuho",
"text": null,
"type": "Combo",
"column": "CHNG_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_ChgafSesupWkYn",
"text": null,
"type": "Combo",
"column": "CHGAF_SESUP_WK_YN_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_ChgafRestEndDt",
"text": null,
"type": "Calendar",
"column": "CHGAF_REST_END_DT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
}
],
"safety": {
"warning": "이 API는 form contract/init 응답만 제공하며 임시저장, 대상자등록, 신고 전송을 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"WETB_013S",
"nameCheck",
"UserChk",
"JungNoChk"
],
"blocked_transaction_cmds": [
"JGCC_050I_1",
"JGCC_050I_2"
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_JGCC_050",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"..."
],
"sections": [
{
"key": "applicant",
"label": "대상자 기본",
"columns": [
"NAME",
"RRNO",
"CHGAF_NAME",
"CHGAF_RRNO"
]
},
{
"key": "selection",
"label": "신청구분",
"columns": [
"INSU_ACPT_YN_YG",
"INSU_ACPT_YN_GG",
"INSU_ACPT_YN_GY",
"INSU_ACPT_YN_SJ"
]
},
{
"key": "change_detail",
"label": "내역변경",
"columns": [
"CHNG_DT",
"CHNG_CD",
"CHNG_NM",
"CHGAF_CRTF_OBTN_DT"
]
},
{
"key": "national_pension",
"label": "국민연금",
"columns": [
"OBTN_MTH_PAY_YN",
"CHGAF_OCPTYPYN_NPC"
]
},
{
"key": "health_insurance",
"label": "건강보험",
"columns": [
"NHIC_CARD_RECV"
]
},
{
"key": "employment_workers_comp",
"label": "고용/산재",
"columns": [
"HRDK_ASCT_SYMB",
"HRDK_ASCT_NAME",
"HRDK_SBCT_MGMT_NO",
"CHGAF_SESUP_WK_YN_CD",
"CHGAF_REST_END_DT"
]
},
{
"key": "target_grid",
"label": "대상자 그리드",
"dataset": "..."
}
],
"shortcut": "pageLinkPopup1('135')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "JGCC_050",
"field_count": 23,
"feature_name": "...",
"page_link_id": "135",
"target_ready": true,
"dataset_count": 24,
"workflow_step": "qualification_change_form_contract_loaded",
"combo_requests": [
{
"label": "변경부호",
"dataset": "..."
},
{
"label": "건강보험증 수령지",
"dataset": "..."
},
{
"label": "취득월 납부여부",
"dataset": "..."
},
{
"label": "국민연금 특수직종",
"dataset": "..."
},
{
"label": "고용/산재 변경 후 적용여부",
"dataset": "..."
}
],
"default_values": {
"DOCID": "JGCC_050",
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15"
},
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": null,
"npc_bslc_mgmt_no": null,
"hrdk_bslc_mgmt_no": null,
"klwc_bslc_mgmt_no": null,
"nhic_bslc_mgmt_no": "",
"firm_management_no": null,
"target_context_ready": false,
"session_cookie_context_ready": false
},
"init_transactions": [
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "JGCC_050Action",
"effect": "임시저장 유무 조회",
"out_ds": "...",
"mutates": false
},
{
"cmd": "nameCheck",
"action": "COMMONAction",
"effect": "성명/주민등록번호 검증",
"mutates": false
},
{
"cmd": "UserChk",
"action": "COMMONAction",
"effect": "가입자 사용자 검증",
"mutates": false
},
{
"cmd": "JungNoChk",
"action": "COMMONAction",
"effect": "건강보험증번호 검증",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "JGCC_050I_1",
"action": "JGCC_050Action",
"button": "save",
"reason": "임시저장/대상자 데이터 생성"
},
{
"cmd": "JGCC_050I_2",
"action": "JGCC_050Action",
"button": "send",
"reason": "실제 자격 내용변경 신고 접수"
},
{
"button": "대상자등록",
"reason": "신고 대상자 등록/검증 상태 변경"
},
{
"button": "파일올리기/첨부파일 전송",
"reason": "첨부 파일 업로드 및 공단 전송"
}
],
"visible_text_markers": [
"주민(외국인)등록번호",
"작성일",
"번 호",
"보험사무대행기관",
"성명",
"고용보험하수급인관리번호\\n (건설공사등의 미승인 하수급인에 한함)",
"내역변경",
"명 칭",
"년 월 일 ",
"변경부호 ",
"변경후내용",
"일련번호",
"신청구분",
"* 내역(성명, 주민등록번호, 특수직종) 변경시 변경 후 내역이 정확하게 입력되었는지 필히 확인하세요.",
"건강보험증 수령지",
"취득월 납부여부",
"! 산재보험 자진납부사업장으로 산재보험신고가 되지 않습니다. 산재보험 해당지사에 문의하시기 바랍니다.",
"* 건강보험증은 가입자 또는 피부양자가 신청하는 경우 발급됩니다.",
"* 건강보험 자격상실일 변경으로 보수총액과 근무월수가 변동된 경우 반드시 \\\"직장가입자 보험료 정산내역 착오자 변경신청서\\\"를 건강보험으로 제출하여야 합니다.",
"(※ 국민연금만 해당)"
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "JGCC_050Action",
"out_ds": "..."
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "JGCC_050Action",
"out_ds": "..."
},
{
"cmd": "JGCC_050I_1",
"in_ds": "...",
"action": "JGCC_050Action",
"out_ds": ""
},
{
"cmd": "JGCC_050I_2",
"in_ds": "...",
"action": "JGCC_050Action",
"out_ds": "..."
},
{
"cmd": "nameCheck",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "UserChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "JungNoChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "UserChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
4. 피부양자 자격신고 입력 서식 조회nhis_ edi. qualification. dependent. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
피부양자 취득 상실 신고서의 가입자, 피부양자, 장애인과 국가유공자, 외국인 구역 칸을 연동 계정 하나로 받습니다. 신고 저장·전송은 하지 않습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- JGBA_010_I_TM·JGBA_010_I(임시저장·전송) 미실행. 대상자등록·파일첨부도 blocked.
- params 는 빈 객체로 보내도 호출됩니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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: init-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "nhis_edi",
"action": "nhis_edi.qualification.dependent.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- sections·fields·grid·validation_transactions·blocked_transactions·safety를 확인합니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| sections | array | 섹션 정의 배열 | |
| fields | array | 입력 필드 정의 배열 | |
| grid | object | 그리드 행 데이터 | |
| validation_ | array | 검증 트랜잭션 계약 배열 | |
| blocked_ | array | 차단된 트랜잭션 목록 (실행 안 됨) | |
| safety | object | 안전 플래그 객체 | |
| form_ | string | 기관 화면 폼 id | |
| document_ | string | 기관 화면 문서 id | |
| business_ | object | 사업장 기본 맥락 값 | |
| default_ | object | 화면 기본값 | |
| datasets | array | 기관 응답 데이터셋 원본 | |
| dataset_ | number | 데이터셋 수 | |
| field_ | number | 입력 필드 수 | |
| combo_ | array | 화면이 부르는 콤보 조회 목록 | |
| init_ | array | 화면 초기 트랜잭션 목록 | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"name": "Grid0",
"columns": [
"ATT_FILE_CNT",
"FRNR_NATL_CD_NHIC",
"MBR_NAME",
"MBR_RRNO",
"OBST_MERT_GRD",
"OBST_MERT_KIND_CD",
"OBST_MERT_RGST_DT",
"OBTN_LOSS_CD",
"OBTN_LOSS_DT",
"PSSP_NAME",
"PSSP_RELT_CD",
"PSSP_RRNO",
"RPT_TYPE",
"STAY_CRTF_CD",
"STAY_PERD_FROM",
"STAY_PERD_TO"
],
"dataset": "...",
"nodatatext": "데이타가 없습니다.",
"column_count": 16
},
"phase": "init",
"fields": [
{
"mask": "@@@@/@@/@@",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "@@",
"name": "mdt_WrtDupSeq",
"text": null,
"type": "MaskEdit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "######-#######",
"name": "mdt_MbrRrno",
"text": null,
"type": "MaskEdit",
"column": "MBR_RRNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_MbrName",
"text": null,
"type": "Edit",
"column": "MBR_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_PsspName",
"text": null,
"type": "Edit",
"column": "PSSP_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "######-#######",
"name": "mdt_PsspRrno",
"text": null,
"type": "MaskEdit",
"column": "PSSP_RRNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_RetCd",
"text": "관계코드",
"type": "Combo",
"column": "PSSP_RELT_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_Gubun",
"text": null,
"type": "Combo",
"column": "RPT_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_ObtnLossDt",
"text": null,
"type": "Calendar",
"column": "OBTN_LOSS_DT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_ObtnLossCd",
"text": null,
"type": "Combo",
"column": "OBTN_LOSS_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_Grade",
"text": null,
"type": "Combo",
"column": "OBST_MERT_GRD",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_ObstMertKindCd",
"text": null,
"type": "Combo",
"column": "OBST_MERT_KIND_CD",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_ObstMertRgstdt",
"text": null,
"type": "Calendar",
"column": "OBST_MERT_RGST_DT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_FrnrNatlCdNhic",
"text": null,
"type": "Combo",
"column": "FRNR_NATL_CD_NHIC",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_StayCrtfCd",
"text": null,
"type": "Combo",
"column": "STAY_CRTF_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_StayPerdTo",
"text": null,
"type": "Calendar",
"column": "STAY_PERD_TO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_StayPerdFrom",
"text": null,
"type": "Calendar",
"column": "STAY_PERD_FROM",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_RqstOffcTelno1",
"text": "국번",
"type": "Combo",
"column": "RQST_OFFC_TELNO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "####",
"name": "mdt_RqstOffcTelno2",
"text": null,
"type": "MaskEdit",
"column": "RQST_OFFC_TELNO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "####",
"name": "mdt_RqstOffcTelno3",
"text": null,
"type": "MaskEdit",
"column": "RQST_OFFC_TELNO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_RqstHomeTelno1",
"text": "국번",
"type": "Combo",
"column": "RQST_HOME_TELNO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "####",
"name": "mdt_RqstHomeTelno2",
"text": null,
"type": "MaskEdit",
"column": "RQST_HOME_TELNO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "####",
"name": "mdt_RqstHomeTelno3",
"text": null,
"type": "MaskEdit",
"column": "RQST_HOME_TELNO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "chk_handicapped",
"text": "Checkbox0",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
}
],
"safety": {
"warning": "이 API는 form contract/init 응답만 제공하며 임시저장, 대상자등록, 파일첨부, 신고 전송을 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"CommonLoginProc",
"execute",
"SI4INFO_001",
"noticeAlert",
"WETZ_002S01",
"GetCommCombo"
],
"blocked_transaction_cmds": [
"JGBA_010_I_TM",
"JGBA_010_I"
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_JGBA_010",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"..."
],
"sections": [
{
"key": "subscriber",
"label": "가입자",
"columns": [
"MBR_NAME",
"MBR_RRNO",
"RQST_OFFC_TELNO_1",
"RQST_OFFC_TELNO_2",
"RQST_OFFC_TELNO_3",
"RQST_HOME_TELNO_1",
"RQST_HOME_TELNO_2",
"RQST_HOME_TELNO_3"
]
},
{
"key": "dependent",
"label": "대상자/피부양자",
"columns": [
"PSSP_NAME",
"PSSP_RRNO",
"PSSP_RELT_CD",
"RPT_TYPE",
"OBTN_LOSS_DT",
"OBTN_LOSS_CD"
]
},
{
"key": "disability_merit",
"label": "장애인/국가유공자",
"columns": [
"OBST_MERT_KIND_CD",
"OBST_MERT_GRD",
"OBST_MERT_RGST_DT"
]
},
{
"key": "foreigner",
"label": "외국인",
"columns": [
"FRNR_NATL_CD_NHIC",
"STAY_CRTF_CD",
"STAY_PERD_FROM",
"STAY_PERD_TO"
]
},
{
"key": "attachment",
"label": "첨부파일",
"columns": [
"ATT_FILE_CNT"
]
},
{
"key": "target_grid",
"label": "대상자 그리드",
"dataset": "..."
}
],
"shortcut": "pageLinkPopup1('104')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "JGBA_010",
"field_count": 24,
"feature_name": "...",
"page_link_id": "104",
"target_ready": true,
"dataset_count": 20,
"workflow_step": "qualification_dependent_form_contract_loaded",
"combo_requests": [
{
"label": "관계코드",
"dataset": "...",
"source_code": "WETZ_009"
},
{
"label": "취득/상실 구분",
"values": [
"취득",
"상실"
],
"dataset": "..."
},
{
"label": "취득/상실 사유",
"dataset": "..."
},
{
"label": "취득 사유",
"dataset": "..."
},
{
"label": "상실 사유",
"dataset": "..."
},
{
"label": "장애인/국가유공자 종별",
"dataset": "...",
"source_code": "WETZ_010"
},
{
"label": "장애 등급",
"dataset": "...",
"source_code": "WETZ_011"
},
{
"label": "외국인 국적",
"dataset": "..."
},
{
"label": "체류자격",
"dataset": "...",
"source_code": "WETZ_012"
},
{
"label": "전화번호 국번",
"dataset": "..."
}
],
"default_values": {
"DOCID": "JGBA_010",
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"RPT_TYPE_options": [
"취득",
"상실"
]
},
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": null,
"npc_bslc_mgmt_no": null,
"hrdk_bslc_mgmt_no": null,
"klwc_bslc_mgmt_no": null,
"nhic_bslc_mgmt_no": "",
"firm_management_no": null,
"target_context_ready": false,
"session_cookie_context_ready": false
},
"init_transactions": [
{
"cmd": "CommonLoginProc",
"action": "COMMONAction",
"effect": "XUI 로그인/사업장 컨텍스트 로드",
"mutates": false
},
{
"cmd": "execute",
"action": "nDefaultAction",
"effect": "작성일 기준일 조회",
"mutates": false
},
{
"cmd": "SI4INFO_001",
"action": "SI4INFOAction",
"effect": "사업장 로그인 정보 조회",
"mutates": false
},
{
"cmd": "noticeAlert",
"action": "COMMONAction",
"effect": "화면 알림/공지 조회",
"mutates": false
},
{
"cmd": "WETZ_002S01",
"in_ds": "...",
"action": "COMMONAction",
"effect": "임시저장 유무 조회",
"out_ds": "...",
"mutates": false
},
{
"cmd": "GetCommCombo",
"action": "COMMONAction",
"effect": "공통 콤보 데이터 로드",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "JGBA_010_I_TM",
"action": "JGBA_010Action",
"button": "save",
"reason": "임시저장 데이터 생성"
},
{
"cmd": "JGBA_010_I",
"action": "JGBA_010Action",
"button": "send",
"reason": "실제 피부양자 자격 신고 접수"
},
{
"button": "대상자등록",
"reason": "신고 대상자 등록/검증 상태 변경"
},
{
"button": "대상자삭제",
"reason": "등록된 대상자 행 삭제"
},
{
"button": "파일첨부/파일전송",
"reason": "첨부 파일 업로드 및 신고 데이터 연계"
}
],
"visible_text_markers": [
"전화번호(가입자)",
" 작성일",
"주민등록번호",
"전화번호(사업장)",
" 일련번호",
"성명",
"취득 / 상실",
"관계부호",
"구분",
"년월일",
"사유",
"장애인, 국가유공자",
"종별",
"등록일자",
"등급",
"가입자",
"대상자",
"외국인 국적",
"체류자격",
"시작일자",
"종료일자",
"-"
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "JGBA_010_I_TM",
"in_ds": "...",
"action": "JGBA_010Action",
"out_ds": "..."
},
{
"cmd": "JGBA_010_I",
"in_ds": "...",
"action": "JGBA_010Action",
"out_ds": "..."
},
{
"cmd": "WETZ_002S01",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "nameCheck",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "JungNoChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
}
],
"validation_transactions": [
{
"cmd": "nameCheck",
"action": "COMMONAction",
"effect": "가입자 성명/주민등록번호 검증"
},
{
"cmd": "JungNoChk",
"action": "COMMONAction",
"effect": "건강보험증 번호 검증"
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
5. 자격상실 신고 입력 서식 조회nhis_ edi. qualification. loss. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
자격 상실 신고서의 보험별 상실일과 상실 코드 칸, 보수총액, 이직확인서 칸과 목록 이름을 로그인한 연동 계정으로 받습니다. 신고 저장·전송은 하지 않습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- JGBB_030I_TMP·JGBB_030I_SND(임시저장·전송) 미실행. 대상자등록·첨부 전송도 blocked.
- params 는 빈 객체로 보내도 호출됩니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명이 하나뿐일 때만 그것이 자동으로 선택됩니다. 둘 이상이면 대표로 지정한 것이 있어도 고르지 않으므로 직접 지정해야 합니다. 대표는 묶음 상품이 기관마다 자격증명을 고를 때만 씁니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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: init-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "nhis_edi",
"action": "nhis_edi.qualification.loss.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- sections·fields·grid·combo_requests·init_transactions·blocked_transactions·safety를 확인합니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| sections | array | 섹션 정의 배열 | |
| fields | array | 입력 필드 정의 배열 | |
| grid | object | 그리드 행 데이터 | |
| combo_ | array | 콤보 요청 목록 | |
| init_ | array | 초기 트랜잭션 계약 배열 | |
| blocked_ | array | 차단된 트랜잭션 목록 (실행 안 됨) | |
| safety | object | 안전 플래그 객체 | |
| form_ | string | 기관 화면 폼 id | |
| document_ | string | 기관 화면 문서 id | |
| business_ | object | 사업장 기본 맥락 값 | |
| default_ | object | 화면 기본값 | |
| datasets | array | 기관 응답 데이터셋 원본 | |
| dataset_ | number | 데이터셋 수 | |
| field_ | number | 입력 필드 수 | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"name": "Grid0",
"columns": [
"ATT_FILE_CNT",
"AVRG_SLRY",
"BASC_PAY1",
"BASC_PAY2",
"BASC_PAY3",
"BASC_PAY4",
"BASC_SLRY",
"BASC_SLRY_SUM",
"BF_YR_FRHY_FEE_TOT_AMT",
"BF_YR_SHY_FEE_TOT_AMT",
"CALC_OBJT_PERD_SEQ",
"CALC_PERD_END_DT",
"CALC_PERD_STRT_DT",
"CHGOCP_DOC_YN",
"CHGOCP_RETR_DT",
"CRTF_OBTN_DT",
"CU_YR_FRHY_FEE_TOT_AMT",
"CU_YR_SHY_FEE_TOT_AMT",
"DAY_WORK_TIME",
"DETL_CHGOCP_RSN",
"ETC",
"ETC_SLRY1",
"ETC_SLRY2",
"ETC_SLRY3",
"ETC_SLRY4",
"ETC_SLRY_SUM",
"GNRL_SLRY",
"INSU_ACPT_YN_GG",
"INSU_ACPT_YN_GY",
"INSU_ACPT_YN_SJ",
"INSU_ACPT_YN_YG",
"LOSS_CD_GG",
"LOSS_CD_YG",
"LOSS_DETL_RSN",
"LOSS_DETL_RSN_KLWC",
"LOSS_DT_GG",
"LOSS_DT_GY",
"LOSS_DT_SJ",
"LOSS_DT_YG",
"LOSS_RSN_TYPE_CD",
"LOSS_RSN_TYPE_CD_KLWC",
"LYEAR_CALC_MTHCNT",
"LYEAR_FEE_TAMT",
"LYEAR_FEE_TAMT_HRDK",
"LYEAR_FEE_TAMT_KLWC",
"NAME",
"OBTN_MTH_PAY_YN_YG",
"PERD_END_DT1",
"PERD_END_DT2",
"PERD_END_DT3",
"PERD_START_DT1",
"PERD_START_DT2",
"PERD_START_DT3",
"RETRAMT_ETCAMT",
"RETRAMT_RECVAMT",
"RRNO",
"RSN_CD1",
"RSN_CD2",
"RSN_CD3",
"SEQ_NO",
"SLRY",
"SLRYPAY_BASCDT_CNT",
"SLRY_CALC_END_DT1",
"SLRY_CALC_END_DT2",
"SLRY_CALC_END_DT3",
"SLRY_CALC_END_DT4",
"SLRY_CALC_STRT_DT1",
"SLRY_CALC_STRT_DT2",
"SLRY_CALC_STRT_DT3",
"SLRY_CALC_STRT_DT4",
"TELNO1",
"TELNO2",
"TELNO3",
"TOTAL_DAY_CNT1",
"TOTAL_DAY_CNT2",
"TOTAL_DAY_CNT3",
"TOTAL_DAY_CNT4",
"TOTAL_INSU_PERD",
"TOTAL_SLRY",
"TOTAL_SLRY_SUM",
"TYEAR_CALC_MTHCNT",
"TYEAR_FEE_TAMT",
"TYEAR_FEE_TAMT_HRDK",
"TYEAR_FEE_TAMT_KLWC",
"WORK_END_YYMM1",
"WORK_END_YYMM2",
"WORK_END_YYMM3",
"WORK_END_YYMM4",
"WORK_START_YYMM1",
"WORK_START_YYMM2",
"WORK_START_YYMM3",
"WORK_START_YYMM4",
"YEAR_SLRY"
],
"dataset": "...",
"nodatatext": "데이타가 없습니다.",
"column_count": 93
},
"phase": "init",
"fields": [
{
"mask": "#,###,###,###",
"name": "mdt_LyearShalfFeeTamtHrdk",
"text": null,
"type": "MaskEdit",
"column": "BF_YR_SHY_FEE_TOT_AMT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_LyearFhalfFeeTamtHrdk",
"text": null,
"type": "MaskEdit",
"column": "BF_YR_FRHY_FEE_TOT_AMT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_TyearShalfFeeTamtHrdk",
"text": null,
"type": "MaskEdit",
"column": "CU_YR_SHY_FEE_TOT_AMT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_TyearFhalfFeeTamtHrdk",
"text": null,
"type": "MaskEdit",
"column": "CU_YR_FRHY_FEE_TOT_AMT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_LossDetlRsn",
"text": null,
"type": "Edit",
"column": "LOSS_DETL_RSN",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_LossDtlRsnTypeCd",
"text": null,
"type": "Combo",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "mdt_Mth3AvrgSlry",
"text": null,
"type": "MaskEdit",
"column": "MTH3_AVRG_SLRY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rb_Obtn_Pay_Yn",
"text": null,
"type": "Radio",
"column": "OBTN_MTH_PAY_YN_YG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": "#,###,###,###",
"name": "mdt_TyearFeeTamtKlwc",
"text": null,
"type": "MaskEdit",
"column": "TYEAR_FEE_TAMT_KLWC",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_LossDetlRsnKlwc",
"text": null,
"type": "Edit",
"column": "LOSS_DETL_RSN_KLWC",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_NpcLossDt",
"text": null,
"type": "Calendar",
"column": "LOSS_DT_YG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_NhicLossDt",
"text": null,
"type": "Calendar",
"column": "LOSS_DT_GG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkLossDt",
"text": null,
"type": "Calendar",
"column": "LOSS_DT_GY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_LossRsnTypeCdKlwc",
"text": null,
"type": "Combo",
"column": "LOSS_RSN_TYPE_CD_KLWC",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_KlwcLossDt",
"text": null,
"type": "Calendar",
"column": "LOSS_DT_SJ",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Klwcv",
"text": "산재보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_SJ",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Klwc",
"text": "산재보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_SJ",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Npcv",
"text": "국민연금",
"type": "CheckBox",
"column": "INSU_ACPT_YN_YG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AsctNo",
"text": null,
"type": "Edit",
"column": "INSU_ASCT_NO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AsctNm",
"text": null,
"type": "Edit",
"column": "INSU_ASCT_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_All",
"text": "전체",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Npc",
"text": "국민연금",
"type": "CheckBox",
"column": "INSU_ACPT_YN_YG",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Nhic",
"text": "건강보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_GG",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Work",
"text": "고용보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_GY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_WStrtNo",
"text": null,
"type": "Edit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_Name",
"text": null,
"type": "Edit",
"column": "NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Nhicv",
"text": "건강보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_GG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbx_Workv",
"text": "고용보험",
"type": "CheckBox",
"column": "INSU_ACPT_YN_GY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "@@@@/@@/@@",
"name": "mdt_MakeDt",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_Rrno",
"text": null,
"type": "MaskEdit",
"column": "RRNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NpcLossCd",
"text": null,
"type": "Combo",
"column": "LOSS_CD_YG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NhicLossCd",
"text": null,
"type": "Combo",
"column": "LOSS_CD_GG",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": "#,###,###,###",
"name": "mdt_TyearFeeTamt",
"text": null,
"type": "MaskEdit",
"column": "TYEAR_FEE_TAMT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "##",
"name": "mdt_TyearCalcMthCnt",
"text": null,
"type": "MaskEdit",
"column": "TYEAR_CALC_MTHCNT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_LyearFeeTamt",
"text": null,
"type": "MaskEdit",
"column": "LYEAR_FEE_TAMT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "##",
"name": "mdt_LyearCalcMthCnt",
"text": null,
"type": "MaskEdit",
"column": "LYEAR_CALC_MTHCNT",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_LyearFeeTamtKlwc",
"text": null,
"type": "MaskEdit",
"column": "LYEAR_FEE_TAMT_KLWC",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_LyearFeeTamtHrdk",
"text": null,
"type": "MaskEdit",
"column": "LYEAR_FEE_TAMT_HRDK",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_LossRsnTypeCd",
"text": null,
"type": "Combo",
"column": "LOSS_RSN_TYPE_CD",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_TelNo1",
"text": "지역코드",
"type": "Combo",
"column": "TELNO1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "####",
"name": "mdt_TelNo2",
"text": null,
"type": "MaskEdit",
"column": "TELNO2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "####",
"name": "mdt_TelNo3",
"text": null,
"type": "MaskEdit",
"column": "TELNO3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_TyearFeeTamtHrdk",
"text": null,
"type": "MaskEdit",
"column": "TYEAR_FEE_TAMT_HRDK",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_EtcAmt",
"text": null,
"type": "MaskEdit",
"column": "RETRAMT_ETCAMT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_GnrlSlry",
"text": null,
"type": "MaskEdit",
"column": "GNRL_SLRY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_WStrtNo",
"text": null,
"type": "Edit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_Name",
"text": null,
"type": "Edit",
"column": "NAME",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "cal_PerdStartDt1",
"text": null,
"type": "Calendar",
"column": "PERD_START_DT1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_PerdEndDt1",
"text": null,
"type": "Calendar",
"column": "PERD_END_DT1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "@@@@/@@/@@",
"name": "mdt_MakeDt",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@-@@-@@",
"name": "mdt_WorkLossDt",
"text": null,
"type": "MaskEdit",
"column": "CHGOCP_RETR_DT",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_Rrno",
"text": null,
"type": "MaskEdit",
"column": "RRNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_PerdStartDt2",
"text": null,
"type": "Calendar",
"column": "PERD_START_DT2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_PerdEndDt2",
"text": null,
"type": "Calendar",
"column": "PERD_END_DT2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_PerdStartDt3",
"text": null,
"type": "Calendar",
"column": "PERD_START_DT3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_PerdEndDt3",
"text": null,
"type": "Calendar",
"column": "PERD_END_DT3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcStrtDt1",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_STRT_DT1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcEndDt1",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_END_DT1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalDayCnt1",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_DAY_CNT1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalDayCnt2",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_DAY_CNT2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalDayCnt3",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_DAY_CNT3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalDayCnt4",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_DAY_CNT4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_BascPay1",
"text": null,
"type": "MaskEdit",
"column": "BASC_PAY1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_BascPay2",
"text": null,
"type": "MaskEdit",
"column": "BASC_PAY2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_BascPay3",
"text": null,
"type": "MaskEdit",
"column": "BASC_PAY3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_BascPay4",
"text": null,
"type": "MaskEdit",
"column": "BASC_PAY4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_BascSlrySum",
"text": null,
"type": "MaskEdit",
"column": "BASC_SLRY_SUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_EtcSlry1",
"text": null,
"type": "MaskEdit",
"column": "ETC_SLRY1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_EtcSlry2",
"text": null,
"type": "MaskEdit",
"column": "ETC_SLRY2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_EtcSlry3",
"text": null,
"type": "MaskEdit",
"column": "ETC_SLRY3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_EtcSlry4",
"text": null,
"type": "MaskEdit",
"column": "ETC_SLRY4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_EtcSlrySum",
"text": null,
"type": "MaskEdit",
"column": "ETC_SLRY_SUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_Slry",
"text": null,
"type": "MaskEdit",
"column": "SLRY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_SlrySum",
"text": null,
"type": "MaskEdit",
"column": "SLRY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_YearSlry",
"text": null,
"type": "MaskEdit",
"column": "YEAR_SLRY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_YearSlrySum",
"text": null,
"type": "MaskEdit",
"column": "YEAR_SLRY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_Etc",
"text": null,
"type": "MaskEdit",
"column": "ETC",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_EtcSum",
"text": null,
"type": "MaskEdit",
"column": "ETC",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_TotalSlry",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_SLRY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_DayWorkTime",
"text": null,
"type": "MaskEdit",
"column": "DAY_WORK_TIME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_DetlChgocpRsn",
"text": null,
"type": "Edit",
"column": "DETL_CHGOCP_RSN",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalInsuPerd",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_INSU_PERD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_RsnCd2",
"text": null,
"type": "Combo",
"column": "RSN_CD2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_RsnCd3",
"text": null,
"type": "Combo",
"column": "RSN_CD3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_SlryCalcStrtDt2",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_STRT_DT2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcEndDt2",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_END_DT2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcStrtDt3",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_STRT_DT3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcEndDt3",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_END_DT3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcStrtDt4",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_STRT_DT4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_SlryCalcEndDt4",
"text": null,
"type": "Calendar",
"column": "SLRY_CALC_END_DT4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_BascSlry",
"text": null,
"type": "MaskEdit",
"column": "BASC_SLRY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "#,###,###,###",
"name": "mdt_RecAmt",
"text": null,
"type": "MaskEdit",
"column": "RETRAMT_RECVAMT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalSlrySum1",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_SLRY_SUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": ",###",
"name": "mdt_AvrgSlry",
"text": null,
"type": "MaskEdit",
"column": "AVRG_SLRY",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalSlrySum",
"text": null,
"type": "MaskEdit",
"column": "TOTAL_SLRY_SUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_CrtfObtnDt",
"text": null,
"type": "Calendar",
"column": "CRTF_OBTN_DT",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_RsnCd1",
"text": null,
"type": "Combo",
"column": "RSN_CD1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cal_WorkStartyymm1",
"text": null,
"type": "Calendar",
"column": "WORK_START_YYMM1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkEndyymm1",
"text": null,
"type": "Calendar",
"column": "WORK_END_YYMM1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkStartyymm2",
"text": null,
"type": "Calendar",
"column": "WORK_START_YYMM2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkEndyymm2",
"text": null,
"type": "Calendar",
"column": "WORK_END_YYMM2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkStartyymm3",
"text": null,
"type": "Calendar",
"column": "WORK_START_YYMM3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkEndyymm3",
"text": null,
"type": "Calendar",
"column": "WORK_END_YYMM3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkEndyymm4",
"text": null,
"type": "Calendar",
"column": "WORK_END_YYMM4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cal_WorkStartyymm4",
"text": null,
"type": "Calendar",
"column": "WORK_START_YYMM4",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "Edit0",
"text": null,
"type": "Edit",
"column": null,
"dataset": null,
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "mdt_TotalInsuPerd01",
"text": null,
"type": "MaskEdit",
"column": "VSTM_WORK_DAYS",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
}
],
"safety": {
"warning": "이 API는 form contract/init 응답만 제공하며 임시저장, 대상자등록, 신고 전송을 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"noticeAlert",
"GetCommCombo",
"GetArtistfirmInfo",
"GetCnstInfo",
"WETB_013S"
],
"blocked_transaction_cmds": [
"JGBB_030I_TMP",
"JGBB_030I_SND"
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_JGBB_030",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"..."
],
"sections": [
{
"key": "applicant",
"label": "대상자 기본",
"columns": [
"NAME",
"RRNO",
"TELNO1",
"TELNO2",
"TELNO3"
]
},
{
"key": "selection",
"label": "신청구분",
"columns": [
"INSU_ACPT_YN_YG",
"INSU_ACPT_YN_GG",
"INSU_ACPT_YN_GY",
"INSU_ACPT_YN_SJ"
]
},
{
"key": "national_pension",
"label": "국민연금",
"columns": [
"LOSS_DT_YG",
"LOSS_CD_YG",
"OBTN_MTH_PAY_YN_YG"
]
},
{
"key": "health_insurance",
"label": "건강보험",
"columns": [
"LOSS_DT_GG",
"LOSS_CD_GG",
"TYEAR_FEE_TAMT",
"LYEAR_FEE_TAMT",
"TYEAR_CALC_MTHCNT",
"LYEAR_CALC_MTHCNT"
]
},
{
"key": "employment_insurance",
"label": "고용보험",
"columns": [
"LOSS_DT_GY",
"LOSS_RSN_TYPE_CD",
"LOSS_DETL_RSN",
"CHGOCP_DOC_YN",
"TYEAR_FEE_TAMT_HRDK",
"LYEAR_FEE_TAMT_HRDK"
]
},
{
"key": "workers_compensation",
"label": "산재보험",
"columns": [
"LOSS_DT_SJ",
"LOSS_RSN_TYPE_CD_KLWC",
"LOSS_DETL_RSN_KLWC",
"TYEAR_FEE_TAMT_KLWC",
"LYEAR_FEE_TAMT_KLWC"
]
},
{
"key": "employment_separation",
"label": "이직확인서/평균임금",
"columns": [
"CRTF_OBTN_DT",
"CHGOCP_RETR_DT",
"RSN_CD1",
"RSN_CD2",
"RSN_CD3",
"TOTAL_INSU_PERD",
"AVRG_SLRY",
"DAY_WORK_TIME"
]
},
{
"key": "agency",
"label": "보험사무 대행기관",
"columns": [
"INSU_ASCT_NO",
"INSU_ASCT_NAME"
]
},
{
"key": "target_grid",
"label": "대상자 그리드",
"dataset": "..."
}
],
"shortcut": "pageLinkPopup1('102')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "JGBB_030",
"field_count": 107,
"feature_name": "...",
"page_link_id": "102",
"target_ready": true,
"dataset_count": 35,
"workflow_step": "qualification_loss_form_contract_loaded",
"combo_requests": [
{
"label": "전화번호 지역코드",
"dataset": "..."
},
{
"label": "국민연금 상실부호",
"dataset": "..."
},
{
"label": "건강보험 상실부호",
"dataset": "..."
},
{
"label": "고용/산재 상실사유코드",
"dataset": "..."
},
{
"label": "이직확인서 사유",
"dataset": "..."
},
{
"label": "초일취득 당월상실 납부여부",
"dataset": "..."
},
{
"label": "상실사유 구체적사유",
"dataset": "..."
}
],
"default_values": {
"DOCID": "JGBB_030",
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15"
},
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": null,
"npc_bslc_mgmt_no": null,
"hrdk_bslc_mgmt_no": null,
"klwc_bslc_mgmt_no": null,
"nhic_bslc_mgmt_no": "",
"firm_management_no": null,
"target_context_ready": false,
"session_cookie_context_ready": false
},
"init_transactions": [
{
"cmd": "noticeAlert",
"action": "COMMONAction",
"effect": "화면 알림/공지 조회",
"mutates": false
},
{
"cmd": "GetCommCombo",
"action": "COMMONAction",
"effect": "공통 콤보 데이터 로드",
"mutates": false
},
{
"cmd": "GetArtistfirmInfo",
"action": "COMMONAction",
"effect": "예술인 사업장 여부 조회",
"mutates": false
},
{
"cmd": "GetCnstInfo",
"action": "COMMONAction",
"effect": "건설현장/사업장 보조정보 조회",
"mutates": false
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "JGBB_030Action",
"effect": "임시저장 유무 조회",
"out_ds": "...",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "JGBB_030I_TMP",
"action": "JGBB_030Action",
"button": "save",
"reason": "임시저장 데이터 생성"
},
{
"cmd": "JGBB_030I_SND",
"action": "JGBB_030Action",
"button": "send",
"reason": "실제 자격상실 신고 접수"
},
{
"button": "대상자등록",
"reason": "신고 대상자 등록/검증 상태 변경"
},
{
"button": "파일올리기/첨부파일 전송",
"reason": "첨부 파일 업로드 및 건강보험공단 전송"
}
],
"visible_text_markers": [
"7.1.~12.31.",
"1.1.~6.30.",
"※ 신고기한 : 연금/고용/산재(사유발생일이 속하는 달의 다음달 15일까지) / 건강(사유발생일로부터 14일 이내)",
"※ 사업장가입자 자격변동사유(입사 또는 퇴사 등)가 발생하는 경우 신고 기한내 신고하여야 합니다.",
"※ \\\"보수총액\\\" 상세 설명",
"※ \\\"보수총액\\\" 상세 설명('22.7.1.자 고용보험 요율인상 관련 작성방법)",
"신청구분",
"전화번호(휴대폰)",
"주민(외국인)등록번호",
"일련번호",
"작성일",
"보험사무 대행기관",
"성 명",
"번 호",
"명 칭",
"상실일",
"상실부호",
"연간보수총액",
"보수총액",
"근무월수",
"해당연도",
"전년도",
"상실사유코드",
"상실사유 구체적사유",
"-",
"전년도 보수총액",
"※ 2011.1.1부터 허위(정정신고 포함), 지연신고 등 위반행위 확인시 주의, 경고없이 즉시 과태료가 부과됩니다.",
"※ \\\"상실구분코드\\\" 상세 설명",
"! 귀 사업장은 으로 산재보험신고가 되지 않습니다.\\n 산재보험 고객지원센터(1588-0075)로 문의바랍니다.",
"초일취득ㆍ당월 상실자 납부여부",
"산재보험 자진납부사업장",
"※ 성명 중복자 등을 고려하여 주민번호 자동입력기능을\\r\\n 삭제하였으므로 주민번호 입력을 부탁드립니다.",
"※ 대표자 상실신고 시 대표자 변경사항을 사전에 관할지사에 확인 후 신고하시기 바랍니다. ※ 가입자가 휴직인 경우에는 복직신고 완료 후 신고하시기 바랍니다.\\r\\n※ 외국인 직장가입자는 체류기간이 종료된 날의 다음날로 자격이 상실됩니다. 해당사유 발생 즉시 상실신고 접수하시기 바랍니다. [직장가입자 상실 상세 설명]",
"※ 보수총액이 연말정산 신고 내역과 다른 경우 연말정산 재정산으로 접수",
" ※ 첨부파일은 국민건강보험공단에만 전송됩니다.(타기관 전송불가)",
"해당연도 보수총액",
"기간",
"일 ",
"성 명",
"작 성 일",
"사유",
"이직일",
"자격취득일(입사일)",
"* 취득일을 먼저 입력하세요.",
"통산피보험 단위기간",
"기준\\n기간\\r\\n연장",
"~",
"임금계산기간",
"계",
"총일수",
"일 ",
"임\\n금\\n내\\n역",
" 기본금",
" 기타수당",
" 상여금",
" 연차수당",
" ",
" 평균임금",
" 1일 통상임금",
" 1일소정근로시간",
" 기타(퇴직금외 기타 금품)",
" 이직 구체적사유",
" 1일 기준보수",
" 퇴직금 수령액",
" 총임금액 / 총일수 =",
"기간제 근로 현황\\n(피보험자가 기간제 근로자였거나 기간제 근로자로 근로하다 이직한 경우만 해당)",
"(근로제공 마지막 날)",
"*이직 전 12개월간 지급된 금액*3/12",
"*초단시간 근로일수",
"(해당자만 기재)",
"*초단시간 근로일수: 이직 전 24개월 동안 1주 소정근로시간이 15시간 미만이고 1주 소정근로일수가 2일 이하인 날",
"※ 납입고지유예기간은 근무월수에서 제외"
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "GetArtistfirmInfo",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "GetCnstInfo",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "JGBB_030Action",
"out_ds": "..."
},
{
"cmd": "JGBB_030I_TMP",
"in_ds": "...",
"action": "JGBB_030Action",
"out_ds": "..."
},
{
"cmd": "JGBB_030I_SND",
"in_ds": "...",
"action": "JGBB_030Action",
"out_ds": "..."
},
{
"cmd": "nameCheck",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "UserChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "JungNoChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
},
{
"cmd": "UserChk",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |