GET `/admin/billing/tax-exports`

查询已生成的税务导出记录列表，支持按税务周期过滤

计费服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`period`	`query`	`string`	否				税务周期

响应

状态	描述	Schema
200	税务导出列表查询成功	`service-billing/internal/handler/dto.TaxExportListResponse`
400	请求参数错误	`object`
401	未授权	`object`
403	无权限	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.TaxExportListResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`items`	array of 参见 `service-billing/internal/handler/dto.TaxExportResponse`	否			统一使用 items
`message`	`string`	否
`pagination`	`object`	否			分页信息（嵌套对象）
`timestamp`	`string`	否
`total`	`integer`	否			总条数（平铺，便于直接读取）

service-billing/internal/handler/dto.TaxExportResponse

字段	类型	必填	示例	约束	描述
`download_url`	`string`	否	`https://storage.example.com/...`
`expires_at`	`string`	否	`2026-04-16T10:00:00Z`
`format`	`string`	否	`pdf`
`period`	`string`	否	`2026-Q1`
`tax_report_id`	`string`	否	`tax_2026q1`

service-core/base/dto.PageInfo

字段	类型	必填	示例	约束	描述
`has_next`	`boolean`	否			HasNext indicates whether there is a next page
`has_prev`	`boolean`	否			HasPrev indicates whether there is a previous page
`page`	`integer`	否			Page is the current page number (1-based)
`page_size`	`integer`	否			PageSize is the number of items per page
`total`	`integer`	否			Total is the total number of items across all pages
`total_pages`	`integer`	否			TotalPages is the total number of pages

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