홈택스 API 연동, 국세청·민간 방식의 핵심 차이와 선택 기준

최종 수정일: 2026년 09월 28일

‘홈택스 API’라는 단일 공식 API는 없습니다. 국세청이 직접 개방한 건 ‘사업자등록번호 진위확인·상태조회’ 오픈 API 하나뿐이고, 전자세금계산서·현금영수증 발행은 국세청 인증을 받은 민간 사업자(팝빌·바로빌 등)의 연동 API로 처리합니다. 도입 전에 “조회가 필요한지, 발행이 필요한지”부터 정해야 선택이 갈립니다.

많은 기업, 특히 스타트업에서는 고객사의 사업자등록 정보를 건건이 확인하는 일이 생각보다 시간을 많이 잡아먹습니다. 매번 홈택스에 들어가서 사업자번호를 입력하고 진위 여부를 확인하는 방식은 비효율적이고, 사람 손이 타는 만큼 실수도 나올 수밖에 없습니다.

그렇다면 방법이 없을까요? API를 기존 시스템에 붙이면 이 과정을 자동화할 수 있습니다. 반복 업무를 줄이면서도 확인 속도와 정확도를 같이 끌어올릴 수 있다는 얘기입니다.

이 글에서는 홈택스 API가 어떤 범위를 말하는지, 연동은 어떻게 접근하는지, 그리고 실제로 어디에 쓰이는지까지 흐름을 정리해보겠습니다.

홈택스 API 개요

홈택스 API는 국세청의 세무 서비스를 외부 시스템과 연결해 데이터를 주고받을 수 있게 하는 연동 규격을 뜻합니다. 개발자는 자사 서비스나 내부 시스템 안에서 세무 관련 기능을 구현할 수 있게 됩니다.

다만 여기서 많이 헷갈립니다. ‘홈택스 API’라는 이름의 단일 공식 API가 딱 하나로 존재하는 구조는 아닙니다. 제공 주체와 목적에 따라 여러 갈래로 나뉘는 개념에 가깝습니다. 예를 들어 전자세금계산서 발급은 홈택스에서 직접 발급하는 방식 외에도, 표준인증을 받은 ERP(전사적자원관리)나 ASP(응용소프트웨어 제공) 시스템을 통해서도 가능합니다.

“AI 대전환은 결국 ‘최상의 납세서비스’와 ‘조세정의 실현’을 국민이 피부로 느끼게 하는 데 그 목적이 있다.”
– 임광현 국세청장, 2026년 국세청 AI혁신담당관실 현판식

국세청의 디지털 전환은 결국 납세자의 편의를 높이고, 더 투명한 세무 행정을 구현하는 방향으로 움직이고 있습니다.

국세청 홈택스 API

국세청 홈택스 API는 국세청이 제공하는 세무 서비스를 외부 시스템과 연동하기 위한 다양한 접근 방식을 통칭하는 표현입니다. 국세청이 공식적으로 안내하는 전자세금계산서 발급 절차는 아래와 같습니다.

1. 국세청이 운영하는 홈택스 웹사이트 또는 모바일 앱을 직접 이용
2. 국세청에 등록된 발급 업무 대행 사업자(ASP)의 사이트를 이용
3. 자체적으로 구축한 전자세금계산서 발급 시스템(ERP)을 이용

시스템 연동으로 세금계산서를 발급하는 경우, 판매자는 ERP나 ASP에서 거래 정보를 입력하고 전자서명한 뒤 구매자에게 이메일로 전송해야 합니다. 그리고 발급일 다음 날까지 해당 정보를 국세청 시스템으로 전송해야 합니다.

국세청이 직접 API 형태로 제공하는 서비스는 ‘사업자등록정보 진위확인 및 상태조회’가 사실상 유일합니다. 다만 국세청 제공 API는 일시적 오류로 서비스가 멈출 수 있으니, 운영 단계에서는 대비책이 필요합니다.

결국 API를 검토할 때는 “국세청이 직접 제공하는가”와 “민간 사업자가 국세청 규격에 맞춰 제공하는가”를 먼저 구분하고 접근하는 편이 안전합니다.

