홈택스 원천세 신고 삭제신청 내역 조회
hometax__tax__withholding__delete_request__history먼저 호출할 도구: hometax__session__login (같은 account_link_id). 기간을 정해 원천세 신고 삭제신청 접수 내역을 조회합니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은 다른 칸이니 그대로 두세요. 호출마다 토큰 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": {
"businessNo": "<businessNo>",
"dateFrom": "<dateFrom>",
"dateTo": "<dateTo>"
},
"name": "hometax__tax__withholding__delete_request__history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateTo | Yes | 조회 기간의 종료일입니다. 형식은 dateFrom 과 같고 dateFrom 보다 빠를 수 없으며 dateFrom 과 31일 넘게 떨어질 수 없습니다. | |
| pageNum | No | 받을 쪽 번호입니다. 1 이상 10000 이하의 정수이고 입력하지 않으면 1 입니다. | |
| taxCode | No | 세목 코드입니다. 원천세를 뜻하는 14 만 받으며 입력하지 않으면 14 입니다. | 14 |
| dateFrom | Yes | 삭제신청 내역을 찾을 기간의 시작일입니다. YYYYMMDD 여덟 자리의 실제 날짜로 입력하며, dateTo 보다 늦거나 dateTo 와 31일 넘게 떨어지면 입력 오류로 거절합니다. | |
| pageSize | No | 한 쪽에 받을 내역 수입니다. 1 이상 500 이하의 정수이고 입력하지 않으면 100 입니다. | |
| businessNo | Yes | 삭제신청 내역을 조회할 사업자의 사업자등록번호입니다. 하이픈 없이 숫자 10자리로 입력합니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| request_idempotency_key | No | 로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다. |