홈택스 원천세 전자파일 변환신고 진행현황 조회
hometax__tax__withholding__file_conversion__status먼저 호출할 도구: hometax__session__login (같은 account_link_id). 원천세 전자파일 변환 작업의 진행현황을 기관에서 다시 읽어 옵니다. view 로 summary(요약, 기본), format_errors(형식검증 오류 목록), format_error_detail(형식검증 오류 한 건의 상세, 오류가 여러 건이면 format_error_row_num 으로 고름), content_errors(내용검증 오류), warnings(경고)를 고릅니다. 조회만 하고 기관에 아무것도 바꾸지 않습니다. 형식검증과 내용검증이 끝났는지 이 단계로 확인한 뒤 다음 단계로 넘어가세요. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은 다른 칸이니 그대로 두세요. 호출마다 토큰 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__status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | 무엇을 조회할지 고르는 값입니다. summary(진행 요약, 기본값), format_errors(형식검증 오류 목록), format_error_detail(형식검증 오류 한 건의 상세), content_errors(내용검증 오류), warnings(내용검증 경고) 가운데 하나이며 입력하지 않으면 summary 입니다. 어느 종류도 기관에 저장하거나 제출하지 않고 읽기만 하며, 모르는 값은 입력 오류로 거절합니다. | summary |
| trns_fle_sn | No | view 가 format_error_detail 일 때 형식검증 오류 목록(format_errors)에서 한 행을 고르는 값입니다. 목록에 행이 하나뿐이면 입력하지 않아도 되고, 고른 값으로 한 행이 정해지지 않으면 409 로 거절합니다. 1자 이상 100자 이하이고 형식검증 오류 목록 행의 trnsFleSn 값입니다. | |
| source_job_id | Yes | 이어서 진행할 이전 단계 작업의 job_id 를 그대로 입력합니다(job_ 으로 시작하는 작업 번호). 이 신고의 변환 작업을 거친 이전 단계 결과를 받습니다. 같은 조직과 환경, 같은 기관 연결에서 성공한 원천세 파일변환 작업이어야 하고 아니면 진행하지 않고 거절합니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| orc_fle_rcvn_sn | No | view 가 format_error_detail 일 때 형식검증 오류 목록(format_errors)에서 한 행을 고르는 값입니다. 목록에 행이 하나뿐이면 입력하지 않아도 되고, 고른 값으로 한 행이 정해지지 않으면 409 로 거절합니다. 1자 이상 100자 이하이고 형식검증 오류 목록 행의 orcFleRcvnSn 값입니다. | |
| format_error_row_num | No | view 가 format_error_detail 일 때 형식검증 오류 목록(format_errors)에서 한 행을 고르는 값입니다. 목록에 행이 하나뿐이면 입력하지 않아도 되고, 고른 값으로 한 행이 정해지지 않으면 409 로 거절합니다. 1자 이상 50자 이하이고 형식검증 오류 목록 행의 rowNum 값입니다. | |
| expected_snapshot_hash | Yes | source_job_id 작업 결과의 snapshot_hash 를 그대로 입력합니다(소문자 16진수 64자리). 그 작업의 내용과 맞지 않으면 진행하지 않고 작성 내용이 바뀌었다는 오류(409)로 거절합니다. | |
| request_idempotency_key | No | 로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다. |