홈택스 open API

홈택스 오픈 API는 국세청이 공공데이터를 민간에 개방해 누구나 활용할 수 있게 제공하는 서비스입니다. 현재 국세청이 공식적으로 개방한 오픈 API는 ‘사업자등록정보 서비스’가 유일하고, 그 안에 ‘사업자등록정보 진위확인’과 ‘사업자등록 상태조회’ 2가지 기능이 들어 있습니다.

이 서비스는 1회 호출 시 최대 100건, 하루 총 100만 건까지 요청할 수 있습니다. 국세청 등록 정보와 30분 주기로 동기화되어 비교적 최신 정보를 유지하는 편입니다.

행정안전부는 이 서비스 개통 당시, 최신 사업자등록정보의 민간 활용으로 온라인 거래가 더 안전하고 편리해질 것으로 기대한다고 밝혔습니다.

온라인 플랫폼이나 금융 서비스에서는 거래 상대의 사업자 정보를 ‘실시간으로 확인할 수 있느냐’가 신뢰와 직결됩니다. 이 오픈 API가 그 기반 역할을 해줍니다.

홈택스 API에는 어떤 종류가 있을까요?

홈택스 관련 API는 제공 주체와 기능을 기준으로 크게 두 갈래로 나눠볼 수 있습니다. 하나는 국세청이 공공데이터포털을 통해 직접 개방하는 ‘공공데이터 오픈 API’이고, 다른 하나는 민간 인증 사업자가 국세청 규격에 맞춰 제공하는 ‘연동 API’입니다.

국세청이 공공데이터포털을 통해 공식 제공하는 오픈 API는 ‘사업자등록정보 진위확인 및 상태조회 서비스’가 유일합니다. 반면 민간 연동 API는 전자세금계산서, 현금영수증 발행 및 조회 등 기능 범위가 훨씬 넓고, 목적에 따라 ‘발행형’과 ‘조회형’으로 다시 갈립니다.

홈택스 관련 API는 국세청이 직접 제공하는 공공데이터 오픈 API와, 민간 인증 사업자가 제공하는 연동 API로 나뉩니다. 도입 전에 “발행이 필요한지, 조회가 필요한지” 목적을 먼저 정리해야 선택이 쉬워집니다.

홈택스 API 연동

홈택스 API 연동 과정은 국세청 오픈 API를 쓰는지, 민간 사업자 연동 API를 쓰는지에 따라 조금 달라집니다. 공통적으로는 제공자가 제공하는 공식 문서와 가이드를 기준으로 개발하고, 충분히 테스트한 뒤 운영에 올리는 흐름이 핵심입니다.

세무 데이터는 민감 정보이기도 합니다. 정확성과 보안은 기본값으로 깔고 가야 합니다. API 연동은 세무·회계 업무 자동화의 시작점이고, 반복 입력에서 나오는 실수를 줄이면서 처리 속도를 올리는 데 도움이 됩니다.

홈택스 API 문서

연동을 제대로 하려면 문서를 먼저 정확히 읽어야 합니다. 국세청 오픈 API 문서는 공공데이터포털에서 확인할 수 있고, 호출 주소(URL), 인증키 사용 방식, 요청·응답 형식 같은 기본 정보가 들어 있습니다.

민간 API는 각 업체가 개발자 센터 형태로 문서를 제공합니다. 기능 설명부터 파라미터, 응답 포맷, 에러 코드까지 정리되어 있어 개발 단계에서 기준점이 됩니다.

연동을 시작하기 전에 공식 문서를 꼼꼼히 확인하는 것, 이게 가장 먼저입니다.

홈택스 API는 어떻게 사용할 수 있나요?

절차는 제공 주체에 따라 다릅니다. 국세청 오픈 API는 공공데이터포털에서 개발계정과 운영계정을 신청하고, 승인 후 인증키를 발급받아 사용합니다. 인증키와 사업자등록번호 등 필수 값을 넣어 호출하면 정상 처리 시 상태 코드 200과 함께 결과가 내려옵니다.

