API 레퍼런스  >  홈택스 연동

홈택스 자동수집 Job 조회

사업자에 등록된 활성 홈택스 자동수집 Job 설정과 실행 상태를 조회합니다.

POST https://dev.sendbill.co.kr:444/api/agent/hometax/scrap-jobs/detail

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 jwt String Y 토큰 발급 API에서 발급한 사업자 JWT JSON Body로 전송
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/hometax/scrap-jobs/detail

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

Body
{
    "jwt": "eyJhbGciOiJIUzI1NiJ9..."
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200
2 data Object 자동수집 Job 정보
3 data.scrapType String 수집 문서 구분
4 data.tradeDirection String 거래 구분
5 data.dateType String 날짜 기준
6 data.taxType String / null 계산서 유형. 현금영수증 전용 Job은 null
7 data.useYn String 사용 여부 Y/N
8 data.status String Job 실행 상태: PENDING, RUNNING, RETRY_WAIT, COMPLETED, FAILED
9 data.attemptCount Integer 현재 재시도 횟수
10 data.nextTargetDate String / null 다음 수집 기준일
11 data.nextRunAt String / null 다음 실행 예정 시각
12 data.nextRetryAt String / null 다음 재시도 시각
13 data.lastStartedAt String / null 최근 실행 시작 시각
14 data.lastFinishedAt String / null 최근 실행 종료 시각
15 data.createdAt String 등록 시각
16 data.updatedAt String 최종 변경 시각
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "scrapType": "03",
        "tradeDirection": "03",
        "dateType": "01",
        "taxType": "03",
        "useYn": "Y",
        "status": "PENDING",
        "attemptCount": 0,
        "nextTargetDate": "2026-09-01",
        "nextRunAt": "2026-09-02T03:00:00+09:00",
        "nextRetryAt": null,
        "lastStartedAt": null,
        "lastFinishedAt": null,
        "createdAt": "2026-09-01T12:00:00",
        "updatedAt": "2026-09-01T12:00:00"
    }
}