현금영수증 상태/요약 정보 조회(GetInfo, GetInfos) API 호출시 반환되는 상태코드(stateCode) 값은 3자리 숫자로 구성되어 있습니다. 상태코드에 대한 이해를 돕기위해 다음에 설명되어 있는 상태코드에 대한 정의와 상태코드 테이블을 참조하여 연동환경에 적절하게 적용하시기 바랍니다.
현금영수증 상태코드(stateCode)란 무엇인가요?
현금영수증 상태코드는 3자리수의 조합으로 구성되며 현재의 처리상태를 나타냅니다. 첫번째 자리수는 ‘문서상태’ 두번째 자리수는 ‘0’으로 고정이며 세번째 자리수는 ‘국세청 상태’ 에 대한 상태값을 의미합니다. 다음의 예시와 상태코드표를 참조하시기 바랍니다.
상태코드(stateCode) : 304 인 경우 – “발행완료 된 현금영수증 국세청 전송완료”
| # _ _ | 문서상태 | _ # _ | 0 | _ _ # | 국세청 상태 |
|---|---|---|---|---|---|
| 1 _ _ | 임시저장 | _ 0 _ | – | _ _ 0 | – |
| – | – | _ _ 1 | 전송전 | ||
| 3 _ _ | 발행완료 | _ _ 2 | 전송대기 | ||
| 4 _ _ | 취소 | _ _ 3 | 전송중 | ||
| _ _ 4 | 전송완료 | ||||
| _ _ 5 | 전송오류 |
현금영수증 상태코드 테이블
상태코드에 대한 자세한 사항은 아래 테이블의 정의와 설명을 참조하시기 바랍니다.
| 코드 | 정의 | 설명 |
|---|---|---|
| 100 | 임시저장 | 임시저장 상태 |
| 300 | 발행완료 | 발행이 완료된 상태 |
| 301,302,303 | 국세청 전송중 | 국세청 전송 처리중 |
| 304 | 국세청 전송완료 | 국세청에 전송이 완료된 상태 |
| 305 | 국세청 전송실패 | 국세청에 전송이 되었으나, 국세청에서 오류를 반환한 상태 |
| 400 | 취소 | 국세청 전송 전 발행자에 의해 발행취소 |
지금까지 현금영수증 상태코드와 상태코드 테이블에 대해 안내해 드렸습니다. 현금영수증 API에 대한 자세한 사항은 [링크허브 자료실 > 현금영수증 API 연동매뉴얼] 참조하시기 바랍니다.
고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.
링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr