개발자 문서
API 레퍼런스

증명서

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

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

BM::BMDZ_200(메뉴 BM::BMDZ_090) 개인별 건강보험료 납부확인서 발급확인 화면 contract를 조회합니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 발급확인·조회 성격이나 출력·발급 버튼은 init에서 미실행.
  • params 는 빈 객체로 보내도 호출됩니다.
Request
순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

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

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : 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: sandbox' \
  --header 'Idempotency-Key: demo-init-001' \
  --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.
순번변수명설명
menu_program_id메뉴 프로그램 ID (BM::BMDZ_090)
screen_id화면 ID (BM::BMDZ_200)
certificate_key증명서 종류 키 (health_premium_payment_individual)
blocked_transactions이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_context로그인한 사업장 기본 정보
dataset_count화면 dataset 개수
datasets원천 Nexacro/SSV dataset
default_values화면 초기값
document_id서식/문서 코드
feature_label기능 표시명(사용자용 기능명)
field_count화면 필드 개수
fieldsform contract 입력 필드 목록
form_idNexacro form ID
grid그리드 dataset·컬럼 정보
init_transactions초기 조회에 실행한 트랜잭션 목록
observed_callservices화면에서 관찰한 service 호출 목록
safety안전 정책(실행 금지 동작과 그 사유)
script_url화면 XFDL JavaScript URL
shortcut화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_url원천 NHIS EDI URL
target_ready화면 진입 준비 완료 여부
visible_text_markers화면 확인용 고정 문구
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": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_WrtDupSeq",
      "text": null,
      "type": "Edit",
      "column": "WRT_DUP_SEQ",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_FinanceCd",
      "text": "회계코드",
      "type": "Combo",
      "column": "NATION_FINANCE_CD",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_NATION_FINANCE_CD"
    },
    {
      "mask": null,
      "name": "cbo_Goji",
      "text": "고지차수",
      "type": "Combo",
      "column": "GOJI_CHASU",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Goji"
    },
    {
      "mask": null,
      "name": "Edit2",
      "text": null,
      "type": "Edit",
      "column": "FIRM_NM",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "Edit1",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_SYM",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "Edit0",
      "text": null,
      "type": "Edit",
      "column": "NHIC_BSLC_MGMT_NO",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_NM",
      "dataset": "ds_Detail",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "APLY_PRSN_JUMIN_NO",
      "dataset": "ds_Detail",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_FAX_NO_3",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_FAX_NO_2",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "APLY_PRSN_FAX_NO_1",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_HP_NO_3",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_HP_NO_2",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "APLY_PRSN_HP_NO_1",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_TEL_NO_3",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_TEL_NO_2",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "APLY_PRSN_TEL_NO_1",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "rdo_BoGubun",
      "text": null,
      "type": "Radio",
      "column": "NY_INSU_TYPE",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_BoGubun"
    },
    {
      "mask": "####/##",
      "name": "mdt_IssueYYmm2",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_STD_YYYYMM_FR",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "@@@@-@@-@@",
      "name": "mdt_ToDay",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_WrtDupSeq",
      "text": null,
      "type": "Edit",
      "column": "WRT_DUP_SEQ",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_FinanceCd",
      "text": "회계코드",
      "type": "Combo",
      "column": "NATION_FINANCE_CD",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_NATION_FINANCE_CD"
    },
    {
      "mask": null,
      "name": "cbo_Goji",
      "text": "고지차수",
      "type": "Combo",
      "column": "GOJI_CHASU",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Goji"
    },
    {
      "mask": null,
      "name": "Edit2",
      "text": null,
      "type": "Edit",
      "column": "FIRM_NM",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "Edit1",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_SYM",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "Edit0",
      "text": null,
      "type": "Edit",
      "column": "NHIC_BSLC_MGMT_NO",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_NM",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "APLY_PRSN_JUMIN_NO",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_FAX_NO_3",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_FAX_NO_2",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "APLY_PRSN_FAX_NO_1",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_HP_NO_3",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_HP_NO_2",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "APLY_PRSN_HP_NO_1",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_TEL_NO_3",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "APLY_PRSN_TEL_NO_2",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "APLY_PRSN_TEL_NO_1",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "rdo_BoGubun",
      "text": null,
      "type": "Radio",
      "column": "NY_INSU_TYPE",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_BoGubun"
    },
    {
      "mask": "####/##",
      "name": "mdt_IssueYYmm2",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_STD_YYYYMM_FR",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_issue_gbn",
      "text": null,
      "type": "Radio",
      "column": "APLY_TYPE",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_APLY_TYPE"
    },
    {
      "mask": "####/##",
      "name": "mdt_IssueYYmm2_part1",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_STD_YYYYMM_FR",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "####/##",
      "name": "mdt_IssueYYmm2_part2",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_STD_YYYYMM_TO",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_PrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "PERSON_RRNO",
      "dataset": "ds_imsiPerson",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_PrsnNm",
      "text": null,
      "type": "Edit",
      "column": "PERSON_NM",
      "dataset": "ds_imsiPerson",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_person_gbn",
      "text": null,
      "type": "Radio",
      "column": "PRSN_TYPE",
      "dataset": "ds_Detail",
      "enabled": null,
      "readonly": null,
      "innerdataset": "@ds_personType"
    },
    {
      "mask": null,
      "name": "rdo_RealIssueDocKind_A",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_KIND",
      "dataset": "ds_RealIssueKind",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_RealIssueDocKind_B",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_KIND",
      "dataset": "ds_RealIssueKind",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_RealIssueDocKind_C",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_KIND",
      "dataset": "ds_RealIssueKind",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_RealIssueDocKind_D",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_KIND",
      "dataset": "ds_RealIssueKind",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_Issue_Gubun",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_BoGubun"
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Nation_Finance_Cd",
      "text": "회계코드",
      "type": "Combo",
      "column": "NATION_FINANCE_CD",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueNationFinanceCd"
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Goji_Chasu",
      "text": "고지차수",
      "type": "Combo",
      "column": "GOJI_CHASU",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueGojiChasu"
    },
    {
      "mask": null,
      "name": "rdo_IssueUsageCd",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_YYYY",
      "text": "발급년월",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "TEL_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "HP_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "FEX_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rbo_Language",
      "text": null,
      "type": "Radio",
      "column": "NPC_LANGUAGE",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_EngSaupName",
      "text": null,
      "type": "Edit",
      "column": "ETC_DATA",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rbo_Use_Gubun",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NpcAYYYY_Fr",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcAYYYY_To",
      "text": "발급년",
      "type": "Combo",
      "column": "TO_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "rbo_Language",
      "text": null,
      "type": "Radio",
      "column": "NPC_LANGUAGE",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_Relation",
      "text": null,
      "type": "Combo",
      "column": "ds_RealIssueKind_CanColumnChange",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_pbltnr_rel"
    },
    {
      "mask": null,
      "name": "edt_Npc_NpsNo",
      "text": null,
      "type": "Edit",
      "column": "NPC_SINGO_PERSON_NPS_NUM",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_EngSaupName",
      "text": null,
      "type": "Edit",
      "column": "ETC_DATA",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NpcBYYYY_Fr",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "NPC_SINGO_PERSON_NPS_NUM",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rbo_Use_Gubun",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_Relation",
      "text": null,
      "type": "Combo",
      "column": "NPC_SINGO_RELATION",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_pbltnr_rel"
    },
    {
      "mask": null,
      "name": "Edit0",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NpcCYYYY_Fr",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcCYYYY_To",
      "text": "발급년",
      "type": "Combo",
      "column": "TO_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcCMM_fr",
      "text": "발급월",
      "type": "Combo",
      "column": "FROM_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "cbo_NpcCMM_to",
      "text": "발급월",
      "type": "Combo",
      "column": "TO_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "rbo_Language",
      "text": null,
      "type": "Radio",
      "column": "NPC_LANGUAGE",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_EngSaupName",
      "text": null,
      "type": "Edit",
      "column": "ETC_DATA",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rbo_Use_Gubun",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_Npc_NpsNo",
      "text": null,
      "type": "Edit",
      "column": "NPC_SINGO_PERSON_NPS_NUM",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_Relation",
      "text": null,
      "type": "Combo",
      "column": "NPC_SINGO_RELATION",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_pbltnr_rel"
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_bohumGubun",
      "text": "보험구분",
      "type": "Combo",
      "column": "WRK_BOHUM_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_WrkBohumGubun"
    },
    {
      "mask": null,
      "name": "cbo_ISSUE_USE",
      "text": "발급용도",
      "type": "Combo",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_hrdk_klwc_use_gubun"
    },
    {
      "mask": null,
      "name": "Combo1",
      "text": "제줄기관",
      "type": "Combo",
      "column": "REQUEST_TYPE",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_sbmt_offc"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "TEL_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Nation_Finance_Cd",
      "text": "회계코드",
      "type": "Combo",
      "column": "NATION_FINANCE_CD",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueNationFinanceCd"
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Goji_Chasu",
      "text": "고지차수",
      "type": "Combo",
      "column": "GOJI_CHASU",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueGojiChasu"
    },
    {
      "mask": null,
      "name": "cbo_YYYY",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "edt_totnabbuNum",
      "text": null,
      "type": "Edit",
      "column": "TOT_NABBU_NUMBER",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "HP_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "TEL_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "FEX_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_IssueUsageCd",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Nation_Finance_Cd",
      "text": "회계코드",
      "type": "Combo",
      "column": "NATION_FINANCE_CD",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueNationFinanceCd"
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Goji_Chasu",
      "text": "고지차수",
      "type": "Combo",
      "column": "GOJI_CHASU",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueGojiChasu"
    },
    {
      "mask": null,
      "name": "cbo_YYYY",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "TEL_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "HP_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "FEX_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_IssueUsageCd",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_totnabbuNum",
      "text": null,
      "type": "Edit",
      "column": "TOT_NABBU_NUMBER",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_EtcFrom_MM",
      "text": "발급월",
      "type": "Combo",
      "column": "FROM_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "cbo_bohumGubun",
      "text": "보험구분",
      "type": "Combo",
      "column": "WRK_BOHUM_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_WrkBohumGubun"
    },
    {
      "mask": null,
      "name": "rdo_IssueUsageCd",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NpcCYYYY_Fr",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcCMM_fr",
      "text": "발급월",
      "type": "Combo",
      "column": "FROM_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "cbo_NpcCYYYY_To",
      "text": "발급년",
      "type": "Combo",
      "column": "TO_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcCMM_to",
      "text": "발급월",
      "type": "Combo",
      "column": "TO_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "cbo_Relation",
      "text": null,
      "type": "Combo",
      "column": "NPC_SINGO_RELATION",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_pbltnr_rel"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_bohumGubun",
      "text": "보험구분",
      "type": "Combo",
      "column": "WRK_BOHUM_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_WrkBohumGubun"
    },
    {
      "mask": null,
      "name": "rdo_IssueUsageCd",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_NpcCYYYY_Fr",
      "text": "발급년",
      "type": "Combo",
      "column": "FROM_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcCMM_fr",
      "text": "발급월",
      "type": "Combo",
      "column": "FROM_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "cbo_NpcCYYYY_To",
      "text": "발급년",
      "type": "Combo",
      "column": "TO_YYYY",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_yyyy"
    },
    {
      "mask": null,
      "name": "cbo_NpcCMM_to",
      "text": "발급월",
      "type": "Combo",
      "column": "TO_MONTH",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_month"
    },
    {
      "mask": null,
      "name": "cbo_Relation",
      "text": null,
      "type": "Combo",
      "column": "NPC_SINGO_RELATION",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_pbltnr_rel"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "TEL_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "HP_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "FEX_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_3",
      "dataset": "ds_RealIssue",
      "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": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueNationFinanceCd"
    },
    {
      "mask": null,
      "name": "cbo_NhicDiv_Goji_Chasu",
      "text": "고지차수",
      "type": "Combo",
      "column": "GOJI_CHASU",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_IssueGojiChasu"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "SING_PRSN_NAME",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "###### - #######",
      "name": "mdt_AplyPrsnJuminNo",
      "text": null,
      "type": "MaskEdit",
      "column": "SINGO_PRSN_JUMINNO",
      "dataset": "ds_RealIssue",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnTelNo1",
      "text": "국번",
      "type": "Combo",
      "column": "TEL_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo2",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnTelNo3",
      "text": null,
      "type": "Edit",
      "column": "TEL_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnHpNo1",
      "text": "국번",
      "type": "Combo",
      "column": "HP_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Hpno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo2",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnHpNo3",
      "text": null,
      "type": "Edit",
      "column": "HP_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "cbo_AplyPrsnFaxNo1",
      "text": "국번",
      "type": "Combo",
      "column": "FEX_NO_1",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_Telno"
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo2",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_2",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnFaxNo3",
      "text": null,
      "type": "Edit",
      "column": "FEX_NO_3",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_IssueUsageCd",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_USE_GUBUN",
      "dataset": "ds_RealIssue",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_totnabbuNum",
      "text": null,
      "type": "Edit",
      "column": "TOT_NABBU_NUMBER",
      "dataset": "ds_RealIssue",
      "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,
    "opened_by_playwright": 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": [
    "ds_List",
    "ds_logInfo",
    "ds_BoGubun",
    "ds_IssueCd",
    "ds_Npc_Issue_Use",
    "ds_NATION_FINANCE_CD",
    "ds_Goji",
    "ds_Combo",
    "ds_Telno",
    "ds_Hpno",
    "ds_Detail",
    "ds_RealIssue",
    "ds_yyyy",
    "ds_month",
    "ds_pbltnr_rel",
    "ds_RealIssueKind",
    "ds_IssueDocInfo",
    "ds_Gisa",
    "ds_IssueHead",
    "ds_IssueDetail",
    "ds_WrkBohumGubun",
    "ds_firm_state_info",
    "ds_HrdkKlwcFirmList",
    "ds_sbmt_offc",
    "ds_firm_info",
    "ds_hrdk_klwc_use_gubun",
    "ds_cond",
    "ds_count",
    "ds_wtcsaupinfo",
    "ds_LoginFirmInfo",
    "ds_IssueNationFinanceCd",
    "ds_IssueGojiChasu",
    "ds_IssueUnbNoList",
    "ds_UserInfo",
    "ds_APLY_TYPE",
    "ds_ibtb100_r2",
    "ds_ibtb100_r1",
    "ds_personType",
    "ds_person",
    "ds_File",
    "ds_imsiPerson",
    "ds_result",
    "ds_fileErrorList",
    "rdo_issue_gbn_innerdataset",
    "rdo_person_gbn_innerdataset",
    "rdo_RealIssueDocKind_A_innerdataset",
    "rdo_RealIssueDocKind_B_innerdataset",
    "rdo_RealIssueDocKind_C_innerdataset",
    "rdo_RealIssueDocKind_D_innerdataset",
    "rdo_IssueUsageCd_innerdataset",
    "rbo_Language_innerdataset",
    "rbo_Use_Gubun_innerdataset",
    "rbo_Language_innerdataset",
    "rbo_Use_Gubun_innerdataset",
    "rbo_Language_innerdataset",
    "rbo_Use_Gubun_innerdataset",
    "rdo_IssueUsageCd_innerdataset",
    "rdo_IssueUsageCd_innerdataset",
    "rdo_IssueUsageCd_innerdataset",
    "rdo_IssueUsageCd_innerdataset",
    "rdo_IssueUsageCd_innerdataset"
  ],
  "shortcut": "pageLinkPopup1('171')",
  "screen_id": "BM::BMDZ_200.xfdl",
  "program_id": "BM::BMDZ_200.xfdl",
  "route_kind": "live_session_contract",
  "script_url": "https://edi.nhis.or.kr/webedi/xui/BM/BMDZ_200.xfdl.js",
  "source_url": "https://edi.nhis.or.kr/webedi/xui/index.jsp",
  "document_id": "BMDZ_200",
  "field_count": 181,
  "feature_name": "nhis_edi_certificate_issuance",
  "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": "BM::BMDZ_090",
    "actual_screen_id": "BM::BMDZ_200",
    "발급대상년월": "화면 기본값 또는 요청값"
  },
  "certificate_key": "health_premium_payment_individual",
  "menu_program_id": "BM::BMDZ_090.xfdl",
  "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": "ds_cond=ds_Init",
      "action": "BMDZ_200Action",
      "out_ds": "ds_LoginFirmInfo=ds_LoginFirmInfo ds_IssueUnbNoList=ds_IssueUnbNoList ds_IssueNationFinanceCd=ds_IssueNationFinanceCd ds_IssueGojiChasu=ds_IssueGojiChasu",
      "mutates": false
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_012Action",
      "out_ds": "ds_count=ds_count",
      "mutates": false
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": "",
      "mutates": false
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_012Action",
      "out_ds": "ds_count=ds_count",
      "mutates": false
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": "",
      "mutates": false
    },
    {
      "cmd": "BMDZ_200WtcCall",
      "in_ds": "ds_cond=ds_RealIssue",
      "action": "BMDZ_200Action",
      "out_ds": "ds_firm_state_info=ds_firm_state_info ds_HrdkKlwcFirmList=ds_firm_office_list ds_firm_info=ds_firm_info ",
      "mutates": false
    },
    {
      "cmd": "BMDZ_200WtcCall",
      "in_ds": "",
      "action": "BMDZ_200Action",
      "out_ds": "ds_IssueHead=ds_IssueHead",
      "mutates": false
    }
  ],
  "blocked_transactions": [
    {
      "cmd": "WETB_012_I02",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail02=ds_Detail ds_person=ds_person",
      "action": "WETB_012Action",
      "out_ds": "ds_Detail=ds_out ds_cond=ds_cond",
      "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": "ds_cond=ds_Init",
      "action": "BMDZ_200Action",
      "out_ds": "ds_LoginFirmInfo=ds_LoginFirmInfo ds_IssueUnbNoList=ds_IssueUnbNoList ds_IssueNationFinanceCd=ds_IssueNationFinanceCd ds_IssueGojiChasu=ds_IssueGojiChasu"
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_012Action",
      "out_ds": "ds_count=ds_count"
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": ""
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_012Action",
      "out_ds": "ds_count=ds_count"
    },
    {
      "cmd": "WETB_012_I02",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail02=ds_Detail ds_person=ds_person",
      "action": "WETB_012Action",
      "out_ds": "ds_Detail=ds_out ds_cond=ds_cond"
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": ""
    },
    {
      "cmd": "BMDZ_200WtcCall",
      "in_ds": "ds_cond=ds_RealIssue",
      "action": "BMDZ_200Action",
      "out_ds": "ds_firm_state_info=ds_firm_state_info ds_HrdkKlwcFirmList=ds_firm_office_list ds_firm_info=ds_firm_info "
    },
    {
      "cmd": "BMDZ_200WtcCall",
      "in_ds": "",
      "action": "BMDZ_200Action",
      "out_ds": "ds_IssueHead=ds_IssueHead"
    }
  ]
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

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

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

