홈택스 원천세 정기신고 초안 초기화
hometax__tax__withholding__regular_report__initREQUIRES prior hometax__session__login call with same account_link_id. Initialize a Hometax regular-withholding draft. This writes to the institution. The first call is not executed: it returns a preview of exactly what will be sent and a one-time confirmation_token (error WRITE_CONFIRMATION_REQUIRED). Show that preview to the user as it is. Only after the user agrees, call again with the same arguments plus that confirmation_token. Never add the token without the user's agreement. Changing any argument makes the token invalid; call without the token to get a new preview. Exception: with draft_mode=resume the call only reads the return already in progress (nothing is written or deleted at the institution), so it runs at once and returns no confirmation_token. 호출마다 토큰 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": {
"periods": "<periods>"
},
"name": "hometax__tax__withholding__regular_report__init"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| periods | Yes | submitYm, attrYm, pymnYm period object | |
| draft_mode | No | 작성 방식. new(기본값)는 새 신고서로 작성하며, 이미 작성 중인 신고서가 있으면 그것을 지우고 시작합니다. resume 은 작성 중인 신고서를 이어서 씁니다. init 과 basic_save 에 같은 값을 입력해 주세요. | |
| fixture_key | No | Optional local fixture key | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| confirmation_token | No | 첫 호출이 돌려준 1회용 확인 토큰입니다(오류 WRITE_CONFIRMATION_REQUIRED). 같은 인자에 이 값을 그대로 넣어 다시 호출하면 실행됩니다. 10분 뒤 만료되고 한 번만 쓸 수 있습니다. |