홈택스 API
국세청 홈택스 업무를 XBOSS Job API 한 곳에서 호출하는 API 입니다. 등록한 공동인증서로 홈택스 세션을 만든 뒤 증명서 신청, 전자세금계산서 발행·조회, 세무 자료 조회, 현금영수증 발행을 같은 요청 형태로 처리합니다. 스탠다드는 데모 환경에서, 유료 요금제(PRO 또는 멀티계정 요금제)는 정식 환경에서 호출합니다. 모든 호출은 POST /v1/jobs 한 경로로 제출하고 작업 아이디로 결과를 받습니다.
홈택스 API 는 공동인증서가 필요합니다. 콘솔 자격증명 등록에서 인증서를 등록하면 account_link_id 가 발급되고, 요청 본문에서 생략하면 대표로 지정한 자격증명이 선택됩니다. [자격증명 등록]
API 목록
증명서
납세·사업자 관련 증명서를 신청하고 발급 목록을 조회합니다.
전자세금계산서
전자세금계산서를 발행·수정하고 목록·상세·합계·통계를 조회합니다.
세무
사업자 상태, 신고 이력, 고지·체납·환급 등 세무 자료를 조회하고 원천징수를 신고합니다.
현금영수증
현금영수증을 발행하고 매출·매입 내역과 당일발행 건을 조회합니다.