XBOSS 국민건강보험공단

국민건강보험공단 API 연동

보험료 고지부터 납부 내역까지,
건강보험 업무 20가지를 REST API와 MCP로 연결합니다.

XBOSS

국민건강보험공단 업무에
필요한 상품 20개를 한곳에서

업무 영역을 선택해 보험료 고지, 납부 내역, 문서함 상품을 확인합니다.

업무 영역

XBOSS 국민건강보험공단

연결 방식이 달라도 동일한 업무 처리

REST API와 MCP 모두 동일한 국민건강보험공단 상품을 제공합니다.

  • REST API기존 시스템에 직접 연동자사 서비스에서 직접 호출
  • MCPCursor, Claude, ChatGPT, Codex, Gemini 지원AI 앱에서 대화로 실행
  • 공동인증서Windows PC에서 한 번 연결암호화해 금고에 보관

반복되는 건강보험 업무를
이렇게 자동화합니다.

당월 건강보험료 직원별 대조

고지 총액과 가입자별 당월 보험료를 조회해 급여 공제액과 대조합니다.

보험료 납부확인서 발급

납부확인서나 완납증명서를 발급합니다. 되돌릴 수 없어 동의 후 진행합니다.

국민건강보험공단 API 연동 순서

결제 수단 없이 가입하면
데모 환경을 즉시 제공합니다.
가입 시 결제 수단을 입력하지 않습니다.API와 MCP 연동을 확인한 뒤 요금제를 선택합니다.

사업장의 공동인증서를
금고에 한 번 연결합니다.
Windows PC에서 연결 프로그램을 한 번 설치합니다.인증서는 암호화해 금고에 보관하고, 연동은 콘솔에서 해제할 수 있습니다.

REST API로 호출하거나
AI 앱에서 대화로 실행합니다.
기존 시스템은 REST API로, AI 앱은 MCP로 동일 상품을 이용합니다.로그인을 먼저 호출한 뒤 해당 세션으로 다른 상품을 호출합니다.

국민건강보험공단 API 연동
자주 묻는 질문

국민건강보험공단 API로 무엇을 할 수 있나요?

보험료 고지, 직원별 보험료, 납부와 미납 내역을 조회하고 납부확인서를 발급합니다. XBOSS는 국민건강보험공단 업무 20가지를 REST API와 MCP로 제공합니다.

신고도 가능한가요?

아닙니다. 신고서를 기관에 제출하는 상품은 없습니다. 제출한 신고서의 접수, 정상, 반송, 반려 건수는 문서함에서 확인합니다.

보험료를 직원별로 조회할 수 있나요?

네. 고지 연월과 차수를 입력하면 가입자별 산출, 조정, 당월 보험료와 합계를 조회합니다. 요청 시 엑셀로도 제공합니다.

미납 보험료는 어떻게 확인하나요?

납부와 미납 내역에서 매월 고지금액, 납부일, 연체금, 미납금액을 조회합니다. 기본은 올해 건강보험이며 장기요양보험분이 포함됩니다.

납부확인서는 어떻게 발급하나요?

납부확인서나 완납증명서를 PDF로 발급합니다. 되돌릴 수 없어 동의한 요청만 발급하며, 동의가 없으면 미리보기만 제공합니다.

연동하려면 무엇을 준비해야 하나요?

Windows PC에 연결 프로그램을 한 번 설치해 사업장의 공동인증서를 금고에 연결합니다. 동일 인증서를 쓰는 다른 기관도 함께 연결됩니다.

기존 시스템과 AI 앱은 어떻게 연결하나요?

기존 시스템은 REST API로, AI 앱은 MCP로 연결합니다. 절차는 이용방법과 개발자 문서에서 안내합니다.

무료 체험이 가능한가요? 요금은 어떻게 되나요?

결제 수단 없이 가입하면 데모 환경을 즉시 제공합니다. 실제 업무는 콘솔에서 요금제를 시작하고, 라이트는 카드 등록이 필요 없습니다. 요금은 요금제에서 확인합니다.

조회나 발급이 실패하면 어떻게 되나요?

실패 시 원인과 조치 방법을 안내합니다. 증명서 발급 결과가 확인되지 않으면 재실행하지 않도록 안내합니다. 해결되지 않으면 서비스문의로 접수해 주세요.

더 궁금한 점은 FAQ와 서비스문의에서 확인합니다.

건강보험 업무 20가지,
XBOSS 하나로 연결하세요.

가입 시 결제 수단을 입력하지 않습니다.