전자세금계산서 통계 조회
hometax__etax__invoice__search_statisticsREQUIRES prior hometax__session__login call with same account_link_id. 전자세금계산서 통계를 월, 분기, 연 단위로 조회합니다. wrt_ym_strt/wrt_ym_end 는 YYYYMM 형식입니다(예: 2025년 7월부터 9월까지는 202507/202509). For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"wrt_ym_strt": "<wrt_ym_strt>",
"wrt_ym_end": "<wrt_ym_end>"
},
"name": "hometax__etax__invoice__search_statistics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dt_cl | No | Aggregation period: '01'=monthly(월별), '02'=quarterly(분기별), '03'=yearly(년도별). Default '01'. | |
| page_num | No | Page number (default 1) | |
| page_size | No | Page size (default 10) | |
| wrt_ym_end | Yes | End period, same format as wrt_ym_strt (monthly YYYYMM / quarterly YYYY+quarter / yearly YYYY). | |
| wrt_ym_strt | Yes | Start period. Monthly(dt_cl=01): YYYYMM (e.g. 202507). Quarterly(02): YYYY+quarter code (e.g. 20251). Yearly(03): YYYY. | |
| etxiv_clsf_cd | No | Invoice classification (전자세금계산서 구분): '01'=tax invoice(전자세금계산서), '03'=invoice(전자계산서). Default '01'. | |
| ht_rtn_cd_end | No | Quarter end code (분기 종료 코드, e.g. '20254'). Used only when dt_cl=02(quarterly). | |
| ht_rtn_cd_strt | No | Quarter start code (분기 시작 코드, e.g. '20251'). Used only when dt_cl=02(quarterly). | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| request_idempotency_key | No | Optional same-request recovery key for authenticated calls; see the tool description. |