> ## 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.

# 结算报表模块

> 商户 Portal 中结算报表模块的工作方式：选择支付日期还是结算日期维度、导出类型及各自的日期跨度限制、适用哪个币种选择器、汇总表中 Order Amount 和 Fee Amount 如何定义、导出何时会拆成 zip，以及如何解读导出任务列表。

[结算报表与导出](/docs/zh/support/settlement-reports-faq) 解释了金额是如何计算的。
[结算文件规范](/docs/zh/support/settlement-file-specification-faq) 是交付文件逐列的字段约定。
**本页讲的是模块本身**——它在哪里、提供哪些选项、哪些限制会在导出开始之前就把它拦下。
同一批报表的定时邮件投递请参阅
[报表投递与邮件订阅](/docs/zh/support/report-delivery-and-subscription-faq)。

## 我在哪里生成结算报表？

**Settlement → Settlement Reports。** 一个页面承担了这项工作的两半：

| 页面上的内容 | 作用 |
| - | - |
| **Customized Export** 按钮 | 打开导出表单：维度、日期范围、导出类型、币种、语言 |
| 下方的列表 | 您发起过的每个导出任务，附状态和下载链接 |
| **Email Subscription** 页签 | 同一批报表的周期性邮件投递，需您的账户已启用 |

您不需要从某个结算批次开始。逐批次下载仍然存在于每个结算批次详情页上，交易列表也有自己的导出——
当您的对账周期与单个批次对不上时，就该用结算报表模块。

## 我应该按支付日期还是按结算日期导出？

这是表单上影响最大的一个选择，它决定了**哪些交易能出现**：

| 维度 | 范围 | 适用场景 |
| - | - | - |
| **Payment Date** | 按交易的支付日期——**包括尚未结算的交易** | 您在关账一个日历周期，需要该周期内发生的所有交易，无论是否已结算 |
| **Settlement Date** | 只有实际已结算的，按结算日期 | 您在对照结算账户收到的资金进行对账 |

选择 Payment Date 时表单会明确提示：*Includes estimated data for completed
transactions pending settlement.*

这就是经典月末问题的答案。在 T+N 的结算周期下，月末最后几天的交易在您 1 号关账时还没有结算。
按**结算日期**导出时它们合理地不会出现。按**支付日期**导出则会出现。

## 有哪些导出类型，各自的日期跨度限制是多少？

| 导出类型 | 粒度 | 最大跨度 |
| - | - | - |
| **Daily Settlement Summary** | 每个日期、每个交易币种一行 | **31 天** |
| **Transaction Settlement Detail** | 每个订单一行，已结算和待结算数据合在一起 | **3 个月** |
| **Selected Period Summary** | 所选整个范围的合计 | **12 个月** |

选择更长的范围会在您提交时被拒绝，任何任务都不会被创建——所以被拒绝的导出不是失败的导出，也没有什么可重试的。
缩短范围再提交即可。未来日期完全无法选择。

## 导出按哪个币种筛选？

取决于导出类型，字段上的标签会告诉您是哪一个：

| 导出类型 | 字段标签 | 含义 |
| - | - | - |
| Daily Settlement Summary | **Order Currency** | 按您的客户支付时使用的币种筛选 |
| Transaction Settlement Detail / Selected Period Summary | **Settlement Currency** | 按您被结算的币种筛选 |

两种情况下保留为 **All Currencies** 都是有效的。切换导出类型会清空您已选的内容，因为选项列表不一样。

## 报表表头是什么语言？

导出表单提供 **Report Language**——`English`、`中文`、`にほんご`——以各语言自身的文字显示，而不是翻译成您的界面语言。
它作用于您正在生成的报表，而不是 Portal，并且与您使用的界面语言无关。

| 导出类型 | 表头语言 |
| - | - |
| **Transaction Settlement Detail** | 您选择的 Report Language |
| **Selected Period Summary** | 您选择的 Report Language |
| **Daily Settlement Summary** | 英文——该类型不显示此选择器 |

列**值**——币种代码、状态值、标识符——在所有语言下都相同；只有表头行和分节标签会变。
如果您按表头名称解析文件，请在订阅或导出上固定语言，而不是去匹配翻译后的文字。

## Transaction Settlement Detail 报表里有什么？

每个交易事件一行，**已结算和尚未结算合在一起**，以 `Settlement
Status` 列（见下文）区分。两类行填充的列不同：

| 行类型 | 填充 | 留空 |
| - | - | - |
| `SETTLED` | `Settlement Batch Id`、`Settlement Date`、`Forex Rate`、`Fee Amount`、`Tax Amount`、`Settlement Amount` 及其 `(Settlement Currency)` 变体 | 所有 `Est …` 列 |
| `UNSETTLED` | `Est Settlement Date`、`Est Forex Rate`、`Est Order Amount (Settlement Currency)`、`Est Fee Amount`、`Est Tax Amount`、`Est Settlement Amount` 及其 `(Settlement Currency)` 变体 | 实际结算各列 |

