홈택스 원천세 신고 삭제신청 대상 조회
hometax__tax__withholding__delete_request__candidatesREQUIRES prior hometax__session__login call with same account_link_id. 삭제를 신청할 수 있는 접수된 원천세 신고 목록을 조회합니다. 조회만 하고 신고를 바꾸지 않습니다. 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": {
"businessNo": "<businessNo>"
},
"name": "hometax__tax__withholding__delete_request__candidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| attrYm | No | 삭제 대상 신고를 귀속연월로 좁힐 때 씁니다. YYYYMM 여섯 자리로 입력하며 입력하지 않으면 귀속연월 조건 없이 조회합니다. | |
| taxCode | No | 세목 코드입니다. 원천세를 뜻하는 14 만 받으며 입력하지 않으면 14 입니다. | 14 |
| businessNo | Yes | 삭제신청할 원천세 신고의 사업자등록번호입니다. 하이픈 없이 숫자 10자리로 입력합니다. | |
| 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. |