XBOSS

kr.xdataPublished by xdata.krOfficial publisherv1.0.0Updated Nov 15, 2026

Korean national tax, insurance, invoice and payroll data as MCP tools. Free tier, no card needed.

The publisher's own server: XBOSS

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server giving an assistant access to Korean national tax (Hometax), insurance, invoice and payroll data, including filing certificates and issuing…

What you can do
  • Log in to Hometax with an NPKI certificate and read the logged-in user's info
  • List and apply for tax certificates (tax clearance, tax payment, VAT base, business registration, income, financial statements) and track receipt ids
  • Search e-tax invoices by summary, list, statistics or approval number, and issue or correct them
  • Search business registration status and details, tax agents, VAT return history, amounts due, refunds, notices, overdue history and payment statements
  • Search cash receipt sales and purchase history, issue, modify or cancel same-day cash receipts, and look up credit card sales data
When to use it
Useful for Korean taxpayers, accountants and bookkeeping workflows that need to look up or file national tax documents, invoices and cash receipts from an assistant. Also relevant when an assistant must check tax deadlines, refunds or overdue amounts before advising.
Requirements
Remote streamable HTTP endpoint at api.xdata.kr; no local runtime. An XBOSS account is needed for most tools (limited free samples exist for some). Institution certificate or bank account registration through the XBOSS console, with certificate registration requiring a Windows PC once. Usage is metered by plan tokens.
Before you install
Many tools write to government records and are irreversible: certificate applications leave a receipt record with no cancellation, and issued or corrected e-tax invoices cannot be undone. Cash receipt cancellation is same-day only. Write tools return a preview and one-time confirmation_token on first call. The login tool handles an NPKI certificate credential; never share passwords or mailbox codes. Paid plans are billed monthly in KRW.

Installation

In SourceWeft

  1. Open XBOSS in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/kr.xdata%2Fxboss-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "xboss": {
      "type": "http",
      "url": "https://api.xdata.kr/mcp"
    }
  }
}

Tools

200

hometax__session__login

홈택스 로그인

Call this FIRST before any other tool for this provider. Login to Hometax via NPKI certificate. Returns a session credential. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

hometax__session__user_info

홈택스 사용자 정보 조회

Retrieve logged-in user info from Hometax. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

hometax__certificate__list

증명서 신청 목록 조회

REQUIRES prior hometax__session__login call with same account_link_id. List certificate applications already filed at Hometax (민원증명 발급 목록) with their receipt ids (cvaId, rcatNo). Read-only. Without strt_dt/end_dt only the last 3 days are returned, so an empty result does not mean the taxpayer has no certificates — widen the period to look further back. Send both dates or neither. One call covers at most one calendar month (strt_dt no earlier than end_dt minus one month); a longer period is refused, because the institution returns an empty list for it instead of an error — split it into monthly calls. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersend_dtstrt_dtpage_numpage_sizeaccount_link_idrequest_idempotency_key

hometax__certificate__apply__national_tax_payment

국세완납증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 국세완납증명(Tax Clearance Certificate) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersadrOpYnamtOpYnresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__certificate__apply__tax_payment_record

납세사실증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 납세사실증명(Certificate of Tax Payment) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersendMmstrtMmadrOpYnamtOpYncerEndYrcerStrtYrresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__certificate__apply__vat_standard

부가가치세과세표준증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 부가가치세과세표준증명(Certificate of VAT Tax Base) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersendYmrequiredstrtYmrequiredadrOpYnresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__certificate__apply__business_registration

사업자등록증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 사업자등록증명(Certificate of Business Registration) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersadrOpYnamtOpYnresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__certificate__apply__business_suspension

휴업사실증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 휴업사실증명(Certificate of Business Suspension) 신청을 연결된 사업자 계정 본인 명의로 기관에 접수합니다. 기관에 휴업 기간이 등록된 사업자만 신청할 수 있습니다. 휴업 이력을 먼저 조회하고, 이력이 없으면 신청을 접수하기 전에 거절합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersadrOpYnamtOpYnresnoOpYnsfbTermEndDtcerpIsnRqsQtysfbTermStrtDtaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__certificate__apply__financial_statement

표준재무제표증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 표준재무제표증명(Certificate of Standard Financial Statements) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbsnorequiredtxyrqrtTrtrequiredadrOpYnamtOpYnincClCdbsyrEndYmresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_token+1 more

hometax__certificate__apply__business_closure

폐업사실증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 폐업사실증명(Certificate of Business Closure) 신청을 연결된 사업자 계정 본인 명의로 기관에 접수합니다. 기관에 이미 폐업으로 등록된 사업자만 신청할 수 있습니다. 폐업 기록을 먼저 조회하고, 계속 사업 중이면 신청을 접수하기 전에 거절합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersadrOpYnamtOpYnresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__certificate__apply__business_registration_reissue

사업자등록증 재발급 신청

REQUIRES prior hometax__session__login call with same account_link_id. 사업자등록증 재발급(Business Registration Certificate Reissuance) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersadrOpYnresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_token

hometax__certificate__apply__income_statement

소득금액증명 신청

REQUIRES prior hometax__session__login call with same account_link_id. 소득금액증명(Certificate of Income) 신청을 기관에 접수합니다. 개인과 개인사업자만 신청할 수 있습니다. 법인은 신청할 수 없으며 기관 화면이 거절합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersadrOpYnresnoOpYntxnrmEndYmrequiredtxnrmStrtYmrequiredcerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_tokencvaDcumSbmsOrgnClCd

hometax__etax__invoice__search_summary

전자세금계산서 합계 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search e-tax invoice summary (totals). Choose ONE date mode: (1) daily: set date_type='01' and start_date+end_date YYYYMMDD. (2) monthly: set date_type='02' and year+month. (3) quarterly: set date_type='03' and year+quarter. search_type '01'=issued(매출), '02'=received(매입). For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersyearmonthquarterend_datedate_typepage_sizestart_datesearch_typeaccount_link_idrequest_idempotency_key

hometax__etax__invoice__search_list

전자세금계산서 목록 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search e-tax invoices by date range. Use from_date/to_date (YYYYMMDD or YYYY-MM-DD). prh_sls_cl_cd: '01'=issued(매출), '02'=received(매입). 국세청 rejects long ranges with '6개월이상은 조회할 수 없습니다.' — keep the window under 6 months and split longer periods into several calls. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersto_daterequiredpage_numfrom_daterequiredpage_sizeprh_sls_cl_cdaccount_link_idrequest_idempotency_key

hometax__etax__invoice__search_statistics

전자세금계산서 통계 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search e-tax invoice statistics by month, quarter, or year. Use wrt_ym_strt/wrt_ym_end in YYYYMM format (e.g. 202507/202509 for July-September 2025). For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersdt_clpage_numpage_sizewrt_ym_endrequiredwrt_ym_strtrequiredetxiv_clsf_cdht_rtn_cd_endht_rtn_cd_strtaccount_link_idrequest_idempotency_key

hometax__etax__invoice__search_detail

전자세금계산서 상세 조회

REQUIRES prior hometax__session__login call with same account_link_id. Get detailed information for a specific e-tax invoice by its 승인번호 (etan). Get etan from hometax__etax__invoice__search_list results. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersetanrequiredaccount_link_idrequest_idempotency_key

hometax__etax__invoice__issue

전자세금계산서 발행

REQUIRES prior hometax__session__login call with same account_link_id. Issue an e-tax invoice to 국세청. IRREVERSIBLE: once issued the buyer is notified and it enters VAT filing; it can only be corrected by issuing a 수정세금계산서, and this service's modify tool only issues one that cancels the original in full (reasons 04 and 06). This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. The preview shows the main values you sent; the supply amount and tax are computed by the server and are not in it. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssplr_tindmnr_bsnorequireditem_namerequiredbill_methodrequiredsplr_mpb_nosupply_daterequiredetxiv_knd_cdetxiv_clsf_cditem_quantityrequiredaccount_link_iditem_unit_pricerequiredconfirmation_token

hometax__etax__invoice__modify

전자세금계산서 수정

REQUIRES prior hometax__session__login call with same account_link_id. Issue a correcting e-tax invoice (수정세금계산서) against an existing one. IRREVERSIBLE, same as issuing. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. You MUST ask the user which correction reason applies and pass etxiv_mdf_rsn_cd; never guess it. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersold_aprv_norequiredsupply_daterequiredetxiv_knd_cdaccount_link_idetxiv_mdf_rsn_cdrequiredconfirmation_tokenetxiv_dmnr_clsf_cd

hometax__tax__business_registration__search_status

사업자등록 상태 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search business registration status by business registration number (사업자등록번호). For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterstxpr_dscm_norequiredaccount_link_idrequest_idempotency_key

hometax__tax__business_registration__search_info

