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