민간 연동 API는 회원가입 후 바로 테스트를 열어주는 곳이 많고, 약 한 달 정도 무료 테스트 기간을 제공하는 경우도 흔합니다. 특히 민간 API 테스트 환경은 더미가 아니라 실제 홈택스 신고 정보를 기반으로 운영되는 경우가 있어, 실환경과 유사하게 검증할 수 있습니다.

운영을 안정적으로 가져가려면, 테스트 환경에서 충분히 검증하고 넘어가는 것이 필수입니다.

홈택스 API 개발

개발 방식은 크게 두 가지로 정리됩니다. 하나는 국세청 표준 인증을 받은 자체 시스템(ERP, ASP)을 직접 구축하는 방식이고, 다른 하나는 이미 인증을 받은 민간 ASP의 API를 호출해 쓰는 방식입니다.

자체 구축은 인증 과정이 복잡하고, 국세청 고시가 바뀔 때마다 유지보수 부담이 큽니다. 그래서 많은 기업이 개발·운영 부담이 적고 검증된 민간 API를 선호합니다.

개발 단계에서는 중복 발행, 거래내역 매칭 오류, 인증서 만료 같은 실무 리스크를 실제로 많이 만납니다. 자체 시스템을 개발하면 국세청 고시 변경 때마다 직접 대응해야 하는 책임이 따라옵니다.

이런 문제를 줄이려면 운영과 분리된 샌드박스(Sandbox) 환경에서 발행 흐름을 충분히 테스트하는 방식이 권장됩니다.

홈택스 API 활용

홈택스 API는 단순히 “자동화”에서 끝나지 않습니다. 전자세금계산서 발행, 사업자등록번호 확인, 현금영수증 처리 같은 핵심 업무를 시스템에 붙이면, 수작업으로 생기는 시간 낭비와 오류를 크게 줄일 수 있습니다.

업무 효율이 올라가면 비용이 줄고, 그만큼 핵심 업무에 집중할 수 있는 여지가 생깁니다. 실시간 데이터가 쌓이니 재고 관리나 자금 흐름 예측에도 도움이 됩니다.

홈택스 전자세금계산서 API

홈택스 전자세금계산서 API는 부가가치세법이 정한 전자적 방식으로 세금계산서를 발급하는 기능을 외부 시스템에 연동하는 것을 의미합니다.

전자세금계산서는 발급 기한을 지키고, XML 원본 파일이 수신자에게 정상 전송되어야 법적 효력이 성립합니다. 이메일 전송이 실패하면 미발급으로 볼 수 있어, 연동 시에는 전송 성공 여부를 확인하는 기능이 반드시 들어가야 합니다.

공급일 다음 달 10일을 넘기면 가산세가 부과될 수 있으니 이 부분도 체크해야 합니다.

민간 API는 대량 발행을 위한 Bulk API나 인프라 안정성을 갖춘 경우가 많아, 처리량이 큰 기업일수록 선택지가 됩니다.

홈택스 사업자등록번호 조회 API

홈택스 사업자등록번호 조회 API는 국세청이 공공데이터포털을 통해 제공하는 공식 오픈 API입니다. 사업자 정보의 진위와 상태를 실시간으로 확인할 때 사용합니다.

‘진위확인’은 사업자번호, 개업일, 대표자명 등 입력 정보의 일치 여부를 검증합니다. ‘상태조회’는 휴업·폐업 상태, 과세 유형 등을 조회합니다.

예전에는 허위 사업자 정보로 인한 거래 사고도 적지 않았습니다. 이 API가 공개되면서 누구나 확인할 수 있게 되었고, 그만큼 거래 안전장치가 하나 생긴 셈입니다.

거래 상대의 휴폐업 상태와 사업자 정보 진위를 실시간으로 확인할 수 있다는 점이 핵심입니다.

홈택스 현금영수증 API

