개발자 문서
API 레퍼런스

증명서 - 국민건강보험공단 EDI

1. 개인별 건강보험 납부확인 입력 서식 조회nhis_edi.certificates.health_premium_payment.individual.init

MCP 도구 이름 nhis_edi__certificates__health_premium_payment__individual__init

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

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

연동 계정으로 개인별 건강보험 납부확인서 신청 화면의 신청인 칸, 신청년월 칸, 가입자 명단 표의 열을 받습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 발급확인·조회 성격이나 출력·발급 버튼은 init에서 미실행.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.health_premium_payment.individual.init이 API 고정값 (기본값)

예시 : nhis_edi.certificates.health_premium_payment.individual.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

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

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_KEYstring이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다.
menu_program_idstring | null메뉴 프로그램 ID (BM::BMDZ_090)
screen_idstring화면 ID (BM::BMDZ_200)
certificate_keystring증명서 종류 키 (health_premium_payment_individual)
blocked_transactionsarray이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_contextobject로그인한 사업장 기본 정보
dataset_countnumber화면 dataset 개수
datasetsarray원천 Nexacro/SSV dataset
default_valuesobject화면 초기값
document_idstring서식/문서 코드
feature_labelstring기능 표시명(사용자용 기능명)
field_countnumber화면 필드 개수
fieldsarrayform contract 입력 필드 목록
form_idstringNexacro form ID
gridobject그리드 dataset·컬럼 정보
init_transactionsarray초기 조회에 실행한 트랜잭션 목록
observed_callservicesarray화면에서 관찰한 service 호출 목록
safetyobject안전 정책(실행 금지 동작과 그 사유)
script_urlstring화면 XFDL JavaScript URL
shortcutstring화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_urlstring원천 NHIS EDI URL
target_readyboolean화면 진입 준비 완료 여부
visible_text_markersarray화면 확인용 고정 문구
json
// 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_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

2. 보험료 납부확인서 입력 서식 조회nhis_edi.certificates.payment_completion.init

MCP 도구 이름 nhis_edi__certificates__payment_completion__init

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

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

연동 계정으로 건강보험료 납부확인서 화면의 고지 총액과 납부 총액 칸, 가입자별 보험료 표의 열, 발급번호 칸을 받습니다. 신고(신청)는 실행하지 않습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • safety.init_only=true. 신고(신청) 버튼은 실제 발급 신청 민원을 생성할 수 있어 init에서 미실행. PDF 발급은 payment_completion.issue.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.payment_completion.init이 API 고정값 (기본값)

예시 : nhis_edi.certificates.payment_completion.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

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

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_KEYstring이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다.
fieldsarray입력 필드 정의 배열
default_valuesobject기본값 설정 객체
blocked_transactionsarray차단된 트랜잭션 목록 (실행 안 됨)
safetyobject안전 플래그 객체 (init_only=true)
certificate_keystring증명서 종류 키 (payment_completion)
business_contextobject로그인한 사업장 기본 정보
dataset_countnumber화면 dataset 개수
datasetsarray원천 Nexacro/SSV dataset
document_idstring서식/문서 코드
feature_labelstring기능 표시명(사용자용 기능명)
field_countnumber화면 필드 개수
form_idstringNexacro form ID
gridobject그리드 dataset·컬럼 정보
init_transactionsarray초기 조회에 실행한 트랜잭션 목록
menu_program_idstring | null화면을 여는 메뉴 프로그램 ID
observed_callservicesarray화면에서 관찰한 service 호출 목록
script_urlstring화면 XFDL JavaScript URL
shortcutstring화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_urlstring원천 NHIS EDI URL
target_readyboolean화면 진입 준비 완료 여부
visible_text_markersarray화면 확인용 고정 문구
json
// 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_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

3. 보험료 납부확인서 발급 실행nhis_edi.certificates.payment_completion.issue

MCP 도구 이름 nhis_edi__certificates__payment_completion__issue

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

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

증명서 종류와 연도, 용도, 발급구분을 넣으면 사업장 건강보험 납부확인서나 4대보험 완납증명서를 발급해 PDF 파일로 받습니다.

  • 로그인을 먼저 호출합니다. 기관 발급 화면을 거쳐 PDF 를 받으므로 조회 API 보다 오래 걸립니다. [국민건강보험공단 EDI 로그인]
  • 요청 거절(HTTP 400, 작업은 만들어지지 않음).
  • 요청 거절(HTTP 409, 작업은 만들어지지 않음).
  • certificate_kind 기본 payment_certificate(사업장 건강보험 납부확인서)이고 completion_certificate 는 사업장 4대보험 완납증명서입니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.payment_completion.issue이 API 고정값 (기본값)