BM::BMDZ_100 납부확인서·완납증명서 발급 화면의 form contract(fields·blocked_transactions·safety)를 조회합니다. 신고(신청)는 실행하지 않습니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 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호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : 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: sandbox' \
  --header 'Idempotency-Key: demo-init-001' \
  --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를 확인합니다.
순번변수명설명
fields입력 필드 정의 배열
default_values기본값 설정 객체
blocked_transactions차단된 트랜잭션 목록 (실행 안 됨)
safety안전 플래그 객체 (init_only=true)
certificate_key증명서 종류 키 (payment_completion)
business_context로그인한 사업장 기본 정보
dataset_count화면 dataset 개수
datasets원천 Nexacro/SSV dataset
document_id서식/문서 코드
feature_label기능 표시명(사용자용 기능명)
field_count화면 필드 개수
form_idNexacro form ID
grid그리드 dataset·컬럼 정보
init_transactions초기 조회에 실행한 트랜잭션 목록
menu_program_id화면을 여는 메뉴 프로그램 ID
observed_callservices화면에서 관찰한 service 호출 목록
script_url화면 XFDL JavaScript URL
shortcut화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_url원천 NHIS EDI URL
target_ready화면 진입 준비 완료 여부
visible_text_markers화면 확인용 고정 문구
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": "ds_List",
      "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": "ds_List",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_GojiChasu",
      "text": null,
      "type": "Edit",
      "column": "GOJI_CHASU",
      "dataset": "ds_List",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_FirmNm",
      "text": null,
      "type": "Edit",
      "column": "FIRM_NM",
      "dataset": "ds_List",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_UnitFrimNm",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_NM",
      "dataset": "ds_List",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_UnitFirmSym",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_SYM",
      "dataset": "ds_List",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_NationFinanceCd",
      "text": null,
      "type": "Edit",
      "column": "NATION_FINANCE_CD",
      "dataset": "ds_List",
      "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": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "#,##0",
      "name": "mdk_Sum1_2",
      "text": null,
      "type": "MaskEdit",
      "column": "NY_GOJI_CTRB_SUM",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "#,##0",
      "name": "mdk_TotSum1",
      "text": null,
      "type": "MaskEdit",
      "column": "GOJI_AMT_TOT",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "#,##0",
      "name": "mdk_BrdnGojiCtrbSum",
      "text": null,
      "type": "MaskEdit",
      "column": "NABBU_CTRB_SUM",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "#,##0",
      "name": "mdk_NyBrdnNabbuCtrbSum",
      "text": null,
      "type": "MaskEdit",
      "column": "NY_NABBU_CTRB_SUM",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "#,##0",
      "name": "mdk_TotSum2",
      "text": null,
      "type": "MaskEdit",
      "column": "NABBU_CTRB_SUM_TOT",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####/##/##",
      "name": "mdt_NtcDt",
      "text": null,
      "type": "MaskEdit",
      "column": "NTC_DT",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####/##/##-@@",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "EDI23-####-#-####-######",
      "name": "mdt_IssueNo",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_NO",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "EDI36-##-########-#######",
      "name": "mdt_IssueNoNew",
      "text": null,
      "type": "MaskEdit",
      "column": "PBLTN_NO",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##",
      "name": "edt_from_yyyymm",
      "text": null,
      "type": "MaskEdit",
      "column": "FROM_YYYYMM",
      "dataset": "ds_Detail01",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##",
      "name": "edt_to_yyyymm",
      "text": null,
      "type": "MaskEdit",
      "column": "TO_YYYYMM",
      "dataset": "ds_Detail01",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##",
      "name": "MaskEdit0",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_STD_YYYYMM",
      "dataset": "ds_List",
      "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,
    "opened_by_playwright": true,
    "allowed_transaction_cmds": [],
    "blocked_transaction_cmds": [
      null,
      null
    ],
    "mutating_actions_executed": false
  },
  "API_KEY": "[REDACTED]",
  "form_id": "BMDZ_100",
  "success": true,
  "datasets": [
    "ds_List",
    "ds_ListTemp",
    "ds_Detail01",
    "ds_logInfo",
    "ds_Detail01_temp",
    "ds_paramSet"
  ],
  "shortcut": "pageLinkPopup1('174')",
  "screen_id": "BM::BMDZ_100.xfdl",
  "program_id": "BM::BMDZ_100.xfdl",
  "route_kind": "live_session_contract",
  "script_url": "https://edi.nhis.or.kr/webedi/xui/BM/BMDZ_100.xfdl.js",
  "source_url": "https://edi.nhis.or.kr/webedi/xui/index.jsp",
  "document_id": "BMDZ_100",
  "field_count": 26,
  "feature_name": "nhis_edi_certificate_issuance",
  "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

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

