현금영수증
현금 결제가 발생하면 고객은 소득공제 또는 지출증빙을 위한 현금영수증 발급을 요청합니다.
가맹점이 국세청과 직접 연동하려면 별도의 시스템 구축이 필요하고, 발급 결과 확인이나 오류 재처리까지 직접 관리해야 합니다.
헥토파이낸셜 현금영수증 서비스는 이 과정을 대행합니다.
가맹점은 발급 요청 API를 호출해 거래 정보를 전달하기만 하면 됩니다.
헥토파이낸셜이 익일 국세청으로 일괄 전송하고, 발급 결과를 수신해 조회할 수 있도록 제공합니다.
개발자는 API 응답으로 반환되는 승인번호, 응답코드, 상태값을 저장하고, 익일 조회 API를 통해 현금영수증 발급 완료 여부와 응답코드로 정상 처리 여부를 판단합니다.
NOTE
현금영수증 핵심 흐름. 발급/취소 API 호출 → 승인번호 발급 → D+1 국세청 일괄 전송 → 오류내역 조회/재처리.
서비스 기능 알아보기
주요 특징
현금 결제 시 소득공제 또는 지출증빙을 위한 현금영수증 발급을 대행하는 서비스입니다. 가맹점은 API 호출만으로 국세청 현금영수증 발급·취소·조회를 처리할 수 있습니다.
- 현금영수증 발급 : 거래 정보를 국세청에 전송하여 소득공제 또는 지출증빙 영수증을 생성합니다.
- 현금영수증 취소 : 원거래 승인번호를 기반으로 발행된 영수증을 국세청으로 승인 취소 처리합니다.
- 현금영수증 조회 : 발급 요청건의 처리 상태(성공/오류/진행중)와 승인 상세 내역을 확인합니다.
- 자진발급 처리 : 구매자 정보 부재나 특정 에러 시, 국세청 지정번호(010-000-1234)로 영수증을 우선 발급합니다. (사용자 정보 미수집 시 법적 의무 이행)
- 가상계좌 연동발급 : 입금 완료 시점에 맞춰 현금영수증이 자동 발행할 수 있습니다.
서비스 흐름 알아보기
- 현금영수증은 모든 기능이 API 방식으로 제공됩니다.
- 발급 요청 후 국세청 전송은 익일(D+1) 일괄 처리 방식입니다.
발급/취소 흐름
가맹점이 현금영수증 발급 또는 취소를 요청하면, 헥토파이낸셜이 익일 국세청으로 일괄 전송합니다. 오류내역은 D+1 13시 이후부터 조회할 수 있습니다.
가맹점
헥토파이낸셜
국세청
11. 현금영수증 등록/취소 요청
1. 현금영수증 등록/취소 요청
22. 승인번호, 발급일자 응답
2. 승인번호, 발급일자 응답
33. D+1 00시, 국세청 일괄 전송
3. D+1 00시, 국세청 일괄 전송
44. D+1 9~12시, 오류내역 수신
4. D+1 9~12시, 오류내역 수신
55. 13시 이후, 오류내역 조회
5. 13시 이후, 오류내역 조회
각 단계 상세
- 1등록/취소 요청 : 가맹점이 현금영수증 발급 또는 취소 API를 호출합니다.
- 2승인번호 응답 : 헥토파이낸셜이 승인번호와 발급일자를 응답합니다.
- 3국세청 일괄 전송 : 요청 익일(D+1) 00시에 헥토파이낸셜이 국세청으로 일괄 전송합니다.
- 4오류내역 수신 : D+1 9~12시에 국세청에서 오류내역을 수신합니다.
- 5오류내역 조회 : 가맹점이 D+1 13시 이후 오류내역 조회 API로 결과를 확인합니다.
현금영수증은 실시간 발급이 아닙니다.
요청 시점에 승인번호가 발급되지만, 국세청 전송은 익일(D+1) 00시에 일괄 처리됩니다.
오류 여부는 D+1 13시 이후 조회 API로 확인해 주세요.
연동 전 확인사항
연동을 시작하기 전에, 아래 사항을 미리 확인해 두시면 좋습니다.
국세청 전송 일정
- 현금영수증은 요청 익일(D+1) 00시에 국세청으로 일괄 전송됩니다.
- 오류내역은 D+1 13시 이후부터 조회 가능합니다.
자동재처리 가맹점
- 영업담당자를 통해 자동재처리 가맹점으로 등록할 수 있습니다.
- 오류코드에 따라 헥토파이낸셜에서 자동으로 재처리되며, 자진발급번호로 발급됩니다.
NOTE
체육시설 문화비 공제 (2025년 7월 시행)
2025년 7월 1일 이후 체육시설 사용료(수영장, 헬스 등)도 문화비로 추가공제됩니다. 강습료는 50% 공제, 입장료/대여료는 100% 공제됩니다.