예시 : nhis_edi.certificates.payment_completion.issue

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

순번변수명타입길이필수설명
certificate_kindstring-Npayment_certificate(납부확인서) 또는 completion_certificate(완납증명서)
yearstring4N조회 연도. payment_certificate일 때

형식 : YYYY

issue_usagestring-N발급용도. payment: 11/12/13, completion: 51/52
issue_gubunstring-N발급구분 00/01/02. payment_certificate만
confirmation_tokenstring-N1회용 확인 토큰입니다. 처음에는 보내지 않습니다. 토큰 없이 부르면 기관에 아무것도 보내지 않고 작업도 만들지 않은 채 확인이 필요하다는 오류(WRITE_CONFIRMATION_REQUIRED)로 끝나고, 응답의 error.confirmation_token 에 토큰이 옵니다. error.message 의 안내를 사용자에게 보여 주고 동의를 받은 뒤 같은 요청에 이 토큰을 넣어 다시 부릅니다. 토큰은 10분 안에 한 번만 쓸 수 있고 처음 요청과 같은 본문, 같은 호출자, 같은 환경에서만 맞으며, 아니면 확인이 만료됐거나 내용이 달라졌다는 오류로 거절합니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_downloadedbooleanPDF 다운로드 성공 여부
issue_nostring | null발급 번호
pdf_sizenumberPDF 파일 크기 (bytes)
pdf_passwordstring | nullPDF 열람 비밀번호 (사업장관리번호)
pdf_password_hintstring | null비밀번호 안내 문구 (미리보기 화면 안내 기준)
certificate_kindstring증명서 종류 (payment_certificate)
selected_valuesobject발급 화면에서 선택된 값
request_argumentstring기관 화면에 넘긴 조회 인자
dialogsarray브라우저 대화상자 기록
report_urlstring리포트 화면 URL
json
// 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_BUSINESS_ERROR조건 거절 — retryable=false — 발급 화면에 넣은 조건(납부확인서는 year, issue_usage, issue_gubun, 완납증명서는 issue_usage)을 기관이 받지 않고 알림창으로 사유를 말했습니다. 발급 요청을 보내기 전이라 발급되지 않았습니다. error.message 는 「기관이 증명서 발급 조건을 받아들이지 않았습니다.」 뒤에 기관 사유가 붙은 문장입니다. 사유대로 값을 고친 뒤 confirmation_token 없이 다시 보내 새 확인을 받습니다.
PROVIDER_BUSINESS_ERROR발급 거절 — retryable=false — 발급 요청 뒤 기관이 알림창으로 거절했습니다. error.message 는 「기관이 증명서 발급을 거절했습니다.」 뒤에 기관 사유가 붙은 문장입니다. 기관이 개인사업장이라 막았으면 error.message 는 「개인사업장은 조달청 제출용 완납증명서만 발급할 수 있습니다. 다른 용도는 대표자 개인 기준으로 발급해야 합니다.」 입니다. 그대로 다시 부르지 않고 사유를 먼저 확인합니다.
PROVIDER_OUTCOME_UNCONFIRMED결과 확인 불가 — retryable=false — 발급 요청을 누른 뒤 60초 안에 증명서 화면도 알림창도 오지 않았거나, 받은 파일이 PDF 가 아니거나, 누른 뒤 증명서 화면이나 내려받기에서 오류가 났습니다. 이미 발급됐을 수 있습니다. error.message 는 「기관의 요청 처리 여부를 확인하지 못했습니다. 다시 실행하지 마세요. 이미 처리됐을 수 있어 중복 처리로 이어집니다.」 입니다. 같은 요청을 다시 보내지 않습니다.
PROVIDER_UNAVAILABLE화면 준비 안 됨 — 기관 발급 화면을 열지 못했거나, 알림창 없이 조건을 넣지 못했거나, 발급 버튼을 찾지 못해 발급 요청을 보내기 전에 멈췄습니다. error.message 는 「기관에 연결하지 못해 요청을 보내지 못했습니다. 잠시 후 다시 시도해 주세요.」 입니다. 쓰기 액션이라 retryable=false 로 표시되지만 보낸 것이 없으므로, 잠시 뒤 confirmation_token 없이 다시 보내 새 확인을 받으면 됩니다.
AUTH_REQUIRED세션 없음 — 로그인 세션이 없어 기관 화면을 열기 전에 멈췄습니다. error.message 는 쓰기 액션에 공통으로 붙는 문장이라 이미 제출됐을 수 있다고 말하지만, 이 액션은 이 경우 발급 요청을 보내지 않습니다. 로그인(nhis_edi.session.login)을 먼저 호출한 뒤 confirmation_token 없이 다시 보내 새 확인을 받습니다.
PROVIDER_SESSION_EXPIRED세션 만료 — 발급 화면을 여는 중 기관이 「로그인 인증이 만료되었습니다.」 알림창을 띄워 발급 요청을 보내기 전에 멈췄습니다. error.message 는 세션 없음과 같은 공통 문장입니다. 로그인(nhis_edi.session.login)을 다시 호출한 뒤 confirmation_token 없이 다시 보내 새 확인을 받습니다.
VALIDATION_INVALID_FIELD입력 오류 — retryable=false — certificate_kind 가 지원하지 않는 값이라 기관 화면을 열기 전에 멈췄습니다. error.message 는 「증명서 종류(certificate_kind)는 payment_certificate(납부확인서)나 completion_certificate(완납증명서)만 받습니다.」 입니다.
POLICY_FEATURE_DISABLED기능 꺼짐 — 지금은 발급할 수 없습니다. 같은 화면의 입력 계약 조회(nhis_edi.certificates.payment_completion.init)와 다른 조회 액션은 그대로 쓸 수 있습니다.
INTERNAL_ERROR서버 구성 — 서버에서 발급용 브라우저를 쓸 수 없어 기관 화면을 열기 전에 멈췄습니다. error.message 는 「지금은 이 상품을 처리할 수 없습니다. 서버 구성 문제로 요청을 실행하지 못했습니다. 서비스문의로 알려 주세요.」 입니다. 다시 불러도 풀리지 않으므로 서비스문의로 알립니다.

4. 사업장 적용 통보서 신청 입력 서식 조회nhis_edi.certificates.workplace_application_notice.apply.init

MCP 도구 이름 nhis_edi__certificates__workplace_application_notice__apply__init

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

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

연동 계정으로 사업장 적용 통보서 신청서 화면의 한글 영문 신청구분, 사업장 칸, 작성일과 일련번호 칸을 받습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 신고(전송)·신청 버튼 미실행 — 발급 신청 접수로 이어질 수 있음.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.workplace_application_notice.apply.init이 API 고정값 (기본값)

예시 : nhis_edi.certificates.workplace_application_notice.apply.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

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

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_KEYstring이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다.
certificate_keystring증명서 종류 키 (workplace_application_notice_apply)
page_link_idstring건강보험 EDI 화면 번호 (175)
blocked_transactionsarray이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_contextobject로그인한 사업장 기본 정보
dataset_countnumber화면 dataset 개수
datasetsarray원천 Nexacro/SSV dataset
default_valuesobject화면 초기값
document_idstring서식/문서 코드
feature_labelstring기능 표시명(사용자용 기능명)
field_countnumber화면 필드 개수
fieldsarrayform contract 입력 필드 목록
form_idstringNexacro form ID
gridobject그리드 dataset·컬럼 정보
init_transactionsarray초기 조회에 실행한 트랜잭션 목록
menu_program_idstring | null화면을 여는 메뉴 프로그램 ID
observed_callservicesarray화면에서 관찰한 service 호출 목록
safetyobject안전 정책(실행 금지 동작과 그 사유)
script_urlstring화면 XFDL JavaScript URL
shortcutstring화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_urlstring원천 NHIS EDI URL
target_readyboolean화면 진입 준비 완료 여부
visible_text_markersarray화면 확인용 고정 문구
json
// 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_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

5. 사업장 적용 통보서 발급확인 입력 서식 조회nhis_edi.certificates.workplace_application_notice.issued.init

MCP 도구 이름 nhis_edi__certificates__workplace_application_notice__issued__init

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

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

연동 계정으로 발급된 사업장 적용 통보서 화면의 사업장명, 사용자 성명, 적용일자, 가입자수, 발급번호 칸 구성을 받습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 기존 발급 건 확인 contract만 제공. 출력·다운로드 미실행. 발급번호 조회 시 필요.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.workplace_application_notice.issued.init이 API 고정값 (기본값)

