홈택스 원천세 신고 삭제신청 준비
hometax__tax__withholding__delete_request__prepareREQUIRES prior hometax__session__login call with same account_link_id. candidates 에서 고른 원천세 신고와 신청인 이름, 연락처, 개인정보 동의를 제출 전에 확인합니다. 조회만 하고 기관에 제출하지 않습니다. 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>",
"sourceJobId": "<sourceJobId>",
"expectedSnapshotHash": "<expectedSnapshotHash>",
"originalFilingReference": "<originalFilingReference>",
"originalReceiptNo": "<originalReceiptNo>"
},
"name": "hometax__tax__withholding__delete_request__prepare"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| consent | No | 개인정보 동의 여부입니다. 사용자 동의를 받았을 때만 JSON 불리언 true 로 입력하며 문자열로 쓴 true 는 입력 오류로 거절하고, false 는 입력하지 않은 것과 같습니다. 제출할 때 이 동의가 기록으로 남습니다. 이 값이 없으면 준비 결과의 required_inputs 에 빠진 항목으로 나오고 그 결과로는 제출(submit)할 수 없으므로, 값을 채워 같은 후보 조회(candidates) 결과로 prepare 를 다시 부릅니다. | |
| taxCode | No | 세목 코드입니다. 원천세를 뜻하는 14 만 받으며 입력하지 않으면 14 입니다. | 14 |
| businessNo | Yes | 삭제신청할 원천세 신고의 사업자등록번호입니다. 하이픈 없이 숫자 10자리로 입력하며 이전 단계 작업의 사업자와 다르면 403 으로 거절합니다. | |
| sourceJobId | Yes | 이어서 진행할 이전 단계 작업의 job_id 를 그대로 입력합니다(job_ 으로 시작하는 작업 번호). 삭제 대상 후보 조회(candidates) 결과를 받습니다. 같은 조직과 환경, 같은 기관 연결에서 성공한 원천세 삭제신청 작업이어야 하고 아니면 진행하지 않고 거절하며, 받지 않는 상태의 결과이면 409 로 거절합니다. | |
| receiptJobId | No | 선택. 원 신고의 접수 결과와 대조할 때만 입력합니다. 성공한 원천세 전자파일 변환신고, 수정신고, 기한후신고의 제출 또는 접수증 조회 작업 ID 입니다. 정기신고 제출 작업 ID 는 입력하지 않습니다. | |
| applicantName | No | 삭제신청에 함께 입력하는 신청인 이름입니다. 1자에서 100자까지이고 공백만 입력하면 입력 오류로 거절합니다. 이 값이 없으면 준비 결과의 required_inputs 에 빠진 항목으로 나오고 그 결과로는 제출(submit)할 수 없으므로, 값을 채워 같은 후보 조회(candidates) 결과로 prepare 를 다시 부릅니다. | |
| applicantPhone | No | 신청인 연락처입니다. 하이픈 없이 숫자 9자리에서 11자리로 입력하며 다른 모양이면 입력 오류로 거절합니다. 이 값이 없으면 준비 결과의 required_inputs 에 빠진 항목으로 나오고 그 결과로는 제출(submit)할 수 없으므로, 값을 채워 같은 후보 조회(candidates) 결과로 prepare 를 다시 부릅니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| originalReceiptNo | Yes | 삭제를 신청할 원 신고의 접수번호입니다. originalFilingReference 와 같은 후보 항목의 receipt_no 를 그대로 입력하며 비어 있으면 입력 오류로 거절합니다. | |
| receiptSnapshotHash | No | 선택. receiptJobId 를 입력할 때 함께 입력하는 그 작업 결과의 해시입니다. | |
| expectedSnapshotHash | Yes | sourceJobId 작업 결과의 snapshot_hash 를 그대로 입력합니다(소문자 16진수 64자리). 그 작업의 내용과 맞지 않으면 진행하지 않고 작성 내용이 바뀌었다는 오류(409)로 거절합니다. | |
| originalFilingReference | Yes | 삭제를 신청할 원 신고의 민원 ID 입니다. 후보 조회(candidates) 결과 candidates 항목의 filing_reference 를 그대로 입력합니다. 비어 있으면 입력 오류로 거절하고, originalReceiptNo 와 함께 후보 하나로 정해지지 않으면 409 로 거절하며, 경정청구 신고서는 삭제신청할 수 없어 거절합니다. 후보 조회 뒤 기관의 신고 정보가 바뀌었으면 거절하므로 후보 조회(candidates)부터 다시 합니다. | |
| request_idempotency_key | No | Optional same-request recovery key for authenticated calls; see the tool description. |