일일 현금영수증 취소
hometax__cash_receipt__daily_issue__cancel먼저 호출할 도구: hometax__session__login (같은 account_link_id). 오늘 발급한 현금영수증을 취소합니다. aprv_no 와 cshpt_cncl_rsn_cd 만 있으면 됩니다. 나머지 칸은 보내지 않으면 오늘 발급한 원본의 값으로 전송합니다(aprv_no 는 hometax__cash_receipt__daily_issue__search 에서 얻습니다). 이 도구는 기관의 기록을 바꿉니다. 첫 호출은 실행되지 않고, 전송할 내용의 미리보기와 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": {
"aprv_no": "<aprv_no>",
"cshpt_cncl_rsn_cd": "<cshpt_cncl_rsn_cd>"
},
"name": "hometax__cash_receipt__daily_issue__cancel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | 봉사료. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| trs_dt | No | 거래일자 YYYYMMDD. 기본은 원본 영수증의 날짜입니다(오늘 발급한 영수증만 취소할 수 있습니다). | |
| aprv_no | Yes | 승인번호. | |
| spl_cft | No | 공급가액. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| rcpr_tin | No | 수취자 납세자 번호(TIN). 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| trs_time | No | 거래 시각 HHMMSS. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| va_txamt | No | 부가세. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| tota_trs_amt | No | 총 거래금액. 원 단위 숫자를 문자열로 입력하며 1 이상이어야 합니다. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| cshpt_usg_cl_cd | No | 용도구분코드. 0=소득공제용, 1=지출증빙용. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| spst_cnfr_cl_cd | No | 발급수단구분코드. 01=주민등록번호, 02=사업자등록번호, 03=휴대전화번호, 04=카드번호. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| cshpt_cncl_rsn_cd | Yes | 취소사유코드. 1=거래취소, 2=오류발급, 3=기타. | |
| cshpt_trs_type_cd | No | 거래유형코드. 01=과세, 02=면세, 03=간이. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. | |
| confirmation_token | No | 첫 호출이 돌려준 1회용 확인 토큰입니다(오류 WRITE_CONFIRMATION_REQUIRED). 같은 인자에 이 값을 그대로 넣어 다시 호출하면 실행됩니다. 10분 뒤 만료되고 한 번만 쓸 수 있습니다. | |
| spst_cnfr_no_enc_cntn | No | 발급수단번호. 발급수단구분코드에 맞는 번호를 숫자만 입력합니다. 입력한 값 그대로 기관에 보내므로 암호화하거나 해시하지 않고, 승인번호를 여기에 입력하지 않습니다. 입력하지 않으면 오늘 발급한 원본의 값을 씁니다. |