// schemas / TAX_INVOICE
매출 전자(세금)계산서
hometax.tax-invoices.sales.v1
매출 세금계산서 + 매출 계산서 통합 목록
요청 파라미터
날짜 범위 필수 — 최대 90일, chunk 90일 단위로 자동 분할.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| dateRangeStart | date | 시작일 조회 시작일 (YYYY-MM-DD) | 예 |
| dateRangeEnd | date | 종료일 조회 종료일 (YYYY-MM-DD) | 예 |
응답 필드
data-jobs/{id}/results 응답의 data[] 각 항목.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| writeDate | date | 작성일자 세금계산서 작성일 (YYYY-MM-DD) | 예 |
| issueDate | date | 발급일자 세금계산서 발행 완료일 (YYYY-MM-DD) | 예 |
| supplierBusinessIdentifier | string | 공급자 사업자등록번호 하이픈 없는 10자리 숫자 | 예 |
| supplyAmount | number | 공급가액 부가세 제외 공급가액 (원 단위) | 예 |
| taxAmount | number | 세액 부가가치세액. 면세/계산서는 0 | 예 |
| totalAmount | number | 합계 금액 공급가액 + 세액 (원 단위) | 예 |
| sendDate | date | 전송일자 국세청 서버 전송 완료일 (YYYY-MM-DD) | 아니오 |
| ntsTransactionId | string | 국세청 승인번호 국세청 발급 고유 승인번호 (24자리). 종이 세금계산서 등 미승인 건은 null | 아니오 |
| supplierSubBusinessNumber | string | 공급자 종사업자번호 종사업장 식별번호 (해당 없으면 null) | 아니오 |
| supplierOrganizationName | string | 공급자 상호 공급자 사업자 등록상 상호명 | 아니오 |
| supplierRepresentativeName | string | 공급자 대표자명 공급자 사업자 등록상 대표자명 | 아니오 |
| supplierAddress | string | 공급자 주소 공급자 사업장 주소 | 아니오 |
| supplierEmail | string | 공급자 이메일 공급자 이메일 주소 | 아니오 |
| buyerBusinessIdentifier | string | 공급받는자 사업자등록번호 하이픈 없는 10자리 숫자. 미등록/영수증 발행 등은 null | 아니오 |
| buyerSubBusinessNumber | string | 공급받는자 종사업장번호 공급받는자 종사업장 식별번호 (해당 없으면 null) | 아니오 |
| buyerOrganizationName | string | 공급받는자 상호 공급받는자 사업자 등록상 상호명 | 아니오 |
| buyerRepresentativeName | string | 공급받는자 대표자명 공급받는자 사업자 등록상 대표자명 | 아니오 |
| buyerAddress | string | 공급받는자 주소 공급받는자 사업장 주소 | 아니오 |
| buyerEmail | string | 공급받는자 이메일 공급받는자 주 이메일 | 아니오 |
| buyerEmailSecondary | string | 공급받는자 추가 이메일 공급받는자 보조 이메일 | 아니오 |
| trusteeBusinessIdentifier | string | 수탁사업장 사업자등록번호 수탁 발행인 경우만 값 존재 | 아니오 |
| trusteeOrganizationName | string | 수탁사업장 상호 수탁사업장 상호 (수탁 발행인 경우만 값 존재) | 아니오 |
| invoiceClassification | string | 세금계산서 분류 세금계산서 / 수정세금계산서 등 | 아니오 |
| invoiceKind | string | 세금계산서 종류 일반 / 일반(수정) 등 | 아니오 |
| issueChannel | string | 발급 채널 인터넷발급 / ASP발급 / ARS발급 / VAN발급 등 | 아니오 |
| paymentType | string | 영수/청구 구분 결제 방식. `영수` (이미 수령) / `청구` (외상) 구분 | 아니오 |
| remark | string | 비고 세금계산서 비고란 | 아니오 |
| itemSupplyDate | date | 품목 공급일자 대표 품목의 공급일 (YYYY-MM-DD) | 아니오 |
| itemName | string | 품목명 대표 품목명. 다품목 명세는 별도 상세 조회 필요 | 아니오 |
| itemSpecification | string | 품목 규격 대표 품목의 규격 | 아니오 |
| itemQuantity | number | 품목 수량 대표 품목 수량 | 아니오 |
| itemUnitPrice | number | 품목 단가 대표 품목 단가 | 아니오 |
| itemSupplyAmount | number | 품목 공급가액 대표 품목의 부가세 제외 공급가액 | 아니오 |
| itemTaxAmount | number | 품목 세액 대표 품목의 부가가치세액 | 아니오 |
| itemRemark | string | 품목 비고 대표 품목의 비고 | 아니오 |