부가세 신고 자동화·세무대리 업무
- 세무대리인이 수임처별 분기·반기 매출·매입 총액을 한 번에 집계
- PG·간편결제 매출 자료와 교차 검증해 누락·중복 매출을 탐지
- 세금계산서·현금영수증·계산서를 한 판에 모아 신고서 자동 작성에 투입
기업11 APIs
홈택스 매입/매출 조회
#매입매출#세금계산서#현금영수증#계산서#부가세신고#세무대리#홈택스
OVERVIEW
상품요약
국세청 홈택스가 집계하는 사업자의 세금계산서·계산서·현금영수증 매입·매출 내역을 기간별·건별로 한 번에 조회하는 유형의 API입니다. 세금계산서·계산서는 발급일자·작성일자·승인번호·공급자·수령자·공급가액·세액·품목·수량·단가를 반환하고, 현금영수증은 매출/매입을 각각 매출일자·승인번호·발급수단·공급가액·부가세·총금액·공제 여부와 함께 반환하며, 세무대리 전용 '매출/매입 총액 누계조회' 엔드포인트까지 포함해 세무대리인이 수임처 여러 곳의 분기·반기 집계를 한 번에 뽑을 수 있는 구조입니다. ERP·경영관리·세무관리 SaaS가 부가세 신고 자료 작성, 법인세·종합소득세 신고 보조 자료 수집, 매입세액 공제 대상 분류를 자동화할 때 자주 선택되는 카테고리입니다.
- 분류
- 기업 데이터
- 자료 출처
- 홈택스
- 수집 방식
- 홈택스에서 조회한 결과를 수집해 단일 스키마로 정규화
- 제공 API
- 11종
- 연동 구조
- 단일 원천, 서브 API 병렬 호출
- 주요 활용
- 부가세 신고 자동화·세무대리 업무, ERP·경영관리 솔루션의 거래 통합, 법인·사업자 여신 심사 보조 자료
SYSTEM FLOW
시스템 흐름
클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 11개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.
ENDPOINTS
제공 API (11종)
| API명 | 제공 정보 | 자료 출처 |
|---|---|---|
| 세금계산서 발행내역(매출) | 반환발급일자·공급자 정보·수령자 정보·합계금액·공급가액·세액·품목·수량·단가 | 홈택스 |
| 세금계산서 발행내역(매입) | 반환매입매출 구분·작성일자·승인번호·발급일자·세액·세금계산서 종류 | 홈택스 |
| 계산서 발행내역(매출) | 반환발급일자·공급자/수령자 정보·공급가액·품목·수량 (면세 계산서) | 홈택스 |
| 계산서 발행내역(매입) | 반환매입매출 구분·작성일자·승인번호·발급일자·세금계산서 종류 | 홈택스 |
| 현금영수증(매출) | 반환매출일자·매출시간·공급가액·부가세·총금액·승인번호·발급수단 | 홈택스 |
| 현금영수증 매출총액 조회(세무대리 전용) | 반환승인일·승인번호·승인금액·이용카드·할부기간·입금정보·수수료정보 (수임처 단위 집계) | 홈택스 |
| 현금영수증 매출내역 누계조회 | 반환승인일·승인번호·승인금액·이용카드·할부기간·입금정보·수수료정보 | 홈택스 |
| 현금영수증(매입) | 반환매입일자·가맹점·공급가액·부가세·봉사료·총금액·공제 여부 | 홈택스 |
| 현금영수증 매입총액 조회(세무대리 전용) | 반환거래년월·공급가액·부가세·봉사료·총금액·거래 건수 | 홈택스 |
| 현금영수증 매입내역 누계조회 | 반환거래년월·공급가액·부가세·봉사료·총금액·거래 건수 | 홈택스 |
| (세금)계산서 상세조회 | 입력승인번호 반환등록번호·상호·성명·사업장·종목·공급가액·세액 (건별 상세) | 홈택스 |
USE CASES
이용사례
ERP·경영관리·세무관리 SaaS가 부가세 신고, 법인세·종합소득세 보조 자료 수집, 매입세액 공제 분류를 자동화하려 할 때 자주 선택되는 홈택스 매입/매출 자료 조회 API 유형입니다.
ERP·경영관리 솔루션의 거래 통합
- 승인번호 기반 건별 상세조회로 회계 시스템의 거래 추적성 강화
- 매입세액 공제 가능 여부(현금영수증 공제 여부 등)를 자동 분류
- 품목·수량·단가 반환을 이용해 원가·매출 분석 리포트를 구성
법인·사업자 여신 심사 보조 자료
- 매출 이력·거래처 다변성을 신용평가 모델의 피처로 편입
- 거래처 마스터(거래 상대방)와 등기부·휴폐업 자료를 결합해 거래 리스크 지수를 산출
- 세금계산서 발행 패턴을 이상 거래 탐지 규칙의 입력 데이터로 활용
ONBOARDING
도입 절차
상담부터 연동·검수까지 네 단계로 진행합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 01
상담 신청
필요한 데이터와 사용 목적을 알려주시면 접수합니다. 목록에 없는 API도 요청할 수 있습니다.
STEP 02
타당성·범위 회신
원천 공개 여부와 수집 방식, 법적 검토를 거쳐 상담 접수 후 2~5영업일 내 타당성을 회신드립니다.
STEP 03
응답 스키마 합의
견적 단계에서 응답 스키마를 합의합니다. 필드명·필터·요약 가공은 정규화 레이어에서 조정합니다.
STEP 04
연동·검수
인증키를 발급하고 연동합니다. 필요한 원천을 병렬 호출해 단일 응답으로 정규화한 결과를 함께 검수합니다.
FAQ
자주 묻는 질문
홈택스 매입/매출 조회 API는 어떤 데이터를 조회할 수 있나요?
세금계산서 발행내역(매출), 세금계산서 발행내역(매입), 계산서 발행내역(매출), 계산서 발행내역(매입), 현금영수증(매출), 현금영수증 매출총액 조회(세무대리 전용) 등 총 11종의 엔드포인트를 제공합니다. 반환: 발급일자·공급자 정보·수령자 정보·합계금액·공급가액·세액·품목·수량·단가
부가세 신고 자동화·세무대리 업무에 홈택스 매입/매출 조회 API를 어떻게 활용하나요?
세무대리인이 수임처별 분기·반기 매출·매입 총액을 한 번에 집계. PG·간편결제 매출 자료와 교차 검증해 누락·중복 매출을 탐지. 세금계산서·현금영수증·계산서를 한 판에 모아 신고서 자동 작성에 투입.
ERP·경영관리 솔루션의 거래 통합에 홈택스 매입/매출 조회 API를 어떻게 활용하나요?
승인번호 기반 건별 상세조회로 회계 시스템의 거래 추적성 강화. 매입세액 공제 가능 여부(현금영수증 공제 여부 등)를 자동 분류. 품목·수량·단가 반환을 이용해 원가·매출 분석 리포트를 구성.
법인·사업자 여신 심사 보조 자료에 홈택스 매입/매출 조회 API를 어떻게 활용하나요?
매출 이력·거래처 다변성을 신용평가 모델의 피처로 편입. 거래처 마스터(거래 상대방)와 등기부·휴폐업 자료를 결합해 거래 리스크 지수를 산출. 세금계산서 발행 패턴을 이상 거래 탐지 규칙의 입력 데이터로 활용.
홈택스 매입/매출 조회 데이터는 어디에서 가져오나요?
홈택스에서 조회한 결과를 수집해 단일 스키마로 정규화합니다. 원천 공개 여부와 수집 방식, 법적 검토는 상담 접수 후 타당성 회신 단계에서 확인합니다.
비용과 기간은 어떻게 정해지나요?
상담 접수 후 2~5영업일 내 타당성과 범위를 회신하고, 견적 단계에서 응답 스키마(필드명·필터·요약 가공)를 합의합니다. 비용과 기간은 이 합의 범위에 따라 견적으로 안내합니다.
목록에 없는 새 API도 요청 가능한가요?
가능합니다. 원천 공개 여부·수집 방식·법적 검토가 선행되며, 상담 접수 후 2~5영업일 내 타당성 회신을 드립니다.
AUTOMATION
이 API로 만드는 업무 자동화
RECOMMENDED