사업자등록 정보 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search detailed business registration information. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersoutput_formatsaccount_link_idrequest_idempotency_key

hometax__tax__return_history__search_vat

부가가치세 신고 이력 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search VAT return history. Use rtn_dt_srt/rtn_dt_end (YYYYMMDD). Dates before 2015-02-23 are refused ('2015년 2월 23일 이후 신고내역만 조회 가능합니다.'), and the NTS screen documents a maximum window of one year — split longer periods into several calls. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrtn_dt_endrequiredrtn_dt_srtrequiredoutput_formatsaccount_link_idrequest_idempotency_key

hometax__tax__payment_due__search_or_pay

납부기한 조회/납부

REQUIRES prior hometax__session__login call with same account_link_id. Search tax amounts due by payment deadline (납부할 세액 조회). Read-only: this tool never executes a payment; the 'or_pay' in its name is historical. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspage_numpage_sizeinqr_cl_cdoutput_formatsaccount_link_idrequest_idempotency_key

hometax__tax__electronic_notice__check_status

전자고지 수신상태 조회

REQUIRES prior hometax__session__login call with same account_link_id. Check electronic notice reception status. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

hometax__tax__refund__search_detail

환급금 상세 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search tax refund details. Use strt_dt/end_dt (YYYYMMDD). The NTS only serves the last 5 years from today. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersend_dtrequiredstrt_dtrequiredtxaa_idtxaa_ynpage_numpage_sizeinqr_cl_cdtxpr_dscm_nooutput_formatsaccount_link_idrequest_idempotency_key

hometax__tax__notice__search_history

고지 내역 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search tax notice history. Use strt_dt/end_dt (YYYYMMDD). The NTS accepts start dates within the last 10 years. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersend_dtrequiredstrt_dtrequiredpage_numsurv_ttlpage_sizentpl_crp_cl_cdoutput_formatsaccount_link_idrequest_idempotency_key

hometax__tax__overdue__search_history

체납 내역 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search overdue tax history (체납 내역). Narrow the period with strt_dt/end_dt; without them the NTS default period applies. Only 3 rows come back per page unless you raise page_size. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersend_dtstrt_dtpage_numsurv_ttlpage_sizentpl_crp_cl_cdoutput_formatsaccount_link_idrequest_idempotency_key

hometax__tax__payment_statement__search_submit_history

지급명세서 제출내역 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search the submission history of payment statements such as daily-worker and simplified payment statements, including whether submitted and the year-month. Use sbms_ym_strt/sbms_ym_end (YYYYMM). For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspage_numpage_sizemate_knd_cdsbms_ym_endrequiredtxtn_ym_endsbms_ym_strtrequiredtxpr_dscm_notxtn_ym_strtaccount_link_idrequest_idempotency_key

hometax__tax__trade_partner__search_list

거래처 관리 목록 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search the list of trade partners the customer has registered for management. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssrt_opttxpr_nmpage_numrprs_fnmpage_sizesrt_cl_cdtxpr_dscm_noaccount_link_idrequest_idempotency_key

hometax__tax__credit_card__search_sales_data

신용카드 매출자료 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search credit card sales data. Use bsno (business number), stl_yr (year YYYY), qrt_from/qrt_to (quarter 1-4). For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbsnorequiredqrt_torequiredstl_yrrequiredpage_numqrt_fromrequiredpage_sizeaccount_link_idrequest_idempotency_key

hometax__cash_receipt__sales__search_history

현금영수증 매출 내역 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt sales history. from_date/to_date are required (YYYYMMDD or YYYY-MM-DD). Counts: totalCount (and the same value in pageInfoVO.totalCount) is the record count for this query and is never fewer than the rows in this response; collectionMeta says whether this response already holds all of them (complete) and how many came back (collectedCount). When complete is false, ask for the next page. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersto_daterequiredpage_numfrom_daterequiredmax_pagespage_sizepbl_cl_cdaccount_link_idfetch_all_pagesrequest_idempotency_key

hometax__cash_receipt__sales__search_summary

현금영수증 매출 합계 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt sales annual summary. Use cmtt_yr for the target year. Optionally specify qrt (quarter 1-4) for quarterly breakdown. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersqrtcmtt_yrrequiredaccount_link_idrequest_idempotency_key

hometax__cash_receipt__purchase__search_history

현금영수증 매입 내역 조회

REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt purchase history. from_date/to_date are required (YYYYMMDD or YYYY-MM-DD). 국세청 rejects ranges longer than 3 months with '조회기간은 최대 3개월 까지 가능합니다.' — split longer periods into 3-month calls. Counts: totalCount (and the same value in pageInfoVO.totalCount) is the record count for this query and is never fewer than the rows in this response; collectionMeta says whether this response already holds all of them (complete) and how many came back (collectedCount). When complete is false, ask for the next page. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersto_daterequiredpage_numfrom_daterequiredmax_pagespage_sizespjb_trs_ynaccount_link_idfetch_all_pagesmrnt_txpr_dscm_norequest_idempotency_key

hometax__cash_receipt__issue_individual

현금영수증 개별 발급

REQUIRES prior hometax__session__login call with same account_link_id. 현금영수증 한 건을 발급합니다. 소비자의 소득공제용 또는 사업자의 지출증빙용(예: 사업자등록번호로 발급)으로 발급합니다. 발급하면 기관의 원장이 바로 바뀌고 받는 쪽의 소득공제와 지출증빙 자료에 반영됩니다. 취소는 발급한 당일에만 할 수 있고, 날짜가 바뀌면 이 도구로 되돌릴 수 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParameterstiptotaTrsAmtrequiredcshptUsgClCdrequiredspstCnfrClCdrequiredcshptTrsTypeCdrequiredaccount_link_idcshptIsnMmoCntnspstCnfrNoEncCntnrequiredconfirmation_token

hometax__cash_receipt__daily_issue__modify

일일 현금영수증 수정

REQUIRES prior hometax__session__login call with same account_link_id. 오늘 발급한 현금영수증을 수정합니다. aprv_no 는 hometax__cash_receipt__daily_issue__search 에서 얻습니다. 보낸 칸은 그 값으로 전송합니다. 다만 바꾼 용도, 거래유형, 발급수단을 기관이 반영하는지는 보장되지 않습니다(발급수단 변경 표시는 항상 N 으로 전송합니다). 보내지 않은 용도, 발급수단, 거래일시, 봉사료, 메모는 오늘 발급한 원본의 값으로 전송합니다. 봉사료를 없애려면 0 을 입력합니다. 원본으로 부가가치세 적용 여부를 알 수 없으면 추측하지 않고 cshpt_trs_type_cd 를 요청합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterstiptrs_dtaprv_norequiredrcpr_tintrs_timetota_trs_amtrequiredaccount_link_idcshpt_usg_cl_cdspst_cnfr_cl_cdcshpt_trs_type_cdconfirmation_tokencshpt_isn_mmo_cntn+1 more

hometax__cash_receipt__daily_issue__cancel

일일 현금영수증 취소

REQUIRES prior hometax__session__login call with same account_link_id. 오늘 발급한 현금영수증을 취소합니다. aprv_no 와 cshpt_cncl_rsn_cd 만 있으면 됩니다. 나머지 칸은 보내지 않으면 오늘 발급한 원본의 값으로 전송합니다(aprv_no 는 hometax__cash_receipt__daily_issue__search 에서 얻습니다). 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterstiptrs_dtaprv_norequiredspl_cftrcpr_tintrs_timeva_txamttota_trs_amtaccount_link_idcshpt_usg_cl_cdspst_cnfr_cl_cdcshpt_cncl_rsn_cdrequired+3 more

hometax__certificate__apply_with_template

증명서 템플릿 신청

REQUIRES prior hometax__session__login call with same account_link_id. 지정한 서식으로 증명서 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbsnotxyrendYmqrtTrtstrtYmadrOpYnamtOpYnincClCdbsyrEndYmresnoOpYntxnrmEndYmtxnrmStrtYm+6 more

hometax__certificate__list_templates

증명서 템플릿 목록 조회

No credential or login required. List the certificate templates that can be applied for (9). The slugs returned here are exactly the values accepted by cert_template; nothing else is. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrequest_idempotency_key

hometax__certificate__apply_auto

증명서 자동 신청

REQUIRES prior hometax__session__login call with same account_link_id. 로그인한 납세자 본인의 정보로 증명서 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbsnotxyrendYmqrtTrtstrtYmadrOpYnamtOpYnincClCdbsyrEndYmresnoOpYntxnrmEndYmtxnrmStrtYm+7 more

hometax__certificate__download

증명서 다운로드