BMDZ_200 화면에서 납부확인서·완납증명서를 실제로 발급하고 PDF 로 받습니다.

  • 로그인을 먼저 호출합니다. 기관 발급 화면을 거쳐 PDF 를 받으므로 조회 API 보다 오래 걸립니다. [국민건강보험공단 EDI 로그인]
  • certificate_kind 기본 payment_certificate. year 기본 당해. issue_usage 기본 11. issue_gubun 기본 00(payment만).
Request
순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

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

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

순번변수명타입길이필수설명
certificate_kindstring-Npayment_certificate(납부확인서) 또는 completion_certificate(완납증명서)
confirmboolean-N발급 확인. 사용자에게 미리보기를 보여주고 동의를 받았을 때만 true 로 보낸다. 자동으로 채우지 않는다
yearstring4N조회 연도 payment_certificate일 때

형식 : YYYY

issue_usagestring-N발급용도. payment: 11/12/13, completion: 51/52
issue_gubunstring-N발급구분 00/01/02. payment_certificate만
include_pdf_base64boolean-N응답에 pdf_base64 포함
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: sandbox' \
  --header 'Idempotency-Key: demo-issue-001' \
  --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 확인. include_pdf_base64=true 시 pdf_base64 포함.
순번변수명설명
pdf_downloadedPDF 다운로드 성공 여부
issue_no발급 번호
pdf_sizePDF 파일 크기 (bytes)
pdf_base64PDF Base64 인코딩 (include_pdf_base64=true 시)
pdf_passwordPDF 열람 비밀번호 (사업장관리번호)
pdf_password_hint비밀번호 안내 문구 (미리보기 화면 안내 기준)
certificate_kind증명서 종류 (payment_certificate)
selected_values발급 화면에서 선택된 값
request_argument기관 화면에 넘긴 조회 인자
dialogs브라우저 대화상자 기록
report_url리포트 화면 URL
json
// result.data
{
  "pdf_downloaded": false,
  "issue_no": "...",
  "pdf_size": 0,
  "pdf_base64": "...",
  "pdf_password": "...",
  "pdf_password_hint": "...",
  "certificate_kind": "...",
  "selected_values": {},
  "request_argument": "...",
  "dialogs": [],
  "report_url": "..."
}
순번오류 코드발생 조건
PROVIDER_UNAVAILABLE선택 실패 — 발급 화면에서 선택값(year · issue_usage · issue_gubun)을 적용하지 못했습니다.
PROVIDER_UNAVAILABLE시간 초과·처리 불가 — 발급·다운로드가 제한 시간 안에 끝나지 않았거나, certificate_kind 가 지원하지 않는 값이거나, 서버에서 발급 기능을 쓸 수 없는 상태입니다.

