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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數end_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數adrOpYnamtOpYnresnoOpYncerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數endMmstrtMmadrOpYnamtOpYncerEndYrcerStrtYrresnoOpYncerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數endYm必填strtYm必填adrOpYnresnoOpYncerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數adrOpYnamtOpYnresnoOpYncerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數adrOpYnamtOpYnresnoOpYnsfbTermEndDtcerpIsnRqsQtysfbTermStrtDtaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bsno必填txyrqrtTrt必填adrOpYnamtOpYnincClCdbsyrEndYmresnoOpYncerpIsnRqsQtyaccount_link_idcvaDcumGranMthdCdconfirmation_token另有 1 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數adrOpYnamtOpYnresnoOpYncerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數adrOpYnresnoOpYncerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數adrOpYnresnoOpYntxnrmEndYm必填txnrmStrtYm必填cerpIsnRqsQtyaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數yearmonthquarterend_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_date必填page_numfrom_date必填page_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數dt_clpage_numpage_sizewrt_ym_end必填wrt_ym_strt必填etxiv_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數etan必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數splr_tindmnr_bsno必填item_name必填bill_method必填splr_mpb_nosupply_date必填etxiv_knd_cdetxiv_clsf_cditem_quantity必填account_link_iditem_unit_price必填confirmation_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數old_aprv_no必填supply_date必填etxiv_knd_cdaccount_link_idetxiv_mdf_rsn_cd必填confirmation_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數txpr_dscm_no必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數output_formatsaccount_link_idrequest_idempotency_key
hometax__tax__my_tax_agent__search
나의세무대리인 조회
REQUIRES prior hometax__session__login call with same account_link_id. Search assigned tax agent 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_numoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數rtn_dt_end必填rtn_dt_srt必填output_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數end_dt必填strt_dt必填txaa_idtxaa_ynpage_numpage_sizeinqr_cl_cdtxpr_dscm_nooutput_formatsaccount_link_idrequest_idempotency_key
hometax__tax__unclaimed_refund__search
미수령 환급금 조회
REQUIRES prior hometax__session__login call with same account_link_id. Search unclaimed tax refunds (최근 5년간 미수령 국세환급금). Both txpr_dscm_no and txpr_nm are required by 국세청 — the session TIN does not substitute for them. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數nnf_cltxpr_nm必填txpr_dscm_no必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數end_dt必填strt_dt必填page_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數end_dtstrt_dtpage_numsurv_ttlpage_sizentpl_crp_cl_cdoutput_formatsaccount_link_idrequest_idempotency_key
hometax__tax__payment_statement__search
납부 내역 조회
REQUIRES prior hometax__session__login call with same account_link_id. Search tax payment statement. mate_knd_cd: document type code. sbms_ym_strt/sbms_ym_end: submission year-month 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數attr_yrrcat_nobman_bsnomate_knd_cd必填sbms_ym_end必填txtn_ym_endsbms_ym_strt必填txtn_ym_strtaccount_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_numpage_sizemate_knd_cdsbms_ym_end必填txtn_ym_endsbms_ym_strt必填txpr_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數srt_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bsno必填qrt_to必填stl_yr必填page_numqrt_from必填page_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_date必填page_numfrom_date必填max_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數qrtcmtt_yr必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_date必填page_numfrom_date必填max_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數tiptotaTrsAmt必填cshptUsgClCd必填spstCnfrClCd必填cshptTrsTypeCd必填account_link_idcshptIsnMmoCntnspstCnfrNoEncCntn必填confirmation_token
hometax__cash_receipt__daily_issue__search
일일 현금영수증 발행 내역 조회
REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt issuance records for a single day (당일 발급 조회). trs_dt is optional; omitting it means today. The adapter documents this endpoint as same-day only, so other dates are not a supported lookup. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數trs_dtpage_numpage_sizeaccount_link_idrequest_idempotency_key
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數tiptrs_dtaprv_no必填rcpr_tintrs_timetota_trs_amt必填account_link_idcshpt_usg_cl_cdspst_cnfr_cl_cdcshpt_trs_type_cdconfirmation_tokencshpt_isn_mmo_cntn另有 1 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數tiptrs_dtaprv_no必填spl_cftrcpr_tintrs_timeva_txamttota_trs_amtaccount_link_idcshpt_usg_cl_cdspst_cnfr_cl_cdcshpt_cncl_rsn_cd必填另有 3 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bsnotxyrendYmqrtTrtstrtYmadrOpYnamtOpYnincClCdbsyrEndYmresnoOpYntxnrmEndYmtxnrmStrtYm另有 6 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bsnotxyrendYmqrtTrtstrtYmadrOpYnamtOpYnincClCdbsyrEndYmresnoOpYntxnrmEndYmtxnrmStrtYm另有 7 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數cva_id必填end_dtrcat_no必填strt_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_dateform_namefrom_dategoji_roundrow_indexes必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數gubunykihoto_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數yearissue_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_link_idrequest_idempotency_key
nhis_edi__hr_payroll__premium_notices__search
건강보험 고지 내역 조회
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_datefrom_dategoji_roundaccount_link_idnotice_year_monthrow_text_containscell_text_containsrequest_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數unb_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數doc_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數unb_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數unb_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數to_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數pagerequest_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數pagerequest_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_link_idbusiness_management_no必填request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_link_idrequest_idempotency_key
nps_edi__b1__declarations__processing_results__search
신고 처리 결과 조회 (국민연금)
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Search declaration processing results from NPS. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_noend_datestart_datedocument_nostatus_codetemplate_codeoutput_formatspage_per_countaccount_link_idrow_text_containsrequest_idempotency_key
nps_edi__b1__certificates__application_results__search
증명서 신청 처리결과 검색
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Search NPS certificate application and issuance 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_noend_datestart_datemember_nametemplate_codepage_per_countaccount_link_idrow_text_containsconfirm_status_codeprocessing_status_coderequest_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_keyrow_indexreceipt_nodocument_norun_prechecktemplate_codeaccount_link_idrow_text_containsrequest_idempotency_keyinclude_ec15_report_rows
nps_edi__b1__certificates__membership__subscribers__search
가입증명 발급 대상자 조회
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Search workplace subscribers eligible for the NPS membership certificate (EC02) by name. Returns row_index/row_key per subscriber for the issue tool; never returns resident numbers. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_nosearch_textpage_per_countaccount_link_idrequest_idempotency_key
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數subscribers必填account_link_idconfirmation_token
nps_edi__b1__pension_notification_documents__search
연금통지서 목록 조회
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Search pension notification documents. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_noend_datestart_datemember_nametemplate_codeoutput_formatspage_per_countaccount_link_idread_status_coderow_text_containsmember_resident_norequest_idempotency_key
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 로 호출하세요. 이 기본 호출은 순수 읽기 전용이 아닙니다.
輸入參數page_norow_keyrow_indexreceipt_nodocument_nomember_namemark_as_readinclude_guidetemplate_codepage_per_countaccount_link_idsearch_type_code另有 4 個
nps_edi__b1__pension_notices__search
연금보험료 고지 목록 조회
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Search pension premium 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_noend_datestart_datetemplate_codepage_per_countaccount_link_idinstallment_roundnotice_year_monthrow_text_containsrequest_idempotency_key
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數row_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_link_idrequest_idempotency_key
nps_edi__b1__lookups__workplace_premium_notices__search
사업장 연금 과오납금 조회
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Look up workplace pension premium overpayments. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數end_year_monthaccount_link_idstart_year_monthdecision_year_monthrequest_idempotency_key
nps_edi__b1__lookups__pension_support_recovery_decisions__search
연금 지원환수 결정 조회
REQUIRES prior nps_edi__auth__npki_session__login call with same account_link_id. Search pension support recovery decisions. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_link_idrequest_idempotency_keyrecovery_decision_year_month
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數auth_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數cvrc_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bpmnorrno_backrrno_frontapplicant_name必填account_link_iddeclaration_apply_daterequest_idempotency_keyresident_registration_number必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數flag必填bpmnorrkey必填check_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數rrkey必填confirmdry_runapplicant_name必填account_link_idcommon_loss_date必填health_insurance必填national_pension必填employment_insurance必填workers_compensation必填current_year_salary_amount必填health_insurance_month_count必填另有 1 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數applicant_name必填account_link_idrequest_idempotency_keyresident_registration_number必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數up_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數rrkey必填confirmdry_runapplicant_name必填account_link_idhealth_insurance必填epi_occupation_code必填epi_occupation_name必填common_monthly_amount必填common_acquisition_date必填resident_registration_number必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數com_cd_clsf_id必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數dry_runselection必填phone_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數cvrc_no必填group_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數cvrc_no必填group_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數cvrc_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bpmnoissu_no必填idnty_nmfrnt_rrnojoin_kind_cd必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數sins_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數srch_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數qstn_sn必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數srch_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數pst_sn必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數pst_sn必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數srch_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bbs_id必填pst_sn必填request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bbs_id必填pst_sn必填atfl_id必填current_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數atfl_id必填dry_runatch_file_sn必填account_link_idrequest_idempotency_key
hometax__tax__return_history__search
세금 신고내역 조회
REQUIRES prior hometax__session__login call with same account_link_id. 신고일자 기간으로 세금 신고내역을 조회합니다. rtn_dt_srt 와 rtn_dt_end 는 YYYYMMDD 이고 기간은 최대 6년입니다. tax_kind 로 세목을 고르고(기본 all 은 홈택스 신고내역 전체 목록, vat 는 부가가치세, corporate 는 법인세), rows 는 page_num 과 page_size 로 나눠 받으며 total_count 가 전체 건수입니다. 부가가치세와 법인세 신고 행에만 return_document_ref 가 있고, 이 값을 hometax__tax__return_document__detail 이나 hometax__tax__return_document__pdf 에 넘기면 그 신고서를 엽니다. 경정청구 내역은 기본으로 함께 조회합니다(include_correction_claims). 신고서를 열 수 있는 경정청구 건은 claims_documents 에 return_document_ref 와 함께 오고, 목록에서만 보이는 건은 claims 에 옵니다. 그 구분은 claims_detail_availability 가 알려 줍니다. 조회만 하고 기관에 아무것도 바꾸지 않습니다. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數page_numtax_kindpage_sizertn_dt_end必填rtn_dt_srt必填output_formatsaccount_link_idrequest_idempotency_keyinclude_correction_claims
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數form_codesoutput_formatsaccount_link_idreturn_document_ref必填request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數form_codesaccount_link_idreturn_document_ref必填request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數auth_provideraccount_link_idrequest_idempotency_keybusiness_registration_no必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數isoa_noaccount_link_idmember_type_codebusiness_management_norequest_idempotency_keybusiness_registration_no必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_link_idrequest_idempotency_key
work24__subsidy__diagnosis__search
고용24 기업지원금 사전진단 조회
REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 조회만 합니다. 사업장 하나에 대해 고용24 사업주 사전진단을 실행하고 지원금 사업마다 판정(eligible, ineligible, undetermined)을 돌려줍니다. undetermined 는 대상으로 세지 않습니다. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數output_formatsprogramme_keysaccount_link_idapplication_yearbusiness_management_norequest_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數manager_nameapplicant_zipmanager_emailprogramme_key必填manager_phone1manager_phone2account_link_idmanager_mobile1manager_mobile2application_yearpayment_bank_namepayment_account_no另有 5 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數receipt_no必填programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數receipt_no必填programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數confirm必填receipt_no必填programme_key必填account_link_idconfirmation_tokenbusiness_management_noadmin_info_sharing_consent必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數confirm必填receipt_no必填programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數confirm必填receipt_no必填programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數date_todate_fromprogramme_key必填output_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數confirm必填receipt_no必填programme_key必填account_link_idconfirmation_tokenbusiness_management_noadmin_info_sharing_consent必填
work24__subsidy__application__target_search
고용24 기업지원금 대상자 후보 조회
REQUIRES prior work24__auth__npki_session__login call with same account_link_id. 지원금 대상자로 지정할 수 있는 사업장 고용보험 피보험자 목록을 돌려줍니다. 대상자는 이 목록에서 고르고 새로 만들지 않으므로 주민등록번호를 넣지 않습니다. 제출은 하지 않습니다. 일부 사업은 화면을 옮길 때 초안이 저장되며, 저장됐는지는 결과의 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數pagequerypage_sizereceipt_no必填programme_key必填account_link_idbusiness_management_norequest_idempotency_key
work24__subsidy__application__target_save
고용24 기업지원금 대상자 저장
REQUIRES prior work24__auth__npki_session__login call with same account_link_id. target_search 가 돌려준 irno 값으로 고른 피보험자를 초안의 지원금 대상자로 지정합니다. 기관에 저장하는 쓰기이며, 초안이 작성중인 동안에는 되돌릴 수 있습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數receipt_no必填worker_type必填target_irnos必填programme_key必填labor_contract必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數confirm必填file_id必填receipt_no必填programme_key必填account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數b_no必填output_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數businesses必填request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bizno必填pageNonumOfRowsinqryBgnDtinqryEndDtrequest_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bizno必填eDate必填sDate必填maxPagescorp_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bizno必填output_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數crnobiznocorpNmpageNonumOfRowsoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bizno必填pageNoinsurancenumOfRowsoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數bizno必填pageNowkplNmnumOfRowsoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數crnobiznopageNobizYearnumOfRowsoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數biznopageNoaddressnumOfRowsoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數biznoendYmmonthsaddressoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數fieldpageNohashtagsnoticeIdnumOfRowsoutput_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數brnobzmnNmpageNonumOfRowsrequest_idempotency_key
opendata__comwel__name_search
상호로 사업자 찾기
공공데이터포털에 개방된 고용보험과 산재보험 가입 사업장 정보(data.go.kr 15059256)를 주기적으로 받아 둔 색인에서 상호로 사업자를 찾아 사업자등록번호, 사업장명, 주소, 성립일을 돌려줍니다. 법인과 개인사업자가 함께 오르고, 상호가 그것으로 시작하는 사업장이 먼저 옵니다. 돌려받은 사업자등록번호로 다른 조회를 이어 갈 수 있습니다. 직원 없이 혼자 운영해 보험에 가입하지 않은 사업자는 없을 수 있어, 결과가 비어 있어도 그 상호의 사업자가 없다는 뜻은 아닙니다. 별도 연동 없이 사용할 수 있습니다. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數limitbusinessName必填request_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數employees必填company_nameattribution_ym必填workplace_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數employees必填company_namepayment_date必填attribution_ym必填workplace_name必填workplace_address必填request_idempotency_keybusiness_registration_no必填
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數include_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數request_idempotency_key
shinhan_easy__accounts__transaction_history__search
신한은행 거래내역 조회
REQUIRES prior shinhan_easy__auth__id_password_session__login call with same account_link_id. Search Shinhan easy-inquiry transaction history for one account. 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. Send exactly one of bank_account_credential_id (one account), bank_account_credential_ids (several accounts) or all_accounts (every account). 계좌마다 사용 토큰이 하나씩 듭니다. 기업정보 브리프처럼 한 번에 여러 사용 토큰을 쓰는 업무는 그 값만큼 계좌마다 듭니다. 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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數end_date必填max_pagessort_orderstart_date必填employee_yninclude_rawall_accountsbusiness_typeoutput_formatsaccount_link_idrequest_idempotency_keybank_account_credential_id另有 1 個
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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數auth_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數account_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 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
輸入參數date_todate_fromaccount_link_idrequest_idempotency_key