XBOSS Hometax

홈택스 API 연동

전자세금계산서부터 원천세 신고까지,
홈택스 업무 85가지를 REST API와 MCP로 연결합니다.

XBOSS

홈택스 업무 개발에 필요한,
상품 85개를 한곳에서

홈택스에 접속하지 않고 쓰던 시스템이나 AI 앱에서 조회, 발급, 신고를 처리하는 상품 묶음입니다.
업무 영역을 누르면 그 안의 상품이 아래에 펼쳐지고, 상품을 누르면 상세 쪽으로 갑니다.

업무 영역

XBOSS Hometax

연결 방식은 달라도 같은 업무를 그대로

내 서비스에서 부르든 AI 앱에서 말로 시키든 같은 홈택스 상품을 씁니다.

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

반복하던 세금 업무를
이렇게 넘깁니다.

매입 매출 내역 받기

전자세금계산서와 현금영수증 내역을 받아 장부와 맞춰 볼 수 있습니다.

원천세 신고 단계별 처리

작성, 검토, 미리보기, 제출을 단계마다 나눠 부릅니다. 수정신고와 기한후신고도 같은 흐름입니다.

홈택스 API 연동 순서

결제 수단 없이 가입하면
데모 환경이 바로 열립니다.
가입할 때 결제 수단을 넣지 않습니다.API와 MCP 연동을 먼저 확인한 뒤 요금제를 고릅니다.

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

REST API로 부르거나
AI 앱에서 말로 시킵니다.
쓰던 시스템은 REST API로, AI 앱은 MCP로 같은 상품을 씁니다.원천세 신고 상품에는 제출 전 미리보기 단계가 따로 있습니다.

홈택스 API 연동,
이런 점이 궁금하신가요?

홈택스 API가 무엇인가요?

홈택스에서 사람이 하던 조회, 발급, 신고를 쓰던 시스템이나 AI 앱에서 처리하도록 연결하는 상품 묶음입니다. XBOSS는 전자세금계산서, 현금영수증, 원천세 신고, 증명서 발급을 비롯한 홈택스 업무 85가지를 REST API와 MCP로 제공합니다.

조회만 되나요, 신고와 발급도 되나요?

조회뿐 아니라 전자세금계산서 발행, 현금영수증 발급, 증명서 신청, 원천세 신고 제출까지 됩니다. 발행, 발급, 신청, 제출처럼 기관에 접수되는 상품은 실행 전에 내용을 확인하고 동의해야 실행됩니다. 원천세 신고 상품에는 제출 전 미리보기 단계가 따로 있습니다.

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

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

인증서는 안전하게 보관되나요?

인증서는 고객 컴퓨터의 연결 프로그램을 통해 등록되며, XBOSS에는 암호화된 형태로 금고처럼 보관됩니다. 연동 정보는 AES-256으로 암호화해 저장합니다. 연동은 콘솔에서 해제할 수 있습니다. 진행 중인 작업이 있거나 대표 인증서이면 바로 해제되지 않습니다.

여러 사업장이나 세무대리 거래처도 연결할 수 있나요?

가능합니다. 사업장이나 거래처마다 인증서를 나눠 연결할 수 있습니다. 세무, 회계 사무실처럼 여러 고객을 다루는 경우에도 연결을 구분해 두면 업무를 섞지 않고 진행할 수 있습니다.

쓰던 시스템과 AI 앱에는 어떻게 연결하나요?

쓰던 시스템은 REST API로 연결합니다. 가입 때 발급되는 API 키로 작업을 요청하고 결과를 받습니다. AI 앱은 MCP로 연결합니다. Cursor, Claude, ChatGPT, Codex, Gemini에 XBOSS를 연결하면 말로 시킬 수 있습니다. 원천세 전자파일의 암호를 넣는 단계는 REST API로 진행합니다. 순서는 이용방법과 개발자 문서에 있습니다.

무료로 써 볼 수 있나요? 요금은 어떻게 되나요?

결제 수단 없이 가입하면 데모 환경이 바로 열려 연동을 확인할 수 있습니다. 실제 업무에 쓸 때는 콘솔에서 요금제를 시작하며, 라이트는 카드 등록이 필요 없습니다. 요금은 요금제에서 확인합니다.

신고나 발행이 실패하면 어떻게 되나요?

실패하면 원인과 다음에 할 일을 함께 안내합니다. 제출처럼 되돌릴 수 없는 작업의 결과를 확인하지 못했을 때는 중복 처리를 막기 위해 다시 실행하지 말라고 안내합니다. 해결되지 않으면 서비스문의로 남겨 주세요. 영업일 기준 8시간 이내에 답합니다.

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

홈택스 업무 85가지,
XBOSS 하나로 연결하세요.

가입할 때 결제 수단을 넣지 않습니다.