블로그
article

홈택스 API 종류, 어떤 업무까지 자동화할 수 있나

홈택스에서 자동화할 수 있는 업무를 계정·자료 수집·발급·신고 확인·증명·세무대리 묶음으로 나눠 정리하고, 자료가 모이면 할 수 있는 일을 함께 봅니다.

이국환SION.LAB 대표예상 읽기 시간 6분

홈택스 API 종류, 어떤 업무까지 자동화할 수 있나

"홈택스에서 뭘 자동으로 받을 수 있는지부터 모르겠습니다."

연동을 검토하는 분들이 처음에 가장 많이 하는 말입니다. 홈택스는 메뉴가 넓어서 담당자마다 쓰는 화면이 다릅니다. 누구는 매출 자료를 내려받고, 누구는 증명서를 끊고, 누구는 수임처 목록을 확인합니다. 그래서 "홈택스 연동"이라는 말이 사람마다 다른 일을 가리킵니다.

이 일은 업무 묶음부터 나눠 보면 정리됩니다. 이 글은 홈택스에서 자동화할 수 있는 업무를 묶음으로 나누고, 자료가 모이기 시작하면 함께 할 수 있는 일이 무엇인지 봅니다.

홈택스 업무는 크게 일곱 묶음으로 나뉩니다

담당자가 홈택스에서 하는 일을 순서대로 늘어놓으면 대개 이렇게 묶입니다.

묶음하는 일들어 있는 것(예)
계정과 권한누가 어떤 사업장으로 접속할지 정리회원정보 조회, 인증서 등록, 부서사용자 신청과 승인
사업자 기본정보등록사항과 신고 상태 확인사업자 등록사항, 정정신고 정보, 신고서 제출 상태
매출·매입 자료거래 자료 받아 오기세금계산서·계산서 발행내역, 현금영수증 매출·매입, 사업용신용카드 매입
발급하기홈택스에서 끊는 일현금영수증 승인·취소 발급, 당일 발급 정정
신고·고지·납부신고 결과와 낼 돈 확인신고결과와 접수증, 납부·환급·고지·체납 내역, 신고도움 자료
증명서와 진위 확인서류 받아 오고 진짜인지 확인사업자등록증명, 납세증명, 소득금액증명, 민원증명 원본확인
세무대리 관계수임 관계 관리수임납세자 목록과 등록·해지, 수임 동의

이 가운데 매출·매입 자료를 매일 받는 방법은 홈택스 매출·매입 자료를 매일 자동으로 받는 글에, 세금계산서를 한 건씩 끊던 일을 자동 발행으로 바꾼 과정은 세금계산서 자동 발행 글에 따로 정리했습니다. 여기서는 그 밖의 묶음까지 포함해 전체 지도를 보는 쪽에 집중합니다.

이렇게 자동화할 수 있습니다

1. 계정과 권한을 먼저 정리합니다

어느 사업자등록번호로, 누구의 계정과 인증 수단으로 접속할지를 정합니다. 사업장이 여러 곳이면 사업장 전환이 필요한지, 담당자별로 부서사용자를 둘지도 이 단계에서 정합니다. 여기가 정리되지 않으면 뒤에 무엇을 붙여도 중간에 멈춥니다.

2. 필요한 묶음 하나부터 고릅니다

일곱 묶음을 한꺼번에 붙일 일은 거의 없습니다. 지금 사람 손이 가장 많이 가는 묶음 하나를 고릅니다. 매달 증명서를 발급해 제출하는 일이 반복된다면 증명 묶음부터 봅니다. 증명서와 소득·연말정산 자료에서 받을 수 있는 항목은 홈택스 증명/조회 API 페이지에, 묶음별 전체 목록은 API 마켓에 있습니다.

3. 받은 자료를 한 형식으로 모읍니다

홈택스 화면마다 항목 이름과 날짜 형식이 다릅니다. 저장할 때 형식을 맞춰 두면 나중에 다른 묶음을 추가해도 기존 자료와 이어 붙일 수 있습니다. 엑셀을 계속 쓰더라도 열 이름과 기준 날짜만 통일해 두면 충분합니다.

4. 판단은 사람이 합니다