标识符、订单、支付方式和时间戳列（`Order Id`、`Merchant Order Id`、
`Payment Request Id`、`Original Order Id`、`Order Amount`、`Order Currency`、`Transaction Type`、
`Event Type`、`Payment Method Type`、`Payment Method`、`Payment Option`、`Payment Request Datetime`、
`Payment Date`、`Payment Time`、`Product Name`）以及币种列（`Fee Currency`、
`Tax Currency`、`Settlement Currency`）是两类行共用的，在任何情况下都不带 `Est` 前缀；
`Comments` 列标记退款备用金结算行。所以一个文件同时回答了"我收到了多少钱"和"还欠我多少"，
两次导出之间一个 `Est` 数字变成实际数字，是结算在运行，不是数据变更。

## 汇总表中的 Order Amount 和 Fee Amount 是怎么定义的？

这两个定义引发的对账争议比其他任何东西都多，因为两者都不是毛额：

```
Order Amount = payment − refund − chargeback

Fee Amount   = payment fee (successful and failed transactions)
             + refund fee
             + chargeback fee
             + chargeback alert fee
```

值得直白说明的后果：

* **`Order Amount` 是净额。** 退款和拒付已经被扣除。把它与您自己的销售毛额比较，差额永远恰好等于您的退款和拒付。
* **`Fee Amount` 可能包含未成功交易的手续费**，如果您的合同对失败尝试计费。这些行带有手续费但没有订单金额，这是正确的，不是数据错误。
* 支付为正数；退款、拒付和拒付预警为负数。

## Daily Settlement Summary 有哪些列？

十列，顺序如下：

| # | 列 |
| - | - |
| 1 | `Payment Date` |
| 2 | `Currency` |
| 3 | `Order Amount` |
| 4 | `Fee Amount` |
| 5 | `Tax Amount` |
| 6 | `Order Amount (Settlement Currency)` |
| 7 | `Fee Amount (Settlement Currency)` |
| 8 | `Tax Amount (Settlement Currency)` |
| 9 | `Settlement Currency` |
| 10 | `Settlement Amount` |

每个原币种列都与其结算币种对应列成对出现，税费无论是哪种税都只有一列——没有单独的 VAT 或预扣税列。
只有结算币种列可以跨行相加——不同订单、手续费和税费币种的金额永远不会按原币种求和。

## 为什么日汇总里一个日期会有好几行？

因为只有当交易币种和手续费币种相同时，一天才是一行。当两者不同，或当天涉及多个手续费币种时，
这一天会拆成**每个手续费币种一行**。VAT 和预扣税的币种会折入手续费币种，而不会进一步拆行。

所以某天订单是一种币种但手续费按两种币种计费，就会为该日期产生两行，它们的结算币种列相加等于当天合计。

## 为什么我的导出回来是一个 zip？

两个独立原因，任何一个单独出现都足以触发：

| 触发条件 | 结果 |
| - | - |
| 结果跨**多个结算币种** | 每个结算币种一个文件，打包成 zip。汇总要求单一结算币种，所以它们不能共用一个文件 |
| 结果超过 **60,000 条数据行** | 拆成顺序编号的文件（`_001`、`_002`、……），打包成 zip |

单一币种且未超行数限制的结果会以单个文件下载，没有 zip，也没有序号后缀。

## 导出任务状态是什么意思？

| 状态 | 含义 |
| - | - |
| **Pending** | 任务在排队或文件仍在生成中 |
| **Success** | 已就绪——Report 列变为下载链接 |
| **Failed** | 生成未完成。请重新发起导出 |

导出在设计上就是异步的：您发起一个，离开页面，稍后再来取文件。列表显示导出日期、状态、导出类型和文件。
导出队列的一般行为，包括链接过期，请参阅
[导出与报表下载](/docs/zh/support/export-center-faq)。

## 导出文件里的 Settlement Status 列是什么意思？

它告诉您某笔交易在导出时点是否已结算，它有**四个**值——不是两个：

| 值 | 含义 |
| - | - |
| `SETTLED` | 该交易已结算。实际结算数字已填充 |
| `UNSETTLED` | 该交易尚未结算 |
| `UNDEFINED` | 该交易正在进行中——例如一笔仍在处理的退款——所以两个答案都还没有意义 |
| `NOT_APPLICABLE` | 不适用结算：订单已关闭、退款失败，或该记录是客户争议 |

把 `UNDEFINED` 或 `NOT_APPLICABLE` 理解为"未结算"会高估仍欠您的金额。
请明确按 `UNSETTLED` 筛选，而不是按"非 `SETTLED`"。

## 我还能看到 Settlement Estimation 菜单，我该用哪一个？

如果您的账户还有它，Settlement Estimation 单独显示结算前的预估，并有自己的 31 天导出。
在实践中它已被**结算报表按 Payment Date 维度导出**取代，后者在一个文件里返回已结算和尚未结算的交易，
您不必导出两次再合并。

您的账户能看到哪些菜单是按商户设置的。如果您更愿意使用统一的单一导出，请联系您的客户经理。

***

同一周期两次导出的数字对不上？
[联系支持团队](mailto:support@waffo.com)，提供两次导出的日期和您选择的维度——
Payment Date 与 Settlement Date 的差异能解释其中大多数情况。


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