홈택스 API
국세청 홈택스 업무를 XBOSS 작업 API 한 곳에서 호출하는 API 입니다.등록한 공동인증서로 홈택스 세션을 만든 뒤 증명서 신청, 전자세금계산서 발행과 조회, 세무 자료 조회, 원천세 신고(정기, 수정, 기한후, 삭제신청, 전자파일 변환), 현금영수증 발행을 같은 요청 형태로 처리합니다.데모는 요금제와 상관없이 모든 계정에 같습니다. 정식 환경은 현재 공개 요금제를 시작한 뒤 쓰는 환경입니다. 모든 호출은 POST /v1/jobs 한 경로로 제출하고 작업 아이디로 결과를 받습니다.
홈택스 API 는 공동인증서가 필요합니다. 콘솔 자격증명 등록에서 인증서를 등록하면 account_link_id 가 발급되고, 요청 본문에서 생략하면 등록한 것이 하나뿐일 때만 그것이 자동으로 선택되고, 둘 이상이면 account_link_id 를 넣어야 합니다. [자격증명 등록]
API 목록
증명서
납세·사업자 관련 증명서를 신청하고 발급 목록을 조회합니다.
전자세금계산서
전자세금계산서를 발행·수정하고 목록·상세·합계·통계를 조회합니다.
세무
사업자 상태, 신고 이력, 고지와 체납, 환급 등 세무 자료를 조회하고, 원천세 정기신고, 수정신고, 기한후신고, 삭제신청, 전자파일 변환신고를 단계별로 작성해 제출합니다.
- 1.개인사업자등록상태 조회
- 2.원천세 정기신고 1단계 시작
- 3.원천세 정기신고 준비자료 안내
- 4.원천세 정기신고 2단계 기본사항 저장
- 5.원천세 정기신고 3단계 소득명세 저장
- 6.원천세 정기신고 4단계 검증
- 7.원천세 정기신고 5단계 미리보기
- 8.원천세 정기신고 6단계 제출
- 9.원천세 신고 접수 내역 조회
- 10.나의세무대리인 조회
- 11.사업자 등록사항 및 담당자 안내
- 12.부가세 신고 이력 조회
- 13.세금 신고내역 조회
- 14.세금 신고서 상세 조회
- 15.세금 신고서 원문 조회
- 16.납부할 세액 조회
- 17.전자고지 수신동의 상태 조회
- 18.환급금 상세 조회
- 19.미수령 환급금 조회
- 20.고지 내역 조회
- 21.체납(연체) 내역 조회
- 22.지급명세서 조회
- 23.지급명세서 등 제출내역
- 24.전자세금계산서 거래처 관리
- 25.신용카드 매출자료 조회
- 26.원천세 수정신고 부표 저장
- 27.원천세 수정신고 기본정보 저장
- 28.원천세 수정신고 작성 취소
- 29.원천세 수정신고 소득별 상세 저장
- 30.원천세 수정신고 신고 내역 조회
- 31.원천세 수정신고 초안 초기화
- 32.원천세 수정신고 작성 참고자료 조회
- 33.원천세 수정신고 제출 전 미리보기
- 34.원천세 수정신고 접수증 조회
- 35.원천세 수정신고 준비자료 안내
- 36.원천세 수정신고 저장 내용 검토
- 37.원천세 수정신고 제출
- 38.원천세 신고 삭제신청 대상 조회
- 39.원천세 신고 삭제신청 내역 조회
- 40.원천세 신고 삭제신청 준비
- 41.원천세 신고 삭제신청 접수증 조회
- 42.원천세 신고 삭제신청 준비자료 안내
- 43.원천세 신고 삭제신청 제출
- 44.원천세 전자파일 변환신고 내용검증 요청
- 45.원천세 전자파일 변환신고 암호 입력 형식검증
- 46.원천세 전자파일 변환신고 작업 시작
- 47.원천세 전자파일 변환신고 제출 전 미리보기
- 48.원천세 전자파일 변환신고 접수증 조회
- 49.원천세 전자파일 변환신고 준비자료 안내
- 50.원천세 전자파일 변환신고 진행현황 조회
- 51.원천세 전자파일 변환신고 제출
- 52.원천세 전자파일 변환신고 원본 올리기
- 53.원천세 기한후신고 부표 저장
- 54.원천세 기한후신고 기본정보 저장
- 55.원천세 기한후신고 작성 취소
- 56.원천세 기한후신고 소득별 상세 저장
- 57.원천세 기한후신고 신고 내역 조회
- 58.원천세 기한후신고 초안 초기화
- 59.원천세 기한후신고 작성 참고자료 조회
- 60.원천세 기한후신고 제출 전 미리보기
- 61.원천세 기한후신고 접수증 조회
- 62.원천세 기한후신고 준비자료 안내
- 63.원천세 기한후신고 저장 내용 검토
- 64.원천세 기한후신고 제출
현금영수증
현금영수증을 발행하고 당일 발행 건을 수정하거나 취소합니다. 매출·매입 내역도 조회합니다.