받은 자료에서 금액이 맞지 않거나 신고 상태가 예상과 다를 때 어떻게 할지는 사람이 정합니다. 신고와 납부도 사람이 합니다. 자동화는 자료를 모아 차이를 보여 주는 데까지입니다.

홈택스 자료가 모이면 할 수 있는 일

한 묶음을 자동으로 받기 시작하면 다음 묶음을 붙이는 비용이 줄어듭니다. 그래서 처음에는 생각하지 않았던 일이 가능해집니다.

  • 낼 돈을 미리 봅니다. 고지 내역과 납부할 세액을 모아 두면 월별로 나갈 세금을 미리 자금 계획에 넣을 수 있습니다.
  • 체납과 환급을 놓치지 않습니다. 체납 내역과 환급금 조회 결과를 정기적으로 받아 담당자에게 알립니다.
  • 증명서 유효 기간을 관리합니다. 입찰이나 거래처 제출용 납세증명처럼 유효 기간이 있는 서류는 만료 전에 다시 받아 둘 수 있습니다.
  • 받은 서류가 진짜인지 확인합니다. 거래처가 보낸 사업자등록증명이나 납세증명을 민원증명 원본확인으로 교차 확인합니다.
  • 수임처 현황을 한 화면에서 봅니다. 세무 대리를 하는 곳이라면 수임 관계와 신고 상태를 함께 보면서 빠진 곳을 찾을 수 있습니다.
  • 공제 대상을 미리 가립니다. 사업용신용카드와 현금영수증 매입의 공제 여부를 받아 두면 신고 직전에 몰아서 보지 않아도 됩니다.

다른 자료와 묶을 때 쓸모가 더 커집니다. 지방세는 홈택스가 아닌 위택스 영역이라 따로 받아야 하고, 4대보험 명부와 묶으면 급여·원천세 자료의 정합성을 볼 수 있습니다. 마감 전체를 어떻게 이어 붙이는지는 월말 마감 자동화 글에, 어디까지 맡기고 어디서 검토할지는 회계 자동화 경계를 다룬 글에 있습니다.

시작 전에 정할 것

1. 계정과 자동 조회 허용 범위

홈택스 자료는 사업자나 세무대리인 계정으로 조회합니다. 계정 관리자와 인증서 갱신 담당자를 정하고, 홈택스 이용 조건에서 자동 조회를 어디까지 허용하는지 확인합니다. 수임처 자료를 받을 때는 수임 동의 범위에 그 자료가 들어 있는지도 함께 봅니다.

2. 개인 자료가 섞이는 묶음인지

소득금액증명, 지급명세서, 연말정산 간소화 자료는 개인의 소득 자료입니다. 임직원 자료를 회사가 받아 보관하려면 정보주체 동의와 보관 범위를 먼저 정하고 법률 검토를 받아야 합니다. 사업자 자료만 필요하다면 개인 묶음은 아예 넣지 않는 편이 안전합니다.

3. 어느 묶음부터 할 것인가

사람 손이 가장 많이 가는 묶음, 빠뜨리면 손해가 큰 묶음, 건수가 많은 묶음 가운데 하나를 고릅니다. 하나가 돌아가기 시작하면 다음 묶음은 같은 자리에 얹으면 됩니다.

정리

홈택스 연동은 하나의 일이 아니라 계정, 기본정보, 자료 수집, 발급, 신고 확인, 증명, 세무대리 관계로 나뉘는 일입니다. 묶음을 나눠 놓고 사람 손이 가장 많이 가는 쪽부터 하나 고르면 범위가 분명해집니다. 하나가 돌아가면 낼 돈 예측, 체납·환급 알림, 증명서 유효 기간 관리, 수임처 현황까지 같은 자리에서 이어 붙일 수 있습니다.

문의 전에 사업자 수(또는 수임처 수), 지금 홈택스에서 사람이 직접 하는 일 가운데 가장 자주 하는 작업, 받은 자료를 어디에 넣고 싶은지(엑셀, 회계 프로그램, 사내 시스템)를 알려 주시면 어느 묶음부터 시작할지 바로 말씀드릴 수 있습니다.

홈택스 업무 자동화 상담하기

#홈택스 API#홈택스 API 연동#세무 자동화#세무대리 자동화
문의하기