API 레퍼런스  >  홈택스 연동

홈택스 자동수집 Job 등록

홈택스 자동수집 대상 문서, 거래 구분과 날짜 기준을 등록합니다.

scrapType이 02이면 taxType을 전송하지 않으며, 01 또는 03에서 taxType을 생략하면 03으로 처리합니다.

인증서 방식(C)은 세금계산서 발행용으로 등록한 공동인증서(인증서 등록 API 또는 인증서 등록 화면)를 함께 사용합니다. 인증서 방식은 요청할 때마다 certPassword로 인증서 비밀번호를 확인합니다.

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 jwt String Y 토큰 발급 API에서 발급한 사업자 JWT JSON Body로 전송
2 scrapType String 2 Y 수집 문서 구분 01 세금계산서, 02 현금영수증, 03 전체
3 tradeDirection String 2 Y 거래 구분 01 매출, 02 매입, 03 전체
4 dateType String 2 N 날짜 기준 01 작성일자, 02 발급일자. 생략 시 01
5 taxType String 2 조건부 계산서 유형 01 세금계산서, 02 계산서, 03 전체
6 certPassword String 조건부 공동인증서 비밀번호 인증서 방식(C)이면 필수. 등록된 인증서의 비밀번호로 검증하며 저장하지 않음
Request JSON 샘플 ›
Request 항목 명세
POST https://api.sendbill.co.kr/api/agent/hometax/scrap-jobs

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

Body
{
    "jwt": "eyJhbGciOiJIUzI1NiJ9...",
    "scrapType": "03",
    "tradeDirection": "03",
    "dateType": "01",
    "taxType": "03"
}

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"
    }
}