REQUIRES prior hometax__session__login call with same account_link_id. 발급된 증명서를 PDF 로 내려받습니다. 결과의 data 에는 발급 식별값(cva_id, rcat_no)이, artifacts[] 에는 PDF 와 서명된 내려받기 주소(download_url)가 담깁니다. 되돌릴 수 없습니다. 기관에서는 이것이 출력이라 출력할 때마다 신청한 발급 매수(발급 한도) 1매를 쓰고, 다 쓰면 증명서를 다시 신청해야 합니다. 취소 기능이 없습니다. cva_id 값은 증명서 신청 결과(apply_auto, apply_with_template 등)에서 얻습니다. rcat_no 값은 apply_auto(data.list_info.rcat_no) 또는 apply_auto_download(최상위)에서 얻고, apply_with_template 의 결과에서는 rcat_no 값이 null 입니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. Files: the document the institution issued, unchanged, as PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterscva_idrequiredend_dtrcat_norequiredstrt_dtpage_numpage_sizerpt_pkg_pthaccount_link_idconfirmation_token

hometax__certificate__apply_auto_download

증명서 자동 신청 및 다운로드

REQUIRES prior hometax__session__login call with same account_link_id. 기본 발급 옵션으로 국세완납증명(Tax Clearance Certificate) 신청을 기관에 접수하고, 발급된 PDF 를 한 번에 내려받습니다. 신청이 먼저 접수되므로 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구에서는 서식과 발급 옵션을 바꿀 수 없습니다(옵션을 정하려면 hometax.certificate.apply.national_tax_payment 를 사용합니다). 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. Files: the document the institution issued, unchanged, as PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idconfirmation_token

hometax__etax__business_info__get

사업자 정보 조회 (전자세금계산서)

REQUIRES prior hometax__session__login call with same account_link_id. Get business info for e-tax invoice purposes. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

hometax__etax__client_info__get

거래처 정보 조회 (전자세금계산서)

REQUIRES prior hometax__session__login call with same account_link_id. Get client/counterparty info for e-tax invoicing. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__session__login

건강보험 EDI 로그인

Call this FIRST before any other tool for this provider. 등록한 공동인증서로 건강보험 EDI에 로그인해 세션을 만들고, 로그인 성공 여부와 이번에 쓴 연동 계정 ID를 돌려줍니다. 로그인이 필요한 건강보험 EDI 조회보다 먼저 부릅니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__session__status

건강보험 EDI 세션 상태 조회

연동 계정을 넣으면 저장된 건강보험 EDI 세션에 접속 정보가 모두 있는지와 로그인 확인 결과를 읽어 인증 여부와 업무 화면 준비 기록을 돌려줍니다. 기관 화면은 열지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__hr_payroll__received_documents__options

수신문서 목록 조회 옵션

REQUIRES prior nhis_edi__session__login call with same account_link_id. 기간이나 고지 연월을 넣으면 수신문서 목록의 행마다 행 번호, 문서 이름, 고지 연월과 차수, 작성 차수를 받습니다. 문서 안쪽은 열지 않고 행 정보만 돌려줍니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersto_dateform_namefrom_dategoji_roundaccount_link_iddocument_statusnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__received_documents__detail

수신문서 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 수신문서 목록에서 고른 행 한 건을 열어 문서 제목과 기관의 문서 코드, 표 이름별 열과 행을 받습니다. 문서 종류마다 오는 표가 서로 다릅니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_dateform_namefrom_daterow_indexgoji_roundaccount_link_iddocument_statusnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__received_documents__batch_details

수신문서 일괄 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 보수월액 수신문서 목록 조회가 돌려준 행 번호를 넣으면 행마다 상세를 열어 결과 목록으로 받습니다. 한 건이라도 못 열면 결과 전체의 성공 표시가 꺼지고 안내 문장이 붙습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersto_dateform_namefrom_dategoji_roundrow_indexesrequiredaccount_link_iddocument_statusnotice_year_monthrequest_idempotency_key

nhis_edi__document_box__sent_documents__list

발송문서 목록 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 조회 기간을 넣어 부르면 보낸 신고서마다 이름과 제출 일시, 접수 건수, 보험별 정상, 반송, 반려 건수를 받습니다. 결과 표는 엑셀로도 받을 수 있고, 그 파일은 청한 호출에만 만들어집니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersgubunykihoto_dateform_codeform_namefrom_dateoutput_formatsaccount_link_idinclude_form_optionsrequest_idempotency_key

nhis_edi__document_box__sent_documents__detail

발송문서 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 보낸문서 목록의 행 번호나 행 키로 고른 4대보험 기준소득월액, 보수월액, 월평균보수 변경신청서 한 건의 대상자와 보험별 신고 내용을 받습니다. 다른 서식의 문서는 오류로 돌아옵니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyfirm_symefirm_symform_coderow_indexwrt_chasuwrt_dup_sequnit_firm_symaccount_link_idrequest_idempotency_key

nhis_edi__file_report__init

파일신고 초기화

REQUIRES prior nhis_edi__session__login call with same account_link_id. 로그인한 연동 계정으로 파일신고에 쓸 수 있는 서식 다섯 가지와 기본 서식, 올릴 수 있는 파일 형식, 신고 자료 표의 열을 받습니다. 파일을 올리거나 검증하거나 신고하지는 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__certificates__payment_completion__init