홈택스 현금영수증 API는 2005년부터 시행된 현금영수증 제도를 기업 시스템에 연동해 발행 및 전송 업무를 자동화하는 서비스입니다. 소비자의 식별정보(휴대폰 번호 등)로 소득공제용 또는 지출증빙용 현금영수증을 발행하고, 내역을 국세청에 자동 전송합니다.

소비자가 발행을 원치 않는 경우, 국세청 지정 코드로 자진 발행하는 기능도 API로 지원됩니다. 수작업이 줄어드는 만큼 오류도 줄고, 발행 내역을 실시간으로 관리하면서 신고 정확도를 끌어올릴 수 있습니다.

—

홈택스 API는 반복적인 세무 업무를 줄이고, 데이터 기반으로 운영을 정리하는 데 도움이 됩니다. 다만 “국세청 오픈 API로 가능한 범위”와 “민간 연동 API가 담당하는 영역”이 명확히 나뉘어 있으니, 처음부터 목적을 확실히 잡고 들어가야 시행착오가 줄어듭니다.

FAQ

Q1. 홈택스 API는 국세청에서 직접 제공하는 단일한 API인가요?
A1. 아닙니다. ‘홈택스 API’라는 단일 공식 API 명칭은 존재하지 않고, 목적에 따라 서로 다른 체계로 나뉩니다. 국세청이 공공데이터포털에서 공식 제공하는 오픈 API는 사업자등록정보 진위확인 및 상태조회 서비스뿐이며, 세금계산서 발행 API는 제공하지 않습니다. 세금계산서 발행 등은 주로 표준인증을 받은 민간 발급 대행 사업자(ASP)의 연동 API로 처리됩니다.

Q2. 홈택스 API로 전자세금계산서를 발행할 때 주의할 점은 무엇인가요?
A2. 핵심은 발급 기한 준수와 전송 성공 여부 확인입니다. 발급 기한은 공급일 다음 달 10일까지이며, 지연 발급 시 가산세가 발생할 수 있습니다. 전자(세금)계산서의 XML 원본 파일(전자서명 포함)이 거래 상대방 이메일에 도달해야 전달로 인정되므로, API 연동 시에도 전송 성공 여부를 반드시 확인해야 합니다.

Q3. 국세청 사업자등록번호 조회 API는 어떤 정보를 제공하고 제한 사항이 있나요?
A3. 사업자등록번호, 개업일자, 대표자명 등을 입력해 진위 여부를 확인하는 ‘진위확인’ 기능과, 사업자등록번호만으로 운영 상태(휴업, 폐업), 과세 유형, 폐업일자 등을 조회하는 ‘상태조회’ 기능을 제공합니다. 호출 허용 건수는 1회 100건, 1일 100만 건으로 제한됩니다. 운영계정은 활용 사례 등록 시 트래픽 증가 신청이 가능합니다.

Q4. 민간 업체의 홈택스 연동 API를 개발할 때 무엇을 고려해야 하나요?
A4. 중복 발행 위험, 거래내역 매칭 오류, 공동인증서 만료로 인한 발행 중단 같은 실무 이슈를 고려해야 합니다. 이를 줄이려면 샌드박스 환경에서 정발행-역발행 흐름을 충분히 테스트하는 것이 권장됩니다. 자체 개발 및 유지보수 부담을 줄이려면 검증된 전문 벤더 API를 활용하는 것도 방법입니다.

Q5. 현금영수증 API를 연동하면 어떤 이점이 있나요?
A5. 현금 거래분에 대한 현금영수증 발행과 국세청 전송 과정을 자동화할 수 있습니다. 수작업 오류가 줄고 처리 시간이 단축되며, 발행 내역을 실시간으로 관리할 수 있습니다. 소비자가 원치 않는 경우 자진 발행도 지원되어, 세무 업무 효율과 투명성을 높이는 데 도움이 됩니다.

본 글은 2026년 9월 기준 공공데이터포털 및 국세청 공개 자료를 바탕으로 정리했습니다. 호출 한도, 발급 기한, 가산세 기준은 법령·고시 개정에 따라 바뀔 수 있으므로 실제 적용 전 국세청 및 각 민간 사업자 공식 문서를 확인해 주세요.