홈택스 원천세 정기신고 상세 저장
hometax__tax__withholding__regular_report__detail_save먼저 호출할 도구: 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>",
"detail_document": "<detail_document>"
},
"name": "hometax__tax__withholding__regular_report__detail_save"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | init 결과의 draft_id 를 그대로 입력합니다. 어느 신고서를 작성 중인지 가리킵니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| detail_document | Yes | 소득종류별 명세입니다. income_sections 가 필수이고, 그 키는 basic_save 에서 고른 소득종류와 정확히 같아야 합니다. 근로소득(employment)의 rows 에는 그 소득종류의 행 코드(code)를 정해진 순서대로 모두 입력합니다. 그 밖의 소득종류의 rows 에는 그 소득종류에서 쓸 수 있는 행 코드 가운데 신고할 행만 입력하고, 같은 코드를 두 번 입력하지 않습니다. 행마다 인원(inc_pymn_nfp_cnt), 총지급액(inc_pymn_tota_pymn_amt), 세액 칸을 채웁니다. previous_refund(이번 세액에서 먼저 빼는 환급세액, 0 이상 정수, 기본 0), annex_choices, succession_popup 은 선택입니다. | |
| idempotency_key | Yes | 같은 요청을 두 번 실행하지 않기 위한 키(8자 이상 128자 이하)입니다. 같은 초안의 다른 단계에는 새 값을 입력하고, 재시도에는 같은 값을 입력합니다. 같은 키로 다시 요청하면 다시 실행하지 않고 처음 결과를 돌려줍니다. | |
| expected_state_version | Yes | 직전 단계 결과의 state_version 을 그대로 입력합니다(1 이상). 그사이 신고서가 바뀌어 값이 다르면 실행하지 않고 거절합니다. |