홈택스 원천세 수정신고 부표 저장
hometax__tax__withholding__amendment_report__annex_save먼저 호출할 도구: hometax__session__login (같은 account_link_id). 작성 중인 원천세 수정신고서의 부표를 저장하고 기관에서 다시 읽어 저장된 내용을 확인합니다. detail_save 로 소득별 상세를 저장한 뒤에 부릅니다. annex_document 의 kind 로 부표 종류를 고르고, 있던 행을 고치거나 지울 때는 lookup 의 부표 조회가 돌려준 행 번호와 해시를 함께 보냅니다. 제출하지 않습니다. 호출마다 토큰 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": {
"source_job_id": "<source_job_id>",
"expected_snapshot_hash": "<expected_snapshot_hash>",
"annex_document": "<annex_document>"
},
"name": "hometax__tax__withholding__amendment_report__annex_save"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source_job_id | Yes | 이어서 진행할 이전 단계 작업의 job_id 를 그대로 입력합니다(job_ 으로 시작하는 작업 번호). 명세 저장(detail_save)이나 부표 저장(annex_save) 결과, 또는 그 상태에서 실행한 조회(lookup) 결과를 받습니다. 부표 종류가 승계명세(refund_succession)이면 기본정보 저장(basic_save) 결과도 받습니다. 같은 조직과 환경, 같은 기관 연결에서 이 신고 유형으로 성공한 작업이어야 하고 아니면 진행하지 않고 거절하며, 받지 않는 작성 상태의 결과이면 409 로 거절합니다. | |
| annex_document | Yes | 저장할 부표를 담는 객체입니다. kind 에 부표 종류를 입력하고, 값을 바꿀 때는 datasets 에, 행을 추가하거나 수정하거나 삭제할 때는 row_operations 에 담습니다. 같은 목록을 두 곳에 함께 입력하면 입력 오류로 거절합니다. 행을 수정하거나 삭제할 때는 query.kind 가 annex_rows 이고 query.annex_kind 에 같은 부표 종류를 입력한 조회(lookup) 결과의 row_targets 에서 받은 row_index 와 expected_row_hash 를 함께 입력하며, 기관의 지금 행과 다르면 409 로 거절합니다. 행을 추가할 때는 그 둘을 입력하지 않고, 삭제할 때는 values 를 입력하지 않습니다. 환급신청 부표(refund)는 이 신고 유형에서 받지 않고 거절합니다. 승계명세(refund_succession)는 바뀐 행이 없으면 거절하고, 저장한 뒤에는 명세 저장(detail_save)을 다시 해야 합니다. 안쪽 칸은 요구사항 조회(requirements) 결과의 actions 아래 annex_save 항목 schema 에 있습니다. JSON 문자열이 아니라 객체로 입력하며 문자열이면 입력 오류로 거절합니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| expected_snapshot_hash | Yes | source_job_id 작업 결과의 snapshot_hash 를 그대로 입력합니다(소문자 16진수 64자리). 그 작업의 내용과 맞지 않으면 진행하지 않고 작성 내용이 바뀌었다는 오류(409)로 거절합니다. |