POPBill Developers
API Reference

현금영수증 상태

현금영수증 상태는 발행부터 국세청 전송까지 팝빌의 처리결과를 확인하는 '팝빌 상태코드'와 국세청 처리결과의 상세정보를 확인하는 '국세청 결과코드'로 구성됩니다.

[GetInfo - 단건 상태 확인] - 1회 호출에 1건 상태 확인
[GetInfos - 대량 상태 확인] - 1회 호출에 1,000건 상태 확인

팝빌 상태코드

팝빌에서 처리된 현금영수증 상태입니다. 팝빌에서 발행된 현금영수증의 확인이 가능합니다.

코드메시지설명
300발행완료현금영수증 발행이 완료된 상태
304전송성공현금영수증 국세청 신고가 정상적으로 완료된 상태
305전송실패국세청이 특정사유로 현금영수증 신고를 반려한 상태

국세청 결과코드

국세청에서 처리된 현금영수증 상태입니다. 팝빌에서 국세청에 전송된 현금영수증만 확인이 가능합니다.

성공

코드설명
0000 국세청의 검증 과정을 통과하여 현금영수증 신고가 정상적으로 완료된 경우
TSK 국세청 검증 과정 통과 (단, 가맹점의 종사업장번호가 유효하지 않은 경우)
TSL 국세청 검증 과정 통과 (단, 가맹점의 종사업장번호는 유효하나 사업자단위과세 사업자가 아닌 경우)
TSM 국세청 검증 과정 통과 (단, 가맹점이 전통시장에 소속된 사업장이 아닌 경우)
TSN 국세청 검증 과정 통과 (단, 가맹점이 도서공연비 사업자가 아닌 경우)
※ 팝빌 상태코드 304(전송성공)에 해당하는 국세청 결과코드 입니다.

실패

코드설명
TS1 식별번호(휴대폰번호/주민등록번호/사업자번호)가 유효하지 않는 경우
TS2 식별번호(카드번호)가 유효하지 않는 경우
TS3 가맹점 업종이 국세청으로부터 현금영수증 발급불가로 지정된 업종코드에 속하는 경우
TS4 "거래금액≠공급가액+부가세+봉사료" 또는 거래금액이 유효하지 않는 경우
TS5 국세청에 거래일자에 속하는 중복된 국세청승인번호가 존재하는 경우
TS6 거래일자가 유효하지 않는 경우
TS7 가맹점 사업자번호가 국세청에 등록되지 않은 경우
TS8 현금영수증의 국세청 신고 형식이 유효하지 않은 경우
TSC 취소 현금영수증의 당초 현금영수증이 국세청에 존재하지 않는 경우
TSE 취소 현금영수증과 당초 현금영수증의 가맹점 사업자번호가 동일하지 않은 경우
TSF 취소 현금영수증과 당초 현금영수증의 거래구분이 동일하지 않은 경우
TSG 취소 현금영수증의 거래금액 합계가 당초 현금영수증의 거래금액을 초과하는 경우
TSH 취소 현금영수증과 당초 현금영수증의 식별번호가 동일하지 않은 경우
TSO 가맹점이 대중교통 사업자가 아닌 경우
※ 팝빌 상태코드 305(전송실패)에 해당하는 국세청 결과코드 입니다.