홈택스 원천세 정기신고 검토
hometax__tax__withholding__regular_report__review먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 정기신고서를 미리보기나 제출 전에 검토합니다. 호출마다 토큰 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": {
"draft_id": "<draft_id>",
"expected_state_version": "<expected_state_version>",
"idempotency_key": "<idempotency_key>"
},
"name": "hometax__tax__withholding__regular_report__review"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | init 결과의 draft_id 를 그대로 입력합니다. 어느 신고서를 작성 중인지 가리킵니다. | |
| annex_document | No | review 단계에서만 읽습니다. choices 를 입력하면 detail_save 때의 annex_choices 를 이 값으로 바꾸고, 입력하지 않으면 그 값을 그대로 씁니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| idempotency_key | Yes | 같은 요청을 두 번 실행하지 않기 위한 키(8자 이상 128자 이하)입니다. 같은 초안의 다른 단계에는 새 값을 입력하고, 재시도에는 같은 값을 입력합니다. 같은 키로 다시 요청하면 다시 실행하지 않고 처음 결과를 돌려줍니다. | |
| expected_state_version | Yes | 직전 단계 결과의 state_version 을 그대로 입력합니다(1 이상). 그사이 신고서가 바뀌어 값이 다르면 실행하지 않고 거절합니다. |