4. 사업장 가입자 자격취득 안내문 신청 입력 서식 조회nhis_edi.certificates.workplace_application_notice.apply.init

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

WE::WETB_011 사업장 적용 통보서 신청 화면 form contract를 조회합니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 신고(전송)·신청 버튼 미실행 — 발급 신청 접수로 이어질 수 있음.
  • params 는 빈 객체로 보내도 호출됩니다.
Request
순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

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

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : 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: sandbox' \
  --header 'Idempotency-Key: demo-init-001' \
  --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.
순번변수명설명
certificate_key증명서 종류 키 (workplace_application_notice_apply)
page_link_id건강보험 EDI 화면 번호 (175)
blocked_transactions이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_context로그인한 사업장 기본 정보
dataset_count화면 dataset 개수
datasets원천 Nexacro/SSV dataset
default_values화면 초기값
document_id서식/문서 코드
feature_label기능 표시명(사용자용 기능명)
field_count화면 필드 개수
fieldsform contract 입력 필드 목록
form_idNexacro form ID
grid그리드 dataset·컬럼 정보
init_transactions초기 조회에 실행한 트랜잭션 목록
menu_program_id화면을 여는 메뉴 프로그램 ID
observed_callservices화면에서 관찰한 service 호출 목록
safety안전 정책(실행 금지 동작과 그 사유)
script_url화면 XFDL JavaScript URL
shortcut화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_url원천 NHIS EDI URL
target_ready화면 진입 준비 완료 여부
visible_text_markers화면 확인용 고정 문구
json
// result.data
{
  "grid": {
    "columns": [],
    "column_count": 0
  },
  "phase": "init",
  "fields": [
    {
      "mask": null,
      "name": "edt_FirmName",
      "text": null,
      "type": "Edit",
      "column": "FIRM_NM",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_FirmSym",
      "text": null,
      "type": "Edit",
      "column": "NHIC_BSLC_MGMT_NO",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_UnitFirmSym",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_SYM",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "@@@@/@@/@@",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "##",
      "name": "mdt_Wrt_Dup_Seq",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_DUP_SEQ",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "rdo_KorEng",
      "text": null,
      "type": "Radio",
      "column": "ISSUE_LANGUAGE_TYPE",
      "dataset": "ds_Detail01",
      "enabled": null,
      "readonly": null,
      "innerdataset": "ds_KorEng"
    }
  ],
  "safety": {
    "warning": "신고(전송)/신청 버튼은 사업장 적용 통보서 발급 신청 접수로 이어질 수 있어 init에서는 실행하지 않는다.",
    "init_only": true,
    "opened_by_playwright": 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": [
    "ds_Detail01",
    "ds_KorEng",
    "ds_count",
    "ds_Gisa",
    "ds_cond",
    "ds_logInfo"
  ],
  "shortcut": "pageLinkPopup1('175')",
  "screen_id": "WE::WETB_011.xfdl",
  "program_id": "WE::WETB_011.xfdl",
  "route_kind": "live_session_contract",
  "script_url": "https://edi.nhis.or.kr/webedi/xui/WE/WETB_011.xfdl.js",
  "source_url": "https://edi.nhis.or.kr/webedi/xui/index.jsp",
  "document_id": "WETB_011",
  "field_count": 6,
  "feature_name": "nhis_edi_certificate_issuance",
  "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": "ds_cond=ds_Init",
      "action": "WETB_011Action",
      "out_ds": "ds_count=ds_count",
      "mutates": false
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_011Action",
      "out_ds": "ds_count=ds_count",
      "mutates": false
    }
  ],
  "blocked_transactions": [
    {
      "cmd": "WETB_011_I01",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail01=ds_Detail01",
      "action": "WETB_011Action",
      "out_ds": "ds_Detail01=ds_out",
      "reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
    },
    {
      "cmd": "WETB_011_I02",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail01=ds_Detail01",
      "action": "WETB_011Action",
      "out_ds": "ds_Detail01=ds_out",
      "reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
    },
    {
      "button": "신고(신청)/신고(전송)/신청",
      "reason": "증명서 신청 민원 생성 가능성"
    },
    {
      "button": "출력/인쇄/다운로드",
      "reason": "발급 상태 변경 또는 출력 이력 생성 가능성"
    }
  ],
  "visible_text_markers": [
    "   사업장관리번호",
    "   사업장명칭",
    "   한  글",
    "신청구분",
    "   영  문",
    "발급대상",
    "   단위사업장 기호",
    "   작성일",
    "   일련번호",
    "* 아래 해당 항목을 선택하신 후, 『신고(전송)/신청』를 클릭하셔야 발급됩니다."
  ],
  "implementation_status": "implemented_init_form_contract_only",
  "observed_callservices": [
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_011Action",
      "out_ds": "ds_count=ds_count"
    },
    {
      "cmd": "WETB_011_I01",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail01=ds_Detail01",
      "action": "WETB_011Action",
      "out_ds": "ds_Detail01=ds_out"
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_011Action",
      "out_ds": "ds_count=ds_count"
    },
    {
      "cmd": "WETB_011_I02",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail01=ds_Detail01",
      "action": "WETB_011Action",
      "out_ds": "ds_Detail01=ds_out"
    }
  ]
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

