> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 报告（发卡对账报告）

> 商户后台发卡「报告」页，生成并下载发卡对账报告：按报告类型/状态筛选历史报告、下载已完成报告；用「生成报告」弹窗按类型、交易类型、卡号/币种、日期范围、文件格式生成新报告。

## 这是什么

这是商户后台**发卡**模块下的「**报告**」页面（页面标题「报告」，副标题「生成并下载发卡对账报告」）。商户在这里生成发卡相关的对账报告并下载：页面上半部是历史报告列表（可按类型、状态筛选），右上「**生成报告**」按钮打开弹窗按条件生成新报告，报告生成完成后回列表下载。想导出卡交易/账户交易/结算/台账对账数据、下载对账单时用这里。

> 进入：从发卡「总览」页的「Reports」快捷入口进入本页。（主导航侧栏的「报告」是跨业务线的全局报告入口，与本发卡专属报告页不同。）

## 操作步骤

查看与筛选历史报告：

1. 进入发卡「**报告**」页，列表展示已生成的报告。
2. 用「**报告类型**」下拉筛选：所有类型 / 卡片交易 / 账户交易 / 卡片结算 / 卡片台账。
3. 用「**状态**」下拉筛选：所有状态 / 处理中 / 已完成 / 失败 / 已过期。
4. 生效的筛选显示在「**筛选条件**」区，点标签「×」移除单项，或「**全部清除**」清空。

下载报告：

1. 找到目标报告行，状态为「**已完成**」且有下载地址时，「**操作**」列显示「**下载**」按钮，点击即下载。
2. 状态非已完成时，操作列按状态显示不可点的占位（已过期 / 失败 / 处理中 / 不可用）。

生成新报告（「导出交易对账报告」弹窗）：

1. 点右上「**生成报告**」。
2. 选「**报告类型**」：卡片交易报告 / 账户交易报告 / 卡片结算报告 / 卡片台账报告。
3. 选「**交易类型**」（结算报告除外，可多选，支持「全部」）。
4. 视报告类型补充条件：
   * 卡片交易 / 卡片结算 / 卡片台账报告：选「**卡号**」（可多选，支持「全部」）。
   * 账户交易报告：选「**币种**」（USD / SGD / HKD，可多选）。
5. 选「**日期范围**」（默认最近 30 天）。
6. 选「**文件格式**」：CSV / Excel / PDF。
7. 填「**文件名**」（选类型时会自动带默认名，可改；最长 80 字符）。
8. 点「**创建**」提交，生成成功后弹窗关闭并刷新列表；点「**取消**」放弃。

## 字段与状态含义

**列表列：**

| 列    | 含义（商户视角）     |
| ---- | ------------ |
| 参考   | 报告的参考编号      |
| 创建时间 | 报告生成时间       |
| 过期时间 | 报告/下载链接的过期时间 |
| 报告类型 | 该报告的类型，见下    |
| 状态   | 报告生成状态，见下    |
| 操作   | 下载按钮或状态占位    |

**报告类型：**

| 类型   | 说明                   |
| ---- | -------------------- |
| 所有类型 | 列表筛选用，表示不限类型（生成时不适用） |
| 卡片交易 | 卡片交易报告               |
| 账户交易 | 账户交易报告               |
| 卡片结算 | 卡片结算报告               |
| 卡片台账 | 卡片台账报告               |

**报告状态：**

| 状态   | 含义           | 操作列表现          |
| ---- | ------------ | -------------- |
| 处理中  | 报告生成中        | 显示不可点的「处理中」    |
| 已完成  | 报告已生成        | 有下载地址时显示可点「下载」 |
| 失败   | 生成失败         | 显示不可点的「失败」     |
| 已过期  | 报告/链接已过期     | 显示不可点的「已过期」    |
| 所有状态 | 列表筛选用，表示不限状态 | —              |

> 「下载」仅在状态为「已完成」且存在下载地址时可点；否则按状态显示占位，其余情况显示「不可用」。

**生成弹窗字段：** 报告类型、交易类型、卡号、币种、日期范围、文件格式（CSV/Excel/PDF）、文件名。账户交易报告的可选币种为 USD / SGD / HKD。

## 边界与常见处理

* **列表「未找到报告」**：还没有生成过报告（或筛选无匹配）。无筛选时提示「生成后报告将显示在此处」；有筛选时提示「请尝试调整您的筛选条件」。
* **「下载」按钮点不了 / 显示灰色**：报告未处于「已完成」或没有下载地址。处理中需等待生成完成；已过期需重新生成；失败需重新生成。
* **点下载提示「下载 URL 不可用」**：该报告没有可用下载地址，重新生成一份。
* **生成时报「交易类型为必填项」**：除结算报告外都需先选交易类型再创建。
* **生成时报「卡号为必填项」**：卡片交易/结算/台账报告在有可选卡号时必须选卡号（含「全部」），避免导出范围失控。
* **生成时报「币种为必填项」**：账户交易报告必须至少选一个币种。
* **生成时报「文件名为必填项 / 文件名不能超过 80 个字符」**：文件名必填且不超过 80 字符。
* **报告过一段时间下不了**：报告有「过期时间」，过期后链接失效，需重新生成。

## 常见问法（Q→A）

* **Q：怎么导出发卡对账数据 / 下载报表？** A：发卡「报告」页点「生成报告」，按类型、交易类型、卡号/币种、日期、格式生成，完成后在列表点「下载」。
* **Q：能生成哪几种报告？** A：卡片交易、账户交易、卡片结算、卡片台账四类。
* **Q：报告支持什么文件格式？** A：CSV、Excel、PDF。
* **Q：报告状态有哪些？** A：处理中、已完成、失败、已过期；只有已完成且有下载地址的才能下载。
* **Q：为什么下载按钮点不了？** A：报告还在处理中、已过期、失败，或没有可用下载地址；处理中等待完成，其他情况重新生成。
* **Q：账户交易报告要选币种吗？** A：要，账户交易报告必须至少选一个币种（USD/SGD/HKD）。
* **Q：卡片交易/结算/台账报告一定要选卡号吗？** A：在有可选卡号时必须选（可选「全部」），否则会提示卡号为必填。
* **Q：报告能一直下载吗？** A：不能，报告有「过期时间」，过期后需重新生成。
* **Q：文件名有什么限制？** A：必填，最长 80 个字符；选报告类型时会自动带一个默认名，可改。
* **Q：「报告」和侧栏那个「报告」是同一个吗？** A：侧栏「报告」是跨业务线的全局报告入口；本页是发卡专属报告页，实际入口以线上为准。