API 레퍼런스  >  홈택스 연동

홈택스 세금계산서 결과 조회

자동수집되어 저장된 세금계산서 또는 계산서를 일별·월별 조건으로 조회합니다.

조회 결과에 미과금 건이 있으면 해당 요청에서 과금한 후 결과를 반환합니다.

POST https://dev.sendbill.co.kr:444/api/agent/hometax/tax-invoices

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 venderno String 10 Y API 사용자 소유 사업자번호 '-' 없이 입력
2 taxtype String 2 Y 계산서 유형 00 전체, 01 세금계산서, 03 계산서
3 datetype String 2 Y 날짜 기준 01 작성일자, 02 발급일자
4 basedate String 8 조건부 일별 조회 기준일 periodType=DAILY일 때 YYYYMMDD
5 basemonth String 6 조건부 월별 조회 기준월 periodType=MONTHLY일 때 YYYYMM
6 orderdirection String 2 Y 정렬 방향 01 내림차순, 02 오름차순
7 tradeDirection String Y 거래 구분 ALL 전체, SALES 매출, PURCHASE 매입
8 periodType String Y 조회 기간 구분 DAILY 일별, MONTHLY 월별
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/hometax/tax-invoices

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

Body
{
    "venderno": "1234567890",
    "taxtype": "01",
    "datetype": "01",
    "basedate": "20260827",
    "orderdirection": "01",
    "tradeDirection": "SALES",
    "periodType": "DAILY"
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 result Integer 처리 결과 코드. 성공 시 1, 실패 시 음수
2 message String 처리 결과 메시지
3 totalCount Integer 조건에 맞는 전체 조회 건수
4 chargedCount Integer 이번 요청에서 실제 과금된 건수
5 taxInvoices Array 세금계산서 목록. 실패 시 빈 배열
6 taxInvoices[].issueId String 국세청 승인번호
7 taxInvoices[].sendDT String 전송일시
8 taxInvoices[].issueDT String 발급일시
9 taxInvoices[].writeDT String 작성일자
10 taxInvoices[].modifyCode String 수정 사유 코드
11 taxInvoices[].taxType String 01 일반 세금계산서, 02 영세율 세금계산서, 03 계산서
12 taxInvoices[].purposeType String 영수·청구 목적 코드
13 taxInvoices[].sVenderNo String 공급자 사업자번호
14 taxInvoices[].sRegId String 공급자 종사업장번호
15 taxInvoices[].sCompanyName String 공급자 상호
16 taxInvoices[].sCeoName String 공급자 대표자명
17 taxInvoices[].sAddress String 공급자 주소
18 taxInvoices[].sUptae String 공급자 업태
19 taxInvoices[].sUpjong String 공급자 업종
20 taxInvoices[].sUser String 공급자 담당자
21 taxInvoices[].sEmail String 공급자 이메일
22 taxInvoices[].rVenderNo String 공급받는자 사업자번호
23 taxInvoices[].rRegId String 공급받는자 종사업장번호
24 taxInvoices[].rCompanyName String 공급받는자 상호
25 taxInvoices[].rCeoName String 공급받는자 대표자명
26 taxInvoices[].rAddress String 공급받는자 주소
27 taxInvoices[].rUptae String 공급받는자 업태
28 taxInvoices[].rUpjong String 공급받는자 업종
29 taxInvoices[].rUser String 공급받는자 담당자
30 taxInvoices[].rEmail String 공급받는자 이메일
31 taxInvoices[].bVenderNo String 수탁자 사업자번호
32 taxInvoices[].bRegId String 수탁자 종사업장번호
33 taxInvoices[].bCompanyName String 수탁자 상호
34 taxInvoices[].bCeoName String 수탁자 대표자명
35 taxInvoices[].bAddress String 수탁자 주소
36 taxInvoices[].bUptae String 수탁자 업태
37 taxInvoices[].bUpjong String 수탁자 업종
38 taxInvoices[].bUser String 수탁자 담당자
39 taxInvoices[].bEmail String 수탁자 이메일
40 taxInvoices[].amountTotal String 공급가액 합계
41 taxInvoices[].taxTotal String 세액 합계
42 taxInvoices[].totalAmount String 총액
43 taxInvoices[].cash String 현금 결제액
44 taxInvoices[].checkBill String 수표 결제액
45 taxInvoices[].note String 어음 결제액
46 taxInvoices[].credit String 외상미수금
47 taxInvoices[].remark1 String 비고 1
48 taxInvoices[].remark2 String 비고 2
49 taxInvoices[].remark3 String 비고 3
50 taxInvoices[].itemName String 대표 품목명
51 taxInvoices[].items Array 품목 목록
52 taxInvoices[].items[].itemseq String 품목 순번
53 taxInvoices[].items[].sup String 공급가액
54 taxInvoices[].items[].obj String 품목명
55 taxInvoices[].items[].dt String 공급 일자
56 taxInvoices[].items[].tax String 세액
57 taxInvoices[].items[].unit String 규격
58 taxInvoices[].items[].remark String 품목 비고
59 taxInvoices[].items[].vlm String 수량
60 taxInvoices[].items[].danga String 단가
Response JSON 샘플 › 
{
    "result": 1,
    "message": "성공",
    "totalCount": 1,
    "chargedCount": 1,
    "taxInvoices": [
        {
            "issueId": "202608274100000000000001",
            "sendDT": "20260827121000",
            "issueDT": "20260827120500",
            "writeDT": "20260827",
            "modifyCode": "",
            "taxType": "01",
            "purposeType": "01",
            "sVenderNo": "1234567890",
            "sRegId": "",
            "sCompanyName": "샘플 공급자",
            "sCeoName": "홍길동",
            "sAddress": "서울특별시 송파구",
            "sUptae": "서비스업",
            "sUpjong": "소프트웨어 개발",
            "sUser": "공급자 담당자",
            "sEmail": "supplier@example.com",
            "rVenderNo": "0987654321",
            "rRegId": "",
            "rCompanyName": "샘플 공급받는자",
            "rCeoName": "김철수",
            "rAddress": "서울특별시 강남구",
            "rUptae": "도소매업",
            "rUpjong": "전자상거래",
            "rUser": "공급받는자 담당자",
            "rEmail": "invoicee@example.com",
            "bVenderNo": "",
            "bRegId": "",
            "bCompanyName": "",
            "bCeoName": "",
            "bAddress": "",
            "bUptae": "",
            "bUpjong": "",
            "bUser": "",
            "bEmail": "",
            "amountTotal": "100000",
            "taxTotal": "10000",
            "totalAmount": "110000",
            "cash": "110000",
            "checkBill": "0",
            "note": "0",
            "credit": "0",
            "remark1": "",
            "remark2": "",
            "remark3": "",
            "itemName": "서비스 이용료",
            "items": [
                {
                    "itemseq": "1",
                    "sup": "100000",
                    "obj": "서비스 이용료",
                    "dt": "20260827",
                    "tax": "10000",
                    "unit": "건",
                    "remark": "",
                    "vlm": "1",
                    "danga": "100000"
                }
            ]
        }
    ]
}