보험료 완납증명서 신청(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 건강보험료 납부확인서 화면의 고지 총액과 납부 총액 칸, 가입자별 보험료 표의 열, 발급번호 칸을 받습니다. 발급은 보험료 납부확인서 발급 실행이 합니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__certificates__payment_completion__issue

보험료 완납증명서 발급

REQUIRES prior nhis_edi__session__login call with same account_link_id. Issue an NHIS payment-completion (완납증명서) or payment (납부확인서) certificate. IRREVERSIBLE: the certificate is issued at 건강보험공단 and an issue number is assigned; there is no cancel action. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. Files: the document the institution issued, unchanged, as PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersyearissue_gubunissue_usageaccount_link_idcertificate_kindconfirmation_token

nhis_edi__certificates__workplace_application_notice__apply__init

사업장 적용 통보서 신청(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 사업장 적용 통보서 신청서 화면의 한글 영문 신청구분, 사업장 칸, 작성일과 일련번호 칸을 받습니다. 이 도구는 신청 버튼을 누르지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__certificates__workplace_member_list__apply__init

사업장 가입자 명단 신청(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 부르면 사업장 가입자 명부 신청 화면의 가입자 범위와 상실자 포함 보기, 대상자 성명과 주민등록번호 칸을 돌려줍니다. 명부 발급은 신청하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__certificates__health_premium_payment__individual__init

건강보험료 납부확인서 신청(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 개인별 건강보험 납부확인서 신청 화면의 신청인 칸, 신청년월 칸, 가입자 명단 표의 열을 받습니다. 칸은 미리 저장해 둔 화면 정보에서 나오며 신청은 하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__certificates__workplace_application_notice__issued__init

사업장 적용 통보서 발급 이력(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 발급된 사업장 적용 통보서 화면의 사업장명, 사용자 성명, 적용일자, 가입자수, 발급번호 칸 구성을 받습니다. 발급된 통보서의 값은 불러오지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__certificates__workplace_member_list__issued__init

사업장 가입자 명단 발급 이력(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 로그인한 연동 계정으로 사업장 가입자 명부 발급확인 화면의 발급일자, 작성차수, 발급번호 칸과 명부 표의 열 이름을 받습니다. 발급된 명부의 가입자 내용은 담기지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__qualification__acquisition__init

자격취득 신고(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정 하나로 자격취득 신고서의 입력 항목 70개와, 대상자와 네 보험, 피부양자 등 구역 아홉의 목록을 받습니다. 신고서를 만들거나 보내지는 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__qualification__acquisition__draft_validate

자격취득 초안 검증

REQUIRES prior nhis_edi__session__login call with same account_link_id. 입사자 성명과 주민등록번호, 고른 보험별 취득 값, 피부양자 행을 넣으면 빠진 항목과 오류, 첨부서류 안내, 대상자 등록 가능 여부를 돌려줍니다. 대상자 등록과 신고는 하지 않습니다. params: definition pending — see docs/contracts/EDI_JOB_ACTION_PARAMS.md. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__qualification__loss__init

자격상실 신고(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 자격 상실 신고서의 보험별 상실일과 상실 코드 칸, 보수총액, 이직확인서 칸과 목록 이름을 로그인한 연동 계정으로 받습니다. 칸 구성은 저장해 둔 상실 신고서 화면 정보에서 읽습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__qualification__change__init

자격변동 신고(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 로그인한 연동 계정으로 부르면 자격 내역변경 신고서의 대상자, 신청구분, 내역변경, 보험별 구역 칸과 변경부호 같은 목록 이름을 받습니다. 신고서는 임시저장하거나 보내지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__qualification__dependent__init

피부양자 신고(초기화)

REQUIRES prior nhis_edi__session__login call with same account_link_id. 피부양자 취득 상실 신고서의 가입자, 피부양자, 장애인과 국가유공자, 외국인 구역 칸을 연동 계정 하나로 받습니다. 취득과 상실 구분만 보기 값이 함께 옵니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__hr_payroll__premium_notices__select

건강보험 고지 선택

REQUIRES prior nhis_edi__session__login call with same account_link_id. 탐색 결과의 행 키나 고지 연월, 문서 이름으로 고지내역서 하나를 골라 같은 연동 계정의 다음 조회가 쓰도록 남기고, 고른 문서 정보와 이어 부를 조회 목록을 받습니다. 고지 내용은 열지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_datefrom_daterow_indexgoji_roundaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__premium_notices__detail

건강보험 고지 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 탐색 결과의 행 키나 고지 연월과 문서 이름으로 고지내역서 하나를 열어 고지 연월과 차수, 보험 종류, 기관이 준 고지 항목 행을 받습니다. 항목 이름은 기관 코드 그대로 옵니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_datefrom_daterow_indexgoji_roundaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__health_premiums__summary

건강보험료 요약 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 고지 연월과 차수를 넣으면 사업장고지내역서(건강)를 열어 고지 인원과 건강보험, 장기요양보험의 산출, 조정, 고지 총액, 납부 마감일, 미납 금액을 받습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_datefrom_daterow_indexgoji_roundaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__health_premiums__employee_details

건강보험료 직원별 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 고지 연월과 차수를 넣으면 가입자고지내역서(건강)를 열어 가입자마다 보수월액과 건강보험, 장기요양보험의 산출, 조정, 당월 보험료와 합계를 받습니다. 요청하면 엑셀로도 받습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_datefrom_daterow_indexgoji_roundoutput_formatsaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__payment_status__list

건강보험료 납부 현황 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 부르면 기본으로 올해 건강보험의 달마다 고지금액, 납부마감일, 납부일, 낸 보험료와 연체금, 미납 금액을 장기요양보험 몫과 함께 받습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersunb_nogoji_chasusearch_yearinsurance_codeoutput_formatsaccount_link_idnation_finance_cdrequest_idempotency_key

nhis_edi__hr_payroll__edi_electronic_notices__contract

EDI 전자고지 조회 규칙

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 부르면 전자고지를 검색해 한 건을 고르는 순서와 고를 때 쓰는 다섯 항목을 받습니다. 규칙은 서버에 적어 둔 것이며 전자고지 내용은 담기지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__hr_payroll__edi_electronic_notices__search_options

EDI 전자고지 조회 옵션

REQUIRES prior nhis_edi__session__login call with same account_link_id. 조회 기간을 넣어 부르면 전자고지마다 고지 연월과 차수, 작성 차수, 납부자번호, 문서 이름과 행 키를 받습니다. 검색 결과는 같은 로그인 세션에 남습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersdoc_idto_datefrom_dateaccount_link_idinsurance_type_coderequest_idempotency_key

nhis_edi__hr_payroll__edi_electronic_notices__select

EDI 전자고지 선택

REQUIRES prior nhis_edi__session__login call with same account_link_id. 전자고지 검색 결과에서 행 번호나 행 키, 고지 연월과 차수로 한 건을 골라 로그인 세션에 남기고 그 고지의 값을 받습니다. 세션에 검색 결과가 없으면 먼저 다시 검색합니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersunb_norow_keyto_datefrom_daterow_indexwrt_chasugoji_chasugoji_yyyymmwrt_dup_seqaccount_link_idrequest_idempotency_key

nhis_edi__hr_payroll__edi_electronic_notices__detail

EDI 전자고지 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 검색해 고른 전자고지 한 건의 고지서 상세 행과 총 납부보험료, 총 체납액, 납부마감일 요약을 받습니다. 고를 고지가 없으면 빈 결과와 기간을 넓히라는 안내가 옵니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersunb_norow_keyto_datefrom_daterow_indexwrt_chasugoji_chasugoji_yyyymmwrt_dup_seqaccount_link_idrequest_idempotency_key

nhis_edi__hr_payroll__year_end_settlement__detail

연말정산 건강보험 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 수신문서 목록에서 직장가입자 보험료 연말정산 산출내역서 행을 찾아 열면 가입자별 행과 열을 받습니다. 산출내역서가 목록에 없으면 행을 찾지 못했다는 결과가 옵니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_dateform_namefrom_daterow_indexgoji_roundaccount_link_iddocument_statusnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__business__basic_info

사업장 기본정보 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 부르면 로그인한 건강보험 EDI 세션이 가진 사업장 기본정보를 받습니다. 사업장을 고르는 입력은 없고, 조회만 하며 업무 자료를 바꾸지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nhis_edi__health_checkups__targets__detail

건강검진 대상자 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 최근 석 달 안에 받은 건강검진 대상자 문서에서 검진년도와 통보일, 사무직과 비사무직 대상자 수, 사업장 주소와 연락처를 돌려줍니다. 문서를 찾지 못하면 찾지 못했다는 결과가 돌아옵니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_datefrom_daterow_indexgoji_roundaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__salary_total_notice__detail

보수총액 신고 상세 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 보수총액 통보서 화면의 상세 데이터와 요약 정보를 조회합니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyto_datefrom_daterow_indexgoji_roundaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nhis_edi__hr_payroll__processing_results__list

처리 결과 목록 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 기간이나 고지 연월을 넣으면 받은 문서와 보낸 문서의 행을 한 목록으로 받습니다. 보낸 문서 행에는 접수 건수와 보험별 정상, 반송, 반려 건수가 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersto_datefrom_dategoji_roundoutput_formatsaccount_link_idnotice_year_monthrequest_idempotency_key

nhis_edi__public__notices__list

건강보험 공지 목록 조회

No credential or login required. 쪽 번호를 넣으면 대외 공지사항 게시판 그 쪽의 글마다 번호나 공지 표시, 제목, 등록일과 글 주소를 받고, 첨부가 있으면 첨부 안내도 받습니다. 연동 계정과 기관 로그인은 필요하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspagerequest_idempotency_key

nhis_edi__public__resources__list

건강보험 자료 목록 조회

No credential or login required. 쪽 번호로 공개 자료실 게시판의 한 쪽을 읽어 자료마다 번호나 공지 표시, 제목, 등록일과 글 주소를 돌려주고, 첨부가 있는 자료에는 첨부 안내가 붙습니다. 파일 자체는 받지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspagerequest_idempotency_key

nhis_edi__public__forms__list

건강보험 전체서식 화면 정보 조회

REQUIRES prior nhis_edi__session__login call with same account_link_id. 연동 계정으로 부르면 이 세션의 업무 화면을 준비한 뒤 전체서식 화면의 화면 번호와 그 메뉴로 가는 연결 번호를 받습니다. 그 화면을 열지는 않으며, 서식 목록이나 서식 파일은 이 결과에 담기지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nps_edi__auth__npki_session__login

국민연금 EDI 로그인

Call this FIRST before any other tool for this provider. Login to NPS EDI via NPKI certificate. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idbusiness_management_norequiredrequest_idempotency_key

nps_edi__auth__session__status

국민연금 EDI 세션 상태 조회

Check NPS EDI session status. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nps_edi__b1__workplace__main_basic_info

사업장 기본정보 조회 (국민연금)

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get workplace main basic info from NPS. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nps_edi__b1__certificates__application_results__document_view

증명서 문서 뷰 파라미터 준비

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Prepare the print and save parameters for one certificate result. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indexreceipt_nodocument_norun_prechecktemplate_codeaccount_link_idrow_text_containsrequest_idempotency_keyinclude_ec15_report_rows

nps_edi__b1__certificates__membership__issue

가입증명서 발급

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Issue the NPS membership certificate (EC02, Korean only) for one subscriber. IRREVERSIBLE: the certificate is issued at 국민연금공단 and stays in the application results list; there is no cancel action. An issued certificate can be printed again only within 24 hours; after that a new application must be sent first. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keylanguagerow_indexmember_nameaccount_link_idconfirmation_token

nps_edi__b1__certificates__membership__apply

가입증명 신청서 발송

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. Send the NPS membership certificate application (form EB0301) for 1 to 100 subscribers. Do this before the issue tool: the issue screen lists subscribers only under a received application document number. IRREVERSIBLE: a sent application cannot be cancelled and stays in the institution's records. Each subscriber needs member_name and rrno (13-digit resident registration number; never echoed back - the preview shows names and the last 4 digits only). 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssubscribersrequiredaccount_link_idconfirmation_token

nps_edi__b1__pension_notification_documents__detail

연금통지서 상세 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get detailed pension notification document. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 기본값(mark_as_read=true)으로 조회 대상 문서를 기관에 읽음 처리합니다. 읽음 처리를 원치 않으면 mark_as_read=false 로 호출하세요. 이 기본 호출은 순수 읽기 전용이 아닙니다.

Parameterspage_norow_keyrow_indexreceipt_nodocument_nomember_namemark_as_readinclude_guidetemplate_codepage_per_countaccount_link_idsearch_type_code+4 more

nps_edi__b1__pension_notices__select

연금보험료 고지 선택

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Select a specific pension premium notice. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indextemplate_codeaccount_link_idinstallment_roundnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nps_edi__b1__national_pension_premiums__summary

국민연금보험료 요약 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get national pension premium summary. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indextemplate_codeaccount_link_idinstallment_roundnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nps_edi__b1__national_pension_premiums__subscribers

국민연금 가입자 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get national pension subscribers list. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indextemplate_codeoutput_formatsaccount_link_idinstallment_roundnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nps_edi__b1__national_pension_premiums__support_details

국민연금 지원 상세 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get pension premium support details. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indextemplate_codeoutput_formatsaccount_link_idinstallment_roundnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nps_edi__b1__national_pension_premiums__payment_history

국민연금 납부 이력 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get national pension premium payment history. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indextemplate_codeaccount_link_idinstallment_roundnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nps_edi__b1__national_pension_premiums__retro_payments

국민연금 소급분 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get retro pension premium payments. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrow_keyrow_indextemplate_codeaccount_link_idinstallment_roundnotice_year_monthrow_text_containscell_text_containsrequest_idempotency_key

nps_edi__b1__national_pension_premiums__guide

국민연금 결정내역 안내 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get pension premium decision-details guide. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

nps_edi__b1__lookups__workplace_premium_support__details

사업장 연금 지원 내역 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Look up workplace pension premium support records. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersend_year_monthaccount_link_idstart_year_monthdecision_year_monthrequest_idempotency_key

nps_edi__b1__lookups__workplace_subscribers__status

사업장 가입자 현황 조회

REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Get workplace subscribers status from NPS. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspage_nomember_namepage_per_countaccount_link_idrequest_idempotency_key

fourinsure__session__login

4대보험 EDI 로그인

Call this FIRST before any other tool for this provider. Login to FourInsure (4대보험) EDI. Returns API_KEY. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersauth_provideraccount_link_idrequest_idempotency_key

fourinsure__b1__business_establishment__init

사업장 성립신고 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize business establishment declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterscvrc_noaccount_link_idrequest_idempotency_key

fourinsure__b1__business_establishment__draft_validate

사업장 성립신고 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate business establishment declaration draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__acqs_init

직원 자격취득 신고 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize employee qualification acquisition declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__los_init

직원 자격상실 신고 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize employee qualification loss declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__chg_init

직원 자격변동 신고 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize employee qualification change declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__dependent_init

피부양자 자격신고 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize dependent qualification declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__acqs_draft_validate

직원 자격취득 신고 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate employee qualification acquisition draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__los_draft_validate

직원 자격상실 신고 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate employee qualification loss draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__chg_draft_validate

직원 자격변동 신고 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate employee qualification change draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__dependent_draft_validate

피부양자 자격신고 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate dependent qualification declaration draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__los_member_lookup

직원 자격상실 가입자 조회

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격상실 신고서를 쓰기 전에 성명과 주민등록번호로 가입자를 조회해 자격키(rrkey)와 보험별 기존 자격취득일·상실일, 기존 신고 여부를 돌려줍니다. 조회만 하며 기관에 저장하거나 제출하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbpmnorrno_backrrno_frontapplicant_namerequiredaccount_link_iddeclaration_apply_daterequest_idempotency_keyresident_registration_numberrequired

fourinsure__b1__member_qualification__los_exist_check

직원 자격상실 기존 신고 확인

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격상실 신고서를 쓰기 전에 보험 하나(국민연금·건강보험·고용보험·산재보험)에 기존 상실신고가 있는지 확인합니다. rrkey 는 자격상실 가입자 조회 결과의 값을 넣습니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersflagrequiredbpmnorrkeyrequiredcheck_typeworkplace_nameaccount_link_idapplicant_rrkeydeclaration_apply_daterequest_idempotency_key

fourinsure__b1__member_qualification__los_save

직원 자격상실 초안 저장

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격상실 신고서를 정보연계센터에 초안으로 저장하고 접수번호를 받습니다. 기관에 실제로 남는 쓰기이고 이 API 로 되돌릴 수 없습니다. 신고서를 기관에 전송하지는 않으며, 마지막 전송은 사용자가 정보연계센터 화면에서 직접 합니다. confirm=true 없이 부르면 저장하지 않고 보낼 값을 미리 보여 주므로, 사용자에게 보여 주고 동의를 받은 뒤 confirm=true 로 다시 부르세요. rrkey 는 자격상실 가입자 조회 결과의 값을 넣습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrrkeyrequiredconfirmdry_runapplicant_namerequiredaccount_link_idcommon_loss_daterequiredhealth_insurancerequirednational_pensionrequiredemployment_insurancerequiredworkers_compensationrequiredcurrent_year_salary_amountrequiredhealth_insurance_month_countrequired+1 more

fourinsure__b1__member_qualification__acqs_member_lookup

직원 자격취득 가입자 조회

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격취득 신고서를 쓰기 전에 성명과 주민등록번호로 가입자를 조회해 자격키(rrkey)와 대표자 여부, 보험별 기존 자격취득일·상실일을 돌려줍니다. 조회만 하며 기관에 저장하거나 제출하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersapplicant_namerequiredaccount_link_idrequest_idempotency_keyresident_registration_numberrequired

fourinsure__b1__member_qualification__acqs_precheck

직원 자격취득 사전 확인

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격취득 신고서를 쓰기 전에 상위 접수번호에 이미 작성된 건수를 확인합니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersup_cvrc_noaccount_link_idrequest_idempotency_key

fourinsure__b1__member_qualification__acqs_save

직원 자격취득 초안 저장

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격취득 신고서를 정보연계센터에 초안으로 저장하고 접수번호를 받습니다. 기관에 실제로 남는 쓰기이고 이 API 로 되돌릴 수 없습니다. 신고서를 기관에 전송하지는 않으며, 마지막 전송은 사용자가 정보연계센터 화면에서 직접 합니다. confirm=true 없이 부르면 저장하지 않고 보낼 값을 미리 보여 주므로, 사용자에게 보여 주고 동의를 받은 뒤 confirm=true 로 다시 부르세요. rrkey 는 자격취득 가입자 조회 결과의 값을 넣습니다. 건강보험 취득부호와 직종 코드는 공통코드 목록 조회로 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrrkeyrequiredconfirmdry_runapplicant_namerequiredaccount_link_idhealth_insurancerequiredepi_occupation_coderequiredepi_occupation_namerequiredcommon_monthly_amountrequiredcommon_acquisition_daterequiredresident_registration_numberrequired

fourinsure__b1__common__com_cd__list

4대보험 공통코드 목록

REQUIRES prior fourinsure__session__login call with same account_link_id. 자격취득·상실 신고서의 사유·직종 칸에 넣는 공통코드(코드 값과 이름)를 분류 아이디별로 조회합니다(예: B112, D114, A101). 조회만 하며 기관에 저장하거나 제출하지 않습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterscom_cd_clsf_idrequiredaccount_link_idrequest_idempotency_key

fourinsure__b1__payroll__amount_change__init

보수월액 변경 신청 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize payroll amount change application. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__payroll__amount_change__draft_validate

보수월액 변경 신청 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate payroll amount change draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__workplace_support__insurance_support__init

두루누리 보험료 지원 신청 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize workplace insurance support declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__workplace_support__household_worker__init

가사근로자 보험료 지원 신청 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize household worker insurance support declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__workplace_support__insurance_support__draft_validate

두루누리 보험료 지원 신청 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate workplace insurance support draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__workplace__withdrawal__init

사업장 탈퇴신고 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize workplace withdrawal declaration. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__workplace__auto_transfer_unagreement__init

자동이체 해지 신청 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize auto transfer cancellation application. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__workplace__auto_transfer_unagreement__draft_validate

자동이체 신청 입력 초안 검증

REQUIRES prior fourinsure__session__login call with same account_link_id. Validate auto transfer application draft without submission. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__certificate__apply__init

4대보험 증명서 신청 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize 4대보험 certificate application. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__certificate__apply__submit

4대보험 증명서 신청 제출

REQUIRES prior fourinsure__session__login call with same account_link_id. Submit a 4대보험 certificate application. IRREVERSIBLE: the application is filed with the 정보연계센터 and a receipt number is assigned; there is no cancel action. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersdry_runselectionrequiredphone_areaphone_lineconfirm_submitphone_exchangeaccount_link_idoutput_sort_codeconfirmation_token

fourinsure__b1__certificate__history__list_init

증명서 신청 이력 목록 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize certificate application history list. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__certificate__history__detail_init

증명서 신청 이력 상세 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize certificate application history detail. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterscvrc_norequiredgroup_cvrc_noaccount_link_idrequest_idempotency_key

fourinsure__b1__certificate__history__list

증명서 신청 이력 목록 조회

REQUIRES prior fourinsure__session__login call with same account_link_id. List certificate application history. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__certificate__history__detail

증명서 신청 이력 상세 조회

REQUIRES prior fourinsure__session__login call with same account_link_id. Get certificate application history detail. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterscvrc_norequiredgroup_cvrc_noaccount_link_idrequest_idempotency_key

fourinsure__b1__certificate__history__pdf_download

증명서 PDF 다운로드

REQUIRES prior fourinsure__session__login call with same account_link_id. Previews the target printable certificate application (its receipt number, status and dates) by default; no PDF is included. Send dry_run=false and confirm_download=true to receive the actual PDF in the result artifacts. Files: the document the institution issued, unchanged, as PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterscvrc_nodry_runaccount_link_idconfirm_downloaddownload_all_available

fourinsure__b1__certificate__issue_fact__confirm

증명서 발급 사실 확인

REQUIRES prior fourinsure__session__login call with same account_link_id. Confirm certificate issuance fact. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbpmnoissu_norequiredidnty_nmfrnt_rrnojoin_kind_cdrequiredaccount_link_idrequest_idempotency_key

fourinsure__b1__civil_receipt__history__list_init

민원접수 이력 목록 초기화

REQUIRES prior fourinsure__session__login call with same account_link_id. Initialize civil receipt history list. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

fourinsure__b1__civil_receipt__history__list

민원접수 이력 목록 조회

REQUIRES prior fourinsure__session__login call with same account_link_id. List civil receipt history. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssins_type_cdsrch_cvrc_noprgrs_stts_cdoutput_formatsaccount_link_idcurrent_page_nocvlcpt_tmplt_cdfrst_reg_end_dtfrst_reg_str_dtrequest_idempotency_key

fourinsure__b1__resources__faqs__list_init

4대보험 FAQ 목록 초기화

No credential or login required. Initialize FAQ list for 4대보험. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrequest_idempotency_key

fourinsure__b1__resources__faqs__list

4대보험 FAQ 목록 조회

No credential or login required. List FAQs for 4대보험. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssrch_optsrch_txtsrch_sortsrch_clsf_cdsrch_type_cdcurrent_page_nosrch_cvlcpt_typerequest_idempotency_key

fourinsure__b1__resources__faqs__detail

4대보험 FAQ 상세 조회

REQUIRES prior fourinsure__session__login call with same account_link_id. Get FAQ detail. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersqstn_snrequiredaccount_link_idcurrent_page_norequest_idempotency_key

fourinsure__b1__resources__notices__institutions__list_init

기관 공지 목록 초기화

No credential or login required. Initialize institution notices list. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrequest_idempotency_key

fourinsure__b1__resources__notices__institutions__list

기관 공지 목록 조회

No credential or login required. List institution notices. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssrch_optsrch_txtsrch_instcurrent_page_norequest_idempotency_key

fourinsure__b1__resources__notices__institutions__detail

기관 공지 상세 조회

No credential or login required. Get institution notice detail. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspst_snrequiredaccount_link_idrequest_idempotency_key

fourinsure__b1__resources__notices__institutions__attachments

기관 공지 첨부파일 조회

No credential or login required. Get institution notice attachments. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterspst_snrequiredaccount_link_idrequest_idempotency_key

fourinsure__b1__resources__forms__list_init

서식 목록 초기화

No credential or login required. Initialize forms list. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrequest_idempotency_key

fourinsure__b1__resources__forms__list

서식 목록 조회

No credential or login required. List available forms. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parameterssrch_txtsrch_job_cdsrch_insu_cdsrch_pubap_cdcurrent_page_norequest_idempotency_key

fourinsure__b1__resources__forms__detail

서식 상세 조회

No credential or login required. Get form detail. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbbs_idrequiredpst_snrequiredrequest_idempotency_key

fourinsure__b1__resources__forms__attachments

서식 첨부파일 조회

No credential or login required. Get form attachments. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbbs_idrequiredpst_snrequiredatfl_idrequiredcurrent_page_norequest_idempotency_key

fourinsure__b1__resources__files__download

파일 다운로드

REQUIRES prior fourinsure__session__login call with same account_link_id. Checks whether the attachment exists and returns its original file name by default (dry-run); no file is included. Send dry_run=false to receive the actual file in the result artifacts. Files: the document the institution issued, unchanged, as Hancom Office (hwp) or PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersatfl_idrequireddry_runatch_file_snrequiredaccount_link_idrequest_idempotency_key

hometax__tax__return_document__detail

세금 신고서 상세 조회

REQUIRES prior hometax__session__login call with same account_link_id. hometax__tax__return_history__search 결과의 return_document_ref 로 그 신고서의 서식별 항목과 값, 표를 조회합니다. 같은 계정 연결에서 받은 return_document_ref 만 쓸 수 있습니다. form_codes 를 빼면 출력할 수 있는 서식을 모두 받고, 넣으면 그 서식만 받습니다. forms 에는 서식마다 서식 코드와 이름, 본서와 부속서류 구분, 칸 이름과 값, 표가 기관 화면에 적힌 그대로 담기고, cells 는 그 칸을 한 줄씩 펼친 목록입니다. 신고 때 따로 낸 첨부는 separate_attachments 에 목록과 상태로 담기며, 서면으로 접수한 신고처럼 첨부를 확인할 수 없으면 없다고 하지 않고 확인할 수 없다고 표시합니다. 원문 PDF 는 hometax__tax__return_document__pdf 로 받습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersform_codesoutput_formatsaccount_link_idreturn_document_refrequiredrequest_idempotency_key

hometax__tax__return_document__pdf

세금 신고서 원문 조회

REQUIRES prior hometax__session__login call with same account_link_id. hometax__tax__return_history__search 결과의 return_document_ref 로 기관이 출력하는 신고서 원문 PDF 를 받습니다. 같은 계정 연결에서 받은 return_document_ref 만 쓸 수 있습니다. form_codes 를 빼면 출력할 수 있는 서식을 모두 받고, 넣으면 그 서식만 받습니다(값은 hometax__tax__return_document__detail 결과의 form_code). PDF 는 결과의 artifacts[] 에 서식마다 담기고 쪽이 많은 서식은 여러 파일로 나뉘며, data 의 forms 에 받은 서식과 쪽수가 담깁니다. 신고 때 따로 낸 첨부 PDF 는 확인할 수 있으면 모두 함께 받고, 서면으로 접수한 신고처럼 확인할 수 없으면 separate_attachments 에 그 상태가 담깁니다. Files: the document the institution issued, unchanged, as PDF, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersform_codesaccount_link_idreturn_document_refrequiredrequest_idempotency_key

comwel__auth__npki_session__login

근로복지공단 로그인

Call this FIRST before any other tool for this provider. Login to COMWEL via NPKI AnySign certificate. Works only when business_registration_no maps to exactly one COMWEL business management number; with two or more the login fails and no input of this tool picks one. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersauth_provideraccount_link_idrequest_idempotency_keybusiness_registration_norequired

comwel__auth__session__status

근로복지공단 세션 상태 조회

Check COMWEL session status. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

work24__auth__npki_session__login

고용24 로그인

Call this FIRST before any other tool for this provider. 공동인증서(법인)로 고용24 에 로그인합니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersisoa_noaccount_link_idmember_type_codebusiness_management_norequest_idempotency_keybusiness_registration_norequired

work24__auth__session__status

고용24 세션 상태 조회

고용24 세션 상태를 확인합니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

work24__subsidy__application__init

고용24 기업지원금 신청 진입

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 조회만 합니다. 고용24 기업지원금 신청 화면에 들어가 그 사업의 사전진단 판정을 확인하고 화면의 입력 항목 구성을 돌려줍니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersprogramme_keyrequiredaccount_link_idbusiness_management_norequest_idempotency_key

work24__subsidy__application__requirements

고용24 기업지원금 신청 필요입력 안내

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. List what the applicant must supply before any write: institution-provided values, customer-required fields, registered payment accounts, and how attachments are procured (the document list itself is issued by draft_validate, keyed by 접수번호). Read-only — call this before workplace_save. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersprogramme_keyrequiredaccount_link_idbusiness_management_norequest_idempotency_key

work24__subsidy__application__workplace_save

고용24 기업지원금 사업장정보 저장

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 고용24 기업지원금 초안에 사업장정보를 저장하고 접수번호를 받습니다. 기관에 저장하는 쓰기입니다. 같은 신청으로 다시 호출하면 초안을 하나 더 만들지 않고 기존 접수번호를 돌려줍니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersmanager_nameapplicant_zipmanager_emailprogramme_keyrequiredmanager_phone1manager_phone2account_link_idmanager_mobile1manager_mobile2application_yearpayment_bank_namepayment_account_no+5 more

work24__subsidy__application__target_init

고용24 기업지원금 대상자정보 단계 진입

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 이미 있는 초안의 대상자정보 단계에 들어가 그 입력 항목 구성을 돌려줍니다. workplace_save 가 준 접수번호(receipt_no)가 필요합니다. 제출은 하지 않습니다. 일부 사업은 화면을 옮길 때 초안이 저장되며, 저장됐는지는 결과의 safety.save_executed 가 알려 줍니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersreceipt_norequiredprogramme_keyrequiredaccount_link_idbusiness_management_norequest_idempotency_key

work24__subsidy__application__draft_validate

고용24 기업지원금 제출 전 확인

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 초안을 실제 화면과 대조해 첨부 서류 목록과 제출할 수 있는지를 돌려줍니다. 제출은 하지 않으며, submit 전에 반드시 거치는 확인입니다. 일부 사업은 화면을 옮길 때 초안이 저장되며, 저장됐는지는 결과의 safety.save_executed 가 알려 줍니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersreceipt_norequiredprogramme_keyrequiredaccount_link_idbusiness_management_norequest_idempotency_key

work24__subsidy__application__submit

고용24 기업지원금 신청 제출

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 고용24 기업지원금 신청을 고용노동부에 제출합니다. 되돌릴 수 없습니다. draft_validate 가 can_submit 을 알린 상태여야 하고, 사용자가 고른 admin_info_sharing_consent 와 사용자가 동의한 뒤에만 보내는 confirm=true 가 필요합니다. confirm 이 없으면 거절되고 아무것도 보내지 않습니다. 이 도구로는 첨부 서류를 올릴 수 없으니 필요한 서류는 고용24 화면에서 먼저 올립니다(빠진 서류는 draft_validate 가 알려 줍니다). 오류 뒤 다시 시도하기 전에 history 를 확인합니다. 이미 접수됐을 수 있습니다. 제출을 되돌리려면 삭제가 아니라 withdraw(반려요청)를 씁니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersconfirmrequiredreceipt_norequiredprogramme_keyrequiredaccount_link_idconfirmation_tokenbusiness_management_noadmin_info_sharing_consentrequired

work24__subsidy__application__withdraw

고용24 기업지원금 신청 철회

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 제출한 고용24 기업지원금 신청을 철회합니다(반려요청). submit 을 되돌리는 방법입니다. 사용자가 동의한 뒤에만 보내는 confirm 이 필요합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersconfirmrequiredreceipt_norequiredprogramme_keyrequiredaccount_link_idconfirmation_tokenbusiness_management_no

work24__subsidy__application__delete

고용24 기업지원금 작성중 초안 삭제

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 아직 제출하지 않은 고용24 기업지원금 초안을 삭제합니다. 사용자가 동의한 뒤에만 보내는 confirm 이 필요합니다. 제출한 신청은 삭제가 아니라 withdraw 로 철회합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersconfirmrequiredreceipt_norequiredprogramme_keyrequiredaccount_link_idconfirmation_tokenbusiness_management_no

work24__subsidy__application__history

고용24 기업지원금 신청 이력 조회

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 조회만 합니다. 이 사업의 지난 고용24 지원금 신청과 처리 상태(작성중, 처리중, 보완요청, 반려, 처리완료 등)를 돌려줍니다. 상태의 기준은 고용24 입니다. 아직 지원하지 않는 사업은 WORK24_SUBSIDY_APPLICATION_HISTORY_NOT_MEASURED 오류로 끝나며, 고용24 화면의 어디에서 확인하는지 알려 줍니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersdate_todate_fromprogramme_keyrequiredoutput_formatsaccount_link_idbusiness_management_norequest_idempotency_key

work24__subsidy__application__modify

고용24 기업지원금 신청 수정

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 이미 제출한 고용24 기업지원금 신청을 제출과 같은 화면에서 수정합니다. 사용자가 고른 admin_info_sharing_consent 와 사용자가 동의한 뒤에만 보내는 confirm=true 가 필요합니다. confirm 이 없으면 거절되고 아무것도 보내지 않습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersconfirmrequiredreceipt_norequiredprogramme_keyrequiredaccount_link_idconfirmation_tokenbusiness_management_noadmin_info_sharing_consentrequired

work24__subsidy__application__target_save

고용24 기업지원금 대상자 저장

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. target_search 가 돌려준 irno 값으로 고른 피보험자를 초안의 지원금 대상자로 지정합니다. 기관에 저장하는 쓰기이며, 초안이 작성중인 동안에는 되돌릴 수 있습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersreceipt_norequiredworker_typerequiredtarget_irnosrequiredprogramme_keyrequiredlabor_contractrequiredaccount_link_idbusiness_management_no

work24__subsidy__application__attachment_delete

고용24 기업지원금 첨부 파일 삭제

REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 고용24 기업지원금 초안에 첨부된 파일 하나를 삭제합니다. 파일은 draft_validate 가 알려 주는 file_id 로 지정합니다. 초안이 작성중일 때만 됩니다. 사용자가 동의한 뒤에만 보내는 confirm 이 필요합니다. 다시 읽은 첨부 목록에 그 파일이 없을 때만 삭제된 것으로 확인합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 confirmation_token 을 더해 다시 호출합니다. 사용자의 동의 없이 토큰을 넣지 않습니다. 인자를 하나라도 바꾸면 토큰은 무효가 됩니다. 그때는 토큰 없이 호출해 새 미리보기를 받습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersconfirmrequiredfile_idrequiredreceipt_norequiredprogramme_keyrequiredaccount_link_idconfirmation_tokenbusiness_management_no

opendata__nts__status

국세청 사업자등록 상태 조회

공공데이터포털에 개방된 국세청 사업자등록 상태(data.go.kr 15081808)를 사업자등록번호(b_no)로 조회합니다. 한 번에 100건까지 넣을 수 있습니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersb_norequiredoutput_formatsrequest_idempotency_key

opendata__nts__validate

국세청 사업자등록 진위 확인

공공데이터포털에 개방된 국세청 사업자등록 진위확인(data.go.kr 15081808)으로 사업자등록 정보가 등록된 내용과 일치하는지 확인합니다. businesses[] 항목마다 b_no, start_dt(YYYYMMDD), p_nm 이 필요합니다. 별도 연동 없이 사용할 수 있습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbusinessesrequiredrequest_idempotency_key

opendata__g2b__sanction

나라장터 부정당업자 제재 조회

공공데이터포털에 개방된 나라장터 부정당업자 제재 정보(data.go.kr 15129466)를 사업자등록번호(bizno)로 조회합니다. 결과가 비어 있으면 이번 조회에서 해당 기록을 찾지 못한 것이고, 제재를 받은 적이 없다는 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbiznorequiredpageNonumOfRowsinqryBgnDtinqryEndDtrequest_idempotency_key

opendata__kiscon__sanction

KISCON 건설업체 공시·행정처분 조회

공공데이터포털에 개방된 KISCON 건설업체 공시(data.go.kr 15061362)를 조회합니다. 원천은 기간(sDate, eDate)으로만 조회할 수 있어, 서버가 그 기간의 공시를 훑어 사업자등록번호(bizno)가 같은 행을 matches 에 돌려줍니다. 공시에 등록번호가 없는 행은 업체명(corp_name)을 넣었을 때 이름이 같은 것을 fallback_candidates 에 담습니다. matches 가 비어 있으면 그 기간에서 찾지 못한 것이고, 처분이 없다는 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbiznorequiredeDaterequiredsDaterequiredmaxPagescorp_namenumOfRowsncrAreaNamencrAreaDetailNamerequest_idempotency_key

opendata__env__waste_sanction

사업장폐기물 행정처분 조회

공공데이터포털에 개방된 사업장폐기물 행정처분 정보(data.go.kr 15156661)를 주기적으로 받아 둔 색인에서 사업자등록번호(bizno)로 조회합니다. 조회할 때 기관에 실시간으로 묻지 않습니다. matches 가 비어 있으면 조회 시점에 유효한 처분 기록을 찾지 못한 것이고, 처분이 없다는 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersbiznorequiredoutput_formatsrequest_idempotency_key

opendata__fsc__corp_outline

기업개요 조회

공공데이터포털에 개방된 법인 기업개요(data.go.kr 15043184)를 조회합니다. 상호(corpNm) 또는 법인등록번호(crno) 또는 사업자등록번호(bizno) 가운데 하나 이상을 주면 법인명, 사업자등록번호, 법인등록번호, 설립일자, 업종, 소재지, 종업원 수, 결산 월, 상장 시장 등을 돌려줍니다. 한 법인의 행이 여럿이면 개방 시점이 다른 기록이고 current 가 가장 최근 것입니다. 개인사업자는 이 자료에 없습니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParameterscrnobiznocorpNmpageNonumOfRowsoutput_formatsrequest_idempotency_key

opendata__comwel__workplace

고용보험 및 산재보험 가입 사업장 조회

공공데이터포털에 개방된 고용보험과 산재보험 가입 사업장 정보(data.go.kr 15059256)를 사업자등록번호로 조회합니다. 사업장명, 보험 구분, 보험가입구분, 성립일자, 상시인원, 업종, 우편번호, 주소를 사업장(적용 단위)마다 한 행으로 돌려주고 summary 에 보험별 사업장 수와 상시인원 합계를 담습니다. 결과가 비어 있어도 미가입 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbiznorequiredpageNoinsurancenumOfRowsoutput_formatsrequest_idempotency_key

opendata__nps__workplace

국민연금 가입 사업장 조회

공공데이터포털에 개방된 국민연금 가입 사업장 정보(data.go.kr 3046071)를 사업자등록번호와 상호로 조회합니다. 원천이 사업자등록번호를 앞 6자리만 제공하므로 candidates 에는 같은 앞자리의 다른 사업장이 섞일 수 있고, 상호가 정확히 일치하는 사업장만 matched 에 가입자수, 당월고지금액, 사업장등록일, 탈퇴일, 업종을 함께 돌려줍니다. 가입자 3인 이상 법인과 10인 이상 개인사업장만 개방되어 빈 결과가 미가입을 뜻하지는 않습니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbiznorequiredpageNowkplNmnumOfRowsoutput_formatsrequest_idempotency_key

opendata__fsc__financials

재무 요약 조회

공공데이터포털에 개방된 법인 요약재무제표(data.go.kr 15043459)를 법인등록번호로 조회합니다. 사업연도마다 별도와 연결 재무제표 행이 따로 오며 매출액, 영업이익, 당기순이익, 총자산, 총부채, 총자본, 자본금, 부채비율을 statements 에, 가장 최근 사업연도의 행을 latest 에 돌려줍니다. 사업자등록번호만 주면 법인등록번호를 찾아 조회하고 개인사업자이면 빈 결과에 그 사유를 담습니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParameterscrnobiznopageNobizYearnumOfRowsoutput_formatsrequest_idempotency_key

opendata__bld__register

사업장 건물 조회

공공데이터포털에 개방된 건축물대장 표제부(data.go.kr 15134735)를 주소로 조회합니다. 주소를 도로명주소 검색으로 지번에 맞춘 뒤 그 지번의 건물(동)마다 건물명, 주용도, 구조, 연면적, 층수, 사용승인일, 승강기 수, 내진설계 여부 등을 buildings 에 돌려주고, 찾은 주소 후보는 address 에, 대표 건물은 primary 에 담습니다. 사업자등록번호만 주면 등록된 소재지를 찾아 조회합니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbiznopageNoaddressnumOfRowsoutput_formatsrequest_idempotency_key

opendata__nrg__trades

사업장 건물 실거래 조회

공공데이터포털에 개방된 상업업무용 부동산 매매 실거래가(data.go.kr 15126463)를 주소로 조회합니다. 주소를 도로명주소 검색으로 지번에 맞춘 뒤 미리 받아 둔 자료에서 같은 지번의 거래(계약일, 거래금액, 건물 주용도, 면적, 층, 거래유형, 해제 여부)를 trades 에 돌려주고, 받아 둔 달과 빠진 달은 coverage 에, 찾은 주소 후보는 address 에 담습니다. 기간은 endYm(기본 이번 달)부터 months(기본 12개월)만큼이며, 그 시군구의 요청 기간을 아직 받아 두지 않았으면 지금 조회 불가로 답합니다. 사업자등록번호만 주면 등록된 소재지를 찾아 조회합니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbiznoendYmmonthsaddressoutput_formatsrequest_idempotency_key

opendata__smes__notices

지원사업 공고 조회

공공데이터포털에 개방된 중소기업 지원사업 공고(data.go.kr 15157820)를 분야와 해시태그로 골라 조회합니다. 공고마다 공고명, 소관기관, 지원분야, 신청기간, 지원대상, 사업개요, 신청방법, 문의처를 원문 그대로 notices 에 돌려주고 원문 링크(pblancUrl)와 출처 줄을 붙입니다. 요약이나 점수는 만들지 않습니다. 전체 건수는 total_count 에, 더 있으면 truncated 가 참이고 pageNo 로 다음 쪽을 조회합니다. 별도 연동 없이 사용할 수 있습니다. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersfieldpageNohashtagsnoticeIdnumOfRowsoutput_formatsrequest_idempotency_key

opendata__ftc__mail_order

통신판매 사업자 조회

공공데이터포털에 개방된 통신판매사업자 등록현황(data.go.kr 15126311)을 상호 또는 사업자등록번호로 조회합니다. 상호(bzmnNm)로 검색하면 온라인 판매를 신고한 사업자를 찾아 사업자등록번호를 함께 돌려주어 다른 조회로 이어 갈 수 있습니다. 전체 건수는 total_count 에 담고, 결과가 비어 있어도 그 상호의 사업자가 없다는 뜻은 아닙니다. 통신판매를 신고하지 않은 사업자와 오프라인 사업자는 이 자료에 없을 수 있습니다. 별도 연동 없이 사용할 수 있습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

ParametersbrnobzmnNmpageNonumOfRowsrequest_idempotency_key

payroll_artifact__register_xlsx

급여대장 엑셀 생성

Build a standard payroll register workbook (xlsx) from attribution_ym and employees[] (tax/deduction amounts already computed). Platform key only — no account_link_id. Result: a summary in data (attribution_ym, employee_count) and the workbook in artifacts[] with a signed download_url (not composite merge). Files: a document generated from this result, as Excel (xlsx), listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersemployeesrequiredcompany_nameattribution_ymrequiredworkplace_nameworkplace_addressrequest_idempotency_keybusiness_registration_no

shinhan_easy__auth__id_password_session__login

신한은행 간편조회 로그인

Call this FIRST before any other tool for this provider. Create a Shinhan easy-inquiry session from a registered ID/password account link. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 사업자 유형: 개인사업자 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_idrequest_idempotency_key

payroll_artifact__payslip_xlsx

급여명세서 엑셀 생성

Build one payroll payslip workbook (xlsx) with one sheet per employee from attribution_ym, payment_date, and employees[]. Platform key only — no account_link_id. Result: a summary in data (attribution_ym, employee_count) and one workbook in artifacts[] with a signed download_url (not composite merge; not Gmail). Files: a document generated from this result, as Excel (xlsx), listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the job_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersemployeesrequiredcompany_namepayment_daterequiredattribution_ymrequiredworkplace_namerequiredworkplace_addressrequiredrequest_idempotency_keybusiness_registration_norequired

shinhan_easy__accounts__list

신한은행 계좌 목록 조회

REQUIRES prior shinhan_easy__auth__id_password_session__login call with same account_link_id. List Shinhan easy-inquiry accounts for a registered account link. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 사업자 유형: 개인사업자 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersinclude_rawaccount_link_idrequest_idempotency_key

shinhan_easy__linked_accounts__list

신한은행 연동 계좌 목록

No credential or login required. List the Shinhan Bank account links this caller registered, each with the account_link_id and bank_account_credential_id the accounts and transaction history tools need. Reads our records only; shinhan_easy.accounts.list fetches live accounts from the bank. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 사업자 유형: 개인사업자 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersrequest_idempotency_key

kb_biz_card__session__login

KB국민카드 기업 로그인

Call this FIRST before any other tool for this provider. 등록한 연동의 인증서로 KB국민카드 기업 세션을 만듭니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersauth_provideraccount_link_idrequest_idempotency_key

kb_biz_card__common__departments__select

KB국민카드 부서 선택

REQUIRES prior kb_biz_card__session__login call with same account_link_id. 지금 세션에서 고를 수 있는 부서 목록을 돌려줍니다. department_name 을 넣으면 그 이름으로 부서를 찾습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_iddepartment_namerequest_idempotency_key

kb_biz_card__common__cards__select

KB국민카드 카드 선택

REQUIRES prior kb_biz_card__session__login call with same account_link_id. 지금 세션에서 고를 수 있는 카드 목록을 돌려줍니다. 부서(department_sequence_no, department_name)를 넣어 그 부서의 카드를 조회할 수 있습니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersaccount_link_iddepartment_namedepartment_sequence_norequest_idempotency_key

kb_biz_card__approvals__init

KB국민카드 승인내역 초기화

REQUIRES prior kb_biz_card__session__login call with same account_link_id. 승인내역 조회를 준비합니다. 고를 수 있는 부서와 카드 목록, 검색에 쓸 기본값(default_search_params)을 돌려줍니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Parametersdate_todate_fromaccount_link_idrequest_idempotency_key

Version history

1
  1. v1.0.0LatestNov 14, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Xdata integrations