Toolpin Monitor a server

XBOSS

kr.xdata/xboss-mcp · v1.0.2 · MCP 2025-11-25

국세, 4대보험, 세금계산서, 급여 데이터를 MCP 도구로 제공하는 XBOSS 공식 서버. 무료 요금제, 카드 등록 없음.

Reachability reachable
checked 2026-11-21 05:37 UTC
Registry status active
Tools pinned 405
8443f580b2e2
Tools last changed 2026-11-21

Provenance

Registry namespace kr.xdata (domain verified by the official registry)
Website https://xboss.biz
Remote endpoints
https://api.xdata.kr/mcp (streamable-http)

Observed changes

When (UTC)EventDetail
2026-11-21 05:37 tools changed 2 added, 0 removed, 29 changed
2026-11-20 05:35 tools changed 2 added, 0 removed, 25 changed
2026-11-19 05:34 tools changed 0 added, 0 removed, 16 changed
2026-11-18 05:34 tools changed 0 added, 0 removed, 138 changed
2026-11-17 05:32 tools changed 2 added, 0 removed, 357 changed
2026-11-16 05:31 tools changed 1 added, 0 removed, 205 changed
2026-11-15 05:30 first capture 398 tools pinned

Pinned tool definitions (405)

ToolDescription
hometax__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 공동인증서로 홈택스에 로그인하고, 이후 도구가 함께 쓰는 세션을 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택...
hometax__session__user_info 로그인한 사용자의 정보를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은...
hometax__certificate__list 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 이미 신청한 민원증명 발급 목록을 접수 식별값(cvaId, rcatNo)과 함께 조회합니다. 조회만 합니다. strt_dt/end_dt 가 없으면 최근 3일 것만 오므로, 결과가 비어도 증명서가 없다는 뜻이 아닙니다. 더 이전 것은 기간을 넓혀 조회합니다. 두 날짜는 함께 넣거나 함께 뺍니다. 한 번에 최대 한...
hometax__certificate__apply__national_tax_payment 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 국세완납증명(Tax Clearance Certificate) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
hometax__certificate__apply__tax_payment_record 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 납세사실증명(Certificate of Tax Payment) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
hometax__certificate__apply__vat_standard 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 부가가치세과세표준증명(Certificate of VAT Tax Base) 신청을 기관에 접수합니다. 사업자 계정으로만 신청할 수 있습니다. 개인 계정으로 연결돼 있으면 신청을 접수하기 전에 거절합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는...
hometax__certificate__apply__business_registration 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 사업자등록증명(Certificate of Business Registration) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
hometax__certificate__apply__business_suspension 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 휴업사실증명(Certificate of Business Suspension) 신청을 연결된 사업자 계정 본인 명의로 기관에 접수합니다. 기관에 휴업 기간이 등록된 사업자만 신청할 수 있습니다. 휴업 이력을 먼저 조회하고, 이력이 없으면 신청을 접수하기 전에 거절합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수...
hometax__certificate__apply__financial_statement 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 표준재무제표증명(Certificate of Standard Financial Statements) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와...
hometax__certificate__apply__business_closure 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 폐업사실증명(Certificate of Business Closure) 신청을 연결된 사업자 계정 본인 명의로 기관에 접수합니다. 기관에 이미 폐업으로 등록된 사업자만 신청할 수 있습니다. 폐업 기록을 먼저 조회하고, 계속 사업 중이면 신청을 접수하기 전에 거절합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수...
hometax__certificate__apply__business_registration_reissue 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 사업자등록증 재발급(Business Registration Certificate Reissuance) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의...
hometax__certificate__apply__income_statement 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 소득금액증명(Certificate of Income) 신청을 기관에 접수합니다. 개인과 개인사업자만 신청할 수 있습니다. 법인은 신청할 수 없으며 기관 화면이 거절합니다. 개인사업자는 추후 지원 예정입니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이...
hometax__etax__invoice__search_summary 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 전자세금계산서 합계를 조회합니다. 날짜 방식은 하나만 고릅니다. (1) 일별: date_type='01' 과 start_date, end_date(YYYYMMDD). (2) 월별: date_type='02' 와 `year`, `month`. (3) 분기별: date_type='03' 과 `year`, `quarter`....
hometax__etax__invoice__search_list 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기간으로 전자세금계산서를 조회합니다. from_date/to_date 는 YYYYMMDD 또는 YYYY-MM-DD 형식입니다. prh_sls_cl_cd 는 '01' 이 발급한 것(매출), '02' 가 받은 것(매입)입니다. 기관은 긴 기간을 '6개월이상은 조회할 수 없습니다.' 로 거절하므로 6개월 미만으로 잡고, 더...
hometax__etax__invoice__search_statistics 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 전자세금계산서 통계를 월, 분기, 연 단위로 조회합니다. wrt_ym_strt/wrt_ym_end 는 YYYYMM 형식입니다(예: 2025년 7월부터 9월까지는 202507/202509). 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을...
hometax__etax__invoice__search_detail 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 승인번호(etan)로 전자세금계산서 한 건의 상세 정보를 조회합니다. etan 은 hometax__etax__invoice__search_list 결과에서 얻습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
hometax__etax__invoice__issue 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 전자세금계산서를 발급합니다. 되돌릴 수 없습니다. 발급하면 공급받는자에게 통지되고 부가가치세 신고 자료에 들어갑니다. 고치려면 수정세금계산서를 발급해야 하며, 이 서비스의 수정발급 도구는 원본 전체를 취소하는 수정세금계산서(사유 04, 06)만 발급합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고,...
hometax__etax__invoice__modify 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 이미 발급한 전자세금계산서에 대해 수정세금계산서를 발급합니다. 발급과 같이 되돌릴 수 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를...
hometax__tax__business_registration__search_status 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 사업자등록번호로 사업자등록 상태를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이...
hometax__tax__business_registration__search_info 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 사업자등록 상세 정보를 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의 job_id 로...
hometax__tax__my_tax_agent__search 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 지정된 세무대리인 정보를 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의 job_id 로...
hometax__tax__return_history__search_vat 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 부가가치세 신고 이력을 조회합니다. rtn_dt_srt/rtn_dt_end 는 YYYYMMDD 형식입니다. 2015-02-23 이전 날짜는 거절되며('2015년 2월 23일 이후 신고내역만 조회 가능합니다.'), 기관 화면은 최대 조회 기간을 1년으로 적고 있으므로 더 긴 기간은 여러 번 나눠 호출합니다. 파일:...
hometax__tax__payment_due__search_or_pay 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 납부기한별로 납부할 세액을 조회합니다. 조회만 하며 이 도구는 납부를 실행하지 않습니다. 이름의 'or_pay' 는 예전 이름이 남은 것입니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기...
hometax__tax__electronic_notice__check_status 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 전자고지 수신 상태를 확인합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를...
hometax__tax__refund__search_detail 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 환급금 상세 내역을 조회합니다. strt_dt/end_dt 는 YYYYMMDD 형식입니다. 기관은 오늘 기준 최근 5년 자료만 제공합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기...
hometax__tax__unclaimed_refund__search 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 최근 5년간 미수령 국세환급금을 조회합니다. 기관은 txpr_dscm_no 와 txpr_nm 을 둘 다 요구하며, 로그인 세션의 납세자 번호로 대신할 수 없습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
hometax__tax__notice__search_history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 고지 내역을 조회합니다. strt_dt/end_dt 는 YYYYMMDD 형식입니다. 기관은 시작일이 최근 10년 안인 조회만 받습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기...
hometax__tax__overdue__search_history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 체납 내역을 조회합니다. strt_dt/end_dt 로 기간을 좁히며, 넣지 않으면 기관의 기본 기간이 적용됩니다. page_size 를 올리지 않으면 한 쪽에 3건만 옵니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에...
hometax__tax__payment_statement__search 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 지급명세서 자료를 조회합니다. mate_knd_cd 는 자료 종류 코드이고, sbms_ym_strt/sbms_ym_end 는 제출 연월(YYYYMM)입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그...
hometax__tax__payment_statement__search_submit_history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 일용근로소득 지급명세서, 간이지급명세서 같은 지급명세서의 제출 내역을 제출 여부와 연월까지 조회합니다. sbms_ym_strt/sbms_ym_end 는 YYYYMM 형식입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만...
hometax__tax__trade_partner__search_list 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 고객이 관리용으로 등록한 거래처 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정...
hometax__tax__credit_card__search_sales_data 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 신용카드 매출자료를 조회합니다. bsno 는 사업자등록번호, stl_yr 는 연도(YYYY), qrt_from/qrt_to 는 분기(1부터 4)입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을...
hometax__cash_receipt__sales__search_history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 현금영수증 매출 내역을 조회합니다. from_date/to_date 는 필수입니다(YYYYMMDD 또는 YYYY-MM-DD). 건수: totalCount(pageInfoVO.totalCount 도 같은 값)는 이 조회의 전체 건수이며 이 응답의 행 수보다 적지 않습니다. collectionMeta 는 이 응답이 이미...
hometax__cash_receipt__sales__search_summary 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 현금영수증 매출의 연간 합계를 조회합니다. cmtt_yr 에 대상 연도를 넣고, 분기별로 보려면 qrt(1부터 4)를 함께 넣습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
hometax__cash_receipt__purchase__search_history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 현금영수증 매입 내역을 조회합니다. from_date/to_date 는 필수입니다 (YYYYMMDD 또는 YYYY-MM-DD). 기관은 3개월보다 긴 기간을 '조회기간은 최대 3개월 까지 가능합니다.' 로 거절하므로, 더 긴 기간은 3개월씩 나눠 호출합니다. 건수:...
hometax__cash_receipt__issue_individual 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 현금영수증 한 건을 발급합니다. 소비자의 소득공제용 또는 사업자의 지출증빙용(예: 사업자등록번호로 발급)으로 발급합니다. 발급하면 기관의 원장이 바로 바뀌고 받는 쪽의 소득공제와 지출증빙 자료에 반영됩니다. 취소는 발급한 당일에만 할 수 있고, 날짜가 바뀌면 이 도구로 되돌릴 수 없습니다. 이 도구는 기관의 기록을...
hometax__cash_receipt__daily_issue__search 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 하루치 현금영수증 발급 내역을 조회합니다(당일 발급 조회). trs_dt 는 선택이며, 넣지 않으면 오늘입니다. 이 조회는 당일 자료만 지원하므로 다른 날짜는 조회하지 않습니다. 건수: totalCount(pageInfoVO.totalCount 도 같은 값)는 이 조회의 전체 건수이며 이 응답의 행 수보다 적지...
hometax__cash_receipt__daily_issue__modify 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 오늘 발급한 현금영수증을 수정합니다. aprv_no 는 hometax__cash_receipt__daily_issue__search 에서 얻습니다. 보낸 칸은 그 값으로 전송합니다. 다만 바꾼 용도, 거래유형, 발급수단을 기관이 반영하는지는 보장되지 않습니다(발급수단 변경 표시는 항상 N 으로 전송합니다). 보내지 않은...
hometax__cash_receipt__daily_issue__cancel 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 오늘 발급한 현금영수증을 취소합니다. aprv_no 와 cshpt_cncl_rsn_cd 만 있으면 됩니다. 나머지 칸은 보내지 않으면 오늘 발급한 원본의 값으로 전송합니다(aprv_no 는 hometax__cash_receipt__daily_issue__search 에서 얻습니다). 이 도구는 기관의 기록을 바꿉니다....
hometax__certificate__apply_with_template 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 지정한 서식으로 증명서 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
hometax__certificate__list_templates 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 신청할 수 있는 증명서 서식 9종의 목록을 돌려줍니다. cert_template 에는 여기서 돌려준 slug 만 넣을 수 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
hometax__certificate__apply_auto 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 로그인한 납세자 본인의 정보로 증명서 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
hometax__certificate__download 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 발급된 증명서를 PDF 로 내려받습니다. 결과의 data 에는 발급 식별값(cva_id, rcat_no)이, artifacts[] 에는 PDF 와 서명된 내려받기 주소(download_url)가 담깁니다. 되돌릴 수 없습니다. 기관에서는 이것이 출력이라 출력할 때마다 신청한 발급 매수(발급 한도) 1매를 쓰고, 다 쓰면...
hometax__certificate__apply_auto_download 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기본 발급 옵션으로 국세완납증명(Tax Clearance Certificate) 신청을 기관에 접수하고, 발급된 PDF 를 한 번에 내려받습니다. 신청이 먼저 접수되므로 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구에서는 서식과 발급 옵션을 바꿀 수 없습니다(옵션을 정하려면...
hometax__etax__business_info__get 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 전자세금계산서 발행에 쓰는 사업자 정보를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정...
hometax__etax__client_info__get 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 전자세금계산서 발행에 쓰는 거래처 정보를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정...
nhis_edi__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 등록한 공동인증서로 건강보험 EDI에 로그인해 세션을 만들고, 로그인 성공 여부와 이번에 쓴 연동 계정 ID를 돌려줍니다. 로그인이 필요한 건강보험 EDI 조회보다 먼저 부릅니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는...
nhis_edi__session__status 연동 계정을 넣으면 저장된 건강보험 EDI 세션에 접속 정보가 모두 있는지와 로그인 확인 결과를 읽어 인증 여부와 업무 화면 준비 기록을 돌려줍니다. 기관 화면은 열지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면...
nhis_edi__hr_payroll__received_documents__options 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 기간이나 고지 연월을 넣으면 수신문서 목록의 행마다 행 번호, 문서 이름, 고지 연월과 차수, 작성 차수를 받습니다. 문서 안쪽은 열지 않고 행 정보만 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
nhis_edi__hr_payroll__received_documents__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 수신문서 목록에서 고른 행 한 건을 열어 문서 제목과 기관의 문서 코드, 표 이름별 열과 행을 받습니다. 문서 종류마다 오는 표가 서로 다릅니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
nhis_edi__hr_payroll__received_documents__batch_details 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 보수월액 수신문서 목록 조회가 돌려준 행 번호를 넣으면 행마다 상세를 열어 결과 목록으로 받습니다. 한 건이라도 못 열면 결과 전체의 성공 표시가 꺼지고 안내 문장이 붙습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만...
nhis_edi__document_box__sent_documents__list 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 조회 기간을 넣어 부르면 보낸 신고서마다 이름과 제출 일시, 접수 건수, 보험별 정상, 반송, 반려 건수를 받습니다. 결과 표는 엑셀로도 받을 수 있고, 그 파일은 청한 호출에만 만들어집니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의...
nhis_edi__document_box__sent_documents__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 보낸문서 목록의 행 번호나 행 키로 고른 4대보험 기준소득월액, 보수월액, 월평균보수 변경신청서 한 건의 대상자와 보험별 신고 내용을 받습니다. 다른 서식의 문서는 오류로 돌아옵니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
nhis_edi__file_report__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 로그인한 연동 계정으로 파일신고에 쓸 수 있는 서식 다섯 가지와 기본 서식, 올릴 수 있는 파일 형식, 신고 자료 표의 열을 받습니다. 파일을 올리거나 검증하거나 신고하지는 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
nhis_edi__certificates__payment_completion__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 건강보험료 납부확인서 화면의 고지 총액과 납부 총액 칸, 가입자별 보험료 표의 열, 발급번호 칸을 받습니다. 발급은 보험료 납부확인서 발급 실행이 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은...
nhis_edi__certificates__payment_completion__issue 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 사업장 건강보험 납부확인서 또는 사업장 4대보험 완납증명서를 발급합니다. 되돌릴 수 없습니다. 기관에서 증명서가 발급되고 발급번호가 매겨지며, 취소하는 기능은 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
nhis_edi__certificates__workplace_application_notice__apply__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 사업장 적용 통보서 신청서 화면의 한글 영문 신청구분, 사업장 칸, 작성일과 일련번호 칸을 받습니다. 이 도구는 신청 버튼을 누르지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그...
nhis_edi__certificates__workplace_member_list__apply__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 부르면 사업장 가입자 명부 신청 화면의 가입자 범위와 상실자 포함 보기, 대상자 성명과 주민등록번호 칸을 돌려줍니다. 명부 발급은 신청하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
nhis_edi__certificates__health_premium_payment__individual__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 개인별 건강보험 납부확인서 신청 화면의 신청인 칸, 신청년월 칸, 가입자 명단 표의 열을 받습니다. 칸은 미리 저장해 둔 화면 정보에서 나오며 신청은 하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
nhis_edi__certificates__workplace_application_notice__issued__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 발급된 사업장 적용 통보서 화면의 사업장명, 사용자 성명, 적용일자, 가입자수, 발급번호 칸 구성을 받습니다. 발급된 통보서의 값은 불러오지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
nhis_edi__certificates__workplace_member_list__issued__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 로그인한 연동 계정으로 사업장 가입자 명부 발급확인 화면의 발급일자, 작성차수, 발급번호 칸과 명부 표의 열 이름을 받습니다. 발급된 명부의 가입자 내용은 담기지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은...
nhis_edi__qualification__acquisition__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정 하나로 자격취득 신고서의 입력 항목 70개와, 대상자와 네 보험, 피부양자 등 구역 아홉의 목록을 받습니다. 신고서를 만들거나 보내지는 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그...
nhis_edi__qualification__acquisition__draft_validate 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 입사자 성명과 주민등록번호, 고른 보험별 취득 값, 피부양자 행을 넣으면 빠진 항목과 오류, 첨부서류 안내, 대상자 등록 가능 여부를 돌려줍니다. 대상자 등록과 신고는 하지 않습니다. params: definition pending, see docs/contracts/EDI_JOB_ACTION_PARAMS.md....
nhis_edi__qualification__loss__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 자격 상실 신고서의 보험별 상실일과 상실 코드 칸, 보수총액, 이직확인서 칸과 목록 이름을 로그인한 연동 계정으로 받습니다. 칸 구성은 저장해 둔 상실 신고서 화면 정보에서 읽습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
nhis_edi__qualification__change__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 로그인한 연동 계정으로 부르면 자격 내역변경 신고서의 대상자, 신청구분, 내역변경, 보험별 구역 칸과 변경부호 같은 목록 이름을 받습니다. 신고서는 임시저장하거나 보내지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
nhis_edi__qualification__dependent__init 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 피부양자 취득 상실 신고서의 가입자, 피부양자, 장애인과 국가유공자, 외국인 구역 칸을 연동 계정 하나로 받습니다. 취득과 상실 구분만 보기 값이 함께 옵니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께...
nhis_edi__hr_payroll__premium_notices__search 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 문서를 받은 기간이나 고지 연월을 넣으면 건강과 연금, 고용, 산재 보험료의 고지내역서 목록을 받습니다. 행마다 행 키, 고지 연월과 차수, 작성 차수가 있고 고지 내용은 열지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을...
nhis_edi__hr_payroll__premium_notices__select 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 탐색 결과의 행 키나 고지 연월, 문서 이름으로 고지내역서 하나를 골라 같은 연동 계정의 다음 조회가 쓰도록 남기고, 고른 문서 정보와 이어 부를 조회 목록을 받습니다. 고지 내용은 열지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그...
nhis_edi__hr_payroll__premium_notices__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 탐색 결과의 행 키나 고지 연월과 문서 이름으로 고지내역서 하나를 열어 고지 연월과 차수, 보험 종류, 기관이 준 고지 항목 행을 받습니다. 항목 이름은 기관 코드 그대로 옵니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
nhis_edi__hr_payroll__health_premiums__summary 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 고지 연월과 차수를 넣으면 사업장고지내역서(건강)를 열어 고지 인원과 건강보험, 장기요양보험의 산출, 조정, 고지 총액, 납부 마감일, 미납 금액을 받습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께...
nhis_edi__hr_payroll__health_premiums__employee_details 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 고지 연월과 차수를 넣으면 가입자고지내역서(건강)를 열어 가입자마다 보수월액과 건강보험, 장기요양보험의 산출, 조정, 당월 보험료와 합계를 받습니다. 요청하면 엑셀로도 받습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[]...
nhis_edi__hr_payroll__payment_status__list 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 부르면 기본으로 올해 건강보험의 달마다 고지금액, 납부마감일, 납부일, 낸 보험료와 연체금, 미납 금액을 장기요양보험 몫과 함께 받습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기...
nhis_edi__hr_payroll__edi_electronic_notices__contract 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 부르면 전자고지를 검색해 한 건을 고르는 순서와 고를 때 쓰는 다섯 항목을 받습니다. 규칙은 서버에 적어 둔 것이며 전자고지 내용은 담기지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
nhis_edi__hr_payroll__edi_electronic_notices__search_options 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 조회 기간을 넣어 부르면 전자고지마다 고지 연월과 차수, 작성 차수, 납부자번호, 문서 이름과 행 키를 받습니다. 검색 결과는 같은 로그인 세션에 남습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그...
nhis_edi__hr_payroll__edi_electronic_notices__select 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 전자고지 검색 결과에서 행 번호나 행 키, 고지 연월과 차수로 한 건을 골라 로그인 세션에 남기고 그 고지의 값을 받습니다. 세션에 검색 결과가 없으면 먼저 다시 검색합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만...
nhis_edi__hr_payroll__edi_electronic_notices__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 검색해 고른 전자고지 한 건의 고지서 상세 행과 총 납부보험료, 총 체납액, 납부마감일 요약을 받습니다. 고를 고지가 없으면 빈 결과와 기간을 넓히라는 안내가 옵니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은...
nhis_edi__hr_payroll__year_end_settlement__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 수신문서 목록에서 직장가입자 보험료 연말정산 산출내역서 행을 찾아 열면 가입자별 행과 열을 받습니다. 산출내역서가 목록에 없으면 행을 찾지 못했다는 결과가 옵니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
nhis_edi__business__basic_info 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 부르면 로그인한 건강보험 EDI 세션이 가진 사업장 기본정보를 받습니다. 사업장을 고르는 입력은 없고, 조회만 하며 업무 자료를 바꾸지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께...
nhis_edi__health_checkups__targets__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 최근 석 달 안에 받은 건강검진 대상자 문서에서 검진년도와 통보일, 사무직과 비사무직 대상자 수, 사업장 주소와 연락처를 돌려줍니다. 문서를 찾지 못하면 찾지 못했다는 결과가 돌아옵니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을...
nhis_edi__hr_payroll__salary_total_notice__detail 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 보수총액 통보서 화면의 상세 데이터와 요약 정보를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nhis_edi__hr_payroll__processing_results__list 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 기간이나 고지 연월을 넣으면 받은 문서와 보낸 문서의 행을 한 목록으로 받습니다. 보낸 문서 행에는 접수 건수와 보험별 정상, 반송, 반려 건수가 있습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기...
nhis_edi__public__notices__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 쪽 번호를 넣으면 대외 공지사항 게시판 그 쪽의 글마다 번호나 공지 표시, 제목, 등록일과 글 주소를 받고, 첨부가 있으면 첨부 안내도 받습니다. 연동 계정과 기관 로그인은 필요하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
nhis_edi__public__resources__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 쪽 번호로 공개 자료실 게시판의 한 쪽을 읽어 자료마다 번호나 공지 표시, 제목, 등록일과 글 주소를 돌려주고, 첨부가 있는 자료에는 첨부 안내가 붙습니다. 파일 자체는 받지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고,...
nhis_edi__public__forms__list 먼저 호출할 도구: nhis_edi__session__login (같은 account_link_id). 연동 계정으로 부르면 이 세션의 업무 화면을 준비한 뒤 전체서식 화면의 화면 번호와 그 메뉴로 가는 연결 번호를 받습니다. 그 화면을 열지는 않으며, 서식 목록이나 서식 파일은 이 결과에 담기지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지...
nps_edi__auth__npki_session__login 이 기관의 다른 도구보다 먼저 호출하세요. 공동인증서로 국민연금 EDI 에 로그인합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관...
nps_edi__auth__session__status 국민연금 EDI 세션 상태를 확인합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은...
nps_edi__b1__workplace__main_basic_info 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금에 등록된 사업장 기본정보를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__declarations__processing_results__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 신고 처리결과를 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면...
nps_edi__b1__certificates__application_results__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 증명서 신청과 발급 처리결과를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
nps_edi__b1__certificates__application_results__document_view 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 증명서 처리결과 한 건의 출력과 저장에 쓰는 값을 준비합니다. 출력이나 저장을 실행하지는 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는...
nps_edi__b1__certificates__membership__subscribers__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 가입증명서(EC02)를 발급할 수 있는 사업장 가입자를 성명으로 조회합니다. 발급 도구에 넣을 row_index 와 row_key 를 가입자마다 돌려주며 주민등록번호는 돌려주지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요....
nps_edi__b1__certificates__membership__issue 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 가입자 한 명의 국민연금 가입증명서(EC02, 한글본만)를 발급합니다. 되돌릴 수 없습니다. 기관에서 증명서가 발급되며, 취소하는 기능은 없습니다. 발급한 증명서는 24시간 안에만 다시 출력할 수 있고, 그 뒤에는 먼저 새로 신청해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지...
nps_edi__b1__certificates__membership__apply 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 가입자 1명에서 100명까지의 국민연금 가입증명 신청서(EB0301)를 기관에 보냅니다. 발급 도구보다 먼저 호출합니다. 발급 화면은 접수된 신청서 문서번호 아래의 가입자만 보여 주기 때문입니다. 되돌릴 수 없습니다. 보낸 신청서는 취소할 수 없고 기관 기록에 남습니다. 대상자마다...
nps_edi__b1__pension_notification_documents__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 연금 통지서 목록을 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의...
nps_edi__b1__pension_notification_documents__detail 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 연금 통지서 한 건의 상세를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__pension_notices__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 연금보험료 고지 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
nps_edi__b1__pension_notices__select 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 연금보험료 고지 한 건을 고릅니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
nps_edi__b1__national_pension_premiums__summary 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 보험료 결정내역 요약을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__national_pension_premiums__subscribers 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 가입자별 보험료 내역을 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가...
nps_edi__b1__national_pension_premiums__support_details 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 보험료 지원 상세 내역을 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가...
nps_edi__b1__national_pension_premiums__payment_history 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 보험료 납부 이력을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__national_pension_premiums__retro_payments 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 보험료 소급분을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
nps_edi__b1__national_pension_premiums__guide 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 국민연금 보험료 결정내역 안내문을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__lookups__workplace_premium_notices__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 사업장 연금보험료 과오납금을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__lookups__workplace_premium_support__details 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 사업장 연금보험료 지원 내역을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__lookups__pension_support_recovery_decisions__search 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 연금보험료 지원 환수 결정 내역을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
nps_edi__b1__lookups__workplace_subscribers__status 먼저 호출할 도구: nps_edi__auth__npki_session__login (같은 account_link_id). 사업장 가입자 현황을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정...
fourinsure__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 4대보험 EDI 에 로그인하고 API_KEY 를 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수...
fourinsure__b1__business_establishment__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 사업장 성립 신고 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__business_establishment__draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 사업장 성립 신고서에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
fourinsure__b1__member_qualification__acqs_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 직원 자격취득 신고 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__member_qualification__los_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 직원 자격상실 신고 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__member_qualification__chg_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 직원 자격변동 신고 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__member_qualification__dependent_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 피부양자 자격신고(취득과 상실) 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
fourinsure__b1__member_qualification__acqs_draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 직원 자격취득 신고서에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
fourinsure__b1__member_qualification__los_draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 직원 자격상실 신고서에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
fourinsure__b1__member_qualification__chg_draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 직원 자격변동 신고서에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
fourinsure__b1__member_qualification__dependent_draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 피부양자 자격신고서(취득과 상실)에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요....
fourinsure__b1__member_qualification__los_member_lookup 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격상실 신고서를 쓰기 전에 성명과 주민등록번호로 가입자를 조회해 자격키(rrkey)와 보험별 기존 자격취득일과 상실일, 기존 신고 여부를 돌려줍니다. 조회만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지...
fourinsure__b1__member_qualification__los_exist_check 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격상실 신고서를 쓰기 전에 보험 하나(국민연금, 건강보험, 고용보험, 산재보험)에 기존 상실신고가 있는지 확인합니다. rrkey 는 자격상실 가입자 조회 결과의 값을 넣습니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어...
fourinsure__b1__member_qualification__los_save 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격상실 신고서를 정보연계센터에 초안으로 저장하고 접수번호를 받습니다. 기관에 실제로 남는 쓰기이고 이 API 로 되돌릴 수 없습니다. 신고서를 기관에 전송하지는 않으며, 마지막 전송은 사용자가 정보연계센터 화면에서 직접 합니다. confirm=true 없이 부르면 저장하지 않고 보낼 값을 미리 보여 주므로,...
fourinsure__b1__member_qualification__acqs_member_lookup 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격취득 신고서를 쓰기 전에 성명과 주민등록번호로 가입자를 조회해 자격키(rrkey)와 대표자 여부, 보험별 기존 자격취득일과 상실일을 돌려줍니다. 조회만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
fourinsure__b1__member_qualification__acqs_precheck 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격취득 신고서를 쓰기 전에 상위 접수번호에 이미 작성된 건수를 확인합니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
fourinsure__b1__member_qualification__acqs_save 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격취득 신고서를 정보연계센터에 초안으로 저장하고 접수번호를 받습니다. 기관에 실제로 남는 쓰기이고 이 API 로 되돌릴 수 없습니다. 신고서를 기관에 전송하지는 않으며, 마지막 전송은 사용자가 정보연계센터 화면에서 직접 합니다. confirm=true 없이 부르면 저장하지 않고 보낼 값을 미리 보여 주므로,...
fourinsure__b1__common__com_cd__list 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 자격취득과 상실 신고서의 사유와 직종 칸에 넣는 공통코드(코드 값과 이름)를 분류 아이디별로 조회합니다(예: B112, D114, A101). 조회만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그...
fourinsure__b1__payroll__amount_change__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 보수월액 변경 신청 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__payroll__amount_change__draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 보수월액 변경 신청서에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
fourinsure__b1__workplace_support__insurance_support__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 두루누리 보험료 지원 신청 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
fourinsure__b1__workplace_support__household_worker__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 가사근로자 보험료 지원 신청 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
fourinsure__b1__workplace_support__insurance_support__draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 두루누리 보험료 지원 신청서에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을...
fourinsure__b1__workplace__withdrawal__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 사업장 탈퇴 신고 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__workplace__auto_transfer_unagreement__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 사업장 자동이체 신청(신규와 해지) 화면의 약관과 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값...
fourinsure__b1__workplace__auto_transfer_unagreement__draft_validate 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 사업장 자동이체 신청서(신규와 해지)에 넣을 값을 검증하고 빠진 값(missing_required_fields)과 틀린 값(field_errors)을 알려 줍니다. 확인만 하며 기관에 저장하거나 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요....
fourinsure__b1__certificate__apply__init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 4대보험 증명서 신청 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__certificate__apply__submit 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 4대보험 증명서 신청서를 제출합니다. 되돌릴 수 없습니다. 신청서가 기관에 접수되고 접수번호가 매겨지며, 취소하는 기능은 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
fourinsure__b1__certificate__history__list_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 증명서 신청 이력 목록 화면의 검색 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면...
fourinsure__b1__certificate__history__detail_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 증명서 신청 이력 상세 화면의 입력 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면...
fourinsure__b1__certificate__history__list 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 증명서 신청 이력 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이...
fourinsure__b1__certificate__history__detail 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 증명서 신청 이력 한 건의 상세를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정...
fourinsure__b1__certificate__history__pdf_download 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 기본으로는 출력할 수 있는 증명서 신청 건(접수번호, 상태, 날짜)을 미리 보여 주며 PDF 는 싣지 않습니다. 실제 PDF 를 결과 artifacts 로 받으려면 dry_run=false 와 confirm_download=true 를 함께 보내세요. 파일: PDF · 기관이 발급한 원본. 결과의...
fourinsure__b1__certificate__issue_fact__confirm 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 발급번호로 증명서가 실제로 발급된 것인지 확인합니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__civil_receipt__history__list_init 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 민원 접수 이력 목록 화면의 검색 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새...
fourinsure__b1__civil_receipt__history__list 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 민원 접수 이력 목록을 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의 job_id...
fourinsure__b1__resources__faqs__list_init 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 4대보험 FAQ 목록 화면의 검색 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택...
fourinsure__b1__resources__faqs__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 4대보험 FAQ 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관...
fourinsure__b1__resources__faqs__detail 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 4대보험 FAQ 한 건의 상세를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정...
fourinsure__b1__resources__notices__institutions__list_init 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 기관 공지 목록 화면의 검색 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을...
fourinsure__b1__resources__notices__institutions__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 기관 공지 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에...
fourinsure__b1__resources__notices__institutions__detail 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 기관 공지 한 건의 상세를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관...
fourinsure__b1__resources__notices__institutions__attachments 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 기관 공지에 붙은 첨부파일 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다....
fourinsure__b1__resources__forms__list_init 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 서식 목록 화면의 검색 양식을 불러옵니다. 조회만 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸...
fourinsure__b1__resources__forms__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 서식 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로...
fourinsure__b1__resources__forms__detail 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 서식 한 건의 상세를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에...
fourinsure__b1__resources__forms__attachments 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 서식에 붙은 첨부파일 목록을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관...
fourinsure__b1__resources__files__download 먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 기본(dry-run)으로는 첨부파일이 있는지 확인하고 원래 파일 이름을 돌려주며 파일은 싣지 않습니다. 실제 파일을 결과 artifacts 로 받으려면 dry_run=false 를 보내세요. 파일: 한글(hwp) 또는 PDF · 기관이 발급한 원본. 결과의 artifacts[] 에 실리고, 내려받기...
hometax__tax__return_history__search 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 신고일자 기간으로 세금 신고내역을 조회합니다. rtn_dt_srt 와 rtn_dt_end 는 YYYYMMDD 이고 기간은 최대 6년입니다. tax_kind 로 세목을 고르고(기본 all 은 홈택스 신고내역 전체 목록, vat 는 부가가치세, corporate 는 법인세), rows 는 page_num 과...
hometax__tax__return_document__detail 먼저 호출할 도구: hometax__session__login (같은 account_link_id). hometax__tax__return_history__search 결과의 return_document_ref 로 그 신고서의 서식별 항목과 값, 표를 조회합니다. 같은 계정 연결에서 받은 return_document_ref 만 쓸 수 있습니다. form_codes 를 빼면 출력할 수 있는 서식을 모두 받고, 넣으면 그...
hometax__tax__return_document__pdf 먼저 호출할 도구: hometax__session__login (같은 account_link_id). hometax__tax__return_history__search 결과의 return_document_ref 로 기관이 출력하는 신고서 원문 PDF 를 받습니다. 같은 계정 연결에서 받은 return_document_ref 만 쓸 수 있습니다. form_codes 를 빼면 출력할 수 있는 서식을 모두 받고, 넣으면 그...
comwel__auth__npki_session__login 이 기관의 다른 도구보다 먼저 호출하세요. 공동인증서로 근로복지공단에 로그인합니다. 사업자등록번호에 사업장이 하나면 그 사업장으로 로그인합니다. 둘 이상이면 로그인할 사업장의 사업장관리번호를 함께 넣어야 하며, 넣지 않으면 로그인이 실패합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
comwel__auth__session__status 근로복지공단 세션 상태를 확인합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은...
work24__auth__npki_session__login 이 기관의 다른 도구보다 먼저 호출하세요. 공동인증서(법인)로 고용24 에 로그인합니다. 개인사업자는 추후 지원 예정입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이...
work24__auth__session__status 고용24 세션 상태를 확인합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은 다른...
work24__subsidy__diagnosis__search 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 조회만 합니다. 사업장 하나에 대해 고용24 사업주 사전진단을 실행하고 지원금 사업마다 판정(eligible, ineligible, undetermined)을 돌려줍니다. undetermined 는 대상으로 세지 않습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 -...
work24__subsidy__application__init 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 조회만 합니다. 고용24 기업지원금 신청 화면에 들어가 그 사업의 사전진단 판정을 확인하고 화면의 입력 항목 구성을 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
work24__subsidy__application__requirements 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 쓰기 전에 신청자가 갖춰야 할 것을 알려 줍니다. 기관이 정해 주는 값, 고객이 꼭 넣어야 하는 칸, 등록된 지급 계좌, 첨부 서류를 마련하는 방법입니다(서류 목록 자체는 draft_validate 가 접수번호 기준으로 내려 줍니다). 읽기 전용이며 workplace_save 전에 부릅니다. 로그인한...
work24__subsidy__application__workplace_save 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 고용24 기업지원금 초안에 사업장정보를 저장하고 접수번호를 받습니다. 기관에 저장하는 쓰기입니다. 같은 신청으로 다시 호출하면 초안을 하나 더 만들지 않고 기존 접수번호를 돌려줍니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로...
work24__subsidy__application__target_init 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 이미 있는 초안의 대상자정보 단계에 들어가 그 입력 항목 구성을 돌려줍니다. workplace_save 가 준 접수번호(receipt_no)가 필요합니다. 제출은 하지 않습니다. 일부 사업은 화면을 옮길 때 초안이 저장되며, 저장됐는지는 결과의 safety.save_executed 가 알려 줍니다....
work24__subsidy__application__draft_validate 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 초안을 실제 화면과 대조해 첨부 서류 목록과 제출할 수 있는지를 돌려줍니다. 제출은 하지 않으며, submit 전에 반드시 거치는 확인입니다. 일부 사업은 화면을 옮길 때 초안이 저장되며, 저장됐는지는 결과의 safety.save_executed 가 알려 줍니다. 로그인한 호출이면 첫 요청 전에...
work24__subsidy__application__submit 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 고용24 기업지원금 신청을 고용노동부에 제출합니다. 되돌릴 수 없습니다. draft_validate 가 can_submit 을 알린 상태여야 하고, 사용자가 고른 admin_info_sharing_consent 와 사용자가 동의한 뒤에만 보내는 confirm=true 가 필요합니다. confirm 이...
work24__subsidy__application__withdraw 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 제출한 고용24 기업지원금 신청을 철회합니다(반려요청). submit 을 되돌리는 방법입니다. 사용자가 동의한 뒤에만 보내는 confirm 이 필요합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
work24__subsidy__application__delete 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 아직 제출하지 않은 고용24 기업지원금 초안을 삭제합니다. 사용자가 동의한 뒤에만 보내는 confirm 이 필요합니다. 제출한 신청은 삭제가 아니라 withdraw 로 철회합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
work24__subsidy__application__history 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 조회만 합니다. 이 사업의 지난 고용24 지원금 신청과 처리 상태(작성중, 처리중, 보완요청, 반려, 처리완료 등)를 돌려줍니다. 상태의 기준은 고용24 입니다. 아직 지원하지 않는 사업은 WORK24_SUBSIDY_APPLICATION_HISTORY_NOT_MEASURED 오류로 끝나며, 고용24...
work24__subsidy__application__modify 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 이미 제출한 고용24 기업지원금 신청을 제출과 같은 화면에서 수정합니다. 사용자가 고른 admin_info_sharing_consent 와 사용자가 동의한 뒤에만 보내는 confirm=true 가 필요합니다. confirm 이 없으면 거절되고 아무것도 보내지 않습니다. 이 도구는 기관의 기록을...
work24__subsidy__application__target_search 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 지원금 대상자로 지정할 수 있는 사업장 고용보험 피보험자 목록을 돌려줍니다. 대상자는 이 목록에서 고르고 새로 만들지 않으므로 주민등록번호를 넣지 않습니다. 제출은 하지 않습니다. 일부 사업은 화면을 옮길 때 초안이 저장되며, 저장됐는지는 결과의 safety.save_executed 가 알려 줍니다....
work24__subsidy__application__target_save 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). target_search 가 돌려준 irno 값으로 고른 피보험자를 초안의 지원금 대상자로 지정합니다. 기관에 저장하는 쓰기이며, 초안이 작성중인 동안에는 되돌릴 수 있습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이...
work24__subsidy__application__attachment_delete 먼저 호출할 도구: work24__auth__npki_session__login (같은 account_link_id). 고용24 기업지원금 초안에 첨부된 파일 하나를 삭제합니다. 파일은 draft_validate 가 알려 주는 file_id 로 지정합니다. 초안이 작성중일 때만 됩니다. 사용자가 동의한 뒤에만 보내는 confirm 이 필요합니다. 다시 읽은 첨부 목록에 그 파일이 없을 때만 삭제된 것으로 확인합니다. 이...
opendata__nts__status 공공데이터포털에 개방된 국세청 사업자등록 상태(data.go.kr 15081808)를 사업자등록번호(b_no)로 조회합니다. 한 번에 100건까지 넣을 수 있습니다. 별도 연동 없이 사용할 수 있습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은...
opendata__nts__validate 공공데이터포털에 개방된 국세청 사업자등록 진위확인(data.go.kr 15081808)으로 사업자등록 정보가 등록된 내용과 일치하는지 확인합니다. businesses[] 항목마다 b_no, start_dt(YYYYMMDD), p_nm 이 필요합니다. 별도 연동 없이 사용할 수 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
opendata__g2b__sanction 공공데이터포털에 개방된 나라장터 부정당업자 제재 정보(data.go.kr 15129466)를 사업자등록번호(bizno)로 조회합니다. 결과가 비어 있으면 이번 조회에서 해당 기록을 찾지 못한 것이고, 제재를 받은 적이 없다는 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만...
opendata__kiscon__sanction 공공데이터포털에 개방된 KISCON 건설업체 공시(data.go.kr 15061362)를 조회합니다. 원천은 기간(sDate, eDate)으로만 조회할 수 있어, 서버가 그 기간의 공시를 훑어 사업자등록번호(bizno)가 같은 행을 matches 에 돌려줍니다. 공시에 등록번호가 없는 행은 업체명(corp_name)을 넣었을 때 이름이 같은 것을 fallback_candidates 에 담습니다. matches 가 비어...
opendata__env__waste_sanction 공공데이터포털에 개방된 사업장폐기물 행정처분 정보(data.go.kr 15156661)를 주기적으로 받아 둔 색인에서 사업자등록번호(bizno)로 조회합니다. 조회할 때 기관에 실시간으로 묻지 않습니다. matches 가 비어 있으면 조회 시점에 유효한 처분 기록을 찾지 못한 것이고, 처분이 없다는 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 -...
opendata__fsc__corp_outline 공공데이터포털에 개방된 법인 기업개요(data.go.kr 15043184)를 조회합니다. 상호(corpNm) 또는 법인등록번호(crno) 또는 사업자등록번호(bizno) 가운데 하나 이상을 주면 법인명, 사업자등록번호, 법인등록번호, 설립일자, 업종, 소재지, 종업원 수, 결산 월, 상장 시장 등을 돌려줍니다. 한 법인의 행이 여럿이면 개방 시점이 다른 기록이고 current 가 가장 최근 것입니다. 개인사업자는 이...
opendata__comwel__workplace 공공데이터포털에 개방된 고용보험과 산재보험 가입 사업장 정보(data.go.kr 15059256)를 사업자등록번호로 조회합니다. 사업장명, 보험 구분, 보험가입구분, 성립일자, 상시인원, 업종, 우편번호, 주소를 사업장(적용 단위)마다 한 행으로 돌려주고 summary 에 보험별 사업장 수와 상시인원 합계를 담습니다. 결과가 비어 있어도 미가입 확인서는 아닙니다. 별도 연동 없이 사용할 수 있습니다. 파일:...
opendata__nps__workplace 공공데이터포털에 개방된 국민연금 가입 사업장 정보(data.go.kr 3046071)를 사업자등록번호와 상호로 조회합니다. 원천이 사업자등록번호를 앞 6자리만 제공하므로 candidates 에는 같은 앞자리의 다른 사업장이 섞일 수 있고, 상호가 정확히 일치하는 사업장만 matched 에 가입자수, 당월고지금액, 사업장등록일, 탈퇴일, 업종을 함께 돌려줍니다. 가입자 3인 이상 법인과 10인 이상 개인사업장만 개방되어...
opendata__fsc__financials 공공데이터포털에 개방된 법인 요약재무제표(data.go.kr 15043459)를 법인등록번호로 조회합니다. 사업연도마다 별도와 연결 재무제표 행이 따로 오며 매출액, 영업이익, 당기순이익, 총자산, 총부채, 총자본, 자본금, 부채비율을 statements 에, 가장 최근 사업연도의 행을 latest 에 돌려줍니다. 사업자등록번호만 주면 법인등록번호를 찾아 조회하고 개인사업자이면 빈 결과에 그 사유를 담습니다. 별도 연동...
opendata__bld__register 공공데이터포털에 개방된 건축물대장 표제부(data.go.kr 15134735)를 주소로 조회합니다. 주소를 도로명주소 검색으로 지번에 맞춘 뒤 그 지번의 건물(동)마다 건물명, 주용도, 구조, 연면적, 층수, 사용승인일, 승강기 수, 내진설계 여부 등을 buildings 에 돌려주고, 찾은 주소 후보는 address 에, 대표 건물은 primary 에 담습니다. 사업자등록번호만 주면 등록된 소재지를 찾아 조회합니다....
opendata__nrg__trades 공공데이터포털에 개방된 상업업무용 부동산 매매 실거래가(data.go.kr 15126463)를 주소로 조회합니다. 주소를 도로명주소 검색으로 지번에 맞춘 뒤 미리 받아 둔 자료에서 같은 지번의 거래(계약일, 거래금액, 건물 주용도, 면적, 층, 거래유형, 해제 여부)를 trades 에 돌려주고, 받아 둔 달과 빠진 달은 coverage 에, 찾은 주소 후보는 address 에 담습니다. 기간은 endYm(기본 이번...
opendata__smes__notices 공공데이터포털에 개방된 중소기업 지원사업 공고(data.go.kr 15157820)를 분야와 해시태그로 골라 조회합니다. 공고마다 공고명, 소관기관, 지원분야, 신청기간, 지원대상, 사업개요, 신청방법, 문의처를 원문 그대로 notices 에 돌려주고 원문 링크(pblancUrl)와 출처 줄을 붙입니다. 요약이나 점수는 만들지 않습니다. 전체 건수는 total_count 에, 더 있으면 truncated 가 참이고...
opendata__ftc__mail_order 공공데이터포털에 개방된 통신판매사업자 등록현황(data.go.kr 15126311)을 상호 또는 사업자등록번호로 조회합니다. 상호(bzmnNm)로 검색하면 온라인 판매를 신고한 사업자를 찾아 사업자등록번호를 함께 돌려주어 다른 조회로 이어 갈 수 있습니다. 전체 건수는 total_count 에 담고, 결과가 비어 있어도 그 상호의 사업자가 없다는 뜻은 아닙니다. 통신판매를 신고하지 않은 사업자와 오프라인 사업자는 이...
opendata__comwel__name_search 공공데이터포털에 개방된 고용보험과 산재보험 가입 사업장 정보(data.go.kr 15059256)를 주기적으로 받아 둔 색인에서 상호로 사업자를 찾아 사업자등록번호, 사업장명, 주소, 성립일을 돌려줍니다. 법인과 개인사업자가 함께 오르고, 상호가 그것으로 시작하는 사업장이 먼저 옵니다. 돌려받은 사업자등록번호로 다른 조회를 이어 갈 수 있습니다. 직원 없이 혼자 운영해 보험에 가입하지 않은 사업자는 없을 수 있어,...
payroll_artifact__register_xlsx attribution_ym 과 employees[](세금과 공제 금액은 이미 계산된 값)로 표준 급여대장 엑셀(xlsx)을 만듭니다. 우리 플랫폼 키로만 돌아 account_link_id 가 필요 없습니다. 결과는 data 의 요약(attribution_ym, employee_count)과 artifacts[] 의 엑셀 한 개(서명된 download_url)입니다. 조합 병합 결과가 아닙니다. 파일: 엑셀(xlsx) ·...
shinhan_easy__auth__id_password_session__login 이 기관의 다른 도구보다 먼저 호출하세요. 등록한 아이디 로그인 연동으로 신한은행 간편조회에 로그인되는지 확인합니다. 결과에 확인된 계좌 수가 들어 있습니다. 비밀정보는 MCP 입력으로 받지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이...
payroll_artifact__payslip_xlsx attribution_ym, payment_date, employees[] 로 직원마다 시트 하나인 급여명세서 엑셀(xlsx) 한 개를 만듭니다. 우리 플랫폼 키로만 돌아 account_link_id 가 필요 없습니다. 결과는 data 의 요약(attribution_ym, employee_count)과 artifacts[] 의 엑셀 한 개(서명된 download_url)입니다. 조합 병합 결과가 아니고 메일로 보내지도...
shinhan_easy__accounts__list 먼저 호출할 도구: shinhan_easy__auth__id_password_session__login (같은 account_link_id). 연동한 신한은행 간편조회의 계좌 목록을 은행에서 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요....
shinhan_easy__linked_accounts__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 호출자가 등록한 신한은행 계좌 연동 목록을 돌려줍니다. 항목마다 계좌 목록과 거래내역 도구가 쓰는 account_link_id 와 bank_account_credential_id 가 있습니다. 은행을 부르지 않고 등록 기록만 읽습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을...
shinhan_easy__accounts__transaction_history__search 먼저 호출할 도구: shinhan_easy__auth__id_password_session__login (같은 account_link_id). 등록된 신한은행 계좌 하나의 거래내역을 조회합니다. bank_account_credential_id 로 고른 계좌를 은행 계좌 목록에서 찾아 그 계좌를 열고, 목록에 없는 계좌는 조회하지 않습니다. 결과는 sort_order 대로 정렬합니다(기본은 최근 먼저). 파일:...
kb_biz_card__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 등록한 연동의 인증서로 KB국민카드 기업 세션을 만듭니다. 개인사업자는 추후 지원 예정입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로...
kb_biz_card__common__departments__select 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 지금 세션에서 고를 수 있는 부서 목록을 돌려줍니다. department_name 을 넣으면 그 이름으로 부서를 찾습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
kb_biz_card__common__cards__select 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 지금 세션에서 고를 수 있는 카드 목록을 돌려줍니다. 부서(department_sequence_no, department_name)를 넣어 그 부서의 카드를 조회할 수 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을...
kb_biz_card__approvals__init 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 승인내역 조회를 준비합니다. 고를 수 있는 부서와 카드 목록, 검색에 쓸 기본값(default_search_params)을 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
kb_biz_card__approvals__search 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 기간(date_from, date_to)의 승인내역 한 쪽을 조회합니다. 결과에 쪽 정보(pagination)와 다른 쪽을 읽을 때 쓰는 search_context 가 들어 있습니다. 승인내역은 오늘로부터 1년 전 같은 날짜까지만 조회할 수 있습니다. 로그인한 호출이면 첫 요청 전에...
kb_biz_card__approvals__page 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 앞선 검색이 돌려준 search_context 와 쪽 번호(page)로 승인내역의 다른 쪽을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을...
kb_biz_card__approvals__result 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 기간(date_from, date_to)의 승인내역을 첫 쪽부터 이어 읽어 한 번에 돌려줍니다. max_pages 로 읽을 쪽 수를 줄일 수 있고, 그래서 남은 쪽이 있으면 pagination.has_next 가 true 입니다. 승인내역은 오늘로부터 1년 전 같은 날짜까지만 조회할 수 있습니다. 파일:...
kb_biz_card__purchases__init 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 매입내역 조회를 준비합니다. 고를 수 있는 부서와 카드 목록, 검색에 쓸 기본값(default_search_params)을 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
kb_biz_card__purchases__search 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 기간(date_from, date_to)의 매입내역 한 쪽을 조회합니다. 결과에 쪽 정보(pagination)와 다른 쪽을 읽을 때 쓰는 search_context 가 들어 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을...
kb_biz_card__purchases__page 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 앞선 검색이 돌려준 search_context 와 쪽 번호(page)로 매입내역의 다른 쪽을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을...
kb_biz_card__purchases__result 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 기간(date_from, date_to)의 매입내역을 첫 쪽부터 이어 읽어 한 번에 돌려줍니다. max_pages 로 읽을 쪽 수를 줄일 수 있고, 그래서 남은 쪽이 있으면 pagination.has_next 가 true 입니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 -...
kb_biz_card__payments__init 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 결제내역 조회를 준비합니다. 고를 수 있는 부서 목록과 검색에 쓸 기본값(default_search_params)을 돌려줍니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고,...
kb_biz_card__payments__search 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 기간(date_from, date_to)의 결제내역 한 쪽을 조회합니다. 결과에 쪽 정보(pagination)와 다른 쪽을 읽을 때 쓰는 search_context 가 들어 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을...
kb_biz_card__payments__page 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 앞선 검색이 돌려준 search_context 와 쪽 번호(page)로 결제내역의 다른 쪽을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을...
kb_biz_card__payments__result 먼저 호출할 도구: kb_biz_card__session__login (같은 account_link_id). 기간(date_from, date_to)의 결제내역을 첫 쪽부터 이어 읽어 한 번에 돌려줍니다. max_pages 로 읽을 쪽 수를 줄일 수 있고, 그래서 남은 쪽이 있으면 pagination.has_next 가 true 입니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 -...
ibk_fast_account__session__login 이 기관의 다른 도구보다 먼저 호출하세요. IBK기업은행 빠른조회 세션을 기존 연동으로 만듭니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다....
ibk_fast_account__accounts__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 호출자가 등록한 IBK기업은행 계좌 연동 목록을 돌려줍니다. 항목마다 잔액 요약 도구가 쓰는 account_link_id 와 bank_account_credential_id 가 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
ibk_fast_account__accounts__quick_summary__get 먼저 호출할 도구: ibk_fast_account__session__login (같은 account_link_id). 등록된 IBK기업은행 계좌 하나의 잔액과 일자별 입출금 요약을 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안...
kb_fast_account__session__login 이 기관의 다른 도구보다 먼저 호출하세요. KB국민은행 빠른조회 세션을 기존 연동으로 만듭니다. 비밀정보는 MCP 입력으로 받지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로...
kb_fast_account__accounts__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 호출자가 등록한 KB국민은행 계좌 연동 목록을 돌려줍니다. 항목마다 거래내역 도구가 쓰는 account_link_id 와 bank_account_credential_id 가 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고,...
kb_fast_account__accounts__transaction_history__search 먼저 호출할 도구: kb_fast_account__session__login (같은 account_link_id). 등록된 KB국민은행 계좌 하나의 거래내역을 기존 세션으로 조회합니다. 한 번에 한 쪽(100건)만 가져옵니다. 거래가 그 수에 닿거나 더 남으면 실패로 끝나니 기간을 나눠 다시 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의...
woori_bank__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 우리은행 빠른조회 세션을 기존 연동으로 만듭니다. 비밀정보는 MCP 입력으로 받지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를...
google__account__status Google 연동을 쓸 수 있는지 알려 주고, 그 연동으로 읽을 수 있는 자산(GA4 속성, Search Console 사이트, Google Ads 계정, YouTube 채널, Tag Manager 컨테이너)을 나열합니다. 읽기만 하며 인자를 받지 않습니다. 이 도구를 먼저 호출하세요. 다른 google 도구는 고객이 이 연동에서 선택한 자산만 받습니다. 축마다 따로 보고하므로 한 축이 막혀도 다른 축이 비지 않습니다....
google__analytics__measurement__audit GA4 속성 하나의 측정 설정을 진단합니다. 데이터 스트림과 주요 이벤트, 그리고 속성 설정(display_name, time_zone, currency_code, industry_category)을 봅니다. 읽기만 하며 태그나 설정을 바꾸지 않습니다. 빠졌거나 맞지 않는 것을 알려 주어 고객이 직접 고칠 수 있게 합니다. 설정 칸 이름은 속성 설정 수정 도구의 인자 이름과 같으므로, 그 도구의 결과를 알 수 없을 때...
google__analytics__report GA4 속성 하나의 성과를 기간으로 조회합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 속성의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 모든 결과는 data_availability 를 밝힙니다. 값은 complete, observed_zero(API가 0이라고 보고함), no_rows(요청에 맞는 것이 없음), partial_collection(일부만 수집), access_error(권한 때문에...
google__search_console__performance Search Console 사이트 하나의 검색 실적(노출수, 클릭수, 검색어)을 조회합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 미국 태평양 시간 기준이고, 결과가 그 사실을 밝힙니다. Google은 상위 행만 돌려주므로 결과는 늘 일부입니다. 모든 결과는 data_availability 를 밝힙니다. 값은 complete, observed_zero(API가 0이라고 보고함), no_rows(요청에 맞는...
google_marketing_pack__report_v1__generate 구글 읽기 세 단계(google__analytics__measurement__audit, google__analytics__report, google__search_console__performance)를 돌려 보고서 하나로 묶습니다. 세 단계는 함께 접수되고, 셋이 모두 끝나거나 실패하면 보고서가 준비됩니다. account_link_id 는 넣지 않습니다. 단계마다 자기 연동을 씁니다. 실패한 단계가 있어도 보고서는...
google__search_console__index_status Search Console 사이트에 속한 페이지 하나의 Google 색인 상태를 조회합니다. 색인 여부, 색인을 막는 것(robots.txt, noindex, 페이지 가져오기 오류), 마지막 크롤링 시각, 표준(canonical) URL을 알려 줍니다. 읽기만 하며 색인을 요청하지 않습니다. 페이지를 실시간으로 검사하지 않고, Google 색인에 저장된 버전을 보고합니다. 시각은 UTC이며 결과가 그 사실을 밝힙니다....
woori_bank__accounts__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 호출자가 등록한 우리은행 계좌 연동 목록을 돌려줍니다. 항목마다 거래내역 도구가 쓰는 account_link_id 와 bank_account_credential_id 가 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
google__youtube__analytics__report YouTube 채널 하나의 성과(조회수, 시청 시간, 구독자, 그 밖에 고객이 요청한 채널 지표)를 기간으로 조회합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함합니다. 응답에는 YouTube가 처리를 마친 날만 담기므로 최근 며칠은 빠지거나 아직 바뀔 수 있습니다. 그래서 결과는 늘 is_final: provisional 을 밝힙니다. 수익 지표는 여기서 조회할 수 없습니다. 모든 지표는...
google__ads__search__report Google Ads 계정 하나의 검색 캠페인 성과를 기간으로 조회합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 광고 계정의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 각 행에서 metrics.impressions 는 metrics.impressions 로, metrics.clicks 는 metrics.clicks 로, metrics.ctr 는 metrics.ctr 로 돌아오고, 그 밖의 지표는...
google__ads__display__report Google Ads 계정 하나의 디스플레이 캠페인 성과를 기간으로 조회합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 광고 계정의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 각 행에서 metrics.impressions 는 metrics.impressions 로, metrics.clicks 는 metrics.clicks 로, metrics.ctr 는 metrics.ctr 로 돌아오고, 그 밖의...
google__ads__pmax__report Google Ads 계정 하나의 Performance Max 캠페인 성과를 기간으로 조회합니다. Performance Max는 광고 그룹 필드에 아무것도 보고하지 않으므로, 그 필드를 요청하면 활동이 없는 것처럼 읽히는 빈 결과를 돌려주지 않고 이유를 밝혀 거절합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 광고 계정의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 각 행에서...
woori_bank__accounts__transaction_history__search 먼저 호출할 도구: woori_bank__session__login (같은 account_link_id). 등록된 우리은행 계좌 하나의 거래내역을 기존 세션으로 조회합니다. 한 번에 한 쪽(50건)만 가져옵니다. 거래가 그 수에 닿거나 더 남으면 실패로 끝나니 기간을 나눠 다시 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의...
google__ads__demand_gen__report Google Ads 계정 하나의 Demand Gen 캠페인 성과를 기간으로 조회합니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 광고 계정의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 각 행에서 metrics.impressions 는 metrics.impressions 로, metrics.clicks 는 metrics.clicks 로, metrics.ctr 는 metrics.ctr 로 돌아오고, 그...
google__ads__video__report Google Ads 계정 하나의 동영상 캠페인 성과를 기간으로 조회합니다. 동영상 전용 지표 이름은 metrics.video_trueview_views 와 metrics.video_trueview_view_rate 이며, metrics.video_views 는 없습니다. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 광고 계정의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 각 행에서...
google__youtube__report_job__read 연동한 YouTube 계정의 예약 대량 보고와, 예약마다 만들어진 보고서(대상 기간, 만든 시각, 파일이 있는지)를 나열합니다. 읽기만 하며 예약을 만들거나 지우지 않습니다. job_id 없이 호출하면 어떤 예약이 있는지, job_id 를 주면 그 예약이 어떤 보고서를 만들었는지 답합니다. 보고서 파일 자체는 돌려주지 않습니다. 시각은 플랫폼이 밝힌 대로 RFC 3339 UTC입니다. 모든 결과는...
google__youtube__report_job__create 연동한 YouTube 계정에 대량 보고를 예약해 플랫폼이 그 보고서를 매일 만들기 시작하게 합니다. 같은 보고 유형의 예약이 이미 있으면 하나 더 만들지 않고 그 예약을 다시 쓰며, 결과의 reused 칸이 그 사실을 밝힙니다. 예약만 만듭니다. 고객 콘텐츠는 바뀌지 않고, 아무것도 게시되지 않으며, 보고서 파일 자체는 돌려주지 않습니다. 만든 뒤 예약 보고 목록 조회 도구로 만들어진 보고서를 확인하세요. 첫 보고서는...
google__ads__channels__report Google Ads 계정 하나에서 네 가지 캠페인 유형(검색, 디스플레이, Performance Max, Demand Gen)의 성과를 한 번의 호출로 합쳐 기간으로 조회합니다. 동영상 캠페인은 포함되지 않으므로 동영상 광고 성과 조회 도구를 쓰세요. 읽기만 합니다. 기간은 시작일과 종료일을 포함하며 광고 계정의 시간대를 따르고, 그 시간대는 결과에 함께 담깁니다. 각 행에서 metrics.impressions 는...
google__search_console__sitemap__submit 연동한 Search Console 사이트에 사이트맵 URL을 제출해 Google이 색인을 위해 읽을 수 있게 합니다. 사이트맵 URL은 선택한 사이트 안에 있어야 합니다. 되돌리려면 사이트맵 삭제 도구로 같은 URL을 삭제하세요. 삭제하면 목록에서만 빠지고, Google이 이미 알고 있는 URL이 검색에서 빠지지는 않습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
google__search_console__sitemap__delete 연동한 Search Console 사이트의 사이트맵 목록에서 사이트맵 URL을 삭제합니다. 사이트맵을 목록에서 뺄 뿐이며, Google이 이미 알고 있는 URL이 이것으로 검색에서 빠지지는 않습니다. 사이트맵 URL은 선택한 사이트 안에 있어야 합니다. 되돌리려면 사이트맵 제출 도구로 같은 URL을 다시 제출하세요. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
google__search_console__site__add 연동한 Google 계정의 Search Console 속성 목록에 사이트를 추가합니다. 추가한다고 그 사이트의 데이터를 읽을 수 있게 되지는 않습니다. 먼저 Search Console에서 소유권을 확인해야 하고, 그다음 연동 설정에서 그 사이트를 선택해야 합니다. 되돌리려면 Search Console 화면에서 속성을 삭제하세요. 사이트 제거 도구는 소유권을 확인하고 연동 설정에서 그 사이트를 선택한 뒤에만 쓸 수...
google__search_console__site__remove 연동한 Google 계정의 Search Console 속성 목록에서 사이트를 제거합니다. 제거하면 이 연동은 그 사이트를 더 이상 읽을 수 없습니다. 다른 사용자가 아직 그 속성을 가지고 있는 동안에는 Google이 데이터를 계속 수집합니다. 되돌리려면 사이트 추가 도구로 같은 사이트를 다시 추가하세요. 소유권이 확인된 소유자가 남아 있지 않으면 소유권을 다시 확인해야 할 수 있습니다. 이 도구는 기관의 기록을...
google__analytics__measurement__update 선택한 Google Analytics 속성의 설정(이름, 보고 시간대, 통화, 업종 분류)을 바꿉니다. 보낸 설정만 바뀝니다. 시간대를 바꿔도 과거 데이터에는 적용되지 않습니다. 결과에 이전 값이 담기므로, 되돌리려면 그 값으로 이 도구를 다시 실행하세요. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
hana_fast_account__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 하나은행 빠른조회 세션을 기존 연동으로 만듭니다. 비밀정보는 MCP 입력으로 받지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를...
google__analytics__measurement__create 연동한 Google 계정의 Analytics 계정 아래에 새 Google Analytics 속성을 만듭니다. 새 속성에는 아직 데이터 스트림이 없고, 조회하려면 먼저 연동 설정에서 선택해야 합니다. 이 상품으로는 속성을 삭제할 수 없으며, Google Analytics 관리 화면에서 삭제합니다. 결과를 알 수 없을 때는 다시 호출하지 마세요. 한 번 더 호출하면 속성이 하나 더 만들어집니다. 이 도구는 기관의 기록을...
google__youtube__video__update 선택한 채널에 있는 영상의 정보(제목, 설명, 태그, 카테고리, 공개 범위, 예약 공개 시각)를 바꿉니다. 보내지 않은 설정은 현재 값 그대로 다시 저장됩니다. 영상을 공개로 바꾸면 그사이 이미 노출된 것은 되돌릴 수 없고, 한 번이라도 공개된 적이 있는 영상은 공개 예약을 할 수 없습니다. 결과에 이전 값이 담기므로, 되돌리려면 그 값으로 이 도구를 다시 실행하세요. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은...
google__youtube__playlist__create 선택한 채널에 새 재생목록을 만듭니다. 이 상품으로는 재생목록을 삭제할 수 없으며, YouTube에서 삭제합니다. 결과를 알 수 없을 때는 다시 호출하지 마세요. 한 번 더 호출하면 재생목록이 하나 더 만들어집니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그...
google__youtube__playlist__item__add 선택한 채널의 재생목록에 영상을 추가합니다. 같은 영상을 다시 추가하면 한 번 더 추가될 수 있습니다. 이 상품으로는 재생목록에서 영상을 뺄 수 없으며, YouTube에서 뺍니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여...
hana_fast_account__accounts__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 호출자가 등록한 하나은행 계좌 연동 목록을 돌려줍니다. 항목마다 거래내역 도구가 쓰는 account_link_id 와 bank_account_credential_id 가 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
google__tag_manager__tag__create 선택한 Google Tag Manager 컨테이너의 작업공간에 태그를 만듭니다. 버전 게시 도구로 작업공간을 게시하기 전에는 그 태그가 실제 사이트에서 동작하지 않습니다. 이 상품으로는 태그를 삭제할 수 없으며, Tag Manager에서 삭제합니다. 결과를 알 수 없을 때는 다시 호출하지 마세요. 한 번 더 호출하면 태그가 하나 더 만들어집니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할...
google__tag_manager__tag__update 선택한 Google Tag Manager 컨테이너의 작업공간에 있는 태그(이름, 유형, 설정, 실행 트리거, 일시중지 상태, 메모)를 바꿉니다. 현재 태그를 먼저 읽고, 보내지 않은 설정은 현재 값 그대로 다시 저장합니다. 태그를 읽은 뒤 Tag Manager에서 그 태그가 바뀌었다면 아무것도 바꾸지 않고, 결과에 그 사실을 알려 줍니다. 작업공간을 게시하기 전에는 변경이 실제 사이트에 반영되지 않습니다. 결과에 이전...
google__tag_manager__version__publish 선택한 Google Tag Manager 컨테이너의 실제 사이트에 게시합니다. workspace_path 와 version_path 중 정확히 하나만 보내세요. workspace_path 를 보내면 그 작업공간이 새 버전이 되어 게시됩니다. 다른 사람이 한 수정을 포함해 그 작업공간의 모든 변경이 함께 게시되며, 결과에는 게시된 변경 목록이 담기고, Google이 새 작업공간 경로를 돌려주면 그 경로도 담깁니다....
google__search_console__sitemap__list 선택한 Search Console 사이트 하나에 제출된 사이트맵을 나열합니다. 사이트맵마다 URL(feedpath), 마지막 제출 시각, 아직 처리 대기 중인지를 알려 줍니다. 읽기만 합니다. 사이트맵 제출 도구나 사이트맵 삭제 도구의 결과를 알 수 없을 때는 쓰기를 다시 호출하지 말고 이 도구로 확인하세요. Google은 목록 전체를 한 번에 돌려주며 이 도구는 자르지 않습니다. 모든 결과는...
google__youtube__video__list 선택한 YouTube 채널에 올린 영상을 나열합니다. 영상마다 video_id, 제목, 공개 시각, 공개 범위를 알려 줍니다. 읽기만 합니다. 영상 정보 수정 도구나 영상 삭제 도구의 결과를 알 수 없을 때는 쓰기를 다시 호출하지 말고 이 도구로 확인하세요. 채널은 연동한 Google 계정이 소유한 것이어야 합니다. row_limit 는 이 호출이 돌려주는 행 수(기본 1000)이며 Google에 보내는 한도가...
hana_fast_account__accounts__transaction_history__search 먼저 호출할 도구: hana_fast_account__session__login (같은 account_link_id). 등록된 하나은행 계좌 하나의 거래내역을 기존 세션으로 조회합니다. 한 번에 한 쪽(60건)만 가져옵니다. 거래가 그 수에 닿거나 더 남으면 실패로 끝나니 기간을 나눠 다시 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의...
google__youtube__playlist__list 선택한 YouTube 채널의 재생목록을 나열합니다. 재생목록마다 playlist_id, 제목, 공개 범위, 영상 수, 만든 시각을 알려 줍니다. 읽기만 합니다. 재생목록 만들기 도구나 재생목록에 영상 넣기 도구의 결과를 알 수 없을 때는 쓰기를 다시 호출하지 말고 이 도구로 확인하세요. 채널은 연동한 Google 계정이 소유한 것이어야 합니다. row_limit 는 이 호출이 돌려주는 행 수(기본 1000)이며...
google__ads__video__asset__create 이미 YouTube에 있는 영상을 선택한 Google Ads 계정에 동영상 자산으로 연결합니다. 영상 주소는 브라우저 주소창에 보이는 그대로 보내세요. 재생목록 주소와 채널 주소는 거절됩니다. 영상 파일은 보내지도 업로드하지도 않습니다. 계정에 같은 영상의 자산이 이미 있으면 아무것도 보내지 않고, 결과에 그 자산을 알려 줍니다. 이 상품으로는 자산을 삭제할 수 없으며, 게재를 멈추려면 그 자산을 쓰는 광고에서 빼세요....
google__ads__search__campaign__update 선택한 Google Ads 계정의 검색 캠페인 하나를 수정합니다. 수정할 수 있는 것은 이름, 게재 여부(ENABLED 또는 PAUSED), 일일 예산입니다. 셋 중 하나 이상을 보내세요. 현재 값과 같은 값은 Google에 보내지 않습니다. daily_budget_amount 는 광고 계정의 통화 단위로 적습니다(KRW 계정이면 원 단위). Google은 하루에 일일 예산의 최대 두 배까지 지출할 수 있고 월 지출은...
google__ads__display__campaign__update 선택한 Google Ads 계정의 디스플레이 캠페인 하나를 수정합니다. 수정할 수 있는 것은 이름, 게재 여부(ENABLED 또는 PAUSED), 일일 예산입니다. 셋 중 하나 이상을 보내세요. 현재 값과 같은 값은 Google에 보내지 않습니다. daily_budget_amount 는 광고 계정의 통화 단위로 적습니다(KRW 계정이면 원 단위). Google은 하루에 일일 예산의 최대 두 배까지 지출할 수 있고 월...
google__ads__pmax__campaign__update 선택한 Google Ads 계정의 Performance Max 캠페인 하나를 수정합니다. 수정할 수 있는 것은 이름, 게재 여부(ENABLED 또는 PAUSED), 일일 예산입니다. 셋 중 하나 이상을 보내세요. 현재 값과 같은 값은 Google에 보내지 않습니다. daily_budget_amount 는 광고 계정의 통화 단위로 적습니다(KRW 계정이면 원 단위). Google은 하루에 일일 예산의 최대 두 배까지...
google__ads__demand_gen__campaign__update 선택한 Google Ads 계정의 Demand Gen 캠페인 하나를 수정합니다. 수정할 수 있는 것은 이름, 게재 여부(ENABLED 또는 PAUSED), 일일 예산입니다. 셋 중 하나 이상을 보내세요. 현재 값과 같은 값은 Google에 보내지 않습니다. daily_budget_amount 는 광고 계정의 통화 단위로 적습니다(KRW 계정이면 원 단위). Google은 하루에 일일 예산의 최대 두 배까지 지출할 수...
google__ads__search__campaign__create 선택한 Google Ads 계정에 검색 캠페인 하나를 한 번의 요청으로 만듭니다. 이 캠페인만 쓰는 새 일일 예산, 캠페인 본체(PAUSED 상태, 입찰 전략은 클릭수 최대화(Maximize clicks), Google 검색과 검색 파트너에만 게재), 광고 그룹 하나, 반응형 검색 광고 하나, 입력한 키워드가 함께 만들어집니다. 일부라도 거절되면 아무것도 만들지 않습니다. 삭제되지 않은 같은 이름의 캠페인이 있으면...
google__ads__display__campaign__create 선택한 Google Ads 계정에 디스플레이 캠페인 하나를 한 번의 요청으로 만듭니다. 이 캠페인만 쓰는 새 일일 예산, 캠페인 본체(PAUSED 상태, 입찰 전략은 전환수 최대화(Maximize conversions)), 광고 그룹 하나, 반응형 디스플레이 광고 하나, 업로드한 이미지마다 이미지 자산이 함께 만들어집니다. 이미지를 먼저 업로드하고 받은 업로드 ID를 넘기세요. 넘긴 업로드 ID 가운데 없는 것, 만료된...
google__ads__pmax__campaign__create 선택한 Google Ads 계정에 Performance Max 캠페인 하나를 한 번의 요청으로 만듭니다. 이 캠페인만 쓰는 새 일일 예산, 캠페인 본체(PAUSED 상태, 입찰 전략은 전환수 최대화(Maximize conversions)), 자산 그룹 하나, 그리고 제목, 설명, 비즈니스 이름, 업로드한 이미지마다 텍스트 또는 이미지 자산이 함께 만들어집니다. 비즈니스 이름과 로고는 캠페인에 연결되고 나머지는 자산...
google__ads__demand_gen__campaign__create 선택한 Google Ads 계정에 Demand Gen 캠페인 하나를 한 번의 요청으로 만듭니다. 이 캠페인만 쓰는 새 일일 예산, 캠페인 본체(PAUSED 상태, 입찰 전략은 전환수 최대화(Maximize conversions)), 광고 그룹 하나, 이미지 광고 하나, 업로드한 이미지마다 이미지 자산이 함께 만들어집니다. 이미지를 먼저 업로드하고 받은 업로드 ID를 넘기세요. 넘긴 업로드 ID 가운데 없는 것, 만료된...
google__youtube__video__thumbnail__set 선택한 채널에 있는 영상의 맞춤 썸네일을 먼저 업로드한 이미지로 설정합니다. JPG 또는 PNG를 업로드하되 purpose 는 youtube.thumbnail 로 지정하고, 받은 업로드 ID를 넘기세요. 넘긴 업로드가 없거나, 만료되었거나, 삭제되었거나, 본인 것이 아니거나, 다른 용도로 올린 것이면 아무것도 보내기 전에 요청이 중단됩니다. YouTube는 16:9 이미지를 권장합니다. 비율이 다른 이미지는 잘리지 않고...
google__youtube__video__caption__add 선택한 채널에 있는 영상에, 먼저 업로드한 자막 파일로 자막 트랙을 추가합니다. 시작 시각과 끝 시각이 들어 있는 UTF-8 SRT, VTT, SBV 파일을 업로드하되 purpose 는 youtube.caption 으로 지정하고, 받은 업로드 ID를 넘기세요. 시간 정보가 없는 파일은 업로드 때 거절됩니다. 넘긴 업로드가 없거나, 만료되었거나, 삭제되었거나, 본인 것이 아니거나, 다른 용도로 올린 것이면 아무것도 보내기...
google__upload__stage 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 나중에 호출할 Google 도구가 쓸 파일 하나를 올려 두고 `upload_id` 를 받습니다. 그 값을 그 파일을 쓰는 도구에 넘기세요. 여기서는 Google에 아무것도 보내지 않습니다. action 은 그 파일을 쓸 도구의 액션 ID입니다(도구 이름의 이중 밑줄을 점으로 바꾼 것). purpose 는 ads_image.marketing,...
google__tag_manager__tag__audit Tag Manager 컨테이너 하나에 게시된(실제 사이트에서 동작하는) 태그를 점검합니다. 게시된 태그가 모두 일시중지되어 있는지, 실행 트리거가 없어 한 번도 실행되지 않는 태그가 무엇인지 알려 줍니다. 읽기만 하며 태그를 바꾸지 않습니다. 게시되지 않은 작업공간 변경이 아니라 지금 게시된 컨테이너 버전을 읽습니다. 모든 결과는 data_availability 를 밝힙니다. 값은 complete,...
nh_fast_account__session__login 이 기관의 다른 도구보다 먼저 호출하세요. NH농협은행 빠른조회 세션을 기존 연동으로 만듭니다. 비밀정보는 MCP 입력으로 받지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로...
nh_fast_account__accounts__list 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 호출자가 등록한 NH농협은행 계좌 연동 목록을 돌려줍니다. 항목마다 잔액과 거래내역 도구가 쓰는 account_link_id 와 bank_account_credential_id 가 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
nh_fast_account__balance__query 먼저 호출할 도구: nh_fast_account__session__login (같은 account_link_id). 등록된 NH농협은행 계좌 하나의 현재 잔액을 기존 세션으로 조회합니다. bank_account_credential_id(계좌 하나), bank_account_credential_ids(여러 계좌), all_accounts(모든 계좌) 중 하나만 보내 주세요. 계좌마다 사용 토큰이 하나씩 듭니다. 기업정보...
nh_fast_account__transaction_history__search 먼저 호출할 도구: nh_fast_account__session__login (같은 account_link_id). 등록된 NH농협은행 계좌 하나의 거래내역을 기존 세션으로 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안...
naver_searchad__campaigns__read 조회만 합니다. 연동한 네이버 검색광고 계정의 캠페인 목록을 돌려줍니다. 캠페인마다 id, 이름, 유형, 상태가 들어 있습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다....
naver_searchad__adgroups__read 조회만 합니다. 캠페인 하나 아래의 광고그룹 목록을 돌려줍니다. nccCampaignId 를 넣습니다. nccCampaignId 는 캠페인 목록 조회에서 얻습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며...
naver_searchad__ads__read 조회만 합니다. 광고그룹 하나 아래의 광고(소재) 목록을 돌려줍니다. nccAdgroupId 를 넣습니다. nccAdgroupId 는 광고그룹 목록 조회에서 얻습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안...
naver_searchad__keywords__read 조회만 합니다. 광고그룹 하나에 등록된 키워드 목록을 돌려줍니다. nccAdgroupId 를 넣습니다. nccAdgroupId 는 광고그룹 목록 조회에서 얻습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며...
naver_searchad__performance__report 조회만 합니다. 캠페인이나 광고그룹 하나의, 정한 기간 동안의 노출수, 클릭수, 비용을 돌려줍니다. id(캠페인이나 광고그룹의 id), fields(보고할 지표), datePreset(기간, 예: last7days)을 넣습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에...
naver_searchad__bizmoney__read 조회만 합니다. 연동한 네이버 검색광고 계정의 비즈머니(bizmoney) 잔액과 그 계정의 budgetLock, refundLock 값을 돌려줍니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값...
tistory__retired_openapi__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 읽기 전용입니다. 티스토리에 임시저장하려면 넣어야 할 것을 알려 줍니다. 콘텐츠 산출물 참조, 글 제목, 선택인 태그와 카테고리, 꼭 필요한 권리 선언입니다. 이것을 읽는 데는 티스토리 연결이 필요 없습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그...
naver_searchad__campaigns__create 연동한 네이버 검색광고 계정에 캠페인 하나를 만듭니다. name 과 campaignTp(WEB_SITE, SHOPPING, POWER_CONTENTS, BRAND_SEARCH, PLACE 중 하나)를 넣습니다. 새 캠페인은 일시정지 상태로 만들어집니다. 하루 예산은 dailyBudget 과 useDailyBudget 으로 함께 정할 수 있고, 광고를 내려면 하루 예산을 정한 뒤 켜도록 안내하세요. 결과를 알 수 없을 때...
tistory__retired_openapi__create 연결된 티스토리 블로그에 새 임시저장 글을 만듭니다. document 를 주면 같은 단계에서 그 글에 내용을 저장하고, 빼면 빈 임시저장 글을 만듭니다. 아무것도 발행하지 않습니다. 최종 발행은 고객이 티스토리에서 하고, 내용은 고객의 것입니다. 먼저 티스토리 블로그를 연결해 주세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수...
naver_searchad__campaigns__update 캠페인 하나를 일시정지하거나 다시 켜거나(userLock), 하루 예산(dailyBudget, useDailyBudget)이나 게재 기간(periodStartDt, periodEndDt, usePeriod)을 바꿉니다. nccCampaignId 는 캠페인 목록 조회에서 얻습니다. 바뀐 결과는 네이버 검색광고의 응답으로 돌려줍니다. 입찰가와 하루 예산은 광고비 한도 안에서만 바꿀 수 있습니다. 광고비 한도는 광고비 한도...
tistory__retired_openapi__update 이미 있는 티스토리 임시저장 글을 새 내용으로 고쳐 다시 임시저장합니다. 발행하지 않습니다. 기존 임시저장 글 번호(sequence)와 document 를 넣습니다. 최종 발행은 고객이 티스토리에서 합니다. 먼저 티스토리 블로그를 연결해 주세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터...
naver_searchad__campaigns__delete 캠페인 하나와 그 아래의 광고그룹, 광고, 키워드를 모두 지웁니다. 되돌릴 수 없으므로 잠시 멈추려면 삭제 대신 일시정지하세요. 지운 뒤 다시 읽어 확인합니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를...
tistory__retired_openapi__publish 고객의 내용을 연결된 티스토리 블로그에 임시저장합니다. 발행하지 않습니다. 최종 발행은 언제나 고객이 티스토리에서 합니다. document 를 넣고, 기존 임시저장 글에 저장하려면 sequence 도 넣습니다. 빼면 새 임시저장 글을 만듭니다. 내용은 고객의 것입니다. 먼저 티스토리 블로그를 연결해 주세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와...
naver_searchad__adgroups__create 캠페인 아래에 광고그룹 하나를 만듭니다. nccCampaignId, name, adgroupType 과 PC 와 모바일의 비즈채널 id(pcChannelId, mobileChannelId)를 넣습니다. 비즈채널 id 는 기존 광고그룹 목록 조회 결과에 있고, 광고그룹이 하나도 없으면 네이버 검색광고 관리 화면에서 비즈채널을 확인하도록 안내하세요. 새 광고그룹도 일시정지 상태로 만들어지고, dailyBudget 과...
naver__blog__post_via_retired_api__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 읽기 전용입니다. 네이버 블로그에 임시저장하려면 넣어야 할 것을 알려 줍니다. 콘텐츠 산출물 참조, 글 제목, 선택인 태그와 카테고리, 꼭 필요한 권리 선언입니다. 이것을 읽는 데는 네이버 연결이 필요 없습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께...
naver_searchad__adgroups__update 광고그룹 하나를 일시정지하거나 다시 켜거나(userLock), 기본 입찰가(bidAmt), 하루 예산(dailyBudget, useDailyBudget), 네트워크별 입찰 가중치나 타기팅(targets 와 fields)을 바꿉니다. 타기팅은 다른 값과 한 요청에 섞을 수 없으니 따로 보냅니다. nccAdgroupId 는 광고그룹 목록 조회에서 얻습니다. 바뀐 결과는 네이버 검색광고의 응답으로 돌려줍니다. 입찰가와 하루...
naver__blog__post_via_retired_api__create 연결된 네이버 블로그에 새 임시저장 글을 만들고 주어진 내용을 저장합니다. 네이버에는 빈 임시저장 단계가 없어 document 가 필수입니다. 아무것도 발행하지 않습니다. 최종 발행은 고객이 네이버 블로그에서 하고, 내용은 고객의 것입니다. 먼저 네이버 계정을 연결해 주세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기...
naver_searchad__adgroups__delete 광고그룹 하나를 지웁니다. 되돌릴 수 없습니다. 지운 뒤 다시 읽어 확인합니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그...
naver__blog__post_via_retired_api__publish 연결한 내 네이버 블로그에 고객의 글을 임시저장합니다. document 에 글을 넣으세요. log_no 에 기존 초안 번호를 주면 그 초안에 이어서 저장해 같은 번호를 돌려주고, 주지 않으면 새 초안을 만듭니다. 임시저장 목록에 없는 번호면 저장하지 않고 초안을 찾지 못했다는 오류가 납니다. 발행은 하지 않습니다. 최종 발행은 고객이 네이버 블로그에서 직접 하고, 글의 내용은 고객의 것입니다. 네이버 계정을 먼저...
naver_searchad__ads__create 광고그룹에 광고 하나를 만듭니다. nccAdgroupId, type, ad(그 유형의 소재)를 넣고, RSA_AD 이면 assets(제목과 설명)도 넣습니다. 광고는 네이버 심사를 거친 뒤 노출됩니다. 소재는 나중에 고칠 수 없으므로, 바꾸려면 새 광고를 만들고 옛 광고를 일시정지하거나 지우세요. 먼저 네이버 검색광고 계정을 연동해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의...
naver__blog__owner_stats__report 연결한 내 네이버 블로그의 방문 통계를 조회합니다. metric 에 통계 지표 한 가지를, start_date 에 기준일(YYYY-MM-DD)을 주면 그 날까지 15일의 날짜별 통계를 entries 목록으로 돌려줍니다. 유입 경로(user/referer/total 과 daily/cv 의 유입 항목)는 기준일 하루치입니다. 각 항목에 dataId, columnInfo, rows, utime 이 있습니다. metric 은...
naver_searchad__ads__update 광고 하나를 일시정지하거나 다시 켭니다(userLock). 소재는 바꿀 수 없습니다. nccAdId 는 광고 목록 조회에서 얻습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여...
naver__blog__owner_post__read 연결한 내 네이버 블로그의 글을 조회합니다. log_no(글 번호)를 주면 그 글의 제목, 날짜, 본문을 돌려주고(mode=view), 주지 않으면 내 글 목록(제목, 글 번호, 날짜, 조회 수, 댓글 수 등)을 돌려줍니다(mode=list). 목록 조회일 때만 output_formats 에 xlsx 를 주어 글 목록을 엑셀 파일로도 받을 수 있습니다. 글 한 편의 본문 조회에는 파일이 없어 output_formats...
naver_searchad__ads__delete 광고 하나를 지웁니다. 되돌릴 수 없습니다. 지운 뒤 다시 읽어 확인합니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그...
naver__content__stage 고객이 작성한 본문을 암호화해 보관하고 content_artifact_ref와 expires_at을 반환합니다. action에는 이 본문을 실제로 사용할 임시저장 액션을 넣으세요. 기관 로그인, 글 저장, 발행, 새 작업 실행, 사용량 차감은 하지 않습니다. 반환된 참조를 기존 document.content_artifact_ref에 넣고, 만료 후 재연결해도 같은 유효 참조로 원래 작업을 이어가세요....
naver_searchad__keywords__create 광고그룹 하나에 키워드를 한 번에 더합니다. nccAdgroupId 와 keywords(keyword 를 담은 객체 목록)를 넣습니다. 키워드 객체에 bidAmt 를 넣으면 그 키워드의 입찰가가 되고, 빼면 광고그룹의 기본 입찰가를 따릅니다. 입찰가 없이 만든 광고그룹이면 네이버 최소 입찰가 70원입니다. useGroupBidAmt 는 넣지 마세요. 새 키워드는 네이버 심사를 거친 뒤 노출됩니다. 일부만 거절되면 결과에...
tistory__content__stage 고객이 작성한 본문을 암호화해 보관하고 content_artifact_ref와 expires_at을 반환합니다. action에는 이 본문을 실제로 사용할 임시저장 액션을 넣으세요. 기관 로그인, 글 저장, 발행, 새 작업 실행, 사용량 차감은 하지 않습니다. 반환된 참조를 기존 document.content_artifact_ref에 넣고, 만료 후 재연결해도 같은 유효 참조로 원래 작업을 이어가세요....
naver_searchad__keywords__update 키워드 하나를 일시정지하거나 다시 켜거나(userLock), 입찰가(bidAmt)를 바꿉니다. nccKeywordId 는 키워드 목록 조회에서 얻습니다. 입찰가와 하루 예산은 광고비 한도 안에서만 바꿀 수 있습니다. 광고비 한도는 광고비 한도 정하기(marketing__budget_limit__set)로 정한 하루 예산 상한과 입찰가 상한입니다. 한도가 없거나 넘는 요청은 실행되지 않으므로, 금액을 넣기 전에 광고비...
blog_autowrite__style__profile 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 엑스보스 공개 블로그에서 정리한 글 구성과 스타일을 조회합니다. 사용 중인 AI가 이 스타일로 본문을 작성한 뒤 naver.content.stage 또는 tistory.content.stage로 보관할 수 있습니다. 제품의 유료 AI 생성, 제공사 로그인, 임시저장이나 최종 발행을 실행하지 않습니다. 로그인한 호출이면 첫 요청 전에...
naver_searchad__keywords__delete 키워드 하나를 지웁니다. 되돌릴 수 없습니다. 지운 뒤 다시 읽어 확인합니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그...
blog_autowrite__content__generate 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 고객이 명시적으로 요청할 때에만 선택한 유료 AI로 한국어 검토용 본문을 생성하고 content_artifact_ref를 반환합니다. 엑스보스 공개 블로그 스타일을 참고합니다. 제공사 로그인, 네이버나 티스토리의 임시저장, 최종 발행은 별도입니다. 반환된 본문 참조를 기존 블로그 초안 작업에 전달하세요. 결과가 불확실하면 기존 작업부터 확인하고 새 키로 자동 재작성하지...
naver_searchad__measurement__audit 조회만 합니다. 연동한 계정 전체(캠페인, 광고그룹, 광고, 키워드)를 읽고 광고가 나가지 못하는 이유를 알려 줍니다. 캠페인이 모두 일시정지된 경우, 광고그룹이 모두 일시정지된 경우, 비즈채널이 없는 광고그룹, 키워드와 광고가 하나도 없는 광고그룹을 찾고 항목마다 고치는 법을 함께 줍니다. 입력이 없습니다. 먼저 네이버 검색광고 계정을 연동해야 합니다. 로그인한 호출이면 첫 요청 전에...
naver__blog__owner_post__update 연결한 내 네이버 블로그의 임시저장 초안 하나를 새 내용으로 고쳐 다시 임시저장합니다. log_no 에 고칠 초안 번호(글 초안 만들기 결과의 log_no)를, document 에 바꿀 글을 넣으세요. 임시저장 목록에 없는 번호면 고치지 않고 초안을 찾지 못했다는 오류가 나며, 새 글을 만들지 않습니다. 발행은 하지 않습니다. 최종 발행은 고객이 네이버 블로그에서 직접 하고, 글의 내용은 고객의 것입니다. 네이버 계정을...
naver__upload__stage 블로그 글의 이미지 블록에 넣을 이미지 파일 하나를 올려 두고 upload_id 를 받습니다. 그 값을 글 내용 image 블록의 upload_id 에 넣으면 글을 저장할 때 그 자리에 이미지가 들어갑니다. 여기서는 블로그에 아무것도 보내지 않습니다. action 은 그 글을 저장할 도구의 액션 ID이고 purpose 는 naver.blog_image 입니다. content_base64 는 파일 바이트를 base64 로...
tistory__upload__stage 블로그 글의 이미지 블록에 넣을 이미지 파일 하나를 올려 두고 upload_id 를 받습니다. 그 값을 글 내용 image 블록의 upload_id 에 넣으면 글을 저장할 때 그 자리에 이미지가 들어갑니다. 여기서는 블로그에 아무것도 보내지 않습니다. action 은 그 글을 저장할 도구의 액션 ID이고 purpose 는 tistory.blog_image 입니다. content_base64 는 파일 바이트를 base64...
naver_openapi__blog__search 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 검색어(query)에 맞는 네이버 블로그 글을 찾아 목록으로 돌려줍니다. 결과 items 의 각 글에 제목(title), 글 링크(link), 요약(description), 블로그 이름(bloggername), 블로그 주소(bloggerlink), 작성일(postdate)이 있고, 전체 건수는 total 에 담깁니다. display 로 한 번에 받을 글 수(1~100,...
marketing__growth_review__compute 채널별 광고비와 고객이 입력한 매출, 신규 유료 고객 수로 마케팅 성과 보고를 계산합니다. channels 에는 채널 이름과 그 기간의 광고비를 넣습니다. 계산하는 지표는 ROAS(광고비 대비 매출)와 CAC(신규 유료 고객 1명당 광고비) 두 가지이고, goal 에 목표를 넣으면 목표 대비 실적을 함께 돌려줍니다. 매출이나 고객 수가 없거나 통화가 섞이면 그 지표는 값 대신 사유를 돌려주며 숫자를 지어내지 않습니다....
marketing__lead_to_revenue__reconcile 고객이 입력한 광고비, 매출, 신규 유료 고객 수, 기여이익으로 ROAS(광고비 대비 매출), 마케팅 ROI(포함 비용 대비 기여이익), CAC(신규 유료 고객 1명당 광고비)를 계산합니다. 필수 입력은 보고 기간과 광고비뿐이고, 나머지는 넣은 만큼 계산하며 없는 지표는 값 대신 사유를 돌려줍니다. 입력한 숫자로 계산만 하고 매출 원장을 보관하지 않습니다. 외부 기관이나 광고 계정을 부르지 않으며 로그인이나 연동이 필요...
marketing__optimization__suggest 고객이 조회해 넣은 광고 항목(키워드, 검색어, 소재, 입찰)의 실적과 고객이 정한 기준(policy)으로 개선 후보를 제안합니다. 클릭 수, 집계 기간, 설정 변경 뒤 학습 기간 기준을 채우지 못한 항목은 제안하지 않고 사유를 돌려줍니다. 결과는 제안일 뿐 광고를 바꾸지 않으며, 실제 변경은 고객이 검토한 뒤 따로 합니다. 외부 기관이나 광고 계정을 부르지 않으며 로그인이나 연동이 필요 없습니다. 로그인한 호출이면 첫...
marketing__report_archive__list 엑스보스에 보관한 마케팅 성과 보고를 찾습니다. 기간을 주면 그 기간과 겹치는 보고만, channel 을 주면 그 채널이 담긴 보고만 돌려주고, limit 로 최대 건수(1~500, 기본 100)를 정합니다. 보관된 보고를 읽기만 하며 로그인이나 연동이 필요 없습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와...
marketing__report_archive__save 고객이 보관을 요청한 마케팅 성과 보고를 엑스보스에 보관하고 보관 번호(archived_report_id)를 돌려줍니다. report_content 에는 성과 보고 도구가 돌려준 결과를 그대로 넣고, 채널 이름과 보고 기간, 보고를 만든 시각(as_of)을 함께 넣습니다. 고객이 보관을 요청했을 때만 부르세요. 부를 때마다 한 건씩 새로 보관되니 같은 보고는 한 번만 보냅니다. 광고나 외부 기관에 아무것도 쓰지 않으며...
marketing__budget_limit__get 이 조직이 정한 광고비 한도(하루 예산 상한과 입찰가 상한, 원 단위)를 읽습니다. 정한 적이 없으면 비어 있는 한도를 돌려주며, 비어 있는 칸은 무제한이 아니라 그 금액을 바꾸는 요청을 막습니다. 한도는 광고 금액을 바꾸는 요청을 막는 기준이고 실제 하루 지출 상한을 보장하지 않습니다. 엑스보스에 저장된 설정을 읽기만 합니다. 외부 기관이나 광고 계정을 부르지 않으며 로그인이나 연동이 필요 없습니다. 로그인한 호출이면...
marketing__budget_limit__set 이 조직의 광고비 한도(하루 예산 상한과 입찰가 상한, 원 단위)를 정합니다. 하루 예산 상한은 daily_budget_limit_won, 입찰가 상한은 max_bid_limit_won 에 0 이상의 정수를 넣고, null 을 넣으면 그 칸을 비웁니다. 보내지 않은 칸은 지금 값 그대로입니다. 비운 칸은 무제한이 아니라 그 금액을 바꾸는 요청을 막습니다. 두 칸 모두 지금 값 이하로 낮추거나 비우는 요청은 첫 호출에...
vat__case__create 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 한 회사와 신고 기간에 대한 부가세 준비 사건을 생성합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
vat__analysis__run 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 표준 부가세 준비 분석 파이프라인을 실행합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
vat__case__get 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 현재 부가세 사건과 준비 상태를 조회합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
vat__analysis__snapshot__get 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 현재 부가세 분석 단계 결과 하나를 조회합니다. 거래와 문서 같은 큰 목록은 건수와 쪽 수만 돌려주고, 목록 이름과 쪽 번호를 지정하면 그 쪽의 내용을 돌려줍니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에...
vat__recommendation__group__get 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 최종 반영 없이 추천 그룹 하나를 미리 봅니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
vat__card__review__import_and_apply 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 회계사 카드 공제 검토 파일을 반입하고 기관 반영을 요청하며, 반영 결과는 같은 case_id 로 사건 조회(vat__case__get)를 불러 확인합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를...
hometax__tax__vat__draft__load 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 부가가치세 정기신고에서 신고서 본문 조회 작업을 수행합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그...
hometax__tax__vat__amendment__create 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 부가가치세 정기신고에서 신고서 본문 수정신고 생성 작업을 수행합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와...
hometax__tax__vat__delete_request__prepare 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 최종 제출 전에 선택한 신고, 신청인, 전화번호, 개인정보 동의를 준비합니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을...
comwel__info__premium_billing_notice__search 먼저 호출할 도구: comwel__auth__npki_session__login (같은 account_link_id). 근로복지공단 보험료 부과고지 내역을 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가...
comwel__info__premium_billing_notice__detail 먼저 호출할 도구: comwel__auth__npki_session__login (같은 account_link_id). 근로복지공단 보험료 부과고지 상세를 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가...
comwel__info__individual_billed_premium__worker_select 먼저 호출할 도구: comwel__auth__npki_session__login (같은 account_link_id). 근로복지공단 개인별 부과고지 보험료 조회에 쓸 근로자를 검색해 고릅니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이...
comwel__info__individual_billed_premium__detail 먼저 호출할 도구: comwel__auth__npki_session__login (같은 account_link_id). 고른 근로자 한 명의 근로복지공단 개인별 부과고지 보험료 상세를 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일...
hometax__tax__withholding__regular_report__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 원천세 정기신고의 단계마다 필요한 입력과 준비자료를 알려 줍니다. 기관에 접속하지 않고 계정 연결도 필요 없습니다. 다른 단계보다 먼저 부르세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값...
hometax__tax__withholding__regular_report__init 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 정기신고서 작성을 시작합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에...
hometax__tax__withholding__regular_report__basic_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 정기신고서에 납세자와 신고 기본정보를 저장합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다....
hometax__tax__withholding__regular_report__detail_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 정기신고서에 소득 구분별 상세를 저장합니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__regular_report__review 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 정기신고서를 미리보기나 제출 전에 검토합니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__regular_report__preview 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출 전에 작성 중인 원천세 정기신고서를 미리 봅니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
hometax__tax__withholding__regular_report__submit 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 정기신고서를 제출합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은...
hometax__tax__withholding__regular_report__history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기간을 정해 접수된 원천세 신고(정기신고, 수정신고, 기한후신고) 목록을 조회합니다. 행마다 접수번호, 접수일, 신고일, 귀속연월, 지급연월, 신고 구분, 납부세액, 납부 상태를 돌려주고 page 에 페이지 번호와 전체 건수를 싣습니다. start_date 와 end_date 는 신고일 기준 YYYYMMDD 이고...
hometax__tax__withholding__amendment_report__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 원천세 수정신고의 단계마다 필요한 입력과 준비자료를 알려 줍니다. 기관에 접속하지 않고 계정 연결도 필요 없습니다. 다른 단계보다 먼저 부르세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값...
hometax__tax__withholding__amendment_report__init 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 귀속연월과 지급연월로 원천세 수정신고 초안을 엽니다. 이미 제출한 수정신고가 있으면 그 사본으로 다시 고치고, 없으면 마감된 원신고의 수정신고를 처음 작성합니다. draft_mode resume 으로 기관에 저장해 둔 수정신고를 이어서 작성합니다. 기관에 작성 중인 신고서를 만듭니다. 호출마다 토큰 1소진 요청 처리 시...
hometax__tax__withholding__amendment_report__lookup 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 수정신고 작성에 필요한 기납부세액, 가산세, 저장된 신고서를 조회합니다. 조회만 하고 신고서를 바꾸지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는...
hometax__tax__withholding__amendment_report__detail_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 수정신고서의 소득 종류별 인원과 금액을 작성 중인 신고서에 저장합니다. 제출하지 않습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__amendment_report__review 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 저장한 원천세 수정신고서를 기관 검증 기준으로 검토합니다. 제출 전에 부르세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__amendment_report__preview 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출 직전 원천세 수정신고서 전체 모습을 그대로 보여 줍니다. 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
hometax__tax__withholding__amendment_report__submit 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 수정신고서를 기관에 제출합니다. 되돌릴 수 없는 기관 쓰기라 사용자의 제출 확인과 동의 값을 명시해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED)....
hometax__tax__withholding__amendment_report__receipt 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출한 원천세 수정신고의 접수번호와 접수일을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
hometax__tax__withholding__amendment_report__history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기간을 정해 원천세 신고 접수 내역을 조회합니다. 정기, 수정, 기한후 신고가 함께 오므로 결과의 신고 구분으로 수정신고 건을 골라 쓰세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
hometax__tax__withholding__late_report__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 원천세 기한후신고의 단계마다 필요한 입력과 준비자료를 알려 줍니다. 기관에 접속하지 않고 계정 연결도 필요 없습니다. 다른 단계보다 먼저 부르세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이...
hometax__tax__withholding__late_report__init 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 귀속연월과 지급연월을 정해 원천세 기한후신고 작성을 시작합니다. 기관에 작성 중인 신고서를 만듭니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__late_report__lookup 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 기한후신고 작성에 필요한 기납부세액, 가산세, 저장된 신고서를 조회합니다. 조회만 하고 신고서를 바꾸지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는...
hometax__tax__withholding__late_report__basic_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 기한후신고서의 신고 구분과 납세자 정보를 작성 중인 신고서에 저장합니다. 제출하지 않습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__late_report__detail_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 기한후신고서의 소득 종류별 인원과 금액을 작성 중인 신고서에 저장합니다. 제출하지 않습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__late_report__review 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 저장한 원천세 기한후신고서를 기관 검증 기준으로 검토합니다. 제출 전에 부르세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__late_report__preview 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출 직전 원천세 기한후신고서 전체 모습을 그대로 보여 줍니다. 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
hometax__tax__withholding__late_report__submit 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 기한후신고서를 기관에 제출합니다. 되돌릴 수 없는 기관 쓰기라 사용자의 제출 확인과 동의 값을 명시해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED)....
hometax__tax__withholding__late_report__receipt 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출한 원천세 기한후신고의 접수번호와 접수일을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
hometax__tax__withholding__late_report__history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기간을 정해 원천세 신고 접수 내역을 조회합니다. 정기, 수정, 기한후 신고가 함께 오므로 결과의 신고 구분으로 기한후신고 건을 골라 쓰세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
hometax__tax__withholding__delete_request__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 원천세 신고 삭제신청의 단계마다 필요한 입력과 준비자료를 알려 줍니다. 기관에 접속하지 않고 계정 연결도 필요 없습니다. 다른 단계보다 먼저 부르세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요....
hometax__tax__withholding__delete_request__candidates 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 삭제를 신청할 수 있는 접수된 원천세 신고 목록을 조회합니다. 조회만 하고 신고를 바꾸지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이...
hometax__tax__withholding__delete_request__prepare 먼저 호출할 도구: hometax__session__login (같은 account_link_id). candidates 에서 고른 원천세 신고와 신청인 이름, 연락처, 개인정보 동의를 제출 전에 확인합니다. 조회만 하고 기관에 제출하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시...
hometax__tax__withholding__delete_request__submit 먼저 호출할 도구: hometax__session__login (같은 account_link_id). prepare 로 확인한 원천세 신고의 삭제신청을 기관에 제출합니다. 기관이 검토해 삭제하므로 제출이 곧 삭제 확정은 아닙니다. 되돌릴 수 없는 기관 쓰기라 사용자의 제출 확인과 동의 값을 명시해야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용...
hometax__tax__withholding__delete_request__receipt 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출한 원천세 신고 삭제신청의 접수번호와 처리 상태를 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이...
hometax__tax__withholding__delete_request__history 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기간을 정해 원천세 신고 삭제신청 접수 내역을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다....
hometax__tax__withholding__file_conversion__requirements 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 원천세 전자파일 변환신고의 단계마다 필요한 입력과 준비자료, 원본 파일을 등록하는 방법을 알려 줍니다. 기관에 접속하지 않고 계정 연결도 필요 없습니다. 다른 단계보다 먼저 부르세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로...
hometax__tax__withholding__file_conversion__init 먼저 호출할 도구: hometax__session__login (같은 account_link_id). filing_type 으로 신고 구분을 정해(regular 정기, amendment 수정, late 기한후, 기본 regular) 원천세 전자파일 변환신고를 시작합니다. 기관이 받는 원본 파일 크기 범위와 진행 중인 변환 작업을 읽기만 하고 기관에 아무것도 올리지 않습니다. 기관에 진행 중인 작업이 있으면 그 작업...
hometax__tax__withholding__file_conversion__upload 먼저 호출할 도구: hometax__session__login (같은 account_link_id). init 의 job_id 를 source_job_id 로, snapshot_hash 를 expected_snapshot_hash 로 하여 미리 등록한 원천세 전자파일 원본을 기관에 올리고 곧바로 형식검증을 요청합니다. 원본 파일 내용은 이 도구로 보낼 수 없습니다. 먼저 REST POST...
hometax__tax__withholding__file_conversion__content_validate 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 형식검증을 통과한 뒤에만 원천세 전자파일 내용검증을 기관에 요청합니다. 통과 전이면 거절됩니다. 요청이 받아들여지면 끝나며, 내용검증 결과와 오류, 경고는 status 로 확인하세요. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을...
hometax__tax__withholding__file_conversion__status 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 전자파일 변환 작업의 진행현황을 기관에서 다시 읽어 옵니다. view 로 summary(요약, 기본), format_errors(형식검증 오류 목록), format_error_detail(형식검증 오류 한 건의 상세, 오류가 여러 건이면 format_error_row_num 으로 고름),...
hometax__tax__withholding__file_conversion__preview 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 내용검증까지 끝나 변환이 완료된 작업에서 제출할 원천세 신고 대상 전체를 보여 줍니다. 변환이 끝나지 않았거나 정상 변환된 대상이 없으면 거절됩니다. 제출하지 않습니다. submit 은 이 단계의 job_id 를 source_job_id 로 받아 미리 본 대상이 그대로일 때만 제출합니다. 로그인한 호출이면 첫 요청 전에...
hometax__tax__withholding__file_conversion__submit 먼저 호출할 도구: hometax__session__login (같은 account_link_id). preview 로 확인한 원천세 전자파일 변환신고 대상을 기관에 제출합니다. 되돌릴 수 없는 기관 쓰기라 사용자의 제출 확인 confirm_submit 과 동의 sbms_agreement 를 함께 보내야 하고 confirm_submit 이 true 여야 제출됩니다. 내용검증 경고가 있으면 confirm_warnings...
hometax__tax__withholding__file_conversion__receipt 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 제출한 원천세 전자파일 변환 작업의 접수번호를 조회합니다. 조회만 합니다. 제출 응답이 불분명했으면 다시 제출하지 말고 이 단계로 접수 여부를 먼저 확인하세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께...
hometax__tax__withholding__amendment_report__basic_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 수정신고서의 신고 구분과 납세자 정보를 작성 중인 신고서에 저장합니다. 제출하지 않습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
hometax__tax__withholding__amendment_report__annex_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 수정신고서의 부표를 저장하고 기관에서 다시 읽어 저장된 내용을 확인합니다. detail_save 로 소득별 상세를 저장한 뒤에 부릅니다. annex_document 의 kind 로 부표 종류를 고르고, 있던 행을 고치거나 지울 때는 lookup 의 부표 조회가 돌려준 행 번호와 해시를 함께 보냅니다....
hometax__tax__withholding__amendment_report__cancel_draft 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기관에 작성 중인 원천세 수정신고서를 취소합니다. 취소하면 그 작성 중 신고서를 되살릴 수 없습니다. 이미 접수된 신고는 취소하지 않으며 접수된 신고를 지우려면 신고 삭제신청을 쓰세요. 그 작성 중 신고서를 다룬 직전 단계의 job_id 를 source_job_id 로 넘깁니다. 이 도구는 기관의 기록을 바꿉니다. 첫...
hometax__tax__withholding__late_report__annex_save 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 기한후신고서의 부표를 저장하고 기관에서 다시 읽어 저장된 내용을 확인합니다. detail_save 로 소득별 상세를 저장한 뒤에 부릅니다. annex_document 의 kind 로 부표 종류를 고르고, 있던 행을 고치거나 지울 때는 lookup 의 부표 조회가 돌려준 행 번호와 해시를 함께 보냅니다....
hometax__tax__withholding__late_report__cancel_draft 먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기관에 작성 중인 원천세 기한후신고서를 취소합니다. 취소하면 그 작성 중 신고서를 되살릴 수 없습니다. 이미 접수된 신고는 취소하지 않으며 접수된 신고를 지우려면 신고 삭제신청을 쓰세요. 그 작성 중 신고서를 다룬 직전 단계의 job_id 를 source_job_id 로 넘깁니다. 이 도구는 기관의 기록을 바꿉니다. 첫...
wetax__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 콘솔에 등록한 사업장 공동인증서로 위택스에 로그인해, 이후 신고 단계와 조회가 함께 쓰는 세션을 만듭니다. 인증서 비밀번호나 인증서 파일은 호출 값으로 받지 않습니다. Call it again if a tool reports the session expired. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한...
wetax__tax__local__due__query 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 지방세 고지 및 미납 내역을 조회하며 납부나 신고는 수행하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
wetax__tax__local__payment__history__query 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 지방세 납부 이력과 기관 식별자를 조회하며 납부는 수행하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시...
wetax__tax__local__refund__query 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 지방세 환급 가능 건수와 신청과 지급 내역, 처리 상태를 조회하며 환급 신청은 수행하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을...
wetax__tax__local_income__special_withholding__init 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 로그인한 사업장이 특별징수 신고를 할 수 있는지, 신고할 사업장(사업자등록번호 일부 가림, 상호, 관할 지자체 코드), 저장 단계마다 넣을 값과 막힌 사유를 돌려줍니다. 신고서는 만들지 않습니다 - 신고서는 신고인 저장이 처음 만듭니다. 로그인한 호출이면 첫 요청 전에...
wetax__tax__local_income__special_withholding__declarant_save 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 기관에 저장합니다. 신고인(대표자)을 정해 위택스에 작성 중인 신고서를 만들고 신고 식별자(dclr_id)를 돌려줍니다. 이후 단계는 모두 이 식별자를 받습니다. 회원정보의 연락처를 그대로 쓰려면 same_as_member_info=true 를 보냅니다. 제출하지 않은 신고서는 위택스가 다음 날 지웁니다. 요청 처리 시...
wetax__tax__local_income__special_withholding__target_save 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 기관에 저장합니다. 귀속 연월, 지급 연월과 소득 종류별 한 줄(인원, 과세표준, 특별징수 지방소득세)을 저장합니다. 귀속 연월은 지급 연월보다 늦을 수 없고, 과세표준이 있는 줄은 인원이 있어야 합니다. 납부지연 일수를 비우면 위택스가 계산한 값을 씁니다. 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다....
wetax__tax__local_income__special_withholding__adjustment_save 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 기관에 저장합니다. 합계를 확인한 뒤 세액과 조정 내용을 저장합니다. 저장되는 조정액, 납부액, 가산세는 보낸 값이 아니라 서버가 이 입력으로 계산한 값입니다. 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별...
wetax__tax__local_income__special_withholding__statement_save 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 기관에 저장합니다. 소득자별 명세 줄을 검사한 뒤 저장합니다. 명세는 선택이라 줄 없이 보내면 명세 없이 다음 단계로 넘어갑니다. 소득 종류, 성명, 식별번호가 같은 줄이 둘이면 거절합니다. 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이...
wetax__tax__local_income__special_withholding__review 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 위택스에 지금 저장된 신고 내용(신고 상태, 귀속 연월, 지급 연월, 과세표준, 산출세액, 납부할 금액)을 돌려줍니다. 제출 전에 이 값을 사용자에게 보여 주고 확인을 받습니다 - 제출한 신고는 미납이고 납부기한이 지나지 않았을 때만 취소할 수 있습니다. 로그인한 호출이면 첫 요청 전에...
wetax__tax__local_income__special_withholding__submit 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 기관에 한 번 제출합니다(실제 신고). 세 확인값(confirm_submit, confirm_amounts_reviewed, confirm_legal_effect)이 모두 true 여야 하고, 하나라도 빠지면 아무것도 보내지 않습니다. 제출한 신고는 미납이고 납부기한이 지나지 않았을 때만 신고 취소 도구로 취소할 수...
wetax__tax__local_income__special_withholding__payment_status 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 제출한 신고의 납부 여부와 납부용 가상계좌 건수, 납부할 금액을 돌려줍니다. 계좌번호는 돌려주지 않고 납부도 하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고,...
wetax__tax__local_income__special_withholding__cancel 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 기관에 한 번 보냅니다. 제출한 신고를 취소하며, 취소한 신고는 되살릴 수 없어 필요하면 다시 신고해야 합니다. 제출된 신고이고 미납이며 납부기한이 지나지 않았을 때만 보내고, 아니면 아무것도 보내지 않고 그 이유를 답합니다. 두 확인값(confirm_cancel, confirm_legal_effect)이 모두 true...
wetax__tax__local_income__special_withholding__search_history 먼저 호출할 도구: wetax__session__login (같은 account_link_id). 조회만 합니다. 기간 안의 신고 이력(신고 식별자, 신고일, 신고 상태, 관할 지자체, 납부 여부)을 돌려줍니다. 납부 여부 칸은 비어 올 수 있고, 금액과 귀속 연월은 담기지 않습니다. 제출을 다시 보내기 전에 앞선 제출이 접수됐는지 여기서 확인합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 -...
si4n__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 사업장 인증서로 로그인하고 다른 사회보험통합징수포털 도구들이 함께 쓰는 세션을 저장합니다. 도구가 세션이 만료됐다고 알리면 다시 호출합니다. 개인사업자는 추후 지원 예정입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새...
si4n__premium__inquiry 먼저 호출할 도구: si4n__session__login (같은 account_link_id). 조회만 합니다. 사업장이 내야 할 보험료와 아직 내지 않은 금액을 돌려줍니다. view 를 by_insurance 로 두고 insurance_type 을 넣으면 그 보험 하나의 고지 내역을, regular_batch 나 batch 로 두면 기관이 보여 주는 보험들의 고지 내역을 한 표로 돌려줍니다. 요약과 체납 내역은 언제나...
si4n__premium_calculation__inquiry 먼저 호출할 도구: si4n__session__login (같은 account_link_id). 조회만 합니다. 고지 월 하나의 보험료를 가입자 수, 월 보험료, 고지 보험료, 연체금, 지원금, 소급 보험료로 나눠 돌려줍니다. 보험료가 늘어난 까닭을 찾을 때 씁니다. 개인별 상세와 엑셀 내려받기는 제공하지 않습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요....
si4n__payment_confirmation__issue 먼저 호출할 도구: si4n__session__login (같은 account_link_id). 납부확인서를 발급합니다. 보험 하나 또는 네 보험 통합(combined)을 고르고 증명서 종류와 기간을 넣습니다. 돌려받는 문서의 비밀번호는 기관이 정합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
gov24__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 법인 인증서로 로그인하고 정부24 증명서 발급 도구들이 함께 쓰는 세션을 저장합니다. 도구가 세션이 만료됐다고 알리면 다시 호출합니다. 개인사업자는 추후 지원 예정입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을...
gov24__local_tax_certificate__issue 먼저 호출할 도구: gov24__session__login (같은 account_link_id). 지방세 납세증명서를 발급하고 내려받는 링크를 돌려줍니다. pre_consent 는 true 여야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를...
gov24__business_registration_certificate__issue 먼저 호출할 도구: gov24__session__login (같은 account_link_id). 사업자등록증명을 발급하고 내려받는 링크를 돌려줍니다. privacy_disclosure 로 주민등록번호를 표시할지 정합니다. pre_consent 는 true 여야 합니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류...
efine__session__login 이 기관의 다른 도구보다 먼저 호출하세요. 법인 인증서로 로그인하고 교통민원24 조회 도구들이 함께 쓰는 세션을 저장합니다. 도구가 세션이 만료됐다고 알리면 다시 호출합니다. 개인사업자는 추후 지원 예정입니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을...
efine__recent_enforcement__query 먼저 호출할 도구: efine__session__login (같은 account_link_id). 조회만 합니다. 기관이 가진 최근 단속 내역을 건수, 다음 쪽이 있는지와 함께 돌려줍니다. 납부와 이의신청은 제공하지 않습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는...
efine__unpaid_penalty__query 먼저 호출할 도구: efine__session__login (같은 account_link_id). 조회만 합니다. 미납 과태료 목록을 돌려줍니다. all_period 를 true 로 두면 전체 기간을 조회하고, false 로 두면 기간(date_from, date_to)을 넣습니다. date_basis 로 그 기간이 납부기한 기준인지 위반일 기준인지 고릅니다. 납부는 제공하지 않습니다. 파일: 엑셀(xlsx) · 이...
efine__paid_penalty__query 먼저 호출할 도구: efine__session__login (같은 account_link_id). 조회만 합니다. 이미 낸 과태료 목록을 돌려줍니다. all_period 를 true 로 두면 전체 기간을 조회하고, false 로 두면 석 달 이내의 기간(date_from, date_to)을 넣습니다. 납부, 출력, 건별 상세는 제공하지 않습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 -...
efine__unpaid_violation__query 먼저 호출할 도구: efine__session__login (같은 account_link_id). 조회만 합니다. 미납 범칙금 목록을 건수, 다음 쪽이 있는지와 함께 돌려줍니다. 납부, 건별 상세, 다른 법인 선택은 제공하지 않습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기...
efine__paid_violation__query 먼저 호출할 도구: efine__session__login (같은 account_link_id). 조회만 합니다. 이미 낸 범칙금 목록을 건수, 다음 쪽이 있는지와 함께 돌려줍니다. 납부, 출력, 건별 상세는 제공하지 않습니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는...
payroll_pack__insurance_deduction_material_v1__generate 건강보험, 국민연금, 고용보험 고지 단계를 묶어 보험료 합계를 계산해 줍니다. 금액은 기관이 사업장에 고지한 합계이고 근로자 몫과 사업주 몫을 모두 담습니다(고용보험은 실업급여 몫만). 근로자 급여에서 떼는 금액이 아니므로 근로자 몫은 따로 계산하세요. 국민건강보험공단, 국민연금공단, 근로복지공단 세션 로그인을 먼저 해야 합니다. 간이세액표로 income_tax_won 과 local_income_tax_won 도...
company_info_pack__brief_v1__generate 사업자 상태, 진위, 공공조달 제재, 건설업 행정처분, 환경 제재 다섯 조각(nts.status, nts.validate, g2b.sanction, kiscon.sanction, env.waste_sanction)을 조회해 한 장의 요약으로 만듭니다. 모든 조각이 우리 플랫폼 키로 돌아 account_link_id 와 인증서가 필요 없습니다. 비어 있는 제재 결과를 제재가 없다고 확인된 것으로 읽지 마세요....
company_info_pack__profile_v1__generate 사업자등록번호 하나로 상태, 위험, 고용, 재무, 사업장 다섯 축을 한 번에 조회해 한 장으로 모아 줍니다. 조각 열하나(사업자 상태와 진위, 공공조달 제재, 건설업 행정처분, 환경 제재, 기업개요, 고용보험과 산재보험 가입 사업장, 국민연금 가입 사업장, 재무 요약, 사업장 건물, 사업장 건물 실거래)가 우리 플랫폼 키로 돌아 account_link_id 와 인증서가 필요 없습니다. axes 로 축을 고르면 그 축의...
subsidy_pack__diagnosis_v1__generate 고용24 사업주 사전진단(대상 지원사업 전부를 한 번에 보는 단계)과 공공데이터 사업자 상태 조회(opendata.nts.status)를 돌려 이 사업장이 신청할 수 있는 지원금을 알려 줍니다. 고용24 단계는 로그인한 세션을 다시 씁니다. account_link_id 는 넣지 않습니다. 단계마다 그 기관의 연동을 스스로 찾습니다. 판정은 고용24 의 원래 네 상태를 그대로 둡니다. 조사후결정과 오류는 판정...
xdata__job__result 자격증명이나 로그인 없이 바로 호출할 수 있습니다. 이 연결이 이미 시작한 작업의 결과를 job_id 로 다시 읽습니다. 새 작업을 만들지 않고, 기관에 아무것도 보내지 않으며, 사용 토큰을 쓰지 않습니다. 호출이 시간 초과로 끊겼는데 작업은 계속 돈 경우(오류의 data 에 job_id 와 바로 쓸 수 있는 result_tool_call 이 있습니다)나 artifacts[] 의 download_url 이 만료된 경우에...
xdata__content__read 자격증명이나 로그인 없이 바로 호출할 수 있습니다. XBOSS 인증은 필요합니다. 기관별 로그인이나 자격증명 등록은 필요하지 않습니다. 이 연결에서 앞서 보관한 본문을 content_artifact_ref로 확인합니다. 이 연결의 조직과 환경에 속한 원문만 읽습니다. 새 작업·기관 호출·발행·사용량 차감은 하지 않습니다. 블로그 재연결 후 원래 작업을 이어가기 전에 원문을 확인할 때 사용하세요. 없음·만료·삭제·다른...
Get alerted when this changes. Email the moment kr.xdata/xboss-mcp drifts, dies, or revives.

Status badge

Toolpin status badge for kr.xdata/xboss-mcp

[![Toolpin](https://toolpin.dev/badge/kr.xdata/xboss-mcp.svg)](https://toolpin.dev/servers/kr.xdata/xboss-mcp)

Maintain this server? Add the badge to your README. It links your users to this live status page.