증명서 - 국민건강보험공단 EDI
1. 개인별 건강보험 납부확인 입력 서식 조회nhis_ edi. certificates. health_ premium_ payment. individual. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연동 계정으로 개인별 건강보험 납부확인서 신청 화면의 신청인 칸, 신청년월 칸, 가입자 명단 표의 열을 받습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- 발급확인·조회 성격이나 출력·발급 버튼은 init에서 미실행.
- 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.certificates.health_premium_payment.individual.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- menu_program_id=BM::BMDZ_090, screen_id=BM::BMDZ_200. certificate_key=health_premium_payment_individual.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| menu_ | string | null | 메뉴 프로그램 ID (BM::BMDZ_090) | |
| screen_ | string | 화면 ID (BM::BMDZ_200) | |
| certificate_ | string | 증명서 종류 키 (health_premium_payment_individual) | |
| blocked_ | array | 이 API에서 실행하지 않는(금지된) 트랜잭션 목록 | |
| business_ | object | 로그인한 사업장 기본 정보 | |
| dataset_ | number | 화면 dataset 개수 | |
| datasets | array | 원천 Nexacro/SSV dataset | |
| default_ | object | 화면 초기값 | |
| document_ | string | 서식/문서 코드 | |
| feature_ | string | 기능 표시명(사용자용 기능명) | |
| field_ | number | 화면 필드 개수 | |
| fields | array | form contract 입력 필드 목록 | |
| form_ | string | Nexacro form ID | |
| grid | object | 그리드 dataset·컬럼 정보 | |
| init_ | array | 초기 조회에 실행한 트랜잭션 목록 | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| safety | object | 안전 정책(실행 금지 동작과 그 사유) | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"columns": [
"CHKYN",
"ERR_MSG",
"PERSON_NM",
"PERSON_RRNO",
"SEQ",
"STR20",
"STR21",
"TGT_JUMIN_NO",
"TGT_RRNO"
],
"column_count": 9
},
"phase": "init",
"fields": [
{
"mask": "@@@@-@@-@@",
"name": "mdt_ToDay",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"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": "cbo_FinanceCd",
"text": "회계코드",
"type": "Combo",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_Goji",
"text": "고지차수",
"type": "Combo",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "Edit2",
"text": null,
"type": "Edit",
"column": "FIRM_NM",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "Edit1",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_SYM",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "Edit0",
"text": null,
"type": "Edit",
"column": "NHIC_BSLC_MGMT_NO",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_NM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "APLY_PRSN_JUMIN_NO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_FAX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_FAX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "APLY_PRSN_FAX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "APLY_PRSN_HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "APLY_PRSN_TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rdo_BoGubun",
"text": null,
"type": "Radio",
"column": "NY_INSU_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "####/##",
"name": "mdt_IssueYYmm2",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_STD_YYYYMM_FR",
"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": null,
"name": "edt_WrtDupSeq",
"text": null,
"type": "Edit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "cbo_FinanceCd",
"text": "회계코드",
"type": "Combo",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_Goji",
"text": "고지차수",
"type": "Combo",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "Edit2",
"text": null,
"type": "Edit",
"column": "FIRM_NM",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "Edit1",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_SYM",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "Edit0",
"text": null,
"type": "Edit",
"column": "NHIC_BSLC_MGMT_NO",
"dataset": "...",
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_NM",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "APLY_PRSN_JUMIN_NO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_FAX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_FAX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "APLY_PRSN_FAX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "APLY_PRSN_HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "APLY_PRSN_TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "APLY_PRSN_TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rdo_BoGubun",
"text": null,
"type": "Radio",
"column": "NY_INSU_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "####/##",
"name": "mdt_IssueYYmm2",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_STD_YYYYMM_FR",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_issue_gbn",
"text": null,
"type": "Radio",
"column": "APLY_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "####/##",
"name": "mdt_IssueYYmm2_part1",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_STD_YYYYMM_FR",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "####/##",
"name": "mdt_IssueYYmm2_part2",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_STD_YYYYMM_TO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_PrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "PERSON_RRNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_PrsnNm",
"text": null,
"type": "Edit",
"column": "PERSON_NM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_person_gbn",
"text": null,
"type": "Radio",
"column": "PRSN_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rdo_RealIssueDocKind_A",
"text": null,
"type": "Radio",
"column": "ISSUE_KIND",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_RealIssueDocKind_B",
"text": null,
"type": "Radio",
"column": "ISSUE_KIND",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_RealIssueDocKind_C",
"text": null,
"type": "Radio",
"column": "ISSUE_KIND",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_RealIssueDocKind_D",
"text": null,
"type": "Radio",
"column": "ISSUE_KIND",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_Issue_Gubun",
"text": null,
"type": "Radio",
"column": "ISSUE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NhicDiv_Nation_Finance_Cd",
"text": "회계코드",
"type": "Combo",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NhicDiv_Goji_Chasu",
"text": "고지차수",
"type": "Combo",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rdo_IssueUsageCd",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_YYYY",
"text": "발급년월",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "FEX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "FEX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "FEX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rbo_Language",
"text": null,
"type": "Radio",
"column": "NPC_LANGUAGE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_EngSaupName",
"text": null,
"type": "Edit",
"column": "ETC_DATA",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rbo_Use_Gubun",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NpcAYYYY_Fr",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcAYYYY_To",
"text": "발급년",
"type": "Combo",
"column": "TO_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rbo_Language",
"text": null,
"type": "Radio",
"column": "NPC_LANGUAGE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_Relation",
"text": null,
"type": "Combo",
"column": "...",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_Npc_NpsNo",
"text": null,
"type": "Edit",
"column": "NPC_SINGO_PERSON_NPS_NUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_EngSaupName",
"text": null,
"type": "Edit",
"column": "ETC_DATA",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NpcBYYYY_Fr",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "NPC_SINGO_PERSON_NPS_NUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rbo_Use_Gubun",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_Relation",
"text": null,
"type": "Combo",
"column": "NPC_SINGO_RELATION",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "Edit0",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NpcCYYYY_Fr",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCYYYY_To",
"text": "발급년",
"type": "Combo",
"column": "TO_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCMM_fr",
"text": "발급월",
"type": "Combo",
"column": "FROM_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCMM_to",
"text": "발급월",
"type": "Combo",
"column": "TO_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rbo_Language",
"text": null,
"type": "Radio",
"column": "NPC_LANGUAGE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_EngSaupName",
"text": null,
"type": "Edit",
"column": "ETC_DATA",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rbo_Use_Gubun",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_Npc_NpsNo",
"text": null,
"type": "Edit",
"column": "NPC_SINGO_PERSON_NPS_NUM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_Relation",
"text": null,
"type": "Combo",
"column": "NPC_SINGO_RELATION",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_bohumGubun",
"text": "보험구분",
"type": "Combo",
"column": "WRK_BOHUM_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_ISSUE_USE",
"text": "발급용도",
"type": "Combo",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "Combo1",
"text": "제줄기관",
"type": "Combo",
"column": "REQUEST_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NhicDiv_Nation_Finance_Cd",
"text": "회계코드",
"type": "Combo",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NhicDiv_Goji_Chasu",
"text": "고지차수",
"type": "Combo",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_YYYY",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_totnabbuNum",
"text": null,
"type": "Edit",
"column": "TOT_NABBU_NUMBER",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "FEX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "FEX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "FEX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_IssueUsageCd",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NhicDiv_Nation_Finance_Cd",
"text": "회계코드",
"type": "Combo",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NhicDiv_Goji_Chasu",
"text": "고지차수",
"type": "Combo",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_YYYY",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "FEX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "FEX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "FEX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_IssueUsageCd",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_totnabbuNum",
"text": null,
"type": "Edit",
"column": "TOT_NABBU_NUMBER",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_EtcFrom_MM",
"text": "발급월",
"type": "Combo",
"column": "FROM_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_bohumGubun",
"text": "보험구분",
"type": "Combo",
"column": "WRK_BOHUM_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rdo_IssueUsageCd",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NpcCYYYY_Fr",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCMM_fr",
"text": "발급월",
"type": "Combo",
"column": "FROM_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCYYYY_To",
"text": "발급년",
"type": "Combo",
"column": "TO_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCMM_to",
"text": "발급월",
"type": "Combo",
"column": "TO_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_Relation",
"text": null,
"type": "Combo",
"column": "NPC_SINGO_RELATION",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_bohumGubun",
"text": "보험구분",
"type": "Combo",
"column": "WRK_BOHUM_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "rdo_IssueUsageCd",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NpcCYYYY_Fr",
"text": "발급년",
"type": "Combo",
"column": "FROM_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCMM_fr",
"text": "발급월",
"type": "Combo",
"column": "FROM_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCYYYY_To",
"text": "발급년",
"type": "Combo",
"column": "TO_YYYY",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NpcCMM_to",
"text": "발급월",
"type": "Combo",
"column": "TO_MONTH",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_Relation",
"text": null,
"type": "Combo",
"column": "NPC_SINGO_RELATION",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "FEX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "FEX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "FEX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmStrtOrlgNo",
"text": null,
"type": "Edit",
"column": null,
"dataset": null,
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmStrtOrlgName",
"text": null,
"type": "Edit",
"column": null,
"dataset": null,
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "cbo_NhicDiv_Nation_Finance_Cd",
"text": "회계코드",
"type": "Combo",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "cbo_NhicDiv_Goji_Chasu",
"text": "고지차수",
"type": "Combo",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "SING_PRSN_NAME",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "###### - #######",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "SINGO_PRSN_JUMINNO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnTelNo1",
"text": "국번",
"type": "Combo",
"column": "TEL_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo2",
"text": null,
"type": "Edit",
"column": "TEL_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnTelNo3",
"text": null,
"type": "Edit",
"column": "TEL_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnHpNo1",
"text": "국번",
"type": "Combo",
"column": "HP_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo2",
"text": null,
"type": "Edit",
"column": "HP_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnHpNo3",
"text": null,
"type": "Edit",
"column": "HP_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "cbo_AplyPrsnFaxNo1",
"text": "국번",
"type": "Combo",
"column": "FEX_NO_1",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo2",
"text": null,
"type": "Edit",
"column": "FEX_NO_2",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnFaxNo3",
"text": null,
"type": "Edit",
"column": "FEX_NO_3",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_IssueUsageCd",
"text": null,
"type": "Radio",
"column": "ISSUE_USE_GUBUN",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_totnabbuNum",
"text": null,
"type": "Edit",
"column": "TOT_NABBU_NUMBER",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_fileName",
"text": null,
"type": "Edit",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "MaskEdit01",
"text": null,
"type": "MaskEdit",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
}
],
"safety": {
"warning": "화면은 발급확인/납부확인서 자료 조회 성격이지만 출력/발급 버튼은 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"BMDZ_200Init",
"WETB_013S",
"LogIns",
"WETB_013S",
"LogIns",
"BMDZ_200WtcCall",
"BMDZ_200WtcCall"
],
"blocked_transaction_cmds": [
"WETB_012_I02",
null,
null
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "BMDZ_200",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"..."
],
"shortcut": "pageLinkPopup1('171')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "BMDZ_200",
"field_count": 181,
"feature_name": "...",
"page_link_id": "171",
"target_ready": true,
"dataset_count": 61,
"feature_label": "증명서 발급확인 - 건강보험료 개인별 납부확인서",
"workflow_step": "certificate_health_premium_payment_individual_contract_loaded",
"default_values": {
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"menu_program_id": "...",
"actual_screen_id": "...",
"발급대상년월": "화면 기본값 또는 요청값"
},
"certificate_key": "health_premium_payment_individual",
"menu_program_id": "...",
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": "000",
"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": "BMDZ_200Init",
"in_ds": "...",
"action": "BMDZ_200Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_012Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "",
"mutates": false
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_012Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "",
"mutates": false
},
{
"cmd": "BMDZ_200WtcCall",
"in_ds": "...",
"action": "BMDZ_200Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "BMDZ_200WtcCall",
"in_ds": "",
"action": "BMDZ_200Action",
"out_ds": "...",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "WETB_012_I02",
"in_ds": "...",
"action": "WETB_012Action",
"out_ds": "...",
"reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
},
{
"button": "신고(신청)/신고(전송)/신청",
"reason": "증명서 신청 민원 생성 가능성"
},
{
"button": "출력/인쇄/다운로드",
"reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
}
],
"visible_text_markers": [
"Static22",
" 건강/장기요양보험 개인별 납부확인서 발급 신청 (신청 후 받은문서에서 확인 가능)",
"발급신청대상",
" 작성일자",
" 일련번호",
" 회계코드",
" 고지차수",
" 사업장명칭",
" 단위사업장 기호",
" 사업장관리번호",
"신청인 인적사항",
" 신청인성명",
" 신청인주민등록번호",
"-",
" 팩스번호",
" 휴대전화",
" 일반전화",
"발급신청구분",
" 신청구분",
" 신청년월",
"※ \\\"신고(신청)\\\"버튼을 누르면 신청되어 일정시간 경과 후 정상적으로 발급되면 \\\"받은문서목록\\\"에서 조회하실 수 있습니다.",
" 건강/장기요양보험 월별 납부확인서 발급 신청 (신청 후 받은문서에서 확인 가능)",
" 성명",
" 주민등록번호",
" 발급구분",
" 가입자선택",
"※ 가입자 선택 시 200명 까지만 가능합니다.",
" 주민등록번호",
"길이(Byte)",
" 참고사항",
" 납부확인서 발급 (실시간 발급 가능)",
"발급구분",
" 서식명",
" 발급년도",
" 국문/영문선택",
" 사업장영문명칭",
" 발급용도",
"※ \\\"발급\\\"버튼을 누르면 납부확인서가 출력됩니다.",
" 발급년도(기간)",
" 발급자와의 관계",
" 신청자NPS번호",
" 청구목적",
" 발급년월(기간)",
" 보험구분",
" 제출기관",
" 통합납부자번호",
" 발급년월",
" 발생신청년월",
" 신청인주민등록번호",
" 휴대전화",
" 발급용도",
" 신청인주민등록번호",
" 사업개시번호",
" ○ 선택하실 가입자 명단을 엑셀파일로 등록 합니다.",
" ○ 선택 가능한 최대 인원은 200명 입니다.",
" ○ 엑셀파일의 제일 첫 행에 주민등록번호를 숫자로만 표기하여 주시기 바랍니다.",
"※ 예시) 엑셀파일(주민등록번호 2개 이상)",
"1",
"2",
"A",
"000000-0000000",
"000000-0000000"
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "BMDZ_200Init",
"in_ds": "...",
"action": "BMDZ_200Action",
"out_ds": "..."
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_012Action",
"out_ds": "..."
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": ""
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_012Action",
"out_ds": "..."
},
{
"cmd": "WETB_012_I02",
"in_ds": "...",
"action": "WETB_012Action",
"out_ds": "..."
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": ""
},
{
"cmd": "BMDZ_200WtcCall",
"in_ds": "...",
"action": "BMDZ_200Action",
"out_ds": "..."
},
{
"cmd": "BMDZ_200WtcCall",
"in_ds": "",
"action": "BMDZ_200Action",
"out_ds": "..."
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
2. 보험료 납부확인서 입력 서식 조회nhis_ edi. certificates. payment_ completion. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연동 계정으로 건강보험료 납부확인서 화면의 고지 총액과 납부 총액 칸, 가입자별 보험료 표의 열, 발급번호 칸을 받습니다. 신고(신청)는 실행하지 않습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- safety.init_only=true. 신고(신청) 버튼은 실제 발급 신청 민원을 생성할 수 있어 init에서 미실행. PDF 발급은 payment_completion.issue.
- 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.certificates.payment_completion.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- fields·default_values·blocked_transactions·safety·certificate_key=payment_completion를 확인합니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| fields | array | 입력 필드 정의 배열 | |
| default_ | object | 기본값 설정 객체 | |
| blocked_ | array | 차단된 트랜잭션 목록 (실행 안 됨) | |
| safety | object | 안전 플래그 객체 (init_only=true) | |
| certificate_ | string | 증명서 종류 키 (payment_completion) | |
| business_ | object | 로그인한 사업장 기본 정보 | |
| dataset_ | number | 화면 dataset 개수 | |
| datasets | array | 원천 Nexacro/SSV dataset | |
| document_ | string | 서식/문서 코드 | |
| feature_ | string | 기능 표시명(사용자용 기능명) | |
| field_ | number | 화면 필드 개수 | |
| form_ | string | Nexacro form ID | |
| grid | object | 그리드 dataset·컬럼 정보 | |
| init_ | array | 초기 조회에 실행한 트랜잭션 목록 | |
| menu_ | string | null | 화면을 여는 메뉴 프로그램 ID | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"columns": [
"FIRM_BRDN_GOJI_CTRB",
"FIRM_BRDN_NABBU_CTRB_SUM",
"INDI_BRDN_GOJI_CTRB",
"JUMIN_NO",
"NM",
"NY_BRDN_NABBU_CTRB_SUM",
"NY_FIRM_BRDN_GOJI_CTRB",
"NY_INDI_BRDN_GOJI_CTRB"
],
"column_count": 8
},
"phase": "init",
"fields": [
{
"mask": "EDI38-##-########-#######",
"name": "mdt_IssueNoNew38",
"text": null,
"type": "MaskEdit",
"column": "PBLTN_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_01",
"text": null,
"type": "Edit",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmMgmtNo",
"text": null,
"type": "Edit",
"column": "FIRM_MGMT_NO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_GojiChasu",
"text": null,
"type": "Edit",
"column": "GOJI_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmNm",
"text": null,
"type": "Edit",
"column": "FIRM_NM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_UnitFrimNm",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_NM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_UnitFirmSym",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_SYM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_NationFinanceCd",
"text": null,
"type": "Edit",
"column": "NATION_FINANCE_CD",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "Checkbox3",
"text": " 건강 * 장기요양보험료",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "Checkbox2",
"text": " 장기요양보험료",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "Checkbox1",
"text": " 건강보험료",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_Cnt1",
"text": null,
"type": "MaskEdit",
"column": null,
"dataset": null,
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "mdk_Sum1_1",
"text": null,
"type": "MaskEdit",
"column": "GOJI_AMT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "mdk_Sum1_2",
"text": null,
"type": "MaskEdit",
"column": "NY_GOJI_CTRB_SUM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "mdk_TotSum1",
"text": null,
"type": "MaskEdit",
"column": "GOJI_AMT_TOT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "mdk_BrdnGojiCtrbSum",
"text": null,
"type": "MaskEdit",
"column": "NABBU_CTRB_SUM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "mdk_NyBrdnNabbuCtrbSum",
"text": null,
"type": "MaskEdit",
"column": "NY_NABBU_CTRB_SUM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "mdk_TotSum2",
"text": null,
"type": "MaskEdit",
"column": "NABBU_CTRB_SUM_TOT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####/##/##",
"name": "mdt_NtcDt",
"text": null,
"type": "MaskEdit",
"column": "NTC_DT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####/##/##-@@",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "EDI23-####-#-####-######",
"name": "mdt_IssueNo",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "EDI36-##-########-#######",
"name": "mdt_IssueNoNew",
"text": null,
"type": "MaskEdit",
"column": "PBLTN_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##",
"name": "edt_from_yyyymm",
"text": null,
"type": "MaskEdit",
"column": "FROM_YYYYMM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##",
"name": "edt_to_yyyymm",
"text": null,
"type": "MaskEdit",
"column": "TO_YYYYMM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##",
"name": "MaskEdit0",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_STD_YYYYMM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_Cnt",
"text": null,
"type": "Edit",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
}
],
"safety": {
"warning": "신고(신청) 버튼은 실제 납부확인서/완납증명서 발급 신청 민원을 생성할 수 있어 init에서는 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [],
"blocked_transaction_cmds": [
null,
null
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "BMDZ_100",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"..."
],
"shortcut": "pageLinkPopup1('174')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "BMDZ_100",
"field_count": 26,
"feature_name": "...",
"page_link_id": "174",
"target_ready": true,
"dataset_count": 6,
"feature_label": "증명서 발급 - 납부확인서, 완납증명서",
"workflow_step": "certificate_payment_completion_form_contract_loaded",
"default_values": {
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"발급신청구분": "건강/장기보험료, 건강보험료, 장기요양보험료 중 선택",
"발급신청대상": "사업장/개인별 화면 기본값"
},
"certificate_key": "payment_completion",
"menu_program_id": null,
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": "000",
"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": [],
"blocked_transactions": [
{
"button": "신고(신청)/신고(전송)/신청",
"reason": "증명서 신청 민원 생성 가능성"
},
{
"button": "출력/인쇄/다운로드",
"reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
}
],
"visible_text_markers": [
" 사업장관리번호",
" 발급일자",
"총고지 인원",
" 발급대상년월",
" 사용용도",
" 발급번호",
"고지\\n총액",
"건강보험료",
"장기요양보험료",
"납부\\n총액",
"합계",
" 작성차수",
" 단위사업장기호",
" 고지차수",
" 회계코드",
"구\\n\\n분",
" 사업장명칭",
" 회계 또는 단위사업장 명칭",
"~"
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": []
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
3. 보험료 납부확인서 발급 실행nhis_ edi. certificates. payment_ completion. issue
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
증명서 종류와 연도, 용도, 발급구분을 넣으면 사업장 건강보험 납부확인서나 4대보험 완납증명서를 발급해 PDF 파일로 받습니다.
- 로그인을 먼저 호출합니다. 기관 발급 화면을 거쳐 PDF 를 받으므로 조회 API 보다 오래 걸립니다. [국민건강보험공단 EDI 로그인]
- 요청 거절(HTTP 400, 작업은 만들어지지 않음).error.code=WRITE_CONFIRMATION_REQUIRED — confirmation_token 없이 부르면 발급하지 않고 이 오류로 끝납니다.error.message 에 확인할 내용이, error.confirmation_token 에 1회용 토큰이, error.preview 에 발급할 증명서 조건(증명서 종류, 연도, 용도, 구분)이 함께 옵니다.안내를 사용자에게 보여 주고 동의를 받은 뒤 같은 요청의 params.confirmation_token 에 그 토큰을 넣어 다시 보냅니다. 토큰은 10분 안에 한 번만 쓸 수 있고 처음 요청과 같은 본문에만 맞습니다.confirm 칸은 확인으로 쓰이지 않으며, 다시 보낼 때 더하면 본문이 달라져 확인 토큰 불일치로 끝납니다.
- 요청 거절(HTTP 409, 작업은 만들어지지 않음).error.code=WRITE_CONFIRMATION_INVALID — 토큰이 만료됐거나, 이미 썼거나, 다른 호출자나 다른 환경에서 받은 것이거나, 확인한 요청 본문과 달라졌으면 발급하지 않고 이 오류로 끝나며 어느 쪽인지는 알려 주지 않습니다.error.message 는 「확인이 만료됐거나 확인한 내용과 달라졌습니다. 다시 확인해 주세요.」 입니다. confirmation_token 없이 같은 요청을 다시 보내 새 토큰과 안내를 받은 뒤 사용자에게 다시 확인을 받습니다.
- certificate_kind 기본 payment_certificate(사업장 건강보험 납부확인서)이고 completion_certificate 는 사업장 4대보험 완납증명서입니다.납부확인서는 year(기본 당해), issue_usage 11(납부확인용, 기본) 12(연말정산용) 13(종합소득세신고용), issue_gubun 00(건강/장기보험료, 기본) 01(건강보험료) 02(장기요양보험료)를 씁니다.완납증명서는 issue_usage 51(조달청제출용) 52(국가, 지방자치단체, 공공기관 제출용)를 보내고 year 와 issue_gubun 은 쓰지 않습니다.issue_usage 기본값 11 은 납부확인서 용도이므로 완납증명서에는 51 이나 52 를 보냅니다.
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 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| certificate_ | string | - | N | payment_certificate(납부확인서) 또는 completion_certificate(완납증명서) | |
| year | string | 4 | N | 조회 연도. payment_certificate일 때 | |
| issue_ | string | - | N | 발급용도. payment: 11/12/13, completion: 51/52 | |
| issue_ | string | - | N | 발급구분 00/01/02. payment_certificate만 | |
| confirmation_ | string | - | N | 1회용 확인 토큰입니다. 처음에는 보내지 않습니다. 토큰 없이 부르면 기관에 아무것도 보내지 않고 작업도 만들지 않은 채 확인이 필요하다는 오류(WRITE_CONFIRMATION_REQUIRED)로 끝나고, 응답의 error.confirmation_token 에 토큰이 옵니다. error.message 의 안내를 사용자에게 보여 주고 동의를 받은 뒤 같은 요청에 이 토큰을 넣어 다시 부릅니다. 토큰은 10분 안에 한 번만 쓸 수 있고 처음 요청과 같은 본문, 같은 호출자, 같은 환경에서만 맞으며, 아니면 확인이 만료됐거나 내용이 달라졌다는 오류로 거절합니다 |
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: issue-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "nhis_edi",
"action": "nhis_edi.certificates.payment_completion.issue",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- pdf_downloaded=true, issue_no·pdf_size 확인. 받은 PDF 는 result.artifacts 에 download_url 과 함께 옵니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| pdf_ | boolean | PDF 다운로드 성공 여부 | |
| issue_ | string | null | 발급 번호 | |
| pdf_ | number | PDF 파일 크기 (bytes) | |
| pdf_ | string | null | PDF 열람 비밀번호 (사업장관리번호) | |
| pdf_ | string | null | 비밀번호 안내 문구 (미리보기 화면 안내 기준) | |
| certificate_ | string | 증명서 종류 (payment_certificate) | |
| selected_ | object | 발급 화면에서 선택된 값 | |
| request_ | string | 기관 화면에 넘긴 조회 인자 | |
| dialogs | array | 브라우저 대화상자 기록 | |
| report_ | string | 리포트 화면 URL |
// result.data
{
"pdf_downloaded": false,
"issue_no": "...",
"pdf_size": 0,
"pdf_password": "...",
"pdf_password_hint": "...",
"certificate_kind": "...",
"selected_values": {},
"request_argument": "...",
"dialogs": [],
"report_url": "..."
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| PROVIDER_ | 조건 거절 — retryable=false — 발급 화면에 넣은 조건(납부확인서는 year, issue_usage, issue_gubun, 완납증명서는 issue_usage)을 기관이 받지 않고 알림창으로 사유를 말했습니다. 발급 요청을 보내기 전이라 발급되지 않았습니다. error.message 는 「기관이 증명서 발급 조건을 받아들이지 않았습니다.」 뒤에 기관 사유가 붙은 문장입니다. 사유대로 값을 고친 뒤 confirmation_token 없이 다시 보내 새 확인을 받습니다. | |
| PROVIDER_ | 발급 거절 — retryable=false — 발급 요청 뒤 기관이 알림창으로 거절했습니다. error.message 는 「기관이 증명서 발급을 거절했습니다.」 뒤에 기관 사유가 붙은 문장입니다. 기관이 개인사업장이라 막았으면 error.message 는 「개인사업장은 조달청 제출용 완납증명서만 발급할 수 있습니다. 다른 용도는 대표자 개인 기준으로 발급해야 합니다.」 입니다. 그대로 다시 부르지 않고 사유를 먼저 확인합니다. | |
| PROVIDER_ | 결과 확인 불가 — retryable=false — 발급 요청을 누른 뒤 60초 안에 증명서 화면도 알림창도 오지 않았거나, 받은 파일이 PDF 가 아니거나, 누른 뒤 증명서 화면이나 내려받기에서 오류가 났습니다. 이미 발급됐을 수 있습니다. error.message 는 「기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.」 입니다. 같은 요청을 다시 보내지 않습니다. | |
| PROVIDER_ | 화면 준비 안 됨 — 기관 발급 화면을 열지 못했거나, 알림창 없이 조건을 넣지 못했거나, 발급 버튼을 찾지 못해 발급 요청을 보내기 전에 멈췄습니다. error.message 는 「기관에 연결하지 못해 요청을 보내지 못했습니다. 잠시 후 다시 시도해 주세요.」 입니다. 쓰기 액션이라 retryable=false 로 표시되지만 보낸 것이 없으므로, 잠시 뒤 confirmation_token 없이 다시 보내 새 확인을 받으면 됩니다. | |
| AUTH_ | 세션 없음 — 로그인 세션이 없어 기관 화면을 열기 전에 멈췄습니다. error.message 는 쓰기 액션에 공통으로 붙는 문장이라 이미 제출됐을 수 있다고 말하지만, 이 액션은 이 경우 발급 요청을 보내지 않습니다. 로그인(nhis_edi.session.login)을 먼저 호출한 뒤 confirmation_token 없이 다시 보내 새 확인을 받습니다. | |
| PROVIDER_ | 세션 만료 — 발급 화면을 여는 중 기관이 「로그인 인증이 만료되었습니다.」 알림창을 띄워 발급 요청을 보내기 전에 멈췄습니다. error.message 는 세션 없음과 같은 공통 문장입니다. 로그인(nhis_edi.session.login)을 다시 호출한 뒤 confirmation_token 없이 다시 보내 새 확인을 받습니다. | |
| VALIDATION_ | 입력 오류 — retryable=false — certificate_kind 가 지원하지 않는 값이라 기관 화면을 열기 전에 멈췄습니다. error.message 는 「증명서 종류(certificate_kind)는 payment_certificate(납부확인서)나 completion_certificate(완납증명서)만 받습니다.」 입니다. | |
| POLICY_ | 기능 꺼짐 — 지금은 발급할 수 없습니다. 같은 화면의 입력 계약 조회(nhis_edi.certificates.payment_completion.init)와 다른 조회 액션은 그대로 쓸 수 있습니다. | |
| INTERNAL_ | 서버 구성 — 서버에서 발급용 브라우저를 쓸 수 없어 기관 화면을 열기 전에 멈췄습니다. error.message 는 「지금은 이 상품을 처리할 수 없습니다. 서버 구성 문제로 요청을 실행하지 못했습니다. 서비스문의로 알려 주세요.」 입니다. 다시 불러도 풀리지 않으므로 서비스문의로 알립니다. |
4. 사업장 적용 통보서 신청 입력 서식 조회nhis_ edi. certificates. workplace_ application_ notice. apply. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연동 계정으로 사업장 적용 통보서 신청서 화면의 한글 영문 신청구분, 사업장 칸, 작성일과 일련번호 칸을 받습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- 신고(전송)·신청 버튼 미실행 — 발급 신청 접수로 이어질 수 있음.
- 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.certificates.workplace_application_notice.apply.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- certificate_key=workplace_application_notice_apply. page_link_id=175.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| certificate_ | string | 증명서 종류 키 (workplace_application_notice_apply) | |
| page_ | string | 건강보험 EDI 화면 번호 (175) | |
| blocked_ | array | 이 API에서 실행하지 않는(금지된) 트랜잭션 목록 | |
| business_ | object | 로그인한 사업장 기본 정보 | |
| dataset_ | number | 화면 dataset 개수 | |
| datasets | array | 원천 Nexacro/SSV dataset | |
| default_ | object | 화면 초기값 | |
| document_ | string | 서식/문서 코드 | |
| feature_ | string | 기능 표시명(사용자용 기능명) | |
| field_ | number | 화면 필드 개수 | |
| fields | array | form contract 입력 필드 목록 | |
| form_ | string | Nexacro form ID | |
| grid | object | 그리드 dataset·컬럼 정보 | |
| init_ | array | 초기 조회에 실행한 트랜잭션 목록 | |
| menu_ | string | null | 화면을 여는 메뉴 프로그램 ID | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| safety | object | 안전 정책(실행 금지 동작과 그 사유) | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"columns": [],
"column_count": 0
},
"phase": "init",
"fields": [
{
"mask": null,
"name": "edt_FirmName",
"text": null,
"type": "Edit",
"column": "FIRM_NM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmSym",
"text": null,
"type": "Edit",
"column": "NHIC_BSLC_MGMT_NO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_UnitFirmSym",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_SYM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "@@@@/@@/@@",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "##",
"name": "mdt_Wrt_Dup_Seq",
"text": null,
"type": "MaskEdit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_KorEng",
"text": null,
"type": "Radio",
"column": "ISSUE_LANGUAGE_TYPE",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": "..."
}
],
"safety": {
"warning": "신고(전송)/신청 버튼은 사업장 적용 통보서 발급 신청 접수로 이어질 수 있어 init에서는 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"WETB_013S",
"WETB_013S"
],
"blocked_transaction_cmds": [
"WETB_011_I01",
"WETB_011_I02",
null,
null
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_WETB011",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"..."
],
"shortcut": "pageLinkPopup1('175')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "WETB_011",
"field_count": 6,
"feature_name": "...",
"page_link_id": "175",
"target_ready": true,
"dataset_count": 6,
"feature_label": "증명서 발급 - 사업장 적용 통보서 신청서",
"workflow_step": "certificate_workplace_application_notice_apply_contract_loaded",
"default_values": {
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"발급대상": "단위사업장 적용통보서 등 화면 선택값",
"신청구분": "한글/영문 선택"
},
"certificate_key": "workplace_application_notice_apply",
"menu_program_id": null,
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": "000",
"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": "WETB_011Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "...",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "WETB_011_I01",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "...",
"reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
},
{
"cmd": "WETB_011_I02",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "...",
"reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
},
{
"button": "신고(신청)/신고(전송)/신청",
"reason": "증명서 신청 민원 생성 가능성"
},
{
"button": "출력/인쇄/다운로드",
"reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
}
],
"visible_text_markers": [
" 사업장관리번호",
" 사업장명칭",
" 한 글",
"신청구분",
" 영 문",
"발급대상",
" 단위사업장 기호",
" 작성일",
" 일련번호",
"* 아래 해당 항목을 선택하신 후, 『신고(전송)/신청』를 클릭하셔야 발급됩니다."
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "..."
},
{
"cmd": "WETB_011_I01",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "..."
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "..."
},
{
"cmd": "WETB_011_I02",
"in_ds": "...",
"action": "WETB_011Action",
"out_ds": "..."
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
5. 사업장 적용 통보서 발급확인 입력 서식 조회nhis_ edi. certificates. workplace_ application_ notice. issued. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연동 계정으로 발급된 사업장 적용 통보서 화면의 사업장명, 사용자 성명, 적용일자, 가입자수, 발급번호 칸 구성을 받습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- 기존 발급 건 확인 contract만 제공. 출력·다운로드 미실행. 발급번호 조회 시 필요.
- 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.certificates.workplace_application_notice.issued.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- certificate_key=workplace_application_notice_issued. page_link_id=172.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| certificate_ | string | 증명서 종류 키 (workplace_application_notice_issued) | |
| page_ | string | 건강보험 EDI 화면 번호 (172) | |
| blocked_ | array | 이 API에서 실행하지 않는(금지된) 트랜잭션 목록 | |
| business_ | object | 로그인한 사업장 기본 정보 | |
| dataset_ | number | 화면 dataset 개수 | |
| datasets | array | 원천 Nexacro/SSV dataset | |
| default_ | object | 화면 초기값 | |
| document_ | string | 서식/문서 코드 | |
| feature_ | string | 기능 표시명(사용자용 기능명) | |
| field_ | number | 화면 필드 개수 | |
| fields | array | form contract 입력 필드 목록 | |
| form_ | string | Nexacro form ID | |
| grid | object | 그리드 dataset·컬럼 정보 | |
| init_ | array | 초기 조회에 실행한 트랜잭션 목록 | |
| menu_ | string | null | 화면을 여는 메뉴 프로그램 ID | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| safety | object | 안전 정책(실행 금지 동작과 그 사유) | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"columns": [],
"column_count": 0
},
"phase": "init",
"fields": [
{
"mask": null,
"name": "edt_FirmMgmtNo",
"text": null,
"type": "Edit",
"column": "FIRM_MGMT_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmNm",
"text": null,
"type": "Edit",
"column": "FIRM_NM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_ReprNm",
"text": null,
"type": "Edit",
"column": "REPR_NM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@@@@@@@@@@@",
"name": "mdt_BirthDay",
"text": null,
"type": "MaskEdit",
"column": "BIRTH_DAY",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##.##",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##.##",
"name": "mdt_NtcDt",
"text": null,
"type": "MaskEdit",
"column": "FIRM_ENTER_DT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_UnitFirmNm",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_NM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@@-####-#-####-######",
"name": "edt_IssueNo",
"text": null,
"type": "MaskEdit",
"column": "ISSUE_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmMgmtNo",
"text": null,
"type": "Edit",
"column": "FIRM_MGMT_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_FirmNm",
"text": null,
"type": "Edit",
"column": "FIRM_NM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_ReprNm",
"text": null,
"type": "Edit",
"column": "REPR_NM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@@@@@@@@@@@",
"name": "mdt_BirthDay",
"text": null,
"type": "MaskEdit",
"column": "BIRTH_DAY",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##.##",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "####.##.##",
"name": "mdt_NtcDt",
"text": null,
"type": "MaskEdit",
"column": "FIRM_ENTER_DT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_UnitFirmNm",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_NM",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@@-####-#-####-######",
"name": "edt_IssueNo",
"text": null,
"type": "MaskEdit",
"column": null,
"dataset": null,
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "#,##0",
"name": "edt_gaibjasu",
"text": null,
"type": "MaskEdit",
"column": "EMP_CNT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@/@@/@@-@@-@@",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
}
],
"safety": {
"warning": "기존 발급 증명서 확인 화면 contract만 제공하며 출력/다운로드는 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"LogIns"
],
"blocked_transaction_cmds": [
null,
null
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_JGDB_FIRM_ADPT_NOTICE",
"success": true,
"datasets": [
"...",
"...",
"..."
],
"shortcut": "pageLinkPopup1('172')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "JGDB_060",
"field_count": 18,
"feature_name": "...",
"page_link_id": "172",
"target_ready": true,
"dataset_count": 3,
"feature_label": "증명서 발급확인 - 사업장 적용 통보서",
"workflow_step": "certificate_workplace_application_notice_issued_contract_loaded",
"default_values": {
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"발급번호": "기존 발급 건 조회/확인 시 필요"
},
"certificate_key": "workplace_application_notice_issued",
"menu_program_id": null,
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": "000",
"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": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "",
"mutates": false
}
],
"blocked_transactions": [
{
"button": "신고(신청)/신고(전송)/신청",
"reason": "증명서 신청 민원 생성 가능성"
},
{
"button": "출력/인쇄/다운로드",
"reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
}
],
"visible_text_markers": [
"Issuance Number : :",
"National Health Insurance (NHI)",
"Name of workplace : ",
"Name of Employer : ",
"Date of NHI Enrollment :",
"This is to certify that the workplace above has been enrolled as an NHI covered",
"workplace in accordance with the article 6 of the National Health Insurance Act.",
"Resident Registration No. :",
"발급일자 :",
"Certificate of Workplace Insured with Korean",
"of Workplace",
"Registration No.",
"Name of Business Unit :",
"National Health Insurance Service",
"건강보험 단위사업장 적용통보서",
"사업장 기호 :",
"사업장 관리번호 :",
"발급번호 :",
"사 업 장 명 :",
"사용자 성명 :",
"적 용 일 자 :",
"귀 사업장은 국민건강보험법 제6조의 규정에 의거 건강보험",
"적용사업장으로 지정되었음을 통보합니다.",
"주 민 번 호 :",
"단위사업장명 :",
"※ 가입자 없는 사업장은 소급해서 탈퇴 될 수 있습니다.",
"(가입자수:",
"명) [※ 전일기준]",
"건강보험사업장 적용통보서",
" 작성차수"
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": ""
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
6. 사업장 가입자 명부 신청 입력 서식 조회nhis_ edi. certificates. workplace_ member_ list. apply. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연동 계정으로 부르면 사업장 가입자 명부 신청 화면의 가입자 범위와 상실자 포함 보기, 대상자 성명과 주민등록번호 칸을 돌려줍니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- 신고(전송)·신청 버튼 미실행. default_values에 가입자범위·상실자포함 선택값 계약 포함.
- 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.certificates.workplace_member_list.apply.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- certificate_key=workplace_member_list_apply. page_link_id=176.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| certificate_ | string | 증명서 종류 키 (workplace_member_list_apply) | |
| page_ | string | 건강보험 EDI 화면 번호 (176) | |
| blocked_ | array | 이 API에서 실행하지 않는(금지된) 트랜잭션 목록 | |
| business_ | object | 로그인한 사업장 기본 정보 | |
| dataset_ | number | 화면 dataset 개수 | |
| datasets | array | 원천 Nexacro/SSV dataset | |
| default_ | object | 화면 초기값 | |
| document_ | string | 서식/문서 코드 | |
| feature_ | string | 기능 표시명(사용자용 기능명) | |
| field_ | number | 화면 필드 개수 | |
| fields | array | form contract 입력 필드 목록 | |
| form_ | string | Nexacro form ID | |
| grid | object | 그리드 dataset·컬럼 정보 | |
| init_ | array | 초기 조회에 실행한 트랜잭션 목록 | |
| menu_ | string | null | 화면을 여는 메뉴 프로그램 ID | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| safety | object | 안전 정책(실행 금지 동작과 그 사유) | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"columns": [
"DAESANGJA_NM",
"FIRM_SYM",
"SEQ",
"TGT_JUMIN_NO",
"UNIT_FIRM_SYM"
],
"column_count": 5
},
"phase": "init",
"fields": [
{
"mask": null,
"name": "mdt_Firm_Sym",
"text": null,
"type": "Edit",
"column": "NHIC_BSLC_MGMT_NO",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_NotAll",
"text": null,
"type": "Radio",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": "@@@@@@-@@@@@@@",
"name": "mdt_AplyPrsnJuminNo",
"text": null,
"type": "MaskEdit",
"column": "TGT_JUMIN_NO",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "edt_AplyPrsnNm",
"text": null,
"type": "Edit",
"column": "DAESANGJA_NM",
"dataset": "...",
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "rdo_All",
"text": null,
"type": "Radio",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "chk_All",
"text": "포함",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "chk_NotAll",
"text": "미포함",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": null,
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "mdt_Unit_Firm_Sym",
"text": null,
"type": "Edit",
"column": "UNIT_FIRM_SYM",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "@@@@/@@/@@",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": "##",
"name": "mdt_Wrt_Dup_Seq",
"text": null,
"type": "MaskEdit",
"column": "WRT_DUP_SEQ",
"dataset": "...",
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "chk_part_in",
"text": "포함",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
},
{
"mask": null,
"name": "chk_part_ex",
"text": "미포함",
"type": "CheckBox",
"column": null,
"dataset": null,
"enabled": "false",
"readonly": null,
"innerdataset": null
}
],
"safety": {
"warning": "신고(전송)/신청 버튼은 사업장 가입자 명부 발급 신청 접수로 이어질 수 있어 init에서는 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [
"WETB_013S",
"LogIns",
"LogIns",
"WETB_013S",
"LogIns",
"nameCheck"
],
"blocked_transaction_cmds": [
"WETB_013_I01",
"WETB_013_I02",
null,
null
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "frm_WETB_013",
"success": true,
"datasets": [
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"...",
"..."
],
"shortcut": "pageLinkPopup1('176')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "WETB_013",
"field_count": 12,
"feature_name": "...",
"page_link_id": "176",
"target_ready": true,
"dataset_count": 12,
"feature_label": "증명서 발급 - 사업장가입자명부발급 신청서",
"workflow_step": "certificate_workplace_member_list_apply_contract_loaded",
"default_values": {
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"가입자범위": "가입자 전원/가입자 일부",
"상실자포함": "포함/미포함"
},
"certificate_key": "workplace_member_list_apply",
"menu_program_id": null,
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": "000",
"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": "WETB_013Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "",
"mutates": false
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "",
"mutates": false
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "...",
"mutates": false
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "",
"mutates": false
},
{
"cmd": "nameCheck",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "...",
"mutates": false
}
],
"blocked_transactions": [
{
"cmd": "WETB_013_I01",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "...",
"reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
},
{
"cmd": "WETB_013_I02",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "...",
"reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
},
{
"button": "신고(신청)/신고(전송)/신청",
"reason": "증명서 신청 민원 생성 가능성"
},
{
"button": "출력/인쇄/다운로드",
"reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
}
],
"visible_text_markers": [
"상실자",
"주민(외국인)등록번호",
"발급명단 대상자",
"성명",
"▶ 사업장 가입자명부 발급 신청서(총 54Byte)",
"필드명",
"주민등록번호",
"길이(Byte)",
"X40",
"N13",
"◈ N13 : 'N'은 숫자를 의미함, '13'는 자릿수를 의미함.",
"◈ X40 : 'X'는 문자를 의미함, '40'은 자릿수를 의미함.",
"◈ XLS, TXT 파일 모두 신고가능",
" (TXT파일은 항목간 구분은 \\\";\\\"(세미콜론)입력)",
"※ (예시) 홍길동;1234567890123",
" 사업장관리번호",
" 단위사업장 기호",
"발급대상",
" 작성일",
" 일련번호",
"* 아래 해당 항목을 선택 후, 『신고(전송)/신청』을 클릭하셔야 발급됩니다.",
"* 본 【사업장 가입자 명부】는 반드시 국민건강보험업무를 위해서만 사용하여야 하며, 또한 【사업장 가입자 명부】는 개인정보이므로\\n\\n",
" 외부로 유출되어 개인의 이익이 침해되는 경우 <b v='true'><fc v='red'>법적인 책임은 공단에 있지 않음</fc></b>을 알려드립니다.",
"* 사업장 가입자 명부 발급은 <b v='true'><fc v='red'>통상 10분 이내로</fc></b> 처리되나, 발급 대상자 수와 전산 상황에 따라 다소 지연될 수 있습니다."
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": [
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "..."
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": ""
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": ""
},
{
"cmd": "WETB_013_I01",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "..."
},
{
"cmd": "WETB_013S",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "..."
},
{
"cmd": "WETB_013_I02",
"in_ds": "...",
"action": "WETB_013Action",
"out_ds": "..."
},
{
"cmd": "LogIns",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": ""
},
{
"cmd": "nameCheck",
"in_ds": "...",
"action": "COMMONAction",
"out_ds": "..."
}
]
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |
7. 사업장 가입자 명부 발급확인 입력 서식 조회nhis_ edi. certificates. workplace_ member_ list. issued. init
MCP 도구 이름 nhis_
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
로그인한 연동 계정으로 사업장 가입자 명부 발급확인 화면의 발급일자, 작성차수, 발급번호 칸과 명부 표의 열 이름을 받습니다.
- 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
- 기존 발급 명부 확인 contract만 제공. 출력·다운로드 미실행.
- 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.certificates.workplace_member_list.issued.init",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- certificate_key=workplace_member_list_issued. page_link_id=173.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| API_ | string | 이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다. | |
| certificate_ | string | 증명서 종류 키 (workplace_member_list_issued) | |
| page_ | string | 건강보험 EDI 화면 번호 (173) | |
| blocked_ | array | 이 API에서 실행하지 않는(금지된) 트랜잭션 목록 | |
| business_ | object | 로그인한 사업장 기본 정보 | |
| dataset_ | number | 화면 dataset 개수 | |
| datasets | array | 원천 Nexacro/SSV dataset | |
| default_ | object | 화면 초기값 | |
| document_ | string | 서식/문서 코드 | |
| feature_ | string | 기능 표시명(사용자용 기능명) | |
| field_ | number | 화면 필드 개수 | |
| fields | array | form contract 입력 필드 목록 | |
| form_ | string | Nexacro form ID | |
| grid | object | 그리드 dataset·컬럼 정보 | |
| init_ | array | 초기 조회에 실행한 트랜잭션 목록 | |
| menu_ | string | null | 화면을 여는 메뉴 프로그램 ID | |
| observed_ | array | 화면에서 관찰한 service 호출 목록 | |
| safety | object | 안전 정책(실행 금지 동작과 그 사유) | |
| script_ | string | 화면 XFDL JavaScript URL | |
| shortcut | string | 화면을 여는 바로가기 호출식(pageLinkPopup1 등) | |
| source_ | string | 원천 NHIS EDI URL | |
| target_ | boolean | 화면 진입 준비 완료 여부 | |
| visible_ | array | 화면 확인용 고정 문구 |
// result.data
{
"grid": {
"columns": [
"JUNG_CHWIDUK_DT",
"JUNG_NO",
"JUNG_SANGSIL_DT",
"JUNIM_NM_PW",
"NM",
"SEQ_NO"
],
"column_count": 6
},
"phase": "init",
"fields": [
{
"mask": null,
"name": "edt_Brch",
"text": null,
"type": "Edit",
"column": "BRCH",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@/@@/@@-@@",
"name": "mdt_WrtChasu",
"text": null,
"type": "MaskEdit",
"column": "WRT_CHASU",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": "@@@@/@@/@@",
"name": "mdk_ProcDt",
"text": null,
"type": "MaskEdit",
"column": "PROC_DT",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
},
{
"mask": null,
"name": "edt_DocNo",
"text": null,
"type": "Edit",
"column": "DOC_NO",
"dataset": "...",
"enabled": null,
"readonly": "true",
"innerdataset": null
}
],
"safety": {
"warning": "기존 발급 가입자 명부 확인 화면 contract만 제공하며 출력/다운로드는 실행하지 않는다.",
"init_only": true,
"allowed_transaction_cmds": [],
"blocked_transaction_cmds": [
null,
null
],
"mutating_actions_executed": false
},
"API_KEY": "[REDACTED]",
"form_id": "JGDB_080",
"success": true,
"datasets": [
"...",
"...",
"..."
],
"shortcut": "pageLinkPopup1('173')",
"screen_id": "...",
"program_id": "...",
"route_kind": "live_session_contract",
"script_url": "https://...",
"source_url": "https://...",
"document_id": "JGDB_080",
"field_count": 4,
"feature_name": "...",
"page_link_id": "173",
"target_ready": true,
"dataset_count": 3,
"feature_label": "증명서 발급확인 - 사업장 가입자 명부",
"workflow_step": "certificate_workplace_member_list_issued_contract_loaded",
"default_values": {
"WRT_CHASU": "20260615ZZ",
"작성일": "2026-06-15",
"발급번호": "기존 발급 건 조회/확인 시 필요"
},
"certificate_key": "workplace_member_list_issued",
"menu_program_id": null,
"source_evidence": {},
"business_context": {
"firm_sym": null,
"firm_name": null,
"unit_firm_sym": "000",
"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": [],
"blocked_transactions": [
{
"button": "신고(신청)/신고(전송)/신청",
"reason": "증명서 신청 민원 생성 가능성"
},
{
"button": "출력/인쇄/다운로드",
"reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
}
],
"visible_text_markers": [
" 발급일자",
" 작성차수",
" 발급번호",
"* 출력시 주민등록번호 일부는 개인정보보호를 위해 특수문자로 대체됩니다."
],
"implementation_status": "implemented_init_form_contract_only",
"observed_callservices": []
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| AUTH_ | 세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다. |