POPBill Developers
API Reference

현금영수증 상태코드

상태코드는 현금영수증 발행부터 국세청 전송까지 문서상태를 확인하는 "상태코드(stateCode)"와 국세청 전송결과(성공, 실패)에 대한 상세설명을 확인할 수 있는 "국세청 결과코드(ntsresultCode)"로 구성됩니다.

팝빌 상태코드와 국세청 결과코드는 '상태 확인(GetInfo) API'를 이용하여 확인 가능합니다. [GetInfo-상태 확인]

팝빌 상태코드(stateCode)

현금영수증 발행부터 국세청 전송까지 문서 처리상태에 대하여 팝빌이 직접 반환하는 상태코드로 "숫자 3자리" 값으로 구성됩니다.

코드메시지설명
300발행완료현금영수증 발행이 완료된 상태입니다.
304전송성공현금영수증 국세청 전송이 정상적으로 완료된 상태입니다.
305전송실패현금영수증 국세청 전송이 특정 사유에 의하여 실패된 상태입니다.

국세청 결과코드(ntsresultCode)

발행한 현금영수증 국세청 전송 처리 결과에 대하여 국세청이 직접 반환하는 결과코드 입니다.

성공

코드메시지설명
0000 성공 국세청의 검증 과정을 통과하여 현금영수증 신고가 정상적으로 완료된 경우

실패

코드메시지설명
TS1 식별번호 오류 – 주민등록번호/사업자번호/휴대폰번호 - 식별번호가 10~13자 사이가 아닌 경우
- 식별번호가 11자이나 '0'으로 시작하지 않은 경우
TS2 식별번호 오류 – 현금영수증 전용 카드 - 식별번호가 16자리인 경우
- 식별번호가 18자리이나 '15442020'으로 시작하지 않은 경우
- 식별번호가 12자리이나 '126'으로 시작하지 않은 경우
TS3 제외대상 사업자와 거래 오류 가맹점 사업자번호가 국세청에 현금영수증 발행불가 사업자로 등록된 경우
TS4 거래금액 오류 - 거래금액과 공급가액+부가세+봉사료 합계가 동일하지 않은 경우
- 공급가액이 부가세보다 작은 경우
- 거래금액이 1원 미만인 경우
TS7 미등록 사업자와 거래 오류 - 가맹점 사업자번호가 국세청에 등록되지 않은 경우
- 가맹점 사업자번호가 국세청에 현금영수증 사업자로 등록되지 않은 경우
TSC 취소거래 오류 – 승인번호/거래일자/취소사유 - 당초 승인 현금영수증이 존재하지 않는 경우
- 당초 승인 현금영수증 국세청 승인번호, 거래일자, 취소사유 중 빈(null) 값이 있을 경우
- 유효하지 않은 취소 사유일 경우
TSE 취소거래 오류 – 가맹점 사업자번호 불일치 취소 현금영수증 가맹점 사업자 번호가 당초 승인 현금영수증과 동일하지 않은 경우
TSF 취소거래 오류 - 거래구분 불일치 취소 현금영수증 거래구분이 당초 승인 현금영수증과 동일하지 않은 경우
TSG 취소거래 오류 - 거래금액 총합계 불일치 취소 현금영수증 거래금액 합계가 당초 승인 현금영수증 거래금액을 초과한 경우
TSH 취소거래 오류 - 신분확인 불일치 취소 현금영수증 식별번호가 당초 승인 현금영수증과 동일하지 않은 경우
TSK 전통시장 종사업장 오류 - 종사업장 번호 - 전통시장 종사업장 번호가 4자리 숫자가 아닌경우
- 전통시장내 종사업자가 아니면서 종사업장 번호가 4자리인 경우
TSL 전통시장 종사업장 오류 - 일반사업자 가맹점이 일반 단독 사업자인 경우
TSM 전통시장 종사업장 오류 - 전통시장에 존재하지 않는 사업자 가맹점이 단위과세 사업자이지만 전통시장에 소속되지 않은경우
TSN 도서공연비 거래 입력 오류 가맹점이 도서공연비 사업자가 아닌 경우
TSO 대중교통 거래 입력 오류 가맹점이 대중교통 사업자가 아닌 경우