국세청 오류코드
현금영수증 등록 시 발생할 수 있는 국세청 오류코드 전체 목록입니다.
오류코드 목록
| 오류코드 | 자동재처리 | 오류내용 | 상세내용 및 처리방안 |
|---|---|---|---|
| TS1 | O | 신분확인(주민등록번호/사업자번호/휴대폰번호) 오류 | ※ 입력값이 오류인 경우 • '신분확인' 항목이 다음과 같은 경우 - 9자리 이하 - 14자리 이상 - 11자리면서 0이 아닌 것으로 시작 → 핸드폰 번호가 아님 |
| TS2 | O | 신분확인(카드) 오류 | ※ 입력값이 오류인 경우 • 현금영수증 전용카드(15442020으로 시작)이면서 18자리가 아닌 경우 • '신분확인' 항목이 12자리면서 126으로 시작하지 않는 경우 → 현금영수증 M카드번호가 아님 |
| TS3 | X | 제외대상 사업자와 거래 오류 | ※ 입력값이 오류인 경우 • 가맹점의 사업자등록번호가 BLO(발행불가 사업자목록)에 포함된 경우 처리방안 • 국세청으로 현금결제내역을 전송하기 전에 해당 가맹점 사업자등록번호가 BLO에 등록되어 있는지 확인 |
| TS4 | X | 거래금액 오류 | ※ 입력값이 오류인 경우 • 거래금액의 총합계 ≠ 공급가액 + 부가가치세 + 봉사료 • 공급가액 < 부가가치세 • 총 거래금액이 1 이하인 경우 |
| TS5 | X | 승인번호 + 거래일자 중복 오류 | 승인번호와 거래일자가 중복된 경우 |
| TS6 | O | 거래일자 오류 | 참고 사항 • 승인코드가 POS인 경우 - 거래일자가 2017.04.03(월)인 거래내역은 2017.04.05(수) 새벽까지 전송한 내역만 유효 - 거래일자가 2017.04.06(목)인 거래내역은 2017.04.10(월) 새벽까지 전송한 내역만 유효 ※ 4.8(토), 4.9(일)은 주말이므로 기준일자 산정에서 제외 |
| TS7 | X | 미등록 사업자와 거래 오류 | 처리방안 • 국세청 홈택스(www.hometax.go.kr) > 조회/발급 > 사업자 상태에서 사업자등록번호로 사업자 등록여부 조회 → 사업자등록상태 확인 후, 승인코드의 기준일자 범위 내로 재전송 |
| TS8 | X | 파일 레이아웃 오류 | ※ 입력값이 오류인 경우 • 승인번호가 총 9자리가 아니거나 뒤의 7자리가 숫자로 이루어지지 않은 경우 • 현금영수증 사업자번호가 10자리 숫자가 아닌 경우 • 가맹점 사업자번호가 10자리 숫자가 아닌 경우 |
| TSB | O | 신분확인정보 거래자구분 불일치 | 등록번호 구분 불일치 |
| TSC | O | 취소거래 입력 오류 - 원 승인거래의 승인번호 + 입력오류 | ※ 입력값이 오류인 경우 • 취소거래이면서 당초 승인번호, 당초 거래일자 항목 중 1개라도 빈 값이 있는 경우 |
| TSD | X | 승인거래 입력 오류 - 원 승인거래의 승인번호 + 거래일자 입력 | 승인거래 시 원 승인번호와 거래일자 입력 오류 |
| TSE | X | 취소거래 입력 오류 - 가맹점 사업자등록번호 불일치 | ※ 입력값이 오류인 경우 • 승인거래와 취소거래의 가맹점 사업자등록번호가 일치하지 않는 경우 처리방안 • 취소거래 전송 시, 당초 승인거래의 가맹점 사업자등록번호를 확인하여 전송 |
| TSF | X | 취소거래 입력 오류 - 거래자 구분 불일치 | ※ 입력값이 오류인 경우 • 승인거래와 취소거래의 거래자 구분(소득공제/지출증빙)을 확인하여 전송 |
| TSG | X | 취소거래 입력 오류 - 취소가능 금액보다 취소요청 합이 클 경우 | ※ 입력값이 오류인 경우 • 승인거래 금액보다 취소요청(들)의 총 '합계'금액이 큰 경우 그 일자의 취소건들 모두 에러 • 중복취소 요청 시 |
| TSH | O | 취소거래 입력 오류 - 신분확인 불일치 | ※ 입력값이 오류인 경우 • 승인거래와 취소거래의 수취자가 다른 경우 ※ 입력값이 유효한 경우 • '신분확인' 항목이 다음과 같은 경우 - 9자리 이하 - 14자리 이상 - 11자리면서 0이 아닌 것으로 시작 → 핸드폰 번호가 아님 |
| TSJ | X | 취소거래 중복 | 중복 취소 요청 |
| TSK | X | 전통시장 종사업자 번호 입력 오류 - 레이아웃 오류 | ※ 입력값이 오류인 경우 • 전통시장 종사업자 일련번호가 숫자 4자리이나 해당 일련번호가 전통시장 내 종사업자에 속하지 않는 경우 |
| TSL | X | 전통시장 종사업자 번호 입력 오류 - 일반사업자 | 일반사업자에 전통시장 코드 입력 시 |
| TSM | X | 전통시장 종사업자 번호 입력 오류 - 전통시장 외부에 존재하는 사업자 | ※ 입력값이 오류인 경우 • 전통시장 외부에 존재하는 사업자인 경우 |
| TSN | X | 도서,공연비 거래 입력 오류 - 미등록 도서,공연비 사업자 | ※ 입력값이 오류인 경우 • 국세청의 도서,공연비,체육시설 사업자로 신청하지 않은 경우 1. 가맹점에서 도서,공연비,체육시설 사업자로 신청하지 않는 경우 문화비소득공제 > 소득공제 사업자 > 접수하기 2. 가맹점이 신청은 했으나, 등록이 완료되지 않은 경우 3. 등록완료까지 되었으나, 국세청에 반영되지 않은 경우(최대 한달 소요 될 수 있음) 처리방안 • 지속적으로 TSN을 받는 경우, 가맹점에 도서,공연비,체육시설 사업자 신청,등록 여부 확인 필요 |
| TSO | X | 대중교통 거래 입력 오류 - 도서,공연비,체육시설 사업자 | ※ 입력값이 오류인 경우 • 대중교통 및 도서,공연비,체육시설 여부 항목이 'Y'인 거래내역의 가맹점이 국세청의 도서,공연비,체육시설 사업자 명단에 있는 경우 처리방안 • 가맹점이 도서,공연비,체육시설 사업자에 해당하는 경우, 도서,공연비,체육시설 여부 항목을 'C'로 변경하여 재전송 |
| E1 | O | 거래가능일 경과 | 거래 가능한 기한이 지난 경우 |
| E2 | X | 원 거래없음 (취소요청 시) | 취소 시 원거래가 존재하지 않는 경우 |
| E3 | O | 항목별 입력 값 오류 | 레이아웃 오류 |
| E4 | X | 항목별 입력 값 오류 | 레이아웃 오류 |
| BLO | X | 위/폐업 사업자 | 발행불가 사업자 |
자동재처리 안내
NOTE
자동재처리 가능 오류코드
자동재처리가 'O'로 표시된 오류코드는 헥토파이낸셜에서 자동으로 재처리가 가능한 코드입니다. 자동재처리 가맹점으로 등록된 경우, 해당 오류코드는 자동으로 재처리됩니다.
자동재처리 가능 오류코드 (8개): TS1, TS2, TS6, TSB, TSC, TSH, E1, E3
자동재처리 불가 오류코드 (18개): TS3, TS4, TS5, TS7, TS8, TSD, TSE, TSF, TSG, TSJ, TSK, TSL, TSM, TSN, TSO, E2, E4, BLO
주의사항
- 자동재처리 가맹점이 아닌 경우, 오류 발생 시 재처리 API를 통해 직접 재처리 요청을 해야 합니다.
- TSN 오류코드는 거래유형이 일반으로 변경되어 국세청에 정상 발급된 건입니다.
추후 문화비 소득공제로 확인되지 않는다면 오류코드 목록의 상세내용 및 처리방안을 확인 바랍니다. - 오류코드 발생 시, 상세내용 및 처리방안을 참고하여 원인을 파악하고 수정 후 재전송해 주세요.
