POPBill Developers
API Reference

전자세금계산서 상태코드

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

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

팝빌 상태코드(stateCode)

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

  • 상태코드메시지설명
    100임시저장공급자가 작성한 세금계산서를 임시저장 합니다.
    300발행완료공급자가 임시저장[100] 상태 세금계산서를 발행(전자서명) 합니다.
    301전송전
    302전송대기
    303전송중
    304전송성공전자세금계산서 국세청 전송이 정상적으로 완료됩니다.
    305전송실패전자세금계산서 국세청 전송이 특정 사유에 의하여 실패됩니다.
    600발행취소공급자가 발행완료[300] 상태 전자세금계산서를 취소합니다.
    발행취소[600] 전자세금계산서는 국세청 전송에서 제외됩니다.
  • 상태코드메시지설명
    100임시저장공급받는자가 작성한 세금계산서를 임시저장 합니다.
    200(역)발행대기공급받는자가 임시저장[100] 상태 세금계산서를 공급자에게 역발행 요청합니다.
    공급자에 의하여 (역)발행거부[400] 또는 발행완료[300] 상태로 변경될 수 있습니다.
    300발행완료공급자가 (역)발행대기[200] 상태 세금계산서를 발행(전자서명) 합니다.
    301전송전
    302전송대기
    303전송중
    304전송성공전자세금계산서 국세청 전송이 정상적으로 완료됩니다.
    305전송실패전자세금계산서 국세청 전송이 특정 사유에 의하여 실패됩니다.
    400(역)발행거부공급자가 (역)발행대기[200] 상태 역발행 세금계산서 발행을 거부합니다.
    500(역)발행취소공급받는자가 (역)발행대기[200] 상태 역발행 세금계산서를 취소합니다.
    600발행취소공급자가 발행완료[300] 상태 전자세금계산서를 취소합니다.
    발행취소[600] 전자세금계산서는 국세청 전송에서 제외됩니다.
  • 상태코드메시지설명
    100임시저장수탁자가 작성한 세금계산서를 임시저장 합니다.
    300발행완료수탁자가 임시저장[100] 상태 세금계산서를 발행(전자서명) 합니다.
    301전송전
    302전송대기
    303전송중
    304전송성공전자세금계산서 국세청 전송이 정상적으로 완료됩니다.
    305전송실패전자세금계산서 국세청 전송이 특정 사유에 의하여 실패됩니다.
    600발행취소수탁자가 발행완료[300] 상태 전자세금계산서를 취소합니다.
    발행취소[600] 전자세금계산서는 국세청 전송에서 제외됩니다.

국세청 결과코드(ntssendErrCode)

발행한 전자세금계산서 국세청 전송 처리 결과에 대하여 국세청이 직접 반환하는 결과코드로 "영문 3자리+숫자 3자리"로 구성됩니다.

성공

코드메시지설명
SUC001 성공 국세청의 검증 과정을 통과하여 전자세금계산서 신고가 정상적으로 완료된 경우

실패

코드메시지설명
SYN002 전자서명 오류 공급자(수탁자)의 전자세금계산서 전자서명이 유효하지 않은 경우
SYN003 승인번호 오류 중복된 국세청 승인번호가 존재하는 경우
SYN004 전자세금계산서 스키마 오류 - 유효하지 않은 전자세금계산서 구조를 가진 경우 : 엘리먼트 중복, 필수 엘리먼트 미존재, 데이터 유형오류, 코드오류, 국세청 승인번호 형식오류 등
- 전자계산서(면세) 과세형태 코드가 영세율인 경우
ERR001 공급자 사업자번호 오류 공급자가 국세청 미등록 사업자인 경우
ERR002 공급받는자 사업자번호 오류 공급받는자가 국세청 미등록 사업자 또는 미등록 주민등록번호(개인)인 경우
ERR003 수탁자 사업자번호 오류 공급자의 전자세금계산서 발행을 위임받은 수탁자가 국세청 미등록 사업자인 경우
ERR005 발행일시 오류 - 발행일시가 유효하지 않는 경우
- 발행일시가 전송일시 이후인 경우
ERR006 작성일자 오류 - 작성일자가 유효하지 않은 경우
- 작성일자가 발행일자 이후인 경우
- 국세청 승인번호 내의 작성일자와 세금계산서 작성일자가 일치하지 않는 경우
ERR007 공급가액, 세액 오류 - 공급가액과 세액의 부호가 다른 경우
- 수정세금계산서 환입 또는 계약의 해제 수정사유의 금액이 정(+)의 값이 경우
- 영세율 전자세금계산서의 세액이 "0"이 아닌 경우
- 전자계산서의 세액이 "0"이 아닌 경우
ERR008 코드 유형 오류 수정세금계산서 수정코드에 오류가 있는 경우
ERR009 폐업사업자 발행 오류 폐업 사업자번호로 폐업신고일자 이후 전자세금계산서를 발행한 경우
ERR010 국세청 등록번호 오류 발행시스템 승인번호의 국세청등록번호와 전송시스템 승인번호의 국세청등록번호가 다른 경우
ERR011 당초승인번호 오류 - 일반 세금계산서에 원본 승인번호가 존재하는 경우
- 수정세금계산서에 원본 승인번호가 존재하지 않거나, 원본 승인번호가 일치하지 않은 경우
ERR099 기타오류 정의되지 않는 기타 오류