5. 사업장 가입자 자격취득 안내문 발급확인 입력 서식 조회nhis_edi.certificates.workplace_application_notice.issued.init

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

JG::JGDB_060 기발급 사업장 적용 통보서 확인 화면 form contract를 조회합니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 기존 발급 건 확인 contract만 제공. 출력·다운로드 미실행. 발급번호 조회 시 필요.
  • params 는 빈 객체로 보내도 호출됩니다.
Request
순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

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

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : 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: sandbox' \
  --header 'Idempotency-Key: demo-init-001' \
  --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.
순번변수명설명
certificate_key증명서 종류 키 (workplace_application_notice_issued)
page_link_id건강보험 EDI 화면 번호 (172)
blocked_transactions이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_context로그인한 사업장 기본 정보
dataset_count화면 dataset 개수
datasets원천 Nexacro/SSV dataset
default_values화면 초기값
document_id서식/문서 코드
feature_label기능 표시명(사용자용 기능명)
field_count화면 필드 개수
fieldsform contract 입력 필드 목록
form_idNexacro form ID
grid그리드 dataset·컬럼 정보
init_transactions초기 조회에 실행한 트랜잭션 목록
menu_program_id화면을 여는 메뉴 프로그램 ID
observed_callservices화면에서 관찰한 service 호출 목록
safety안전 정책(실행 금지 동작과 그 사유)
script_url화면 XFDL JavaScript URL
shortcut화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_url원천 NHIS EDI URL
target_ready화면 진입 준비 완료 여부
visible_text_markers화면 확인용 고정 문구
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": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_FirmNm",
      "text": null,
      "type": "Edit",
      "column": "FIRM_NM",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_ReprNm",
      "text": null,
      "type": "Edit",
      "column": "REPR_NM",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "@@@@@@@@@@@@@@",
      "name": "mdt_BirthDay",
      "text": null,
      "type": "MaskEdit",
      "column": "BIRTH_DAY",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##.##",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##.##",
      "name": "mdt_NtcDt",
      "text": null,
      "type": "MaskEdit",
      "column": "FIRM_ENTER_DT",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_UnitFirmNm",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_NM",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "@@@@@-####-#-####-######",
      "name": "edt_IssueNo",
      "text": null,
      "type": "MaskEdit",
      "column": "ISSUE_NO",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_FirmMgmtNo",
      "text": null,
      "type": "Edit",
      "column": "FIRM_MGMT_NO",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_FirmNm",
      "text": null,
      "type": "Edit",
      "column": "FIRM_NM",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_ReprNm",
      "text": null,
      "type": "Edit",
      "column": "REPR_NM",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "@@@@@@@@@@@@@@",
      "name": "mdt_BirthDay",
      "text": null,
      "type": "MaskEdit",
      "column": "BIRTH_DAY",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##.##",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "####.##.##",
      "name": "mdt_NtcDt",
      "text": null,
      "type": "MaskEdit",
      "column": "FIRM_ENTER_DT",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_UnitFirmNm",
      "text": null,
      "type": "Edit",
      "column": "UNIT_FIRM_NM",
      "dataset": "ds_View",
      "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": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "@@@@/@@/@@-@@-@@",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_View",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    }
  ],
  "safety": {
    "warning": "기존 발급 증명서 확인 화면 contract만 제공하며 출력/다운로드는 실행하지 않는다.",
    "init_only": true,
    "opened_by_playwright": 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": [
    "ds_logInfo",
    "ds_View",
    "ds_Detail01"
  ],
  "shortcut": "pageLinkPopup1('172')",
  "screen_id": "JG::JGDB_060.xfdl",
  "program_id": "JG::JGDB_060.xfdl",
  "route_kind": "live_session_contract",
  "script_url": "https://edi.nhis.or.kr/webedi/xui/JG/JGDB_060.xfdl.js",
  "source_url": "https://edi.nhis.or.kr/webedi/xui/index.jsp",
  "document_id": "JGDB_060",
  "field_count": 18,
  "feature_name": "nhis_edi_certificate_issuance",
  "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": "ds_cond=ds_logInfo",
      "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": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": ""
    }
  ]
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

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

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

