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

# 报表交付与邮件订阅

> Waffo 报表文件送达你的四种方式——Portal 下载、Waffo SFTP、你自己的 SFTP 或邮件——以及如何自助管理结算报表邮件订阅：计划、收件人、正文语言、发送历史，还有交付方式变更何时生效。

[结算报表与导出](/docs/zh/support/settlement-reports-faq) 解释了数字是如何产生的以及如何按需拉取报表。本页覆盖另一半：**报表文件如何周期性地送达你**，以及如何自助管理结算报表邮件订阅。文件布局和 SFTP 路径仍在 [对账报表](/docs/zh/developer-docs/tools-and-references/references/reconciliation-reports)。

## 我的报表文件可以送到哪里？

周期性报表文件支持四种交付目标。每个报表族**只有一个**处于生效状态，而无论你选哪种，Portal 下载始终可用：

| 交付目标 | 发生什么 | 适用场景 |
| - | - | - |
| **仅 Portal** | 不推送——文件生成后在 Portal 中等待 | 你手工对账 |
| **Waffo SFTP** | 放到 Waffo 为你签发的 SFTP 账户上，位于文档记载的路径下 | 你想要一个拉取源，且不想自建基础设施 |
| **你自己的 SFTP** | Waffo 主动连接你的 SFTP 主机并把文件写到那里 | 你的财务系统已经在监听一个 SFTP 端点 |
| **邮件** | 作为**邮件附件**发送给你配置的收件人 | 消费文件的是人，不是系统 |

目标是**按报表族**设置的——交易明细、结算、账单、发票和列表导出分别配置——所以结算文件可以通过 SFTP 拉取，而账单送到邮箱。把某个报表族指向邮件或你自己的 SFTP，会停止它向 Waffo SFTP 账户的推送。

这些目标通过支持安排，不在 Portal 页面上操作：**Waffo SFTP** 需要接收账户信息的邮箱，以及你连接时使用的公网 IP 或 IP 段；**你自己的 SFTP** 需要主机、端口、用户名、密码和基础目录；**邮件**需要收件人和 CC 地址。在两种 SFTP 目标上，文件都保留原始文件名，位于你的基础目录加相同的 `/{report family}/{date}/` 子路径下，所以一个脚本可以同时适用于两者。文件在 Waffo SFTP 账户上只保留有限时间——Portal 副本保留。

## 我改了交付目标，什么时候生效？

从**下一个导出周期**开始。已在进行中的任务按它启动时的配置完成，所以正在运行的周期仍会送达旧目的地——在你看到第一个文件落到新目的地之前，保持旧 SFTP 路径或邮箱可访问。

## 不找支持，我能让结算报表按计划发到邮箱吗？

可以——**Settlements → Settlement Reports → Email Subscription**。一个订阅就是一封周期性邮件：一组报表、一个日期基准、一个计划、收件人和正文语言。该标签页受权限控制——如果你在该页面上能看到它，说明该功能对你的账户可用。你可以在那里做的事：

| 操作 | 作用 |
| - | - |
| **订阅列表** | 你的订阅，分页显示，带状态和 Last Sent |
| **Add / Edit** | 创建订阅，或修改现有订阅的报表、计划、收件人或语言 |
| **Suspend / Resume / Delete** | 在 `ACTIVE` 和 `SUSPENDED` 之间切换订阅，或删除它 |
| **Send History** | 某个订阅的发送尝试记录 |
| **Preview** | 表单旁边的邮件正文实时渲染 |

## 哪些报表？按什么日期基准？

**Report Type** 是多选，至少选一个：*Transaction Settlement Detail*（默认）、*Daily Settlement Summary*、*Selected Period Summary*——与 Customized Export 提供的三种相同。**Time Dimension** 决定数据窗口按哪个日期切分：

| Time Dimension | 含义 |
| - | - |
| `PAYMENT_DATE`（默认） | 按交易支付日期切分。包含已完成但仍待结算交易的**预估**数据 |
| `SETTLEMENT_DATE` | 按实际结算日期切分，所以每一行都是已结算的数字 |

当收件人把该邮件当作最终账务时，选 `SETTLEMENT_DATE`。

## 怎么设置计划？用的是哪个时区？

| Schedule Type | Schedule Detail |
| - | - |
| `DAILY` | 仅小时 |
| `WEEKLY` | 星期几（周一至周日）+ 小时。默认：周一 09:00 |
| `MONTHLY` | 每月几号 1–31 + 小时，其中 **31 表示当月最后一天**——所以在二月也会触发 |

小时为整点，`00:00`–`23:00`，标注为 **(UTC+8)**——与结算中其他所有地方使用的日切一致。没有分钟级设置。

## 能有多少收件人？主题是什么？哪种语言？

| 字段 | 规则 |
| - | - |
| **Recipient (To)** | 正好**一个**地址。其他人用 CC |
| **CC** | 最多 **10** 个地址；粘贴时用逗号、空格或分号分隔 |
| **Email Subject** | 必填，最多 200 个字符。预填为 `WAFFO-Settlement Report-{your MID}-{your merchant name}` |

保存订阅前会校验每个地址。把邮件组放在 **To**，CC 留给个人。

**Email Body Language** 按订阅设置——English、中文或にほんご——与你使用 Portal 的语言无关，所以两个订阅可以分别用各自的语言服务一个区域团队和一个本地团队。表单旁边有正文的**实时预览**，会随你更改语言、时间维度、计划或主题而重新渲染。

## 订阅停了，或者某次发送失败了，我去哪里看？

订阅状态为 `ACTIVE` 或 `SUSPENDED`。**Suspend** 停止发送但保留配置，**Resume** 恢复，**Delete** 永久删除。**Last Sent** 列是发现悄悄停掉的订阅最快的方式。然后 **Send History** 列出每次尝试：

| 列 | 告诉你什么 |
| - | - |
| **Status** | 发送处理中为 `Pending`，之后为 `Success` 或 `Failed` |
| **Trigger Time** | 计划触发的时间 |
| **Data Window** | 报表实际覆盖的时间段起止 |
| **Recipient (To)** | 该次尝试使用的地址，按当时的配置 |
| **Result** | 成功时为发送时间戳，失败时为失败原因 |

失败的尝试带有自己的原因，最常见的是收件方拒收。通过编辑订阅来修复；下一次计划运行使用新值。每一行保留该次尝试时生效的收件人，所以旧行显示的是旧地址。

***

需要把某个报表族指向新的地方？[联系支持](mailto:support@waffo.com)，说明报表族和目的地。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.