표준재무제표증명 신청
hometax__certificate__apply__financial_statementDestructive
REQUIRES prior hometax__session__login call with same account_link_id. 표준재무제표증명(Certificate of Standard Financial Statements) 신청을 기관에 접수합니다. 되돌릴 수 없습니다. 접수하면 기관에 접수 기록(cvaId, rcatNo)이 남으며 취소 기능이 없습니다. 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 1회용 confirmation_token 을 돌려줍니다(오류 WRITE_CONFIRMATION_REQUIRED). 그 미리보기를 사용자에게 그대로 보여 줍니다. 사용자가 동의한 뒤에만 같은 인자에 그 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": {
"bsno": "<bsno>",
"qrtTrt": "<qrtTrt>"
},
"name": "hometax__certificate__apply__financial_statement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bsno | Yes | 대상 사업자등록번호(숫자 10자리) (서식이 요구하는 값) | |
| txyr | No | 과세년도(개인, YYYY) (구분에 따라 서식이 요구하는 값) | |
| qrtTrt | Yes | 개인/법인 구분 코드(02 개인, 03 법인) (서식이 요구하는 값) | |
| adrOpYn | No | 주소 표시 여부(Y/N) (서식의 선택 입력) | |
| amtOpYn | No | 금액 표시 여부(Y/N, 그 항목이 있는 서식에서만 반영) (서식의 선택 입력) | |
| incClCd | No | 소득구분(개인) (구분에 따라 서식이 요구하는 값) | |
| bsyrEndYm | No | 사업연도 종료연월(법인, YYYYMM) (구분에 따라 서식이 요구하는 값) | |
| resnoOpYn | No | 주민등록번호 표시 여부(Y/N, 법인은 N 고정) (서식의 선택 입력) | |
| cerpIsnRqsQty | No | 발급 매수 (서식의 선택 입력) | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| cvaDcumGranMthdCd | No | 교부방법 코드 (서식의 선택 입력) | |
| confirmation_token | No | 첫 호출이 돌려준 1회용 확인 토큰입니다(오류 WRITE_CONFIRMATION_REQUIRED). 같은 인자에 이 값을 그대로 넣어 다시 호출하면 실행됩니다. 10분 뒤 만료되고 한 번만 쓸 수 있습니다. | |
| cvaDcumSbmsOrgnClCd | No | 제출처 구분코드 (서식의 선택 입력) |