WE::WETB_013 사업장 가입자 명부 발급 신청 화면 form contract를 조회합니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 신고(전송)·신청 버튼 미실행. default_values에 가입자범위·상실자포함 선택값 계약 포함.
  • params 는 빈 객체로 보내도 호출됩니다.
Request
순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

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

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : 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: sandbox' \
  --header 'Idempotency-Key: demo-init-001' \
  --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.
순번변수명설명
certificate_key증명서 종류 키 (workplace_member_list_apply)
page_link_id건강보험 EDI 화면 번호 (176)
blocked_transactions이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_context로그인한 사업장 기본 정보
dataset_count화면 dataset 개수
datasets원천 Nexacro/SSV dataset
default_values화면 초기값
document_id서식/문서 코드
feature_label기능 표시명(사용자용 기능명)
field_count화면 필드 개수
fieldsform contract 입력 필드 목록
form_idNexacro form ID
grid그리드 dataset·컬럼 정보
init_transactions초기 조회에 실행한 트랜잭션 목록
menu_program_id화면을 여는 메뉴 프로그램 ID
observed_callservices화면에서 관찰한 service 호출 목록
safety안전 정책(실행 금지 동작과 그 사유)
script_url화면 XFDL JavaScript URL
shortcut화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_url원천 NHIS EDI URL
target_ready화면 진입 준비 완료 여부
visible_text_markers화면 확인용 고정 문구
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": "ds_Init",
      "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": "ds_Detail03",
      "enabled": null,
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_AplyPrsnNm",
      "text": null,
      "type": "Edit",
      "column": "DAESANGJA_NM",
      "dataset": "ds_Detail03",
      "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": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "@@@@/@@/@@",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_Init",
      "enabled": "false",
      "readonly": null,
      "innerdataset": null
    },
    {
      "mask": "##",
      "name": "mdt_Wrt_Dup_Seq",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_DUP_SEQ",
      "dataset": "ds_Init",
      "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,
    "opened_by_playwright": 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": [
    "ds_Detail03",
    "ds_List03",
    "ds_count",
    "ds_cond",
    "ds_File",
    "ds_logInfo",
    "ds_FileErr",
    "ds_NmChk",
    "ds_Temp",
    "ds_List01",
    "rdo_NotAll_innerdataset",
    "rdo_All_innerdataset"
  ],
  "shortcut": "pageLinkPopup1('176')",
  "screen_id": "WE::WETB_013.xfdl",
  "program_id": "WE::WETB_013.xfdl",
  "route_kind": "live_session_contract",
  "script_url": "https://edi.nhis.or.kr/webedi/xui/WE/WETB_013.xfdl.js",
  "source_url": "https://edi.nhis.or.kr/webedi/xui/index.jsp",
  "document_id": "WETB_013",
  "field_count": 12,
  "feature_name": "nhis_edi_certificate_issuance",
  "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": "ds_cond=ds_Init",
      "action": "WETB_013Action",
      "out_ds": "ds_count=ds_count",
      "mutates": false
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": "",
      "mutates": false
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": "",
      "mutates": false
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_013Action",
      "out_ds": "ds_count=ds_count",
      "mutates": false
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": "",
      "mutates": false
    },
    {
      "cmd": "nameCheck",
      "in_ds": "ds_NmChk=ds_NmChk",
      "action": "COMMONAction",
      "out_ds": "ds_NmChk=ds_NmChk",
      "mutates": false
    }
  ],
  "blocked_transactions": [
    {
      "cmd": "WETB_013_I01",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail03=ds_Detail03 ds_List03=ds_List03",
      "action": "WETB_013Action",
      "out_ds": "ds_Detail03=ds_out",
      "reason": "증명서 신청/발급/출력 가능성이 있어 init API에서 실행 금지"
    },
    {
      "cmd": "WETB_013_I02",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail03=ds_Detail03 ds_List03=ds_List03",
      "action": "WETB_013Action",
      "out_ds": "ds_Detail03=ds_out",
      "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": "ds_cond=ds_Init",
      "action": "WETB_013Action",
      "out_ds": "ds_count=ds_count"
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": ""
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": ""
    },
    {
      "cmd": "WETB_013_I01",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail03=ds_Detail03 ds_List03=ds_List03",
      "action": "WETB_013Action",
      "out_ds": "ds_Detail03=ds_out"
    },
    {
      "cmd": "WETB_013S",
      "in_ds": "ds_cond=ds_Init",
      "action": "WETB_013Action",
      "out_ds": "ds_count=ds_count"
    },
    {
      "cmd": "WETB_013_I02",
      "in_ds": "ds_cond=ds_Init ds_count=ds_count ds_Detail03=ds_Detail03 ds_List03=ds_List03",
      "action": "WETB_013Action",
      "out_ds": "ds_Detail03=ds_out"
    },
    {
      "cmd": "LogIns",
      "in_ds": "ds_cond=ds_logInfo",
      "action": "COMMONAction",
      "out_ds": ""
    },
    {
      "cmd": "nameCheck",
      "in_ds": "ds_NmChk=ds_NmChk",
      "action": "COMMONAction",
      "out_ds": "ds_NmChk=ds_NmChk"
    }
  ]
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.

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

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

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

