API 레퍼런스  >  세금계산서 조회

(세금)계산서 상태 조회

- (세금)계산서 현황을 조회합니다.
POST https://dev.sendbill.co.kr:444/api/agent/status/detail

Request

Request 본문 ›
No 변수명 타입 길이 필수 설명
1 billseq String 19 Y (세금)계산서 고유번호
Request 예시 ›
Request 본문
POST https://api.sendbill.co.kr/api/agent/document/registDirect

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json;charset=UTF-8
Accept-Charset: UTF-8			

Body
{
    "billseq" : "seq20260611_01"
}

Response

Response 본문 ›
NO 변수명 타입 설명
1 Result int 결과 코드
성공 : 1, 실패 : 음수
2 Message String 결과 메시지
3 Data Object 데이터
Data
NO 변수명 설명 반환 데이터 예시
1 billseq (세금)계산서 고유번호 Parameter와 동일한 billseq
2 billstat ▲ (세금)계산서 상태 코드표 참고
↳ billstat
코드 종류
0 미개봉
1 승인
2 반려
3 개봉
4 승인취소
5 미전송
6 삭제
9 종이문서저장
3 transyn 전송여부 Y (성공) / N (전송대기) / E (에러)
4 reportstat ▲ 국세청 신고 상태 코드표 참고
↳ reportstat
코드 종류
N 미신고
A 접수대기
B 접수완료
R 신고완료
F 신고실패
5 reportissueid 국세청 승인 번호 xxxxxxxx41000011xxxxxxxx
6 reportrsltcd ▲ 국세청 신고 결과 코드표 참고
↳ reportstat
코드 상태 세부내용
SUC001 성공 모든 검증 과정을 통과한 경우
SYN002 공급사업자, 수탁자 전자서명 오류 공급사업자 전자서명 또는 위수탁세금계산서의 경우 수탁자 전자서명이 유효하지 않은 경우
SYN003 승인번호 중복 오류 승인번호가 국세청에 정상적인 (세금)계산서로 기 등록되어 있는 경우
SYN004 전자(세금)계산서 스키마 오류 1. 유효하지 않은 전자(세금)계산서 구조(딜리버트중복, 필수 필리버트 미존재, 코드오류, 데이터유형 오류, 승인번호 형식 오류 등)를 가진 경우
2. 계산서의 종류 코드가 없을 경우
ERR001 공급사업자사업자번호 오류 국세청 미등록 사업자
ERR002 공급받는자사업자번호 오류 국세청 미등록 사업자 또는 미등록 주민등록번호인 경우
ERR003 수탁사업자등록번호 오류 수탁사업자 존재 시 국세청 미등록사업자
ERR005 발급일시 오류 1. 발급일시가 유효하지 않은 경우
2. 발급일시가 전송일시 이후인 경우
ERR006 작성일자 오류 1. 작성일자가 유효하지 않은 경우
2. 작성일자가 발급일시 이후인 경우
3. 승인번호 내의 작성일자와 작성일자가 다른 경우
ERR007 공급가액, 세액 오류 1. 공급가액과 세액의 부호가 다른 경우
2. 수정(세금)계산서의 원인 코드 계약의 해제 시 금액이 정(+)의 값인 경우
3. 영세율(위수탁)세금계산서의 때 세액이 "0"이 아닌 경우
4. 계산서일 때 세액이 "0"이 아닌 경우
5. 세액 합계액이 공급가액 합계액의 10%가 아닌 경우
(단, 단수조정으로 공급가액의 합계액과 세액의 합계액을 각각 (+),(-)10원 이내의 금액은 허용)
ERR008 코드 유형 오류 (세금)계산서 종류, 공급받는자 사업자등록번호 구분 코드, 수정세금계산서의 대수정 코드에 오류가 있는 경우
ERR009 폐업사업자 발급 오류 공급사업자가 폐업신고일자 이후 계산서를 발급한 경우
ERR010 국세청 등록번호 오류 발급시스템 승인번호의 국세청등록번호와 전송시스템의 국세청등록번호가 다른 경우
ERR011 당초승인번호 오류 1. 수정세금계산서에 입력된 당초승인번호가 존재하지 않거나, 공급자의 당초승인번호가 아닌 경우
2. 일반세금계산서일 때 당초승인번호가 입력된 경우
ERR999 정의되지 않은 기타오류 수정계산서의 사유가 내국신용장 사후개설인 경우
7 reportdate 국세청 전송 일시 yyyyMMddHHmmss
8 md5
9 ManagerData ▲ (세금)계산서 관리 요청내역
↳ ManagerData
No 변수명 설명
1 orderseq 요청 고유번호
2 billseq (세금)계산서 고유번호
3 create_dt 요청 생성일
4 chg_date 요청 실행시간
5 cmd_div 6 : 삭제, E : 이메일 재전송
6 set_yn 요청 처리현황
7 remark 비고
8 etc01 기타1
9 etc02 기타2
10 etc03 기타3
11 etc04 기타4
12 etc05 기타5
Response 예시 › 
{
    "Result" : 1,
    "Message" : "성공",
    "Data" : {
	"reportrsltcd" : "",
	"reportstat" : "A",
	"reportdate" : "",
	"transyn" : "Y",
	"billseq" : "seq20260611_01",
	"sbillseq" : "131844969",
	"reportissueid" : "202606114100001170464918",
	"billstat" : "0",
	"md5" : "88659CFC4AD3C03767EDFD735B208517",
	"ManagerData" : [
	    {
		"orderseq" : "412",
		"billseq" : "seq20260611_01",
		"create_dt" : "20260611",
		"chg_date" : "2026-06-11 14:47:44.0",
		"cmd_div" : "E",
		"set_yn" : "Y",
		"remark" : "test05@netmania.co.kr",
		"etc1" : "",
		"etc2" : "",
		"etc3" : "",
		"etc4" : "",
		"etc5" : ""
	    }
	]
    }
}