API

세금계산서 목록 조회

작성일 2026.03.13 | 수정일 2026.03.13

GET/cash/v1/taxinvoice

Query

corpNum— 사업자번호 필터 (최대 24자)

corpName— 사업자명 필터 (최대 64자)

stateCode— 세금계산서 상태코드 필터 (최대 14자). 아래 상태코드표 참조.

ntsResult— 국세청 전송결과 코드 필터 (최대 14자). 아래 결과코드표 참조.

openYN— 개봉 여부 필터

startDate— 조회 시작 날짜

endDate— 조회 종료 날짜

offset— 조회 시작 위치 (기본값: 0)

limit— 조회 건수 (기본값: 20)

발급받은 세금계산서 목록을 조회합니다. 상태코드, 국세청 전송결과, 사업자번호 등으로 필터링할 수 있습니다.

세금계산서 상태코드표

code	status	Description
100	임시저장	공급자가 세금계산서를 임시저장
200	승인대기	공급자가 발행예정 처리, 공급받는자의 승인 대기
210	발행대기	공급받는자가 승인, 공급자의 발행 대기
300, 310	발행완료	세금계산서 발행 완료
301~303, 311~313	전송중	국세청 전송 진행 중
304, 314	전송성공	국세청 전송 완료
305, 315	전송실패	국세청 전송 실패
400	거부	공급받는자가 거부
500, 510	취소	공급자가 취소
600, 610	발행취소	공급자가 발행 취소

국세청 전송결과 코드표

code	Description
SUC001	성공
SYN002	공급자 전자서명 오류
SYN003	승인번호 오류 (이미 등록된 승인번호)
SYN004	전자세금계산서 스키마 오류
ERR001	공급자 사업자등록번호 오류
ERR002	공급받는자 사업자등록번호 오류
ERR003	수탁자 사업자등록번호 오류
ERR005	발행일시 오류
ERR006	작성일자 오류
ERR007	공급가액, 세액 오류
ERR008	코드 유형 오류
ERR009	폐업사업자 발행 오류
ERR010	국세청 등록번호 오류
ERR011	당초승인번호 오류
ERR999	기타 오류

Response

chat

응답은 아래 객체를 포함한 배열(Array) 형태입니다.

Name	Type	Required	Description
_id	string	*	문서 관리 번호 (mgtKey)
accountId	string	*	계정 고유 ID
taxType	string	*	과세/비과세 구분. 'tax'(과세) 또는 'free'(비과세).
corpNum	string	*	사업자등록번호
corpName	string	*	사업자명
writeDate	string	*	작성일자
issueType	string	*	발행 유형. 'regular'(정발행) 또는 'reverse'(역발행).
supplyCostTotal	number	*	공급가액
taxTotal	number	*	부가세
totalAmount	number	*	합계 금액 (공급가액 + 부가세)
purposeType	string	*	영수/청구 구분. 'receipt'(영수) 또는 'bill'(청구).
itemKey	string\|null	*	아이템 키. 수정세금계산서 발행 시 사용.
stateCode	string\|null	*	세금계산서 상태코드. 아래 상태코드표 참조.
openYN	boolean\|null	*	개봉 여부
openDT	boolean\|null		개봉 일시
ntsResult	string\|null	*	국세청 전송결과 코드
ntsResultErrorCode	string\|null		국세청 전송실패 사유코드
modifyCode	string\|null		수정 사유코드 (1~6)
preIssuance	boolean	*	선세금계산서 여부
depositStatus	boolean	*	입금완료 여부
dateCreated	string	*	생성 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)

Structure

Response

[
  {
    "_id": "20240701-001",
    "accountId": "12345678901234",
    "taxType": "tax",
    "corpNum": "1234567890",
    "corpName": "(주)테스트",
    "writeDate": "20240701",
    "issueType": "regular",
    "supplyCostTotal": 45455,
    "taxTotal": 4545,
    "totalAmount": 50000,
    "purposeType": "receipt",
    "itemKey": "KEY123456",
    "stateCode": "304",
    "openYN": true,
    "openDT": null,
    "ntsResult": "SUC001",
    "ntsResultErrorCode": null,
    "modifyCode": null,
    "preIssuance": false,
    "depositStatus": true,
    "dateCreated": "2024-07-01T12:00:00.000Z",
    "dateUpdated": "2024-07-02T08:00:00.000Z"
  }
]