JG::JGDB_080 기발급 사업장 가입자 명부 확인 화면 form contract를 조회합니다.

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [국민건강보험공단 EDI 로그인]
  • 기존 발급 명부 확인 contract만 제공. 출력·다운로드 미실행.
  • params 는 빈 객체로 보내도 호출됩니다.
Request
순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

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

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 모의 응답
  • real_test데모 — 하루 100 사용 토큰
  • 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조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : 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: sandbox' \
  --header 'Idempotency-Key: demo-init-001' \
  --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.
순번변수명설명
certificate_key증명서 종류 키 (workplace_member_list_issued)
page_link_id건강보험 EDI 화면 번호 (173)
blocked_transactions이 API에서 실행하지 않는(금지된) 트랜잭션 목록
business_context로그인한 사업장 기본 정보
dataset_count화면 dataset 개수
datasets원천 Nexacro/SSV dataset
default_values화면 초기값
document_id서식/문서 코드
feature_label기능 표시명(사용자용 기능명)
field_count화면 필드 개수
fieldsform contract 입력 필드 목록
form_idNexacro form ID
grid그리드 dataset·컬럼 정보
init_transactions초기 조회에 실행한 트랜잭션 목록
menu_program_id화면을 여는 메뉴 프로그램 ID
observed_callservices화면에서 관찰한 service 호출 목록
safety안전 정책(실행 금지 동작과 그 사유)
script_url화면 XFDL JavaScript URL
shortcut화면을 여는 바로가기 호출식(pageLinkPopup1 등)
source_url원천 NHIS EDI URL
target_ready화면 진입 준비 완료 여부
visible_text_markers화면 확인용 고정 문구
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": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "@@@@/@@/@@-@@",
      "name": "mdt_WrtChasu",
      "text": null,
      "type": "MaskEdit",
      "column": "WRT_CHASU",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": "@@@@/@@/@@",
      "name": "mdk_ProcDt",
      "text": null,
      "type": "MaskEdit",
      "column": "PROC_DT",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    },
    {
      "mask": null,
      "name": "edt_DocNo",
      "text": null,
      "type": "Edit",
      "column": "DOC_NO",
      "dataset": "ds_List",
      "enabled": null,
      "readonly": "true",
      "innerdataset": null
    }
  ],
  "safety": {
    "warning": "기존 발급 가입자 명부 확인 화면 contract만 제공하며 출력/다운로드는 실행하지 않는다.",
    "init_only": true,
    "opened_by_playwright": true,
    "allowed_transaction_cmds": [],
    "blocked_transaction_cmds": [
      null,
      null
    ],
    "mutating_actions_executed": false
  },
  "API_KEY": "[REDACTED]",
  "form_id": "JGDB_080",
  "success": true,
  "datasets": [
    "ds_List",
    "ds_Detail01",
    "ds_logInfo"
  ],
  "shortcut": "pageLinkPopup1('173')",
  "screen_id": "JG::JGDB_080.xfdl",
  "program_id": "JG::JGDB_080.xfdl",
  "route_kind": "live_session_contract",
  "script_url": "https://edi.nhis.or.kr/webedi/xui/JG/JGDB_080.xfdl.js",
  "source_url": "https://edi.nhis.or.kr/webedi/xui/index.jsp",
  "document_id": "JGDB_080",
  "field_count": 4,
  "feature_name": "nhis_edi_certificate_issuance",
  "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세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.