API 레퍼런스  >  홈택스 연동

홈택스 현금영수증 결과 조회

자동수집되어 저장된 현금영수증을 일별·월별, 매출·매입 조건으로 조회합니다.

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

POST https://dev.sendbill.co.kr:444/api/agent/hometax/cash-receipts

Request

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

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

Body
{
    "venderno": "1234567890",
    "basedate": "20260827",
    "orderdirection": "01",
    "tradeDirection": "PURCHASE",
    "periodType": "DAILY"
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 result Integer 처리 결과 코드. 성공 시 1, 실패 시 음수
2 message String 처리 결과 메시지
3 totalCount Integer 조건에 맞는 전체 조회 건수
4 chargedCount Integer 이번 요청에서 실제 과금된 건수
5 cashReceipts Array 현금영수증 목록. 실패 시 빈 배열
6 cashReceipts[].issueId String 승인번호
7 cashReceipts[].tradeDT String 거래일자
8 cashReceipts[].tradeType String 거래 구분 코드. 0 승인거래, 1 취소거래
9 cashReceipts[].franchiseNum String 가맹점 사업자번호
10 cashReceipts[].franchiseName String 가맹점명
11 cashReceipts[].identityNum String 소비자 식별번호
12 cashReceipts[].amount String 거래금액
13 cashReceipts[].tax String 부가세
14 cashReceipts[].tip String 봉사료
Response JSON 샘플 › 
{
    "result": 1,
    "message": "성공",
    "totalCount": 1,
    "chargedCount": 1,
    "cashReceipts": [
        {
            "issueId": "202608270000000001",
            "tradeDT": "20260827",
            "tradeType": "0",
            "franchiseNum": "1234567890",
            "franchiseName": "샘플 가맹점",
            "identityNum": "010****1234",
            "amount": "55000",
            "tax": "5000",
            "tip": "0"
        }
    ]
}