홈택스 원천세 기한후신고 초안 초기화
hometax__tax__withholding__late_report__init먼저 호출할 도구: 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": {
"business_no": "<business_no>",
"periods": "<periods>"
},
"name": "hometax__tax__withholding__late_report__init"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| periods | Yes | 신고 기간 세 값을 담은 객체입니다. submitYm(제출연월), attrYm(귀속연월), pymnYm(지급연월)을 각각 YYYYMM 여섯 자리로 입력하고, 귀속연월이 지급연월보다 늦거나 지급연월이 제출연월보다 늦으면 입력 오류로 거절합니다. JSON 문자열이 아니라 객체로 입력하며 문자열이면 입력 오류로 거절합니다. | |
| draft_mode | No | 작성 방식입니다. new(기본값)는 새 신고서를 작성하고 resume 은 기관에 저장해 둔 작성 중 신고서를 이어서 씁니다. new 인데 기관에 작성 중인 신고가 이미 있으면 그것을 지우지 않고 409 로 거절하므로, 이어 쓰려면 resume 으로 다시 부릅니다. 다른 값은 입력 오류로 거절합니다. | new |
| business_no | Yes | 신고할 사업자등록번호 10자리 | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. |