기업6 APIs

홈택스 현금영수증 발급

#현금영수증발급#승인거래#취소거래#POS#홈택스#부가세#이커머스환불

OVERVIEW

상품요약

국세청 홈택스의 가맹점 대상 현금영수증 발급 기능을 API 형태로 호출해 승인 거래 발급, 취소 거래 발급, 당일 발급 건의 정정·취소, 발급 내역 조회, 당일 거래 내역 조회, 발급 결과 조회까지 현금영수증 발행 업무 일체를 자동화하는 유형의 API입니다. 사업자가 고객 정보(휴대폰번호·카드번호·사업자번호·주민등록번호 등 발급 수단)와 거래 금액을 넘기면 국세청 승인번호·거래 유형·총 거래금액 같은 필드가 반환되어 POS·이커머스·SaaS 정산 시스템이 수동 조작 없이 발행 결과를 바로 반영할 수 있습니다. 현금 매출 비중이 큰 외식·서비스 업종, 프리랜서·사업자 대상 SaaS, 온라인 간편결제 환불 플로우에서 발급·취소·정정을 일관되게 자동화할 때 자주 선택되는 카테고리입니다.

SYSTEM FLOW

시스템 흐름

클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 6개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.

ENDPOINTS

제공 API (6종)

API명	제공 정보	자료 출처
현금영수증 승인거래 발급	입력발급수단번호·거래금액·거래 유형(소득공제/지출증빙) 반환승인번호·승인일시·총 거래금액	홈택스
현금영수증 취소거래 발급	입력원 승인번호·취소 금액 반환승인번호·발급수단·용도 구분·총 거래금액·총 취소금액·취소 건수	홈택스
현금영수증 당일 발급 정정·취소	입력원 승인번호 반환거래일시·승인번호·발급수단·거래구분·총 거래금액 (당일 내 수정 전용 플로우)	홈택스
현금영수증 발급내역 조회	반환기간별 거래일시·승인번호·발급수단·거래구분·총 거래금액·총 취소금액	홈택스
현금영수증 당일거래 발급내역 조회	반환당일 거래일시·승인번호·발급수단·거래구분·총 거래금액	홈택스
현금영수증 발급결과 조회	입력승인번호 반환거래일시·발급수단·거래구분·총 거래금액·발급 결과(성공/실패·사유코드)	홈택스

USE CASES

이용사례

POS·이커머스·SaaS 정산 시스템이 현금영수증 발급·취소·정정을 수동 조작 없이 일관 처리하려 할 때 자주 선택되는 현금영수증 발행 API 유형입니다.

POS·오프라인 매장 결제 단말

현금 결제 시 고객 휴대폰번호·카드 입력만으로 자동 발급하는 표준 흐름에 활용
환불 처리 시 원 승인번호를 참조해 취소 거래를 동시 발행하는 정합성 확보
당일 정정·취소로 오발행을 바로 보정하는 POS 운영 정책에 편입

이커머스·간편결제 플랫폼의 환불 자동화

현금성 결제(계좌이체·간편결제) 환불 시 취소 거래 발행을 함께 묶어 처리
발급 결과 조회로 실패 건을 재시도·알림 처리하는 운영 루틴에 쓰임
세무 정합성을 위해 발급 내역을 회계 시스템과 주기 동기화

세무·회계 SaaS와 프리랜서용 발행 도구

프리랜서·소규모 사업자가 수기 발행 대신 앱·웹으로 즉시 발행하는 UX 구성
월말 매출 증빙 패키지에 발급 내역 조회 결과를 자동 포함
부가세 신고 시 현금영수증 매출을 매출 구분별로 자동 분류

RECOMMENDED