현금영수증 매입 내역 조회
hometax__cash_receipt__purchase__search_history먼저 호출할 도구: hometax__session__login (같은 account_link_id). 현금영수증 매입 내역을 조회합니다. from_date/to_date 는 필수입니다 (YYYYMMDD 또는 YYYY-MM-DD). 기관은 3개월보다 긴 기간을 '조회기간은 최대 3개월 까지 가능합니다.' 로 거절하므로, 더 긴 기간은 3개월씩 나눠 호출합니다. 건수: totalCount(pageInfoVO.totalCount 도 같은 값)는 이 조회의 전체 건수이며 이 응답의 행 수보다 적지 않습니다. collectionMeta 는 이 응답이 이미 전부를 담았는지(complete)와 몇 건이 왔는지(collectedCount)를 알려 줍니다. complete 가 false 면 다음 쪽을 요청합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의 job_id 로 xdata__job__result 를 다시 불러 새 링크를 받습니다. 로그인 없이 받은 결과는 함께 온 recovery_receipt 를 따로 보관했다가, 처음의 job_id 나 pack_run_id 와 함께 xdata__job__result 에 보내세요. 증표로는 그 결과 하나만, 원래 파일 보관 기간이 끝날 때까지 열 수 있습니다. 증표는 공개하지 마세요. 잃어버리면 가입해도 되찾을 수 없습니다. 나중에 로그인해도 증표는 그대로 쓰이고, 다른 결과는 열지 못합니다. 증표가 없으면 처음 계정과 같은 환경(데모 · 정식)에서만 결과를 읽을 수 있습니다. 로그인한 호출이면 첫 요청 전에 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": {
"from_date": "<from_date>",
"to_date": "<to_date>"
},
"name": "hometax__cash_receipt__purchase__search_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to_date | Yes | 조회 종료일 YYYYMMDD 또는 YYYY-MM-DD (예: 20260131). 필수입니다. | |
| page_num | No | 쪽 번호. 기본 1. | |
| from_date | Yes | 조회 시작일 YYYYMMDD 또는 YYYY-MM-DD (예: 20260101). 필수입니다. | |
| max_pages | No | fetch_all_pages 가 true 일 때만 씁니다. 전체 수집에서 읽을 최대 쪽 수입니다(기본 100). 이 쪽 수를 다 읽고도 남은 행이 있으면 부분 결과 없이 입력 오류(VALIDATION_INVALID_FIELD)로 끝나니 조회 기간을 나누거나 값을 올려 다시 요청하세요. | |
| page_size | No | 한 쪽에 받을 건수. 기본 10. | |
| spjb_trs_yn | No | 현금매출명세서 발행 여부. 'all'=전체, 'Y'=발행분만. 기본 'all'. | |
| output_formats | No | 선택 입력입니다. 결과를 엑셀(xlsx) 파일로도 받으려면 입력해 주세요. 파일은 결과의 artifacts[] 에 실립니다. 비워 두면 데이터만 받습니다. | |
| account_link_id | No | 연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다. | |
| fetch_all_pages | No | true 면 한 쪽이 아니라 모든 쪽을 모읍니다(기본 false). 쪽마다 기관 요청이 따로 나가 더 느립니다. | |
| mrnt_txpr_dscm_no | No | 가맹점 사업자번호로 거릅니다(하이픈을 넣어도 됩니다). 입력하지 않아도 됩니다. | |
| request_idempotency_key | No | 로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다. |