전체 연동 플로우
현금영수증은 등록/취소 요청 → 국세청 일괄 전송 → 오류 내역 조회 순으로 처리됩니다.
전체 흐름
가맹점
헥토파이낸셜
국세청
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시 이후, 발급 오류 내역 조회
오류 내역 조회 가능 시간
국세청 작업에 의해 오류 내역 조회 가능 시간(13시 이후)은 지연될 수 있습니다.
재처리 결과 조회 시간은 지연될 수 있습니다
국세청 작업 상황에 따라 오류내역과 재처리 결과의 수신 및 조회 가능 시간이 늦어질 수 있습니다. 결과가 없으면 잠시 후 다시 조회하세요.
1단계: 현금영수증 등록/취소
가맹점 서버에서 현금영수증 등록 또는 취소를 요청합니다.
| 구분 | 도메인 |
|---|---|
| 테스트 | tcash.settlebank.co.kr |
| 상용 | cash.settlebank.co.kr |
등록 요청 주요 파라미터
| 파라미터 | 설명 |
|---|---|
mid | 상점 아이디 |
assort | 승인구분 (0: 등록, 1: 취소) |
transNo | 가맹점 고유 주문번호 |
trDt | 거래일시 (yyyyMMddhh24miss) |
amt | 공급가액 |
vat | 부가세 |
purpose | 용도구분 (0: 소득공제, 1: 지출증빙) |
identityGb | 등록번호 구분 (1: 카드, 2: 주민번호, 3: 사업자번호, 4: 휴대전화) |
identity | 현금영수증 등록번호 |
등록/취소 API 문서
2단계: 발급 오류 내역 조회
D+1일 13시 이후 국세청 처리 결과를 조회합니다.
| 구분 | 도메인 |
|---|---|
| 테스트 | tb-nspay.settlebank.co.kr |
| 상용 | nspay.settlebank.co.kr |
재처리
발급 오류가 발생한 경우 재처리를 통해 다시 등록할 수 있습니다.
자동재처리 가맹점
- D+1 13시 이후 발급 오류 내역을 조회합니다.
- 자동재처리 대상 오류는 헥토파이낸셜에서 재처리 데이터를 생성합니다.
- 재처리 데이터는 원거래 발급일자 기준 D+2에 국세청으로 일괄 전송됩니다.
- 국세청 처리 후 재처리 결과내역 조회 API로 최종 결과를 확인합니다.
일반 가맹점
- D+1 13시 이후 발급 오류 내역을 조회합니다.
- 조회된 오류 중 재처리가 필요한 건을 재처리 등록 API로 요청합니다.
- 재처리 요청 데이터는 원거래 발급일자 기준 D+2에 국세청으로 일괄 전송됩니다.
- 국세청 처리 후 재처리 결과내역 조회 API로 최종 결과를 확인합니다.