예시 : nhis_edi.certificates.workplace_application_notice.issued.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

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

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_KEYstring이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다.
certificate_keystring증명서 종류 키 (workplace_application_notice_issued)
page_link_idstring건강보험 EDI 화면 번호 (172)
blocked_transactionsarray이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_contextobject로그인한 사업장 기본 정보
dataset_countnumber화면 dataset 개수
datasetsarray원천 Nexacro/SSV dataset
default_valuesobject화면 초기값
document_idstring서식/문서 코드
feature_labelstring기능 표시명(사용자용 기능명)
field_countnumber화면 필드 개수
fieldsarrayform contract 입력 필드 목록
form_idstringNexacro form ID
gridobject그리드 dataset·컬럼 정보
init_transactionsarray초기 조회에 실행한 트랜잭션 목록
menu_program_idstring | null화면을 여는 메뉴 프로그램 ID
observed_callservicesarray화면에서 관찰한 service 호출 목록
safetyobject안전 정책(실행 금지 동작과 그 사유)
script_urlstring화면 XFDL JavaScript URL
shortcutstring화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_urlstring원천 NHIS EDI URL
target_readyboolean화면 진입 준비 완료 여부
visible_text_markersarray화면 확인용 고정 문구
json
// 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_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

6. 사업장 가입자 명부 신청 입력 서식 조회nhis_edi.certificates.workplace_member_list.apply.init

MCP 도구 이름 nhis_edi__certificates__workplace_member_list__apply__init

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

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

연동 계정으로 부르면 사업장 가입자 명부 신청 화면의 가입자 범위와 상실자 포함 보기, 대상자 성명과 주민등록번호 칸을 돌려줍니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 신고(전송)·신청 버튼 미실행. default_values에 가입자범위·상실자포함 선택값 계약 포함.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.workplace_member_list.apply.init이 API 고정값 (기본값)

예시 : nhis_edi.certificates.workplace_member_list.apply.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

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

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_KEYstring이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다.
certificate_keystring증명서 종류 키 (workplace_member_list_apply)
page_link_idstring건강보험 EDI 화면 번호 (176)
blocked_transactionsarray이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_contextobject로그인한 사업장 기본 정보
dataset_countnumber화면 dataset 개수
datasetsarray원천 Nexacro/SSV dataset
default_valuesobject화면 초기값
document_idstring서식/문서 코드
feature_labelstring기능 표시명(사용자용 기능명)
field_countnumber화면 필드 개수
fieldsarrayform contract 입력 필드 목록
form_idstringNexacro form ID
gridobject그리드 dataset·컬럼 정보
init_transactionsarray초기 조회에 실행한 트랜잭션 목록
menu_program_idstring | null화면을 여는 메뉴 프로그램 ID
observed_callservicesarray화면에서 관찰한 service 호출 목록
safetyobject안전 정책(실행 금지 동작과 그 사유)
script_urlstring화면 XFDL JavaScript URL
shortcutstring화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_urlstring원천 NHIS EDI URL
target_readyboolean화면 진입 준비 완료 여부
visible_text_markersarray화면 확인용 고정 문구
json
// 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_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

7. 사업장 가입자 명부 발급확인 입력 서식 조회nhis_edi.certificates.workplace_member_list.issued.init

MCP 도구 이름 nhis_edi__certificates__workplace_member_list__issued__init

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

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

로그인한 연동 계정으로 사업장 가입자 명부 발급확인 화면의 발급일자, 작성차수, 발급번호 칸과 명부 표의 열 이름을 받습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 기존 발급 명부 확인 contract만 제공. 출력·다운로드 미실행.
  • params 는 빈 객체로 보내도 호출됩니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : nhis_edi

actionstring-Y호출할 작업입니다.
  • nhis_edi.certificates.workplace_member_list.issued.init이 API 고정값 (기본값)

예시 : nhis_edi.certificates.workplace_member_list.issued.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

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

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: 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_KEYstring이 호출에 쓴 연동 계정의 ID(account_link_id)입니다. XBOSS API 키가 아닙니다.
certificate_keystring증명서 종류 키 (workplace_member_list_issued)
page_link_idstring건강보험 EDI 화면 번호 (173)
blocked_transactionsarray이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_contextobject로그인한 사업장 기본 정보
dataset_countnumber화면 dataset 개수
datasetsarray원천 Nexacro/SSV dataset
default_valuesobject화면 초기값
document_idstring서식/문서 코드
feature_labelstring기능 표시명(사용자용 기능명)
field_countnumber화면 필드 개수
fieldsarrayform contract 입력 필드 목록
form_idstringNexacro form ID
gridobject그리드 dataset·컬럼 정보
init_transactionsarray초기 조회에 실행한 트랜잭션 목록
menu_program_idstring | null화면을 여는 메뉴 프로그램 ID
observed_callservicesarray화면에서 관찰한 service 호출 목록
safetyobject안전 정책(실행 금지 동작과 그 사유)
script_urlstring화면 XFDL JavaScript URL
shortcutstring화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_urlstring원천 NHIS EDI URL
target_readyboolean화면 진입 준비 완료 여부
visible_text_markersarray화면 확인용 고정 문구
json
// 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_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.