홈택스 원천세 전자파일 변환신고 제출 전 미리보기
hometax__tax__withholding__file_conversion__previewREQUIRES prior hometax__session__login call with same account_link_id. 내용검증까지 끝나 변환이 완료된 작업에서 제출할 원천세 신고 대상 전체를 보여 줍니다. 변환이 끝나지 않았거나 정상 변환된 대상이 없으면 거절됩니다. 제출하지 않습니다. submit 은 이 단계의 job_id 를 source_job_id 로 받아 미리 본 대상이 그대로일 때만 제출합니다. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 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>"
},
"name": "hometax__tax__withholding__file_conversion__preview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source_job_id | Yes | 이어서 진행할 이전 단계 작업의 job_id 를 그대로 입력합니다(job_ 으로 시작하는 작업 번호). 변환이 끝나 제출할 수 있는 상태의 결과를 받습니다. 기관에서 제출 가능한 변환 결과가 없으면 409 로 거절합니다. 같은 조직과 환경, 같은 기관 연결에서 성공한 원천세 파일변환 작업이어야 하고 아니면 진행하지 않고 거절합니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| expected_snapshot_hash | Yes | source_job_id 작업 결과의 snapshot_hash 를 그대로 입력합니다(소문자 16진수 64자리). 그 작업의 내용과 맞지 않으면 진행하지 않고 작성 내용이 바뀌었다는 오류(409)로 거절합니다. | |
| request_idempotency_key | No | Optional same-request recovery key for authenticated calls; see the tool description. |