XBOSS

{'type': 'object', 'required': ['bizno', 'start_dt', 'p_nm', 'sDate', 'eDate'], 'properties': {'p_nm': {'type': 'string', 'description': 'Representative name for nts.validate'}, 'bizno': {'type': 'string', 'description': '10-digit business registration number (outer SSOT)'}, 'eDate': {'type': 'string', 'description': 'kiscon window end YYYYMMDD (sDate<=eDate)'}, 'sDate': {'type': 'string', 'description': 'kiscon window start YYYYMMDD'}, 'start_dt': {'type': 'string', 'description': 'Opening date YYYYMMDD for nts.validate'}, 'corp_name': {'type': 'string', 'description': 'Optional corp name fallback for kiscon matching'}, 'idempotency_key': {'type': 'string', 'description': 'Optional outer idempotency key; leg keys are derived deterministically from this value.'}}}

{'type': 'object', 'required': ['business_registration_no'], 'properties': {'auth_provider': {'type': 'string', 'description': 'Auth provider: npki_anysign (default: npki_anysign)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_registration_no': {'type': 'string', 'description': '10-digit business registration number (e.g. 1234567890)'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['insurance_year', 'worker_resident_no', 'worker_record_no', 'labor_provider_yn'], 'properties': {'insurance_year': {'type': 'string', 'description': 'Insurance year YYYY'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'insurance_month': {'type': 'string', 'description': 'Insurance month MM'}, 'worker_record_no': {'type': 'string', 'description': 'Worker record number returned by worker_select'}, 'labor_provider_yn': {'type': 'string', 'description': 'Labor provider flag Y/N (from worker_select)'}, 'worker_resident_no': {'type': 'string', 'description': 'Worker resident number returned by worker_select'}, 'refund_reflection_yn': {'type': 'string', 'description': 'Refund reflection flag Y/N'}, 'business_management_no': {'type': 'string', 'description': 'Business management number'}}}

{'type': 'object', 'required': ['insurance_year', 'worker_name', 'birth_ymd'], 'properties': {'birth_ymd': {'type': 'string', 'description': 'Worker birth date YYMMDD'}, 'worker_name': {'type': 'string', 'description': 'Worker name'}, 'insurance_year': {'type': 'string', 'description': 'Insurance year YYYY'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': 'Business management number (optional)'}}}

{'type': 'object', 'required': ['detail_keys', 'detail_context'], 'properties': {'detail_keys': {'type': 'array', 'items': {'type': 'object'}, 'minItems': 1, 'description': "Detail keys to fetch. Pass the objects from the search result's `detail_candidates` array as-is (filter by insurance_key when needed)."}, 'worker_name': {'type': 'string', 'description': 'Worker name filter (optional)'}, 'detail_context': {'type': 'object', 'description': "Search context. Pass the search result's `detail_context` object as-is."}, 'insurance_type': {'enum': ['industrial_accident', 'employment'], 'type': 'string', 'description': 'Insurance type filter. Required only when detail_keys mixes both types.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'worker_resident_no': {'type': 'string', 'description': 'Worker resident registration number filter (optional)'}}}

{'type': 'object', 'required': ['billing_year', 'billing_month'], 'properties': {'billing_year': {'type': 'string', 'description': 'Billing year YYYY'}, 'billing_month': {'type': 'string', 'description': 'Billing month MM'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': 'Business management number (optional; selects the workplace)'}}}

{'type': 'object', 'properties': {'auth_provider': {'type': 'string', 'description': 'Auth provider: manual_session | npki_anysign (default: npki_anysign)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['property_id'], 'properties': {'property_id': {'type': 'string', 'description': 'GA4 property, either "properties/123456" or the bare id "123456". Must be one the customer selected for this link.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['property_id', 'start_date', 'end_date', 'metrics'], 'properties': {'offset': {'type': 'integer', 'minimum': 0, 'description': 'Row offset for paging. Omit for the first page.'}, 'metrics': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'GA4 metric names, e.g. ["sessions", "totalUsers", "keyEvents"]. In each row, sessions is returned as metrics.sessions, totalUsers is returned as metrics.users, keyEvents is returned as metrics.conversions; other GA4 metrics are returned under channel_metrics.'}, 'end_date': {'type': 'string', 'description': 'End date, YYYY-MM-DD only. Inclusive.'}, 'row_limit': {'type': 'integer', 'minimum': 1, 'description': 'Max rows to return. Omit for the default.'}, 'dimensions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional breakdown, e.g. ["sessionDefaultChannelGroup"].'}, 'start_date': {'type': 'string', 'description': 'Start date, YYYY-MM-DD only. Inclusive.'}, 'property_id': {'type': 'string', 'description': 'GA4 property, either "properties/123456" or the bare id "123456". Must be one the customer selected for this link.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['property_id', 'site_url', 'start_date', 'end_date'], 'properties': {'metrics': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional GA4 metric names. When omitted the report uses ["sessions", "totalUsers", "keyEvents"], the metrics shared across channels. The result lists the metrics it used. In each row, sessions is returned as metrics.sessions, totalUsers is returned as metrics.users, keyEvents is returned as metrics.conversions; other GA4 metrics are returned under channel_metrics.'}, 'end_date': {'type': 'string', 'description': 'End date, YYYY-MM-DD only. Inclusive.'}, 'site_url': {'type': 'string', 'description': 'Search Console property exactly as Google lists it — "https://example.com/" and "sc-domain:example.com" are different properties and a trailing slash matters.'}, 'start_date': {'type': 'string', 'description': 'Start date, YYYY-MM-DD only. Inclusive.'}, 'property_id': {'type': 'string', 'description': 'GA4 property, either "properties/123456" or the bare id "123456". Must be one the customer selected for this link.'}}}

{'type': 'object', 'required': ['site_url', 'inspection_url'], 'properties': {'site_url': {'type': 'string', 'description': 'Search Console property exactly as Google lists it — "https://example.com/" and "sc-domain:example.com" are different properties and a trailing slash matters.'}, 'inspection_url': {'type': 'string', 'description': 'Full http or https URL of one page to inspect, e.g. "https://example.com/pricing". It must be inside site_url: under the prefix for a URL-prefix property, or on that domain or one of its subdomains for a sc-domain: property.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['site_url', 'start_date', 'end_date'], 'properties': {'end_date': {'type': 'string', 'description': 'End date, YYYY-MM-DD only. Inclusive.'}, 'site_url': {'type': 'string', 'description': 'Search Console property exactly as Google lists it — "https://example.com/" and "sc-domain:example.com" are different properties and a trailing slash matters.'}, 'row_limit': {'type': 'integer', 'maximum': 25000, 'minimum': 1, 'description': 'Max rows to return. Omit for the default.'}, 'start_row': {'type': 'integer', 'minimum': 0, 'description': 'Row offset for paging. Omit for the first page.'}, 'data_state': {'enum': ['final', 'all'], 'type': 'string', 'description': 'final (default) returns settled data only; all includes fresh, still-changing rows. The result says which it was.'}, 'dimensions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional breakdown, e.g. ["query", "page"].'}, 'start_date': {'type': 'string', 'description': 'Start date, YYYY-MM-DD only. Inclusive.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {'trs_dt': {'type': 'string', 'description': 'Transaction date YYYYMMDD (e.g. 20250731). Optional — defaults to today.'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['from_date', 'to_date'], 'properties': {'to_date': {'type': 'string', 'description': 'End date YYYYMMDD or YYYY-MM-DD (e.g. 20260131). Required.'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'from_date': {'type': 'string', 'description': 'Start date YYYYMMDD or YYYY-MM-DD (e.g. 20260101). Required.'}, 'max_pages': {'type': 'integer', 'description': 'Safety cap when fetch_all_pages is true (default 100)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'fetch_all_pages': {'type': 'boolean', 'description': 'true collects every page instead of one (default false). Each page is a separate NTS request, so it is slower.'}}}

{'type': 'object', 'required': ['from_date', 'to_date'], 'properties': {'to_date': {'type': 'string', 'description': 'End date YYYYMMDD or YYYY-MM-DD (e.g. 20260131). Required.'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'from_date': {'type': 'string', 'description': 'Start date YYYYMMDD or YYYY-MM-DD (e.g. 20260101). Required.'}, 'max_pages': {'type': 'integer', 'description': 'Safety cap when fetch_all_pages is true (default 100)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'fetch_all_pages': {'type': 'boolean', 'description': 'true collects every page instead of one (default false). Each page is a separate NTS request, so it is slower.'}}}

{'type': 'object', 'required': ['cmtt_yr'], 'properties': {'qrt': {'type': 'integer', 'description': 'Quarter 1-4. Optional — omit for full-year summary.'}, 'cmtt_yr': {'type': 'string', 'description': "Target year YYYY (e.g. '2025'). Required."}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'cert_template': {'enum': ['cert_gukse_wannap', 'cert_napse_sasil', 'cert_bugase_gwase_pyojun', 'cert_saeopja_deungrok_jeungmyeong', 'cert_hyupeop_sasil', 'cert_pyojun_jaemu_jepyo', 'cert_pyepeop_sasil', 'cert_saeopja_jaebalgup', 'cert_sodeuk_geumaeg_jeungmyeong'], 'type': 'string', 'description': 'Certificate template slug. One of: cert_gukse_wannap 국세완납증명 / cert_napse_sasil 납세사실증명 / cert_bugase_gwase_pyojun 부가가치세과세표준증명 / cert_saeopja_deungrok_jeungmyeong 사업자등록증명 / cert_hyupeop_sasil 휴업사실증명 / cert_pyojun_jaemu_jepyo 표준재무제표증명 / cert_pyepeop_sasil 폐업사실증명 / cert_saeopja_jaebalgup 사업자등록증 재발급 / cert_sodeuk_geumaeg_jeungmyeong 소득금액증명. Defaults to cert_gukse_wannap when omitted; any other value is refused before the NTS is contacted.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'use_company_tin': {'type': 'boolean', 'description': "true (default) uses the corporate TIN; false uses the representative's personal TIN."}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'bsno': {'type': 'string', 'description': '대상 사업자등록번호(숫자 10자리) (서식이 요구하는 값)'}, 'txyr': {'type': 'string', 'description': '과세년도(개인, YYYY) (구분에 따라 서식이 요구하는 값)'}, 'qrtTrt': {'type': 'string', 'description': '개인/법인 구분 코드(02 개인, 03 법인) (서식이 요구하는 값)'}, 'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'incClCd': {'type': 'string', 'description': '소득구분(개인) (구분에 따라 서식이 요구하는 값)'}, 'bsyrEndYm': {'type': 'string', 'description': '사업연도 종료연월(법인, YYYYMM) (구분에 따라 서식이 요구하는 값)'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'endMm': {'type': 'string', 'description': 'Receipt period end month MM (납세사실증명 전용)'}, 'strtMm': {'type': 'string', 'description': 'Receipt period start month MM (납세사실증명 전용)'}, 'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'cerEndYr': {'type': 'string', 'description': 'Receipt period end year YYYY (납세사실증명 전용)'}, 'cerStrtYr': {'type': 'string', 'description': 'Receipt period start year YYYY (납세사실증명 전용)'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'properties': {'adrOpYn': {'type': 'string', 'description': "Show address on the certificate: 'Y' or 'N'"}, 'amtOpYn': {'type': 'string', 'description': "Show amount: 'Y' or 'N'"}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'resnoOpYn': {'type': 'string', 'description': "Show resident number: 'Y' or 'N' (forced 'N' for corporations)"}, 'cerpIsnRqsQty': {'type': 'string', 'description': 'Number of copies to issue (발급 매수)'}, 'cert_template': {'enum': ['cert_gukse_wannap', 'cert_napse_sasil', 'cert_bugase_gwase_pyojun', 'cert_saeopja_deungrok_jeungmyeong', 'cert_hyupeop_sasil', 'cert_pyojun_jaemu_jepyo', 'cert_pyepeop_sasil', 'cert_saeopja_jaebalgup', 'cert_sodeuk_geumaeg_jeungmyeong'], 'type': 'string', 'description': 'Certificate template slug. One of: cert_gukse_wannap 국세완납증명 / cert_napse_sasil 납세사실증명 / cert_bugase_gwase_pyojun 부가가치세과세표준증명 / cert_saeopja_deungrok_jeungmyeong 사업자등록증명 / cert_hyupeop_sasil 휴업사실증명 / cert_pyojun_jaemu_jepyo 표준재무제표증명 / cert_pyepeop_sasil 폐업사실증명 / cert_saeopja_jaebalgup 사업자등록증 재발급 / cert_sodeuk_geumaeg_jeungmyeong 소득금액증명. Defaults to cert_gukse_wannap when omitted; any other value is refused before the NTS is contacted.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'cvaDcumGranMthdCd': {'type': 'string', 'description': 'Delivery method code (교부방법 코드)'}, 'cvaDcumSbmsOrgnClCd': {'type': 'string', 'description': 'Submission target code (제출처 구분코드)'}}}

{'type': 'object', 'required': ['cva_id', 'rcat_no'], 'properties': {'cva_id': {'type': 'string', 'description': 'Certificate ID (증명서 ID, cvaId)'}, 'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview. Printing consumes one issued copy and cannot be undone.'}, 'rcat_no': {'type': 'string', 'description': 'Receipt number (접수번호, rcatNo)'}, 'rpt_pkg_pth': {'type': 'string', 'description': 'Report package path (rptPkgPth). Optional — looked up from the certificate list when omitted.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'end_dt': {'type': 'string', 'description': 'Application end date YYYYMMDD or YYYY-MM-DD. Optional; omitting it means today. Send together with strt_dt.'}, 'strt_dt': {'type': 'string', 'description': 'Application start date YYYYMMDD or YYYY-MM-DD. Optional; omitting it means 3 days ago. Send together with end_dt. No earlier than end_dt minus one month.'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['dmnr_bsno', 'item_name', 'supply_date', 'bill_method', 'item_quantity', 'item_unit_price'], 'properties': {'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'splr_tin': {'type': 'string', 'description': 'Supplier TIN. Optional.'}, 'dmnr_bsno': {'type': 'string', 'description': 'Buyer business registration number (구매자 사업자등록번호, 10 digits)'}, 'item_name': {'type': 'string', 'description': 'Item/service name (품목명)'}, 'bill_method': {'type': 'string', 'description': "Billing method (청구방법): '01'=영수, '02'=청구"}, 'splr_mpb_no': {'type': 'string', 'description': '공급자 종사업장번호. 주사업장이면 "0". Optional (기본 "0").'}, 'supply_date': {'type': 'string', 'description': 'Supply date YYYYMMDD (공급일자)'}, 'etxiv_knd_cd': {'type': 'string', 'description': 'Invoice kind code (세금계산서 유형 코드). Optional.'}, 'etxiv_clsf_cd': {'type': 'string', 'description': 'Invoice class code (세금계산서 종류 코드). Optional.'}, 'item_quantity': {'type': 'integer', 'description': 'Item quantity (수량)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'item_unit_price': {'type': 'integer', 'description': 'Unit price (단가, KRW)'}}}

{'type': 'object', 'required': ['supply_date', 'old_aprv_no', 'etxiv_mdf_rsn_cd'], 'properties': {'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval.'}, 'old_aprv_no': {'type': 'string', 'description': 'Approval number of the original invoice (원본 승인번호, 24 digits; hyphens allowed). Get it from hometax__etax__invoice__search_list.'}, 'supply_date': {'type': 'string', 'description': 'YYYYMMDD. 수정세금계산서 작성일(사유 04 은 이 날짜로 발행) - 그 밖의 사유는 원본 작성일로 발행하고, 이 값은 원본에 발행일이 없을 때 환율조회 기준일로만 쓴다'}, 'etxiv_knd_cd': {'type': 'string', 'description': "Invoice kind code (기본 '01'). Optional."}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'etxiv_mdf_rsn_cd': {'enum': ['04', '06'], 'type': 'string', 'description': '수정사유코드 - 사용자에게 물어서 받는다. 04 계약의 해제(당초분 전액 음수 1장(계약 해제일)) - 계약 전부가 해제됐을 때만 씁니다(일부 해지는 공급가액 변동). 계약 해제일이 속한 달의 다음 달 10일까지 발급해야 하며, 넘기면 지연발급 가산세 대상입니다. / 06 착오에 의한 이중발급(당초분 전액 음수 1장(당초 작성일)). This is recorded at 국세청 and cannot be undone.'}, 'etxiv_dmnr_clsf_cd': {'type': 'string', 'description': "Buyer class code (기본 '01'). Optional."}}}

{'type': 'object', 'required': ['etan'], 'properties': {'etan': {'type': 'string', 'description': 'Invoice approval number (승인번호, 24 chars). Obtain from hometax__etax__invoice__search_list results.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['from_date', 'to_date'], 'properties': {'to_date': {'type': 'string', 'description': 'End date YYYYMMDD or YYYY-MM-DD (e.g. 20260131)'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'from_date': {'type': 'string', 'description': 'Start date YYYYMMDD or YYYY-MM-DD (e.g. 20260101)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'prh_sls_cl_cd': {'enum': ['01', '02'], 'type': 'string', 'description': "Invoice direction: '01'=issued(매출), '02'=received(매입). Default '01'."}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['wrt_ym_strt', 'wrt_ym_end'], 'properties': {'dt_cl': {'enum': ['01', '02'], 'type': 'string', 'description': "'01'=issued(작성일), '02'=received(전송일). Default '01'."}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'wrt_ym_end': {'type': 'string', 'description': 'End month YYYYMM (e.g. 202509 for September 2025). NOT a full date.'}, 'wrt_ym_strt': {'type': 'string', 'description': 'Start month YYYYMM (e.g. 202507 for July 2025). NOT a full date.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'year': {'type': 'integer', 'description': "Year (e.g. 2025). Required when date_type='02' (monthly) or '03' (quarterly)."}, 'month': {'type': 'integer', 'description': "Month 1-12. Required when date_type='02' (monthly)."}, 'quarter': {'type': 'integer', 'description': "Quarter 1-4. Required when date_type='03' (quarterly)."}, 'end_date': {'type': 'string', 'description': "End date YYYYMMDD (e.g. 20250930). Required when date_type='01' (daily)."}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'date_type': {'enum': ['01', '02', '03'], 'type': 'string', 'description': "Date mode: '01'=daily(default, needs start_date/end_date), '02'=monthly(needs year+month), '03'=quarterly(needs year+quarter)."}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'start_date': {'type': 'string', 'description': "Start date YYYYMMDD (e.g. 20250701). Required when date_type='01' (daily)."}, 'search_type': {'enum': ['01', '02'], 'type': 'string', 'description': "'01'=issued(매출, default), '02'=received(매입)."}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['txpr_dscm_no'], 'properties': {'txpr_dscm_no': {'type': 'string', 'description': "Business registration number 사업자등록번호 (10 digits, hyphens stripped automatically, e.g. '1234567890' or '123-45-67890')."}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['bsno', 'stl_yr', 'qrt_from', 'qrt_to'], 'properties': {'bsno': {'type': 'string', 'description': 'Business registration number'}, 'qrt_to': {'type': 'string', 'description': "End quarter '1'~'4'"}, 'stl_yr': {'type': 'string', 'description': "Settlement year YYYY (e.g. '2026')"}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'qrt_from': {'type': 'string', 'description': "Start quarter '1'~'4'"}, 'page_size': {'type': 'integer', 'description': 'Page size (default 50)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['strt_dt', 'end_dt'], 'properties': {'end_dt': {'type': 'string', 'description': 'End date YYYYMMDD'}, 'strt_dt': {'type': 'string', 'description': 'Start date YYYYMMDD'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 3)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'end_dt': {'type': 'string', 'description': 'End date YYYYMMDD or YYYY-MM-DD (optional)'}, 'strt_dt': {'type': 'string', 'description': 'Start date YYYYMMDD or YYYY-MM-DD (optional)'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'surv_ttl': {'type': 'string', 'description': 'Survey title filter (조회 제목). Optional.'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 3)'}, 'ntpl_crp_cl_cd': {'type': 'string', 'description': 'Taxpayer classification code (납세자 구분). Optional.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'inqr_cl_cd': {'type': 'string', 'description': "Lookup mode (조회구분코드). Optional. '01' shows only items whose payment deadline has passed."}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['mate_knd_cd', 'sbms_ym_strt', 'sbms_ym_end'], 'properties': {'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'mate_knd_cd': {'enum': ['A0051', 'A0053', 'A0056', 'A0057', 'A0086', 'A0085', 'A0088', 'A0087', 'A0084', 'A0283', 'A0055', 'A0259', 'A0257'], 'type': 'string', 'description': 'Document type code (자료종류코드) — one of: A0051 근로소득 지급명세서 / A0053 퇴직소득 지급명세서 / A0056 의료비 명세서 / A0057 기부금 명세서 / A0086 사업소득 지급명세서 / A0085 사업소득(연말정산용) 지급명세서 / A0088 기타소득 지급명세서 / A0087 종교인소득(연말정산용) 지급명세서 / A0084 이자·배당소득 지급명세서 / A0283 연금계좌 지급명세서 / A0055 비거주자 사업·기타소득 지급명세서 / A0259 부동산등 양도소득 지급명세서 / A0257 유가증권 양도소득 지급명세서. Any other value is refused before the NTS is contacted.'}, 'sbms_ym_end': {'type': 'string', 'description': 'Submission end year-month YYYYMM'}, 'sbms_ym_strt': {'type': 'string', 'description': 'Submission start year-month YYYYMM'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['sbms_ym_strt', 'sbms_ym_end'], 'properties': {'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'mate_knd_cd': {'type': 'string', 'description': 'Document type code'}, 'sbms_ym_end': {'type': 'string', 'description': 'Submission end year-month YYYYMM'}, 'txtn_ym_end': {'type': 'string', 'description': 'Taxation end year-month YYYYMM'}, 'sbms_ym_strt': {'type': 'string', 'description': 'Submission start year-month YYYYMM'}, 'txpr_dscm_no': {'type': 'string', 'description': 'Taxpayer number (hyphens allowed)'}, 'txtn_ym_strt': {'type': 'string', 'description': 'Taxation start year-month YYYYMM'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['strt_dt', 'end_dt'], 'properties': {'end_dt': {'type': 'string', 'description': 'End date YYYYMMDD'}, 'strt_dt': {'type': 'string', 'description': 'Start date YYYYMMDD'}, 'txaa_id': {'type': 'string', 'description': 'Tax accountant ID'}, 'txaa_yn': {'type': 'string', 'description': 'Tax accountant flag Y/N'}, 'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'inqr_cl_cd': {'type': 'string', 'description': 'Inquiry classification code'}, 'txpr_dscm_no': {'type': 'string', 'description': 'Taxpayer number (hyphens allowed)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['rtn_dt_srt', 'rtn_dt_end'], 'properties': {'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'rtn_dt_end': {'type': 'string', 'description': 'Return date range end YYYYMMDD'}, 'rtn_dt_srt': {'type': 'string', 'description': 'Return date range start YYYYMMDD'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'page_num': {'type': 'integer', 'description': 'Page number (default 1)'}, 'page_size': {'type': 'integer', 'description': 'Page size (default 10)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['txpr_dscm_no', 'txpr_nm'], 'properties': {'nnf_cl': {'type': 'string', 'description': "내외국인구분: 'n'=내국인(default), '1'=외국인. Optional."}, 'txpr_nm': {'type': 'string', 'description': '납세자명 (성명 또는 상호). Required.'}, 'txpr_dscm_no': {'type': 'string', 'description': '납세자식별번호 (사업자등록번호 또는 주민등록번호, 하이픈 없이 숫자만). Required.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['bank_account_credential_id'], 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'bank_account_credential_id': {'type': 'string', 'format': 'uuid', 'description': "bank_account_credential_id of one registered account - take it from this bank's accounts list tool"}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['search_context', 'page'], 'properties': {'page': {'type': 'integer', 'description': 'Page number to fetch'}, 'search_context': {'type': 'object', 'description': 'Search context returned by init/search'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to collect'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'page': {'type': 'integer', 'description': 'Page number; default 1'}, 'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to collect'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name filter'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number from departments.select'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name filter'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['search_context', 'page'], 'properties': {'page': {'type': 'integer', 'description': 'Page number to fetch'}, 'search_context': {'type': 'object', 'description': 'Search context returned by init/search'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to collect'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'page': {'type': 'integer', 'description': 'Page number; default 1'}, 'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to collect'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['search_context', 'page'], 'properties': {'page': {'type': 'integer', 'description': 'Page number to fetch'}, 'search_context': {'type': 'object', 'description': 'Search context returned by init/search'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to collect'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number'}}}

{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'page': {'type': 'integer', 'description': 'Page number; default 1'}, 'date_to': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'date_from': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to collect'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'department_name': {'type': 'string', 'description': 'Department name'}, 'department_sequence_no': {'type': 'string', 'description': 'Department sequence number'}}}

{'type': 'object', 'properties': {'auth_provider': {'type': 'string', 'description': 'Authentication provider; default npki_delfino'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['bank_account_credential_id', 'start_date', 'end_date'], 'properties': {'end_date': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'sort_order': {'enum': ['desc', 'asc'], 'type': 'string', 'default': 'desc', 'description': 'Transaction time sort order'}, 'start_date': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'transaction_type': {'enum': ['all', 'deposit', 'withdrawal'], 'type': 'string', 'default': 'all', 'description': 'Transaction direction filter'}, 'bank_account_credential_id': {'type': 'string', 'format': 'uuid', 'description': "bank_account_credential_id of one registered account - take it from this bank's accounts list tool"}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'description': 'Page number (default: 1)'}}}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'description': 'Page number (default: 1)'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['business_management_no'], 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit business management number (e.g. 12345678901)'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'confirm': {'type': 'boolean', 'description': 'Set true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.'}, 'row_key': {'type': 'string', 'description': 'options[].row_key from the subscribers list tool'}, 'language': {'enum': ['ko', 'en'], 'type': 'string', 'description': 'Certificate language. Default ko.'}, 'row_index': {'type': 'integer', 'description': 'options[].row_index from the subscribers list tool'}, 'member_name': {'type': 'string', 'description': 'Subscriber name. If several share it, pass row_index or row_key instead.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {'page_no': {'type': 'integer', 'description': 'Page number (default: 1)'}, 'search_text': {'type': 'string', 'description': 'Subscriber name to search (srchData). Omit for the whole list.'}, 'page_per_count': {'type': 'integer', 'description': 'Items per page (default: 10)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['bizno'], 'properties': {'bizno': {'type': 'string', 'maxLength': 10, 'minLength': 10, 'description': '사업자등록번호 10자리. 로컬 색인의 brno 와 대조한다.'}}}

{'type': 'object', 'required': ['bizno'], 'properties': {'bizno': {'type': 'string', 'maxLength': 10, 'minLength': 10, 'description': '사업자등록번호 10자리(예: "1234567890"). 하이픈은 서버가 지운다.'}, 'pageNo': {'type': 'integer', 'minimum': 1, 'description': '페이지 번호(기본 1).'}, 'numOfRows': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': '페이지당 행 수(기본 100, 최대 100).'}, 'inqryBgnDt': {'type': 'string', 'description': '조회 시작 일시 YYYYMMDDHHMM(선택).'}, 'inqryEndDt': {'type': 'string', 'description': '조회 종료 일시 YYYYMMDDHHMM(선택).'}}}

{'type': 'object', 'required': ['bizno', 'sDate', 'eDate'], 'properties': {'bizno': {'type': 'string', 'maxLength': 10, 'minLength': 10, 'description': '사업자등록번호 10자리. 조회 기간을 훑은 뒤 응답의 ncrMasterNum 과 대조한다.'}, 'eDate': {'type': 'string', 'description': '공시 기간 종료일 YYYYMMDD(기관 필수).'}, 'sDate': {'type': 'string', 'description': '공시 기간 시작일 YYYYMMDD(기관 필수).'}, 'maxPages': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': '훑을 최대 페이지 수(기본 5, 상한 20).'}, 'corp_name': {'type': 'string', 'description': '업체명(선택) - 원본 행의 등록번호(ncrMasterNum)가 비어 있을 때 이름으로 대조한다(M2/M3 방식).'}, 'numOfRows': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': '기관 페이지당 행 수(기본 100, 최대 100).'}, 'ncrAreaName': {'type': 'string', 'description': '등록 시도 필터(선택).'}, 'ncrAreaDetailName': {'type': 'string', 'description': '등록 시군구 필터(선택).'}}}

{'type': 'object', 'required': ['b_no'], 'properties': {'b_no': {'type': 'array', 'items': {'type': 'string', 'maxLength': 10, 'minLength': 10}, 'maxItems': 100, 'minItems': 1, 'description': '사업자등록번호 목록 - 각 10자리 숫자(예: ["1234567890"]). 최대 100건.'}}}

{'type': 'object', 'required': ['businesses'], 'properties': {'businesses': {'type': 'array', 'items': {'type': 'object', 'required': ['b_no', 'start_dt', 'p_nm'], 'properties': {'b_nm': {'type': 'string', 'description': '상호(선택).'}, 'b_no': {'type': 'string', 'maxLength': 10, 'minLength': 10, 'description': '사업자등록번호(10자리 숫자).'}, 'p_nm': {'type': 'string', 'description': '대표자 성명(필수).'}, 'p_nm2': {'type': 'string', 'description': '대표자 성명 2(선택).'}, 'b_type': {'type': 'string', 'description': '종목(선택).'}, 'corp_no': {'type': 'string', 'description': '법인등록번호(선택).'}, 'b_sector': {'type': 'string', 'description': '업태(선택).'}, 'start_dt': {'type': 'string', 'description': '개업일자 YYYYMMDD.'}}}, 'maxItems': 100, 'minItems': 1, 'description': '진위 확인 대상 사업자 목록. 항목마다 b_no, start_dt(YYYYMMDD), p_nm 이 필수.'}}}

{'type': 'object', 'required': ['attribution_ym', 'payment_date', 'employees', 'workplace_name', 'business_registration_no', 'workplace_address'], 'properties': {'employees': {'type': 'array', 'items': {'type': 'object', 'required': ['employee_key', 'employee_name', 'birth_date', 'monthly_pay_won', 'dependent_count', 'national_pension_won', 'health_insurance_won', 'long_term_care_won', 'employment_insurance_won', 'income_tax_won', 'local_income_tax_won', 'total_deduction_won', 'net_pay_won'], 'properties': {'birth_date': {'type': 'string', 'description': 'YYYY-MM-DD or YYYYMMDD'}, 'net_pay_won': {'type': 'integer'}, 'employee_key': {'type': 'string', 'description': 'Stable employee id within the request'}, 'employee_name': {'type': 'string'}, 'gross_pay_won': {'type': 'integer'}, 'income_tax_won': {'type': 'integer'}, 'base_salary_won': {'type': 'integer'}, 'dependent_count': {'type': 'integer', 'minimum': 1, 'description': 'ADR-069 D-4: >=1 includes self; never invent'}, 'monthly_pay_won': {'type': 'integer', 'description': 'Canonical monthly pay / gross (ADR-069). Wins over monthly_salary_won when both are set.'}, 'basic_salary_won': {'type': 'integer'}, 'long_term_care_won': {'type': 'integer'}, 'monthly_salary_won': {'type': 'integer', 'description': 'Alias for monthly_pay_won when pay is absent'}, 'total_deduction_won': {'type': 'integer'}, 'health_insurance_won': {'type': 'integer'}, 'local_income_tax_won': {'type': 'integer'}, 'national_pension_won': {'type': 'integer'}, 'children_count_8_to_20': {'type': 'integer', 'minimum': 0, 'description': 'ADR-069 D-4: >=0; omit → 0 when monthly pay + dependent_count present'}, 'employment_insurance_won': {'type': 'integer'}}}, 'minItems': 1, 'description': 'Employee rows for payslip sheets (amounts already computed).'}, 'company_name': {'type': 'string', 'description': 'Alias for workplace_name (runtime accepts either).'}, 'payment_date': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$', 'description': 'Payment date YYYY-MM-DD.'}, 'attribution_ym': {'type': 'string', 'pattern': '^[0-9]{6}$', 'maxLength': 6, 'minLength': 6, 'description': 'Payroll attribution month as YYYYMM (e.g. 202603).'}, 'workplace_name': {'type': 'string', 'description': 'Workplace / company display name (required for payslip).'}, 'workplace_address': {'type': 'string'}, 'business_registration_no': {'type': 'string'}}}

{'type': 'object', 'required': ['attribution_ym', 'employees'], 'properties': {'employees': {'type': 'array', 'items': {'type': 'object', 'required': ['employee_key', 'employee_name', 'birth_date', 'monthly_pay_won', 'dependent_count', 'national_pension_won', 'health_insurance_won', 'long_term_care_won', 'employment_insurance_won', 'income_tax_won', 'local_income_tax_won', 'total_deduction_won', 'net_pay_won'], 'properties': {'birth_date': {'type': 'string', 'description': 'YYYY-MM-DD or YYYYMMDD'}, 'net_pay_won': {'type': 'integer'}, 'employee_key': {'type': 'string', 'description': 'Stable employee id within the request'}, 'employee_name': {'type': 'string'}, 'gross_pay_won': {'type': 'integer'}, 'income_tax_won': {'type': 'integer'}, 'base_salary_won': {'type': 'integer'}, 'dependent_count': {'type': 'integer', 'minimum': 1, 'description': 'ADR-069 D-4: >=1 includes self; never invent'}, 'monthly_pay_won': {'type': 'integer', 'description': 'Canonical monthly pay / gross (ADR-069). Wins over monthly_salary_won when both are set.'}, 'basic_salary_won': {'type': 'integer'}, 'long_term_care_won': {'type': 'integer'}, 'monthly_salary_won': {'type': 'integer', 'description': 'Alias for monthly_pay_won when pay is absent'}, 'total_deduction_won': {'type': 'integer'}, 'health_insurance_won': {'type': 'integer'}, 'local_income_tax_won': {'type': 'integer'}, 'national_pension_won': {'type': 'integer'}, 'children_count_8_to_20': {'type': 'integer', 'minimum': 0, 'description': 'ADR-069 D-4: >=0; omit → 0 when monthly pay + dependent_count present'}, 'employment_insurance_won': {'type': 'integer'}}}, 'minItems': 1, 'description': 'Employee rows with name, birth_date, dependent counts, pay/allowance/deduction/tax/net amounts in won.'}, 'company_name': {'type': 'string', 'description': 'Alias for workplace_name'}, 'attribution_ym': {'type': 'string', 'pattern': '^[0-9]{6}$', 'maxLength': 6, 'minLength': 6, 'description': 'Payroll attribution month as YYYYMM (e.g. 202603).'}, 'workplace_name': {'type': 'string'}, 'workplace_address': {'type': 'string'}, 'business_registration_no': {'type': 'string'}}}

{'type': 'object', 'required': ['billing_year', 'billing_month'], 'properties': {'billing_year': {'type': 'string', 'description': 'Billing year in YYYY format'}, 'billing_month': {'oneOf': [{'type': 'string'}, {'type': 'integer', 'maximum': 12, 'minimum': 1}], 'description': 'Billing month 1-12 (string or integer)'}, 'idempotency_key': {'type': 'string', 'description': 'Optional outer idempotency key; leg keys are derived deterministically from this value.'}, 'business_management_no': {'type': 'string', 'description': 'Optional COMWEL business management number; defaults to the logged-in workplace'}}}

{'type': 'object', 'required': ['notice_year_month', 'installment_round', 'billing_year', 'billing_month'], 'properties': {'goji_round': {'type': 'integer', 'description': 'Optional NHIS notice round'}, 'nps_row_key': {'type': 'string', 'description': 'Optional NPS row key from pension notice search, used only to disambiguate multiple exact matches'}, 'billing_year': {'type': 'string', 'description': 'COMWEL billing year in YYYY format'}, 'nhis_row_key': {'type': 'string', 'description': 'Optional NHIS row key from premium notice search, used only to disambiguate multiple exact matches'}, 'billing_month': {'oneOf': [{'type': 'string'}, {'type': 'integer', 'maximum': 12, 'minimum': 1}], 'description': 'COMWEL billing month 1-12 (string or integer)'}, 'idempotency_key': {'type': 'string', 'description': 'Optional outer idempotency key; leg keys are derived deterministically from this value.'}, 'nhis_document_id': {'enum': ['BMBB_030', 'BMBB_050'], 'type': 'string', 'default': 'BMBB_030', 'description': 'NHIS summary document: BMBB_030=regular, BMBB_050=adjusted'}, 'installment_round': {'enum': [1, 2], 'type': 'integer', 'description': 'NPS installment round: 1=ED02, 2=ED08'}, 'notice_year_month': {'type': 'string', 'description': 'Target notice year-month in YYYYMM format'}, 'business_management_no': {'type': 'string', 'description': 'Optional COMWEL business management number; defaults to the logged-in workplace'}}}

{'type': 'object', 'required': ['notice_year_month', 'installment_round'], 'properties': {'goji_round': {'type': 'integer', 'description': 'Optional NHIS notice round'}, 'nps_row_key': {'type': 'string', 'description': 'Optional NPS row key from pension notice search, used only to disambiguate multiple exact matches'}, 'nhis_row_key': {'type': 'string', 'description': 'Optional NHIS row key from premium notice search, used only to disambiguate multiple exact matches'}, 'idempotency_key': {'type': 'string', 'description': 'Optional outer idempotency key; leg keys are derived deterministically from this value.'}, 'nhis_document_id': {'enum': ['BMBB_030', 'BMBB_050'], 'type': 'string', 'default': 'BMBB_030', 'description': 'NHIS summary document: BMBB_030=regular, BMBB_050=adjusted'}, 'installment_round': {'enum': [1, 2], 'type': 'integer', 'description': 'NPS installment round: 1=ED02, 2=ED08'}, 'notice_year_month': {'type': 'string', 'description': 'Target notice year-month in YYYYMM format'}}}

{'type': 'object', 'properties': {'include_raw': {'type': 'boolean', 'description': 'Include raw provider response fields'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['bank_account_credential_id', 'start_date', 'end_date'], 'properties': {'end_date': {'type': 'string', 'description': 'End date YYYY-MM-DD or YYYYMMDD'}, 'max_pages': {'type': 'integer', 'description': 'Maximum pages to fetch; default 20, max 100'}, 'sort_order': {'enum': ['desc', 'asc'], 'type': 'string', 'description': 'Order of the returned transactions by date; desc is newest first (default), asc is oldest first.'}, 'start_date': {'type': 'string', 'description': 'Start date YYYY-MM-DD or YYYYMMDD'}, 'employee_yn': {'type': 'string', 'description': 'Provider employee flag; default 2'}, 'include_raw': {'type': 'boolean', 'description': 'Include raw provider response fields'}, 'business_type': {'type': 'string', 'description': 'Provider business type; default 2'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'bank_account_credential_id': {'type': 'string', 'description': 'Opaque bank-account credential selected by the user'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['business_registration_no'], 'properties': {'isoa_no': {'type': 'string', 'description': '사무대행기관 번호. Required only when member_type_code=BE902.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'member_type_code': {'type': 'string', 'description': '회원유형: BE904 일반사업자 (default) or BE902 사무대행기관'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. Required for 장려금 신청 screens.'}, 'business_registration_no': {'type': 'string', 'description': '10-digit business registration number (e.g. 1234567890)'}}}

{'type': 'object', 'properties': {'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no', 'confirm'], 'properties': {'confirm': {'type': 'boolean', 'description': '되돌릴 수 없는 처리에 대한 명시 확인. true 가 아니면 거부된다.'}, 'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no'], 'properties': {'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key'], 'properties': {'date_to': {'type': 'string', 'description': '조회 종료일 YYYYMMDD. 비우면 오늘.'}, 'date_from': {'type': 'string', 'description': '조회 시작일 YYYYMMDD. 비우면 date_to 기준 30일 전(화면 기본값과 동일).'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key'], 'properties': {'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no', 'confirm', 'admin_info_sharing_consent'], 'properties': {'confirm': {'type': 'boolean', 'description': '되돌릴 수 없는 처리에 대한 명시 확인. true 가 아니면 거부된다.'}, 'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}, 'admin_info_sharing_consent': {'type': 'boolean', 'description': '행정정보 공동이용 동의 여부. 고용24 제출 화면의 필수 항목이며 동의 여부는 고객이 직접 정해야 한다. 미지정이면 제출이 거부된다.'}}}

{'type': 'object', 'required': ['programme_key'], 'properties': {'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no', 'confirm', 'admin_info_sharing_consent'], 'properties': {'confirm': {'type': 'boolean', 'description': '되돌릴 수 없는 처리에 대한 명시 확인. true 가 아니면 거부된다.'}, 'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}, 'admin_info_sharing_consent': {'type': 'boolean', 'description': '행정정보 공동이용 동의 여부. 고용24 제출 화면의 필수 항목이며 동의 여부는 고객이 직접 정해야 한다. 미지정이면 제출이 거부된다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no'], 'properties': {'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no', 'target_irnos', 'worker_type', 'labor_contract'], 'properties': {'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'worker_type': {'enum': ['P2', 'P3', 'P', 'S', 'W', 'R'], 'type': 'string', 'description': '근로자유형. 고용24 화면 필수 선택 항목이며 기관이 채워 주지 않는다. 라벨은 target_search 응답의 selection_options 에 있다.'}, 'target_irnos': {'type': 'array', 'items': {'type': 'string'}, 'description': 'target_search 결과의 irno 배열. 주민번호는 필요하지 않다 — 기관이 이미 아는 값을 다시 받지 않는다.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'labor_contract': {'enum': ['ACV00', 'ACV01', 'ACV02', 'ACV03'], 'type': 'string', 'description': '근로계약유형. 고용24 화면 필수 선택 항목.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no'], 'properties': {'page': {'type': 'integer', 'description': '1-based 페이지 (기본 1)'}, 'query': {'type': 'string', 'description': '대상자 성명 부분검색. 비우면 피보험자 전체.'}, 'page_size': {'type': 'integer', 'description': '페이지 크기 (기본 10)'}, 'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key', 'receipt_no', 'confirm'], 'properties': {'confirm': {'type': 'boolean', 'description': '되돌릴 수 없는 처리에 대한 명시 확인. true 가 아니면 거부된다.'}, 'receipt_no': {'type': 'string', 'description': '민원신청접수번호 (cvplRqutRcno). workplace_save 가 발급한 값.'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}}}

{'type': 'object', 'required': ['programme_key'], 'properties': {'manager_name': {'type': 'string', 'description': '담당자명'}, 'applicant_zip': {'type': 'string', 'description': '사업장 우편번호 (5자리)'}, 'manager_email': {'type': 'string', 'description': '담당자 이메일 (예: manager@example.com)'}, 'programme_key': {'type': 'string', 'description': '카탈로그 사업 키 (예: w24_b0010 고용촉진장려금). subsidy_pack 진단 결과의 programme_key 를 그대로 넣는다.'}, 'manager_phone1': {'type': 'string', 'description': '담당자 유선전화 국번 앞자리 (예: 02)'}, 'manager_phone2': {'type': 'string', 'description': '담당자 유선전화 나머지 (예: 6380-5554)'}, 'account_link_id': {'type': 'string', 'description': 'Account link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).'}, 'manager_mobile1': {'type': 'string', 'description': '담당자 휴대전화 앞자리 (예: 010)'}, 'manager_mobile2': {'type': 'string', 'description': '담당자 휴대전화 나머지'}, 'application_year': {'type': 'integer', 'description': '신청 시작 연도'}, 'payment_bank_name': {'type': 'string', 'description': '지원금 입금 은행명'}, 'payment_account_no': {'type': 'string', 'description': '지원금 입금 계좌번호'}, 'application_quarter': {'type': 'integer', 'description': '신청 시작 분기/월 구분값'}, 'applicant_base_address': {'type': 'string', 'description': '사업장 기본주소'}, 'business_management_no': {'type': 'string', 'description': '11-digit 고용보험 사업장관리번호. 비우면 로그인 시 저장된 값을 쓴다.'}, 'payment_account_holder': {'type': 'string', 'description': '예금주명 (사업장명과 일치해야 한다)'}, 'applicant_detail_address': {'type': 'string', 'description': '사업장 상세주소'}}}