개발자 문서
API 레퍼런스

사업장·성립 - 4대보험

이 쪽의 모든 작업에 해당

  • 로그인을 먼저 호출해 세션을 만든 뒤, 같은 account_link_id 로 호출합니다. [4대보험 로그인]

1. 사업장 성립 신고 입력 초안 검증fourinsure.b1.business_establishment.draft_validate

MCP 도구 이름 fourinsure__b1__business_establishment__draft_validate

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

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

사업장 성립 신고서에 적을 값을 넣으면 저장이나 신고 없이 점검해 빠진 필수 항목과 항목별 오류, 신고 가능 여부를 돌려줍니다.

  • params 를 빈 객체로 보내도 작업은 성공하지만, 그러면 필수 입력이 missing_required_fields 로 돌아오고 workflow_gate.input_ready 가 false 입니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.business_establishment.draft_validate이 API 고정값 (기본값)

예시 : fourinsure.b1.business_establishment.draft_validate

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

  • 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입필수설명
selected_formsstring | arrayN신고서 선택
workplaceobjectN사업장 공통 정보입니다. 소재지, 연락처, 사업자등록번호와 환급계좌 등을 담습니다. 아래 하위 칸과 검증 결과를 확인합니다
workplace.namestringN사업장 명칭 생략 시 기본값: ""
workplace.type_codestringN사업장 형태 생략 시 기본값: ""
workplace.postal_codestringN소재지 우편번호 생략 시 기본값: ""
workplace.address_line1stringN소재지 기본주소 생략 시 기본값: ""
workplace.address_line2stringN사업장 소재지 상세주소입니다. 생략 시 기본값: ""
workplace.mailing_same_as_workplacestring | booleanN우편물 수령지가 사업장 소재지와 같은지 나타냅니다. 다르면 수령지 우편번호와 기본주소가 필요합니다. 생략 시 기본값: null
workplace.mailing_postal_codestringN우편물 수령지 우편번호 생략 시 기본값: ""
workplace.mailing_address_line1stringN우편물 수령지 기본주소 생략 시 기본값: ""
workplace.mailing_address_line2stringN우편물 수령지 상세주소입니다. 생략 시 기본값: ""
workplace.emailstringN전자우편주소 생략 시 기본값: ""
workplace.phoneobjectN사업장 전화번호
workplace.phone.areastringN전화번호의 지역번호 또는 휴대전화 식별번호입니다. 생략 시 기본값: ""
workplace.phone.middlestringN전화번호 가운데 구간입니다. 생략 시 기본값: ""
workplace.phone.laststringN전화번호 마지막 구간입니다. 생략 시 기본값: ""
workplace.faxobjectN사업장 팩스번호의 세 구간입니다
workplace.fax.areastringN전화번호의 지역번호 또는 휴대전화 식별번호입니다. 생략 시 기본값: ""
workplace.fax.middlestringN전화번호 가운데 구간입니다. 생략 시 기본값: ""
workplace.fax.laststringN전화번호 마지막 구간입니다. 생략 시 기본값: ""
workplace.mobileobjectN사업장 휴대전화번호의 세 구간입니다
workplace.mobile.areastringN전화번호의 지역번호 또는 휴대전화 식별번호입니다. 생략 시 기본값: ""
workplace.mobile.middlestringN전화번호 가운데 구간입니다. 생략 시 기본값: ""
workplace.mobile.laststringN전화번호 마지막 구간입니다. 생략 시 기본값: ""
workplace.business_type_namestringN업태 생략 시 기본값: ""
workplace.business_item_namestringN종목명 생략 시 기본값: ""
workplace.primary_product_namestringN주생산품 생략 시 기본값: ""
workplace.business_registration_numberstringN사업자등록번호 생략 시 기본값: ""
workplace.corporation_registration_numberstringN법인등록번호 생략 시 기본값: ""
workplace.refund_bank_namestringN환급계좌 은행명 생략 시 기본값: ""
workplace.refund_account_holder_namestringN환급계좌 예금주명 생략 시 기본값: ""
workplace.refund_account_numberstringN환급계좌 계좌번호 생략 시 기본값: ""
workplace.refund_account_certifiedstring | booleanN환급계좌 인증 생략 시 기본값: null
representativeobjectN대표자 성명, 주민등록번호, 주소와 인증 여부입니다
representative.namestringN대표자 성명 생략 시 기본값: ""
representative.resident_registration_numberstringN대표자 주민등록번호 생략 시 기본값: ""
representative.phoneobjectN대표자 전화번호의 세 구간입니다
representative.phone.areastringN전화번호의 지역번호 또는 휴대전화 식별번호입니다. 생략 시 기본값: ""
representative.phone.middlestringN전화번호 가운데 구간입니다. 생략 시 기본값: ""
representative.phone.laststringN전화번호 마지막 구간입니다. 생략 시 기본값: ""
representative.postal_codestringN대표자 우편번호 생략 시 기본값: ""
representative.address_line1stringN대표자 주소 생략 시 기본값: ""
representative.address_line2stringN대표자 상세주소입니다. 생략 시 기본값: ""
representative.appointment_datestringN대표자 취임일자 생략 시 기본값: ""
representative.certifiedstring | booleanN대표자 인증 생략 시 기본값: null
representative.joint_representative_countstringN공동대표자 수입니다. 생략 시 기본값: ""
joint_representativesarrayN공동대표자별 정보 목록입니다. 한 사람마다 객체 하나를 보냅니다
joint_representatives[].resident_registration_numberstringN공동대표자 주민등록번호입니다. 생략 시 기본값: ""
joint_representatives[].rrkeystringN공동대표자 인증 결과의 식별키입니다. 생략 시 기본값: ""
joint_representatives[].namestringN공동대표자 성명입니다. 생략 시 기본값: ""
joint_representatives[].phoneobjectN공동대표자 전화번호의 세 구간입니다
joint_representatives[].phone.areastringN전화번호의 지역번호 또는 휴대전화 식별번호입니다. 생략 시 기본값: ""
joint_representatives[].phone.middlestringN전화번호 가운데 구간입니다. 생략 시 기본값: ""
joint_representatives[].phone.laststringN전화번호 마지막 구간입니다. 생략 시 기본값: ""
joint_representatives[].postal_codestringN공동대표자 우편번호입니다. 생략 시 기본값: ""
joint_representatives[].address_line1stringN공동대표자 기본주소입니다. 생략 시 기본값: ""
joint_representatives[].address_line2stringN공동대표자 상세주소입니다. 생략 시 기본값: ""
joint_representatives[].appointment_datestringN공동대표자 취임일자입니다. 생략 시 기본값: ""
auto_transferobjectN자동이체 및 전자고지 신청 정보입니다. 신청 선택에 따라 계좌와 수신자 인증을 확인합니다
auto_transfer.applystring | booleanN자동이체 신청 여부입니다. 생략 시 기본값: null
auto_transfer.section_enabledstring | booleanN자동이체 또는 전자고지 입력 영역을 사용하는지 나타냅니다. 생략 시 기본값: null
auto_transfer.same_as_refund_accountstring | booleanN환급계좌와 같은 계좌를 사용하는지 나타냅니다. 생략 시 기본값: null
auto_transfer.bank_namestringN자동이체 은행명 생략 시 기본값: ""
auto_transfer.account_numberstringN자동이체 계좌번호 생략 시 기본값: ""
auto_transfer.account_holder_idstringN자동이체 예금주 식별값 생략 시 기본값: ""
auto_transfer.account_holder_namestringN자동이체 예금주명입니다. 생략 시 기본값: ""
auto_transfer.transfer_day_codestringN자동이체 희망일 코드입니다. 생략 시 기본값: ""
auto_transfer.combined_transfer_applystring | booleanN합산 자동이체 신청 여부입니다. 생략 시 기본값: null
auto_transfer.electronic_notice_channelsstring | arrayN전자고지 수신 채널 선택값입니다
auto_transfer.account_certifiedstring | booleanN자동이체 계좌 인증 생략 시 기본값: null
auto_transfer.recipient_rrnostringN수신자 주민등록번호 생략 시 기본값: ""
auto_transfer.recipient_namestringN수신자 성명 생략 시 기본값: ""
auto_transfer.recipient_emailstringN수신자 전자우편주소 생략 시 기본값: ""
auto_transfer.recipient_mobileobjectN전자고지 수신자 휴대전화번호의 세 구간입니다
auto_transfer.recipient_mobile.areastringN전화번호의 지역번호 또는 휴대전화 식별번호입니다. 생략 시 기본값: ""
auto_transfer.recipient_mobile.middlestringN전화번호 가운데 구간입니다. 생략 시 기본값: ""
auto_transfer.recipient_mobile.laststringN전화번호 마지막 구간입니다. 생략 시 기본값: ""
auto_transfer.recipient_certifiedstring | booleanN수신자 인증 생략 시 기본값: null
auto_transfer.mobile_certifiedstring | booleanN수신자 휴대전화 인증 생략 시 기본값: null
construction_siteobjectN건설현장 해당 여부와 사업기간 정보입니다
construction_site.relevant_ynstringN건설현장 사업장 해당 여부입니다. 생략 시 기본값: ""
construction_site.nps_daily_worker_management_ynstringN국민연금 건설일용근로자 사업장 분리관리 해당 여부입니다. 생략 시 기본값: ""
construction_site.start_datestringN건설현장 사업기간 시작일 생략 시 기본값: ""
construction_site.end_datestringN건설현장 사업기간 종료일 생략 시 기본값: ""
insurance_supportobjectN국민연금과 고용보험의 보험료 지원 신청 여부 및 신청월입니다
insurance_support.national_pension_applystring | booleanN국민연금 보험료 지원 신청 여부입니다. 생략 시 기본값: null
insurance_support.national_pension_apply_monthstringN국민연금 지원신청월 생략 시 기본값: ""
insurance_support.employment_insurance_applystring | booleanN고용보험 보험료 지원 신청 여부입니다. 생략 시 기본값: null
insurance_support.employment_insurance_apply_monthstringN고용보험 지원신청월 생략 시 기본값: ""
national_pensionobjectN국민연금
national_pension.worker_countstringN국민연금 근로자수 생략 시 기본값: ""
national_pension.eligible_subscriber_countstringN국민연금 가입대상자수 생략 시 기본값: ""
national_pension.application_datestringN국민연금 적용연월일 생략 시 기본값: ""
national_pension.separated_workplace_relevant_ynstringN국민연금 분리적용사업장 해당여부 생략 시 기본값: ""
national_pension.headquarters_workplace_management_nostringN국민연금 본점 사업장관리번호입니다. 생략 시 기본값: ""
national_pension.headquarters_workplace_namestringN국민연금 본점 사업장명입니다. 생략 시 기본값: ""
national_pension.headquarters_user_namestringN국민연금 본점 사용자 성명입니다. 생략 시 기본값: ""
health_insuranceobjectN건강보험
health_insurance.applicable_subscriber_countstringN건강보험 적용대상자수 생략 시 기본값: ""
health_insurance.application_datestringN건강보험 적용연월일 생략 시 기본값: ""
health_insurance.workplace_character_codestringN건강보험 사업장특성부호 생략 시 기본값: ""
health_insurance.headquarters_workplace_management_nostringN건강보험 본점 사업장관리번호입니다. 생략 시 기본값: ""
health_insurance.accounting_category_codesstring | arrayN건강보험 회계 구분 코드 목록입니다
employment_insuranceobjectN고용보험
employment_insurance.regular_worker_countstringN고용보험 상시근로자수 생략 시 기본값: ""
employment_insurance.insured_worker_countstringN고용보험 피보험자수 생략 시 기본값: ""
employment_insurance.establishment_datestringN고용보험 성립일 생략 시 기본값: ""
employment_insurance.data_apply_scopestring | arrayN고용보험 자료반영
employment_insurance.main_workplace_management_nostringN고용보험 주된 사업장관리번호입니다. 생략 시 기본값: ""
employment_insurance.main_workplace_namestringN고용보험 주된 사업장명입니다. 생략 시 기본값: ""
employment_insurance.main_workplace_business_registration_numberstringN고용보험 주된사업장 사업자등록번호 생략 시 기본값: ""
employment_insurance.main_workplace_business_type_namestringN고용보험 주된사업장 업종 생략 시 기본값: ""
employment_insurance.main_workplace_regular_worker_countstringN고용보험 주된사업장 총상시근로자수 생략 시 기본값: ""
employment_insurance.main_workplace_insured_worker_countstringN고용보험 주된사업장 총피보험자수 생략 시 기본값: ""
employment_insurance.priority_support_target_company_ynstringN고용보험 우선지원대상기업 여부 생략 시 기본값: ""
workers_compensationobjectN산재보험
workers_compensation.regular_worker_countstringN산재보험 상시근로자수 생략 시 기본값: ""
workers_compensation.business_kind_namestringN산재보험 사업 종류 이름입니다. 생략 시 기본값: ""
workers_compensation.business_form_codestringN산재보험 사업의 형태 생략 시 기본값: ""
workers_compensation.business_period_start_datestringN산재보험 사업기간 시작일 생략 시 기본값: ""
workers_compensation.business_period_end_datestringN산재보험 사업기간 종료일 생략 시 기본값: ""
workers_compensation.establishment_datestringN산재보험 성립일 생략 시 기본값: ""
workers_compensation.accident_occurred_ynstringN산재보험 산업재해발생여부 생략 시 기본값: ""
workers_compensation.main_workplace_ynstringN산재보험 주된 사업장 여부 생략 시 기본값: ""
workers_compensation.main_workplace_management_nostringN산재보험 주된 사업장 관리번호 생략 시 기본값: ""
workers_compensation.main_workplace_namestringN산재보험 주된 사업장명입니다. 생략 시 기본값: ""
workers_compensation.original_workplace_management_nostringN산재보험 원 사업장관리번호입니다. 생략 시 기본값: ""
administrative_information_consentstring | booleanN행정정보 공동이용 동의
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: draft_validate-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.business_establishment.draft_validate",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • 저장 · 신고 없이 입력만 검증합니다. result.data 의 missing_required_fields 와 field_errors 로 고칠 항목을, workflow_gate 의 input_ready 와 can_submit_report 로 다음 단계로 갈 수 있는지 확인합니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
feature_namestring기능 식별자
phasestring처리 단계(draft_validate)
workflow_stepstring처리 단계 식별자
route_kindstring처리 방식 — live_context_local_validation(화면 계약을 불러와 서버에서 검증)
source_urlstring서버가 요청한 기관 화면 주소
current_viewstring현재 화면 식별자
target_readyboolean대상 폼 준비 여부
business_contextobject사업장 컨텍스트 객체
selected_insurancesarray검증 대상으로 고른 보험 목록
enabled_sectionsarray화면 기준 섹션 사용 가능 상태 배열(key · label · enabled)
required_fieldsarray화면 기준 필수 입력 항목 배열(field_key · label · section · required_when)
missing_required_fieldsarray빠진 필수 입력 항목 배열(required_fields 와 같은 모양)
field_errorsarray입력 누락 · 형식 오류 배열(field_key · label · section · message)
warningsarray주의 메시지 배열(code · section · message · field_key)
screen_notesarray화면 확인 메모 배열
field_bindingsobject입력 키와 화면 필드의 대응 맵
normalized_inputobject정규화한 입력값 맵
draft_form_previewobject화면 필드에 채울 값 미리보기 맵
followup_endpointsarray기관 화면이 다음 단계에서 부르는 주소 목록({url} 객체 배열)입니다. 우리 API 주소가 아니며 직접 호출하지 않습니다
workflow_gateobject진행 판정 객체(input_ready · blocking_issue_count · can_save=false · can_submit_report · report_status · blocked_reason)
workflow_gate.input_readyboolean필수 입력 누락과 형식 오류가 없으면 true 입니다. 이 호출이 신고를 실행했다는 뜻은 아닙니다.
workflow_gate.blocking_issue_countnumber입력 누락과 형식 오류를 합한 차단 항목 수입니다.
workflow_gate.can_saveboolean항상 false 입니다. 이 작업은 저장하지 않습니다.
workflow_gate.can_submit_reportboolean입력과 동의 조건을 충족해 신고 가능한 상태인지 나타냅니다. 실제 전송 여부는 safety.submit_executed 로 확인합니다.
workflow_gate.report_statusstring신고 가능 또는 신고 불가입니다. 프로그램 분기에는 can_submit_report 를 사용합니다.
workflow_gate.blocked_reasonstring신고 불가 사유입니다. 신고 가능한 상태면 빈 문자열입니다.
safetyobject안전 플래그 객체(input_only=true · save_executed=false · submit_executed=false)
safety.input_onlyboolean항상 true 입니다. 입력 검증만 수행합니다.
safety.save_executedboolean항상 false 입니다. 기관에 저장하지 않았습니다.
safety.submit_executedboolean항상 false 입니다. 기관에 신고하지 않았습니다.
safety.blocked_buttonsarray이 검증 단계에서 실행하지 않는 화면 버튼 이름 목록입니다(저장, 취소).
safety.warningstring실제 업무 상태를 변경하지 않았음을 알리는 안내 문장입니다.
implementation_statusstring구현 상태 식별자
json
// 합성 빈 입력을 실제 검증 코드로 실행한 예시입니다. input_ready=false 이며 저장·제출은 수행하지 않았습니다.
{
  "success": true,
  "feature_name": "...",
  "phase": "draft_validate",
  "workflow_step": "business_establishment_draft_validated",
  "route_kind": "live_context_local_validation",
  "source_url": "https://...",
  "current_view": "target_form",
  "target_ready": true,
  "business_context": {
    "workplace_management_no": "",
    "workplace_name": "",
    "user_id": "",
    "reporter_name": "",
    "declared_insurance_rows": [],
    "initial_declaration_info": {}
  },
  "selected_insurances": [],
  "enabled_sections": [
    {
      "key": "selection",
      "label": "신고서 선택",
      "enabled": true
    },
    {
      "key": "workplace",
      "label": "공통-사업장(사업주)",
      "enabled": true
    },
    {
      "key": "representative",
      "label": "공통-사용자(대표자)",
      "enabled": true
    },
    {
      "key": "auto_transfer",
      "label": "보험료 자동이체 및 전자고지",
      "enabled": true
    },
    {
      "key": "construction_site",
      "label": "국민연금/건강보험-건설현장 사업장 설정",
      "enabled": false
    },
    {
      "key": "insurance_support",
      "label": "국민연금/고용보험-보험료지원신청",
      "enabled": false
    },
    {
      "key": "national_pension",
      "label": "국민연금",
      "enabled": false
    },
    {
      "key": "health_insurance",
      "label": "건강보험",
      "enabled": false
    },
    {
      "key": "employment_insurance",
      "label": "고용보험",
      "enabled": false
    },
    {
      "key": "workers_compensation",
      "label": "산재보험",
      "enabled": false
    },
    {
      "key": "workflow",
      "label": "신고 단계",
      "enabled": true
    }
  ],
  "required_fields": [
    {
      "field_key": "selected_forms",
      "label": "신고서 선택",
      "section": "selection",
      "required_when": "최소 1개 선택"
    },
    {
      "field_key": "workplace.name",
      "label": "사업장 명칭",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.type_code",
      "label": "사업장 형태",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.postal_code",
      "label": "소재지 우편번호",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.address_line1",
      "label": "소재지 기본주소",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.phone",
      "label": "사업장 전화번호",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.business_type_name",
      "label": "업태",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.business_item_name",
      "label": "종목명",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.primary_product_name",
      "label": "주생산품",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.business_registration_number",
      "label": "사업자등록번호",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "representative.name",
      "label": "대표자 성명",
      "section": "representative",
      "required_when": "대표자 정보 필수"
    },
    {
      "field_key": "representative.resident_registration_number",
      "label": "대표자 주민등록번호",
      "section": "representative",
      "required_when": "대표자 정보 필수"
    },
    {
      "field_key": "representative.address_line1",
      "label": "대표자 주소",
      "section": "representative",
      "required_when": "대표자 정보 필수"
    },
    {
      "field_key": "administrative_information_consent",
      "label": "행정정보 공동이용 동의",
      "section": "workflow",
      "required_when": "제출 가능 상태 필수"
    },
    {
      "field_key": "workplace.mailing_postal_code",
      "label": "우편물 수령지 우편번호",
      "section": "workplace",
      "required_when": "우편물 수령지가 소재지와 다를 때 필수"
    },
    {
      "field_key": "workplace.mailing_address_line1",
      "label": "우편물 수령지 기본주소",
      "section": "workplace",
      "required_when": "우편물 수령지가 소재지와 다를 때 필수"
    },
    {
      "field_key": "representative.appointment_date",
      "label": "대표자 취임일자",
      "section": "representative",
      "required_when": "대표자 정보 입력 시 필수"
    },
    {
      "field_key": "representative.certified",
      "label": "대표자 인증",
      "section": "representative",
      "required_when": "대표자 주민번호/성명 입력 후 필수"
    }
  ],
  "missing_required_fields": [
    {
      "field_key": "selected_forms",
      "label": "신고서 선택",
      "section": "selection",
      "required_when": "최소 1개 선택"
    },
    {
      "field_key": "workplace.name",
      "label": "사업장 명칭",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.type_code",
      "label": "사업장 형태",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.postal_code",
      "label": "소재지 우편번호",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.address_line1",
      "label": "소재지 기본주소",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.mailing_postal_code",
      "label": "우편물 수령지 우편번호",
      "section": "workplace",
      "required_when": "우편물 수령지가 소재지와 다를 때 필수"
    },
    {
      "field_key": "workplace.mailing_address_line1",
      "label": "우편물 수령지 기본주소",
      "section": "workplace",
      "required_when": "우편물 수령지가 소재지와 다를 때 필수"
    },
    {
      "field_key": "workplace.business_type_name",
      "label": "업태",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.business_item_name",
      "label": "종목명",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.primary_product_name",
      "label": "주생산품",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.business_registration_number",
      "label": "사업자등록번호",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "workplace.phone",
      "label": "사업장 전화번호",
      "section": "workplace",
      "required_when": "사업장 정보 필수"
    },
    {
      "field_key": "representative.name",
      "label": "대표자 성명",
      "section": "representative",
      "required_when": "대표자 정보 필수"
    },
    {
      "field_key": "representative.resident_registration_number",
      "label": "대표자 주민등록번호",
      "section": "representative",
      "required_when": "대표자 정보 필수"
    },
    {
      "field_key": "representative.address_line1",
      "label": "대표자 주소",
      "section": "representative",
      "required_when": "대표자 정보 필수"
    },
    {
      "field_key": "representative.appointment_date",
      "label": "대표자 취임일자",
      "section": "representative",
      "required_when": "대표자 정보 입력 시 필수"
    },
    {
      "field_key": "representative.certified",
      "label": "대표자 인증",
      "section": "representative",
      "required_when": "대표자 주민번호/성명 입력 후 필수"
    },
    {
      "field_key": "administrative_information_consent",
      "label": "행정정보 공동이용 동의",
      "section": "workflow",
      "required_when": "제출 가능 상태 필수"
    }
  ],
  "field_errors": [
    {
      "field_key": "workplace.phone",
      "label": "사업장 전화번호",
      "section": "workplace",
      "message": "사업장 전화번호를 입력해야 합니다."
    }
  ],
  "warnings": [
    {
      "code": "INPUT_ONLY",
      "section": "workflow",
      "message": "사업장 성립신고 draft-validate는 화면 기준 입력 검증만 수행하며 저장/신고는 실행하지 않습니다.",
      "field_key": null
    }
  ],
  "screen_notes": [
    "실화면 기준으로 신고서 선택, 공통 사업장/대표자, 자동이체/전자고지, 건설현장 설정, 보험료지원신청, 보험별 고유 입력 섹션을 기준으로 입력 구조를 정리했습니다.",
    "행정정보 공동이용 동의는 제출 가능 상태 판단에 필수로 취급합니다."
  ],
  "field_bindings": {
    "selected_forms": {
      "screen_fields": [
        "nps1",
        "nhi1",
        "epi1",
        "iai1"
      ]
    },
    "workplace": {
      "screen_fields": [
        "bplcNm",
        "bplcTypeCd",
        "bplcLctnOzip",
        "bplcLctnBscAddr",
        "bplcLctnDaddr",
        "bplcTelrno",
        "bplcTelono",
        "bplcTelino",
        "bplcFxrno",
        "bplcFxono",
        "bplcFxino",
        "bzowrTypeNm",
        "bzitemNm",
        "mainPdNm",
        "bzmnNo",
        "crno",
        "emlAddr"
      ]
    },
    "representative": {
      "screen_fields": [
        "rprsNm",
        "rrno",
        "rprsLctnOzip",
        "rprsLctnBscAddr",
        "rprsLctnDaddr"
      ]
    },
    "administrative_information_consent": {
      "screen_fields": [
        "adInfoJointUseAgreYn"
      ]
    },
    "auto_transfer": {
      "screen_fields": [
        "bankNm",
        "fnstCd",
        "dpstrNm",
        "encptAttranActno",
        "dpstrBzmnNo",
        "aplcntRrno",
        "dpstrRrkey"
      ]
    },
    "insurance_support": {
      "screen_fields": [
        "npsSprtYn",
        "epiSprtYn"
      ]
    }
  },
  "normalized_input": {
    "selected_forms": [],
    "workplace": {
      "name": "",
      "type_code": "",
      "postal_code": "",
      "address_line1": "",
      "address_line2": "",
      "mailing_same_as_workplace": false,
      "mailing_postal_code": "",
      "mailing_address_line1": "",
      "mailing_address_line2": "",
      "email": "",
      "phone": {
        "area": "",
        "middle": "",
        "last": "",
        "full": ""
      },
      "fax": {
        "area": "",
        "middle": "",
        "last": "",
        "full": ""
      },
      "mobile": {
        "area": "",
        "middle": "",
        "last": "",
        "full": ""
      },
      "business_type_name": "",
      "business_item_name": "",
      "primary_product_name": "",
      "business_registration_number": "",
      "corporation_registration_number": "",
      "refund_bank_name": "",
      "refund_account_holder_name": "",
      "refund_account_number": "",
      "refund_account_certified": false
    },
    "representative": {
      "name": "",
      "resident_registration_number": "",
      "phone": {
        "area": "",
        "middle": "",
        "last": "",
        "full": ""
      },
      "postal_code": "",
      "address_line1": "",
      "address_line2": "",
      "appointment_date": "",
      "certified": false,
      "joint_representative_count": ""
    },
    "joint_representatives": [],
    "auto_transfer": {
      "section_enabled": false,
      "apply": false,
      "same_as_refund_account": false,
      "bank_name": "",
      "account_number": "",
      "account_holder_id": "",
      "account_holder_name": "",
      "transfer_day_code": "",
      "combined_transfer_apply": false,
      "electronic_notice_channels": [],
      "account_certified": false,
      "recipient_rrno": "",
      "recipient_name": "",
      "recipient_email": "",
      "recipient_mobile": {
        "area": "",
        "middle": "",
        "last": "",
        "full": ""
      },
      "recipient_certified": false,
      "mobile_certified": false
    },
    "construction_site": {
      "relevant_yn": "",
      "nps_daily_worker_management_yn": "",
      "start_date": "",
      "end_date": ""
    },
    "insurance_support": {
      "national_pension_apply": false,
      "national_pension_apply_month": "",
      "employment_insurance_apply": false,
      "employment_insurance_apply_month": ""
    },
    "national_pension": {
      "worker_count": "",
      "eligible_subscriber_count": "",
      "application_date": "",
      "separated_workplace_relevant_yn": "",
      "headquarters_workplace_management_no": "",
      "headquarters_workplace_name": "",
      "headquarters_user_name": ""
    },
    "health_insurance": {
      "applicable_subscriber_count": "",
      "application_date": "",
      "workplace_character_code": "",
      "headquarters_workplace_management_no": "",
      "accounting_category_codes": []
    },
    "employment_insurance": {
      "regular_worker_count": "",
      "insured_worker_count": "",
      "establishment_date": "",
      "data_apply_scope": [],
      "main_workplace_management_no": "",
      "main_workplace_name": "",
      "main_workplace_business_registration_number": "",
      "main_workplace_business_type_name": "",
      "main_workplace_regular_worker_count": "",
      "main_workplace_insured_worker_count": "",
      "priority_support_target_company_yn": ""
    },
    "workers_compensation": {
      "regular_worker_count": "",
      "business_kind_name": "",
      "business_form_code": "",
      "business_period_start_date": "",
      "business_period_end_date": "",
      "establishment_date": "",
      "accident_occurred_yn": "",
      "main_workplace_yn": "",
      "main_workplace_management_no": "",
      "main_workplace_name": "",
      "original_workplace_management_no": ""
    },
    "administrative_information_consent": false
  },
  "draft_form_preview": {
    "selected_forms": [],
    "workplace_name": "",
    "workplace_type_code": "",
    "workplace_phone": "",
    "business_registration_number": "",
    "representative_name": "",
    "representative_rrno": "",
    "representative_appointment_date": "",
    "representative_certified": false,
    "joint_representatives": [],
    "auto_transfer_apply": false,
    "auto_transfer_section_enabled": false,
    "construction_site_relevant_yn": "",
    "insurance_support": {
      "national_pension_apply": false,
      "national_pension_apply_month": "",
      "employment_insurance_apply": false,
      "employment_insurance_apply_month": ""
    },
    "national_pension": {
      "worker_count": "",
      "eligible_subscriber_count": "",
      "application_date": ""
    },
    "health_insurance": {
      "applicable_subscriber_count": "",
      "application_date": "",
      "workplace_character_code": ""
    },
    "employment_insurance": {
      "regular_worker_count": "",
      "insured_worker_count": "",
      "data_apply_scope": []
    },
    "workers_compensation": {
      "regular_worker_count": "",
      "business_form_code": "",
      "main_workplace_yn": ""
    },
    "administrative_information_consent": false
  },
  "followup_endpoints": [],
  "workflow_gate": {
    "input_ready": false,
    "blocking_issue_count": 19,
    "can_save": false,
    "can_submit_report": false,
    "report_status": "신고 불가",
    "blocked_reason": "필수 입력 또는 화면 형식 규칙이 아직 충족되지 않았습니다."
  },
  "safety": {
    "input_only": true,
    "save_executed": false,
    "submit_executed": false,
    "blocked_buttons": [
      "저장",
      "취소"
    ],
    "warning": "실제 업무 상태를 변경하는 저장/신고는 수행하지 않습니다."
  },
  "implementation_status": "implemented_input_only_draft_validation"
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.

2. 사업장 성립 신고 초기조회fourinsure.b1.business_establishment.init

MCP 도구 이름 fourinsure__b1__business_establishment__init

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

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

사업장 성립 신고 화면의 초기 정보를 조회해 사업장 명칭과 관리번호, 공통 신고 목록, 화면에 채워진 신고 정보를 돌려줍니다.

  • params 는 빈 객체로 보내도 호출됩니다. 사용할 인증서는 account_link_id 로 지정합니다.

Request

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

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

[참고] 인증

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

[참고] 환경

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

[참고] 재시도

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

예시 : fourinsure

actionstring-Y호출할 작업입니다.
  • fourinsure.b1.business_establishment.init이 API 고정값 (기본값)

예시 : fourinsure.b1.business_establishment.init

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

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

순번변수명타입필수설명
cvrc_nostringN민원 접수번호 cvrcNo. 기본 "" — params {} 가능
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: init-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "fourinsure",
  "action": "fourinsure.b1.business_establishment.init",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • result.data 의 user_info 와 사업장 신고 목록(comm_bplc_dclr_list), 신고 상세(comm_bplc_dclr_info)를 확인합니다.
  • 여러 JSON 타입이 함께 표시된 칸은 서버가 세부 타입을 고정하지 않는 기관 원문 또는 동적 값입니다.
순번변수명타입설명
user_infoobject로그인한 사용자의 사업장 정보 객체입니다. bpmno(사업장관리번호), bplcNm(사업장명), userId(사용자 아이디), username(사용자 이름) 칸만 담기고 인증 정보와 연락처는 담지 않습니다
comm_bplc_dclr_liststring | number | boolean | object | array | null사업장 신고 목록 배열
comm_bplc_dclr_infostring | number | boolean | object | array | null사업장 신고 상세 객체
comm_bplc_dclr_epi_yn_bpmnostring | number | boolean | object | array | null고용·산재 가입 사업장번호(EPI)
comm_bplc_dclr_iai_yn_bpmnostring | number | boolean | object | array | null산재보험 가입 사업장번호(IAI)
json
// result.data
{
  "user_info": {
    "bpmno": "12345678901",
    "bplcNm": "예시 주식회사",
    "userId": "user01",
    "username": "예시 주식회사"
  },
  "comm_bplc_dclr_info": {
    "dir": "ASC",
    "rsn": null,
    "brno": "1234567890",
    "crno": "000000-0000000",
    "rrno": "[REDACTED]",
    "sort": null,
    "work": null,
    "bpmno": "12345678901",
    "clsNm": null,
    "rnmCd": null,
    "rrkey": null,
    "agreYn": null,
    "bplcNm": "예시 주식회사",
    "bplcSb": null,
    "cvrcNo": null,
    "fnstCd": "   ",
    "fnstNm": null,
    "liCdNm": null,
    "memCnt": null,
    "regYmd": null,
    "userNm": null,
    "userSn": null,
    "admstCd": null,
    "bscAddr": null,
    "dpstrNm": " ",
    "istlYmd": null,
    "lgaddcd": null,
    "rnmCdNm": null,
    "tpbizCd": "58222",
    "tpbizNm": "응용 소프트웨어 개발 및 공급업",
    "wrkrCnt": "1",
    "aplcnYmd": "20250601",
    "bizKndCd": null,
    "bplcFxno": null,
    "bplcSeCd": "1",
    "bzstatNm": null,
    "dsmslYmd": null,
    "extshYmd": null,
    "instSeCd": null,
    "kornFlnm": "홍길동",
    "opbizYmd": null,
    "stdgCdNm": null,
    "totalCnt": null,
    "userAddr": null,
    "aplcnYmd1": null,
    "aplcnYmd2": null,
    "bizTypeCd": null,
    "bplcEpiYn": null,
    "bplcFxino": "    ",
    "bplcFxono": "    ",
    "bplcFxrno": "    ",
    "bplcIaiYn": null,
    "bplcNhiYn": null,
    "bplcNpsYn": null,
    "bplcSbEpi": null,
    "bplcSbIai": null,
    "bplcSbNhi": null,
    "bplcSbNps": null,
    "bplcTelno": null,
    "clsbizYmd": null,
    "epiBplcSb": "12345678901",
    "epiBrofCd": "2040",
    "eplCntrCd": null,
    "extshYmd1": null,
    "extshYmd2": null,
    "extshYmd3": null,
    "extshYmd4": null,
    "frstRegDt": null,
    "iaiBplcSb": "12345678901",
    "iaiBrofCd": "2040",
    "joinjnrps": null,
    "kcoBrofCd": null,
    "lastChgDt": null,
    "loginPart": null,
    "mainBpmno": "           ",
    "nhiBplcSb": "12345678",
    "nhiBrofCd": "0131",
    "npsBplcSb": "12345678901",
    "npsBrofCd": "1124",
    "ntsSttsCd": null,
    "othagSeCd": null,
    "rprsvFlnm": null,
    "userDaddr": "예시빌딩 4층 401호",
    "userRrkey": "*******8901",
    "bfchgBpmno": null,
    "bizKndCdNm": "정보처리 및 기타컴퓨터운용관련사업          ",
    "bplcFormCd": "1",
    "bplcTelino": "1234",
    "bplcTelono": "1234",
    "bplcTelrno": "123 ",
    "encptActno": null,
    "epiaBplcSb": null,
    "extshRsnCd": null,
    "frstRegDt1": null,
    "frstRegDt2": null,
    "lastChgDt1": null,
    "lastChgDt2": null,
    "mainBplcNm": null,
    "memEpiSeCd": null,
    "memNhiSeCd": null,
    "memNpsSeCd": null,
    "othagBpmno": null,
    "rmbrFnstCd": null,
    "rprsvDaddr": null,
    "rprsvRrkey": null,
    "rsnOcrnYmd": null,
    "tpbizCdEpi": null,
    "userAddrHo": "1234",
    "userAddrSt": "1234",
    "userTelino": "    ",
    "userTelono": "    ",
    "userTelrno": "    ",
    "wrcRgnSeCd": "7",
    "bplcEmlAddr": " ",
    "bplcEstbYmd": "20251001",
    "bplcJoinYmd": "20250601",
    "bplcLborgCd": null,
    "bplcLctnFlr": null,
    "bplcRnmAddr": null,
    "bplcSttsCd1": "1",
    "bplcSttsCd2": "1",
    "bplcSttsCd3": "1",
    "bplcSttsCd4": "1",
    "etcDclrSeCd": null,
    "joinTrprCnt": "1",
    "lastPrcsYmd": "20250730",
    "mainPrdctNm": null,
    "nhiUpBplcSb": null,
    "ntsBplcSeCd": null,
    "othagMemCnt": null,
    "rmbrDpstrNm": null,
    "rprsvTelino": null,
    "rprsvTelono": null,
    "rprsvTelrno": null,
    "tcbizEndYmd": null,
    "unitBplcCnt": 0,
    "userAddrBan": "12",
    "userAddrFlr": null,
    "userAddrTng": "12",
    "userBscAddr": "서울특별시 중구 예시로 123",
    "userRnmAddr": "서울특별시 중구 예시로 123",
    "userSaddrHo": "123",
    "userSaddrNm": "예시빌딩 4층 401호",
    "bplcEstbYmd1": "20251001",
    "bplcEstbYmd2": "20251001",
    "bplcLctnAddr": null,
    "bplcLctnBmno": "1",
    "bplcLctnBsno": "1",
    "bplcLctnOzip": "12345",
    "cmptncBrofCd": null,
    "cmptncBrofNm": null,
    "mrgeDclrSeCd": null,
    "rprsvBscAddr": null,
    "rprsvEmlAddr": null,
    "rprsvRnmAddr": null,
    "searchColumn": null,
    "tcbizBgngYmd": null,
    "userAddrBmno": "123",
    "userAddrBsno": "12",
    "userAddrOzip": "12345",
    "userRnmDaddr": "예시빌딩 4층 401호",
    "userSaddrDng": "123",
    "bplcLctnDaddr": "예시빌딩 4층 401호",
    "bplcLctnRnmCd": "123456789012",
    "bplcLctnSggCd": "123",
    "bplcMblTelcno": "   ",
    "bplcMblTelino": "    ",
    "bplcMblTelono": "    ",
    "bplcTypeCdEpi": "1",
    "bplcTypeCdIai": "1",
    "cnstBizEndYmd": null,
    "frstRegUserId": null,
    "idntyTrgtYnVl": null,
    "lastChgUserId": null,
    "pstmRcptnAddr": null,
    "pstmRcptnBmno": "0",
    "pstmRcptnBsno": "0",
    "pstmRcptnOzip": "      ",
    "rprsvAddrBmno": null,
    "rprsvAddrBsno": null,
    "rprsvRnmDaddr": null,
    "searchKeyword": null,
    "tcbizDclrSeCd": null,
    "userAddrRnmCd": "123456789012",
    "userAddrSggCd": "123",
    "userMblTelcno": null,
    "userMblTelino": null,
    "userMblTelono": null,
    "bizEndDclrSeCd": null,
    "bplcLctnAddrHo": " ",
    "bplcLctnAddrSt": " ",
    "bplcLctnBlckNm": " ",
    "bplcLctnCtpvCd": "12",
    "bplcLctnDongCd": "1234567890",
    "bplcLctnStdgCd": "1234567890",
    "bplcLctnUdgdYn": null,
    "clsbizDclrSeCd": null,
    "cnstBizBgngYmd": null,
    "encptRmbrActno": null,
    "pstmRcptnDaddr": " ",
    "pstmRcptnRnmCd": "-",
    "pstmRcptnSggCd": null,
    "rprsvAddrRnmCd": null,
    "rprsvAddrSggCd": null,
    "rprsvMblTelcno": null,
    "rprsvMblTelino": null,
    "rprsvMblTelono": null,
    "unitBplcRmvYmd": null,
    "userAddrAddrSt": null,
    "userAddrBlckNm": " ",
    "userAddrBldgHo": null,
    "userAddrCtpvCd": "12",
    "userAddrDongCd": "1234567890",
    "userAddrStdgCd": "1234567890",
    "userAddrUdgdYn": null,
    "bplcLctnAddrBan": " ",
    "bplcLctnAddrTng": " ",
    "bplcLctnAdemdCd": "123",
    "bplcLctnBscAddr": "서울특별시 중구 예시로 123",
    "bplcLctnFlrNoNm": null,
    "bplcLctnRnmAddr": "서울특별시 중구 예시로 123",
    "bplcLctnSaddrHo": " ",
    "bplcLctnSaddrNm": " ",
    "bplcLctnStemdCd": "123",
    "pstmRcptnAddrHo": null,
    "pstmRcptnAddrSt": null,
    "pstmRcptnBlckNm": null,
    "pstmRcptnCtpvCd": "-",
    "pstmRcptnDongCd": "-",
    "pstmRcptnStdgCd": "-",
    "pstmRcptnUdgdYn": null,
    "rprsvAddrCtpvCd": null,
    "rprsvAddrDongCd": null,
    "rprsvAddrStdgCd": null,
    "rprsvAddrUdgdYn": null,
    "userAddrAdemdCd": "123",
    "userAddrBldgDng": null,
    "userAddrStemdCd": "123",
    "bplcLctnDaddrRnm": null,
    "bplcLctnRnmDaddr": "예시빌딩 4층 401호",
    "bplcLctnSaddrDng": " ",
    "bplcLctnStdgLiCd": "12",
    "bplcLctnUdgdSeCd": "1",
    "bslcBascaddrComm": null,
    "bslcDetladdrComm": null,
    "emlInfrmAplyYnVl": null,
    "pstmRcptnAddrBan": null,
    "pstmRcptnAddrFlr": null,
    "pstmRcptnAddrTng": null,
    "pstmRcptnAdemdCd": null,
    "pstmRcptnBscAddr": " ",
    "pstmRcptnRnmAddr": null,
    "pstmRcptnSaddrHo": null,
    "pstmRcptnSaddrNm": null,
    "pstmRcptnStemdCd": null,
    "recvBascaddrComm": null,
    "recvDetladdrComm": null,
    "rprsvAddrFlrNoNm": null,
    "unitBplcAplcnYmd": null,
    "userAddrStdgLiCd": "12",
    "userAddrUdgdSeCd": "1",
    "userBascaddrComm": null,
    "userDetladdrComm": null,
    "afwdPstmRcptnAddr": null,
    "afwdPstmRcptnBmno": null,
    "afwdPstmRcptnBsno": null,
    "bplcLctnMtnStSeCd": "N",
    "epiWhdwlExtshSeCd": null,
    "frstRegUserIpAddr": null,
    "iaiWhdwlExtshSeCd": null,
    "lastChgUserIpAddr": null,
    "nhiWhdwlExtshSeCd": null,
    "npsWhdwlExtshSeCd": null,
    "pstmRcptnDaddrRnm": null,
    "pstmRcptnRnmDaddr": null,
    "pstmRcptnSaddrDng": null,
    "pstmRcptnStdgLiCd": null,
    "pstmRcptnUdgdSeCd": "-",
    "rcptDataMdfcnYnVl": null,
    "rprsvAddrLctnOzip": null,
    "rprsvAddrStdgCdNm": null,
    "rprsvAddrStdgLiCd": null,
    "userAddrMtnStSeCd": "N",
    "afwdPstmRcptnRnmCd": null,
    "afwdPstmRcptnSggCd": null,
    "bplcLctnBldgAddrHo": null,
    "bplcLctnBscAddrRnm": null,
    "bslcPlcSpaddaddrHo": null,
    "pstmRcptnMtnStSeCd": "-",
    "smsNtfctnMblTelcno": null,
    "smsNtfctnMblTelino": null,
    "smsNtfctnMblTelono": null,
    "userAddrZipLclsfCd": null,
    "userAddrZipMclsfCd": null,
    "wrkrCntElpDclrSeCd": null,
    "wrkrCntUndDclrSeCd": null,
    "afwdPstmRcptnAddrHo": null,
    "afwdPstmRcptnAddrSt": null,
    "afwdPstmRcptnBlckNm": null,
    "afwdPstmRcptnCtpvCd": null,
    "afwdPstmRcptnDongCd": null,
    "afwdPstmRcptnStdgCd": null,
    "afwdPstmRcptnUdgdYn": null,
    "bplcLctnBldgAddrDng": null,
    "bslcBascaddrNewComm": null,
    "bslcDetladdrNewComm": null,
    "cnstSteBplcRlvtYnVl": "2",
    "epiInsrncOfwkAgcyNo": null,
    "iaiInsrncOfwkAgcyNo": null,
    "insrncOfwkAgcyDclNm": null,
    "pstmRcptnBldgAddrHo": null,
    "pstmRcptnBscAddrRnm": null,
    "pstmRcptnZipLclsfCd": null,
    "pstmRcptnZipMclsfCd": null,
    "userBascaddrNewComm": null,
    "userDetladdrNewComm": null,
    "afwdPstmRcptnAddrBan": null,
    "afwdPstmRcptnAddrFlr": null,
    "afwdPstmRcptnAddrTng": null,
    "pstmRcptnBldgAddrDng": null,
    "pstmRcptnRnmAddrComm": null,
    "wkmvBfrBplcSbrdMngNo": null,
    "afwdPstmRcptnSpclAddr": null,
    "afwdPstmRcptnStdgLiCd": null,
    "pstmRcptnRnmDaddrComm": null,
    "afwdPstmRcptnMtnStSeCd": null,
    "insrncOfwkAgcyDclrYnVl": null,
    "afwdPstmRcptnBldgAddrHo": null,
    "afwdPstmRcptnZipLclsfCd": null,
    "afwdPstmRcptnZipMclsfCd": null,
    "afwdPstmRcptnBldgAddrDng": null
  },
  "comm_bplc_dclr_list": [
    {
      "dir": "ASC",
      "rsn": null,
      "brno": null,
      "crno": null,
      "rrno": "[REDACTED]",
      "sort": null,
      "work": null,
      "bpmno": "12345678901",
      "clsNm": null,
      "rnmCd": null,
      "rrkey": null,
      "agreYn": null,
      "bplcNm": null,
      "bplcSb": null,
      "cvrcNo": null,
      "fnstCd": null,
      "fnstNm": null,
      "liCdNm": null,
      "memCnt": null,
      "regYmd": null,
      "userNm": null,
      "userSn": "1",
      "admstCd": null,
      "bscAddr": null,
      "dpstrNm": null,
      "istlYmd": "2025-06-01",
      "lgaddcd": null,
      "rnmCdNm": null,
      "tpbizCd": null,
      "tpbizNm": null,
      "wrkrCnt": null,
      "aplcnYmd": null,
      "bizKndCd": null,
      "bplcFxno": null,
      "bplcSeCd": null,
      "bzstatNm": null,
      "dsmslYmd": null,
      "extshYmd": null,
      "instSeCd": null,
      "kornFlnm": "홍길동",
      "opbizYmd": null,
      "stdgCdNm": null,
      "totalCnt": null,
      "userAddr": null,
      "aplcnYmd1": null,
      "aplcnYmd2": null,
      "bizTypeCd": null,
      "bplcEpiYn": null,
      "bplcFxino": null,
      "bplcFxono": null,
      "bplcFxrno": null,
      "bplcIaiYn": null,
      "bplcNhiYn": "Y",
      "bplcNpsYn": null,
      "bplcSbEpi": null,
      "bplcSbIai": null,
      "bplcSbNhi": null,
      "bplcSbNps": null,
      "bplcTelno": null,
      "clsbizYmd": null,
      "epiBplcSb": null,
      "epiBrofCd": null,
      "eplCntrCd": null,
      "extshYmd1": null,
      "extshYmd2": null,
      "extshYmd3": null,
      "extshYmd4": null,
      "frstRegDt": null,
      "iaiBplcSb": null,
      "iaiBrofCd": null,
      "joinjnrps": null,
      "kcoBrofCd": null,
      "lastChgDt": null,
      "loginPart": null,
      "mainBpmno": null,
      "nhiBplcSb": null,
      "nhiBrofCd": null,
      "npsBplcSb": null,
      "npsBrofCd": null,
      "ntsSttsCd": null,
      "othagSeCd": null,
      "rprsvFlnm": null,
      "userDaddr": null,
      "userRrkey": "*******8901",
      "bfchgBpmno": null,
      "bizKndCdNm": null,
      "bplcFormCd": null,
      "bplcTelino": null,
      "bplcTelono": null,
      "bplcTelrno": null,
      "encptActno": null,
      "epiaBplcSb": null,
      "extshRsnCd": null,
      "frstRegDt1": null,
      "frstRegDt2": null,
      "lastChgDt1": null,
      "lastChgDt2": null,
      "mainBplcNm": null,
      "memEpiSeCd": null,
      "memNhiSeCd": null,
      "memNpsSeCd": null,
      "othagBpmno": null,
      "rmbrFnstCd": null,
      "rprsvDaddr": null,
      "rprsvRrkey": null,
      "rsnOcrnYmd": null,
      "tpbizCdEpi": null,
      "userAddrHo": null,
      "userAddrSt": null,
      "userTelino": "1234",
      "userTelono": "1234",
      "userTelrno": "123",
      "wrcRgnSeCd": null,
      "bplcEmlAddr": null,
      "bplcEstbYmd": null,
      "bplcJoinYmd": null,
      "bplcLborgCd": null,
      "bplcLctnFlr": null,
      "bplcRnmAddr": null,
      "bplcSttsCd1": null,
      "bplcSttsCd2": null,
      "bplcSttsCd3": null,
      "bplcSttsCd4": null,
      "etcDclrSeCd": null,
      "joinTrprCnt": null,
      "lastPrcsYmd": null,
      "mainPrdctNm": null,
      "nhiUpBplcSb": null,
      "ntsBplcSeCd": null,
      "othagMemCnt": null,
      "rmbrDpstrNm": null,
      "rprsvTelino": null,
      "rprsvTelono": null,
      "rprsvTelrno": null,
      "tcbizEndYmd": null,
      "unitBplcCnt": 0,
      "userAddrBan": null,
      "userAddrFlr": null,
      "userAddrTng": null,
      "userBscAddr": "서울특별시 중구 예시로 123",
      "userRnmAddr": null,
      "userSaddrHo": null,
      "userSaddrNm": null,
      "bplcEstbYmd1": null,
      "bplcEstbYmd2": null,
      "bplcLctnAddr": null,
      "bplcLctnBmno": null,
      "bplcLctnBsno": null,
      "bplcLctnOzip": null,
      "cmptncBrofCd": null,
      "cmptncBrofNm": null,
      "mrgeDclrSeCd": null,
      "rprsvBscAddr": null,
      "rprsvEmlAddr": null,
      "rprsvRnmAddr": null,
      "searchColumn": null,
      "tcbizBgngYmd": null,
      "userAddrBmno": null,
      "userAddrBsno": null,
      "userAddrOzip": "12345",
      "userRnmDaddr": null,
      "userSaddrDng": null,
      "bplcLctnDaddr": null,
      "bplcLctnRnmCd": null,
      "bplcLctnSggCd": null,
      "bplcMblTelcno": null,
      "bplcMblTelino": null,
      "bplcMblTelono": null,
      "bplcTypeCdEpi": null,
      "bplcTypeCdIai": null,
      "cnstBizEndYmd": null,
      "frstRegUserId": null,
      "idntyTrgtYnVl": null,
      "lastChgUserId": null,
      "pstmRcptnAddr": null,
      "pstmRcptnBmno": null,
      "pstmRcptnBsno": null,
      "pstmRcptnOzip": null,
      "rprsvAddrBmno": null,
      "rprsvAddrBsno": null,
      "rprsvRnmDaddr": null,
      "searchKeyword": null,
      "tcbizDclrSeCd": null,
      "userAddrRnmCd": null,
      "userAddrSggCd": null,
      "userMblTelcno": null,
      "userMblTelino": null,
      "userMblTelono": null,
      "bizEndDclrSeCd": null,
      "bplcLctnAddrHo": null,
      "bplcLctnAddrSt": null,
      "bplcLctnBlckNm": null,
      "bplcLctnCtpvCd": null,
      "bplcLctnDongCd": null,
      "bplcLctnStdgCd": null,
      "bplcLctnUdgdYn": null,
      "clsbizDclrSeCd": null,
      "cnstBizBgngYmd": null,
      "encptRmbrActno": null,
      "pstmRcptnDaddr": null,
      "pstmRcptnRnmCd": null,
      "pstmRcptnSggCd": null,
      "rprsvAddrRnmCd": null,
      "rprsvAddrSggCd": null,
      "rprsvMblTelcno": null,
      "rprsvMblTelino": null,
      "rprsvMblTelono": null,
      "unitBplcRmvYmd": null,
      "userAddrAddrSt": null,
      "userAddrBlckNm": null,
      "userAddrBldgHo": null,
      "userAddrCtpvCd": null,
      "userAddrDongCd": null,
      "userAddrStdgCd": null,
      "userAddrUdgdYn": null,
      "bplcLctnAddrBan": null,
      "bplcLctnAddrTng": null,
      "bplcLctnAdemdCd": null,
      "bplcLctnBscAddr": null,
      "bplcLctnFlrNoNm": null,
      "bplcLctnRnmAddr": null,
      "bplcLctnSaddrHo": null,
      "bplcLctnSaddrNm": null,
      "bplcLctnStemdCd": null,
      "pstmRcptnAddrHo": null,
      "pstmRcptnAddrSt": null,
      "pstmRcptnBlckNm": null,
      "pstmRcptnCtpvCd": null,
      "pstmRcptnDongCd": null,
      "pstmRcptnStdgCd": null,
      "pstmRcptnUdgdYn": null,
      "rprsvAddrCtpvCd": null,
      "rprsvAddrDongCd": null,
      "rprsvAddrStdgCd": null,
      "rprsvAddrUdgdYn": null,
      "userAddrAdemdCd": null,
      "userAddrBldgDng": null,
      "userAddrStemdCd": null,
      "bplcLctnDaddrRnm": null,
      "bplcLctnRnmDaddr": null,
      "bplcLctnSaddrDng": null,
      "bplcLctnStdgLiCd": null,
      "bplcLctnUdgdSeCd": null,
      "bslcBascaddrComm": null,
      "bslcDetladdrComm": null,
      "emlInfrmAplyYnVl": null,
      "pstmRcptnAddrBan": null,
      "pstmRcptnAddrFlr": null,
      "pstmRcptnAddrTng": null,
      "pstmRcptnAdemdCd": null,
      "pstmRcptnBscAddr": null,
      "pstmRcptnRnmAddr": null,
      "pstmRcptnSaddrHo": null,
      "pstmRcptnSaddrNm": null,
      "pstmRcptnStemdCd": null,
      "recvBascaddrComm": null,
      "recvDetladdrComm": null,
      "rprsvAddrFlrNoNm": null,
      "unitBplcAplcnYmd": null,
      "userAddrStdgLiCd": null,
      "userAddrUdgdSeCd": null,
      "userBascaddrComm": null,
      "userDetladdrComm": null,
      "afwdPstmRcptnAddr": null,
      "afwdPstmRcptnBmno": null,
      "afwdPstmRcptnBsno": null,
      "bplcLctnMtnStSeCd": null,
      "epiWhdwlExtshSeCd": null,
      "frstRegUserIpAddr": null,
      "iaiWhdwlExtshSeCd": null,
      "lastChgUserIpAddr": null,
      "nhiWhdwlExtshSeCd": null,
      "npsWhdwlExtshSeCd": null,
      "pstmRcptnDaddrRnm": null,
      "pstmRcptnRnmDaddr": null,
      "pstmRcptnSaddrDng": null,
      "pstmRcptnStdgLiCd": null,
      "pstmRcptnUdgdSeCd": null,
      "rcptDataMdfcnYnVl": null,
      "rprsvAddrLctnOzip": null,
      "rprsvAddrStdgCdNm": null,
      "rprsvAddrStdgLiCd": null,
      "userAddrMtnStSeCd": null,
      "afwdPstmRcptnRnmCd": null,
      "afwdPstmRcptnSggCd": null,
      "bplcLctnBldgAddrHo": null,
      "bplcLctnBscAddrRnm": null,
      "bslcPlcSpaddaddrHo": null,
      "pstmRcptnMtnStSeCd": null,
      "smsNtfctnMblTelcno": null,
      "smsNtfctnMblTelino": null,
      "smsNtfctnMblTelono": null,
      "userAddrZipLclsfCd": null,
      "userAddrZipMclsfCd": null,
      "wrkrCntElpDclrSeCd": null,
      "wrkrCntUndDclrSeCd": null,
      "afwdPstmRcptnAddrHo": null,
      "afwdPstmRcptnAddrSt": null,
      "afwdPstmRcptnBlckNm": null,
      "afwdPstmRcptnCtpvCd": null,
      "afwdPstmRcptnDongCd": null,
      "afwdPstmRcptnStdgCd": null,
      "afwdPstmRcptnUdgdYn": null,
      "bplcLctnBldgAddrDng": null,
      "bslcBascaddrNewComm": null,
      "bslcDetladdrNewComm": null,
      "cnstSteBplcRlvtYnVl": null,
      "epiInsrncOfwkAgcyNo": null,
      "iaiInsrncOfwkAgcyNo": null,
      "insrncOfwkAgcyDclNm": null,
      "pstmRcptnBldgAddrHo": null,
      "pstmRcptnBscAddrRnm": null,
      "pstmRcptnZipLclsfCd": null,
      "pstmRcptnZipMclsfCd": null,
      "userBascaddrNewComm": null,
      "userDetladdrNewComm": null,
      "afwdPstmRcptnAddrBan": null,
      "afwdPstmRcptnAddrFlr": null,
      "afwdPstmRcptnAddrTng": null,
      "pstmRcptnBldgAddrDng": null,
      "pstmRcptnRnmAddrComm": null,
      "wkmvBfrBplcSbrdMngNo": null,
      "afwdPstmRcptnSpclAddr": null,
      "afwdPstmRcptnStdgLiCd": null,
      "pstmRcptnRnmDaddrComm": null,
      "afwdPstmRcptnMtnStSeCd": null,
      "insrncOfwkAgcyDclrYnVl": null,
      "afwdPstmRcptnBldgAddrHo": null,
      "afwdPstmRcptnZipLclsfCd": null,
      "afwdPstmRcptnZipMclsfCd": null,
      "afwdPstmRcptnBldgAddrDng": null
    }
  ],
  "comm_bplc_dclr_epi_yn_bpmno": "",
  "comm_bplc_dclr_iai_yn_bpmno": ""
}
순번오류 코드발생 조건
AUTH_REQUIRED세션 없음 — 로그인 세션이 없습니다. 로그인을 먼저 호출합니다.
PROVIDER_AUTH_FAILED인증 만료 — 인증이 만료됐습니다. 로그인을 다시 호출합니다.
PROVIDER_UPSTREAM_ERROR업스트림 오류 — 기관 연결 실패, 응답 없음, 오류 응답, 읽을 수 없는 응답입니다. error.message 안내대로 잠시 후 다시 호출하거나 보낸 값과 연동 계정 권한을 확인합니다.