개발자 문서
API 레퍼런스

홈택스 API

국세청 홈택스 업무를 XBOSS 작업 API 한 곳에서 호출하는 API 입니다.

홈택스 API 는 공동인증서가 필요합니다. 콘솔 자격증명 등록에서 인증서를 등록하면 account_link_id 가 발급되고, 요청 본문에서 생략하면 등록한 것이 하나뿐일 때만 그것이 자동으로 선택되고, 둘 이상이면 account_link_id 를 넣어야 합니다. [자격증명 등록]

API 목록

세션

홈택스 로그인 세션을 만들고 회원·사업자 기본 정보를 확인합니다. 다른 홈택스 API 를 부르기 전에 먼저 호출합니다.

세무

사업자 상태, 신고 이력, 고지와 체납, 환급 등 세무 자료를 조회하고, 원천세 정기신고, 수정신고, 기한후신고, 삭제신청, 전자파일 변환신고를 단계별로 작성해 제출합니다.

현금영수증

현금영수증을 발행하고 당일 발행 건을 수정하거나 취소합니다. 매출·매입 내역도 조회합니다.