Skip to main content
结算报表与导出解释了金额如何计算以及如何按需拉取报表。 报表投递与邮件订阅说明文件如何按计划送达你。 本页是字段级的契约:每一列是什么意思、带几位小数、什么情况下为空是正常的,以及每个文件如何命名。

我会收到哪些报表文件,每份分别什么时候生成?

三份文件均为 CSV,UTF-8 编码。两份结算报表以结算批次为键;交易报表以交易日为键,与你的结算周期无关。 这一区分带来两种行为,也是大多数「我的文件不见了」工单的原因:
  • 没有交易的日子仍会生成 Transaction Details 文件——只含表头行。
  • 没有净结算的结算日不会生成任何结算文件,因为不存在结算批次。如果你需要在每个计划日期都收到占位文件,那是按商户的配置——见 结算报表与导出。

文件名具体是什么?

  • transaction date 和 settlement date 为 UTC+8 的 YYYYMMDD;PDF 日期为 YYYYMMDD。
  • settlement currency 出现在结算文件名中,正是因为批次按结算币种打包。如果同一个结算日有两种结算币种,你会收到两套文件,通过最后这一段区分。
  • 需要重新生成的文件不会被覆盖:它会以新的版本后缀再写一份(..._v1.0_1.csv 之后是 ..._v2.0_1.csv),所以你已经取走的下载内容永远不会在你不知情时改变。

文件投递到哪里,会保留多久?

文件可在商户 Portal 获取;如果你使用 SFTP 投递,则位于文档中说明的交易和结算目录下——具体路径见 对账报表。 **对账报表在 SFTP 服务器上仅保留有限时间。它们在商户 Portal 上始终可以下载。**如果你的拉取任务离线了一段时间,请从 Portal 而不是 SFTP 补齐缺口。 SFTP 访问支持两种登录方式:用户名加密码或密钥认证。推荐使用密钥认证。

Transaction Details 各字段是什么意思?

Payment Date 和 Payment Time 有意拆成两列:日期列决定一笔交易属于哪个交易日——从而属于哪次结算——因此可以直接作为分组键使用,无需解析时间戳。

Settlement Details 各字段是什么意思?

行粒度与 Transaction Details 相同,另加每笔交易的结算结果。 无论是哪种税,税费都以单一的 Tax Amount 列报告;没有单独的 VAT 或预提税列——见费用与税费处理。

Settlement Summary 各字段是什么意思?

针对单一结算币种,每种交易类型一行,另加一行 TOTAL。 **汇总表中没有 Order Amount 列。**每一个金额列都已经以结算币种表示,这正是各行可以相加的原因——不同订单币种、费用币种和税费币种的金额从不以原币种求和。

币种只有两位小数,为什么我的文件显示六位?

因为结算精度是按商户的配置。你的账户被设为 2 位或 6 位小数之一,配置后固定不变。在 6 位小数的账户上,结算币种金额以六位小数书写并补零到该宽度, 所以整数会显示为 99.000000。以原订单币种计的 Order Amount 保留该币种自身的小数位,不补零。 固定宽度,数值较短时一律补零: 在 6 位小数的账户上,正是这一点让明细行与批次精确对上:明细 Settlement Amount 之和等于批次金额,没有尾差。

Forex Currency Pair 什么时候有值,是哪个货币对?

费用和税费可能以既非订单币种也非结算币种的币种计费,所以货币对按优先级解析——第一个匹配的条件生效: 没有订单金额的行——被计费的失败尝试,或拒付预警——只判定费用币种;已胜诉的拒付只判定订单币种。 所以即使你的订单币种已经等于结算币种,一行也可能带有货币对:该行的换汇步骤是针对费用或税费,而不是订单。Forex Rate 恰在货币对为空时为空。

我收到一份批次号全是零的结算文件,这是什么?

那是占位文件,只有当你的账户被配置为在每个计划结算日都生成文件(而不是只在发生结算时生成)时才会产生:
它只包含表头行,别无其他。全零批次号是有意为之——不存在结算批次,所以没有真实 id 可填,并且商户 Portal 中不会出现结算批次记录。 请把它当作区分「没有可结算的内容」与「文件没有送达」的投递心跳,而不是一次结算事件。

我能一次下载整个月的结算明细吗?

能,从结算批次列表下载。选择一段实际结算日期范围,把这些批次一起下载: min settlement date 和 max settlement date 是你所选范围内最早和最晚的结算日期,YYYYMMDD UTC+8。请求异步执行——到 Reports 模块领取结果,见 导出与报表下载。 如果你想按不同维度切分——按支付日期、按订单币种,或按日汇总而不是逐笔——请改用自定义导出;其选项列在 结算报表与导出。

PDF 文件遵循什么格式约定?

结算账单、提现账单和发票共用同一套布局和约定,所以同一个值在三者中含义相同: 页面顺序同样固定:开具方 Waffo 实体的名称和地址,然后是单据信息块(日期和编号),然后是你的公司名称和地址,最后是业务明细表。

结算账单里有什么,汇率是怎么算的?

列为 Country/Region、Transaction Amount、Fee Amount、Tax Amount、Avg. Forex Rate 和 Settlement Amount,合计列在表格下方。Tax Amount 的格式与其他金额一致,即 {Tax Currency} {Tax Amount}。 Avg. Forex Rate 是加权平均,不是简单平均。每个分项汇率按其自身的结算金额加权:
保留 8 位小数。用原始金额合计除以结算金额合计会得到略有不同的数字,这就是按那种方式重算无法复现账单的原因。

发票里有什么,为什么有好几个附件?

发票覆盖费用,按费用币种分组: 账单和发票邮件由 Waffo 财务邮箱发出;如有疑问请回复支持,而不是回复发件人。 **IOF 不在发票上。**当某笔交易适用 IOF 时,Waffo 无法为其开具发票,因此它被排除在发票文件之外。它仍会出现在结算计算中。
对某个具体文件做对账时仍然对不上? 联系支持并提供文件名——其中的结算批次 id 和结算币种足以定位该次结算。