Adyen报告文件名里的唯一标识和日期格式怎么读

下载Adyen payment accounting report后,文件名本身就是一份可读的元数据。按官方命名约定,文件名结构为:

YYYY_MM_DD、八位标识、文件名
本文涉及的概念与核对环节。
payments_accounting_report_filtered_<REPORT_START_DATE>_<REPORT_END_DATE>_<UNIQUE_IDENTIFIER>

默认扩展名是 .csv。其中日期格式固定为 YYYY_MM_DD,唯一标识是一个八位字母数字字符串(eight-character alphanumeric string)。把这两点记住,你就能在打开文件之前先判断报告覆盖的起止日期,并区分不同批次生成的文件。

拆解文件名:从哪一段读到什么

以这个示意文件名为例(仅演示格式,日期取值不代表对账区间规则):

payments_accounting_report_filtered_2025_03_01_2025_03_31_a1b2c3d4.csv

按约定逐段核对:

  • payments_accounting_report_filtered 是报告类型前缀,表明这是经过筛选的 payment accounting report;
  • 紧接着第一段日期 2025_03_01 是报告起始日期(REPORTSTARTDATE);
  • 第二段日期 2025_03_31 是报告结束日期(REPORTENDDATE);
  • 最后一段 a1b2c3d4 是八位唯一标识;
  • .csv 是默认扩展名。

判断日期时不要按“月/日/年”的习惯去猜:格式是年在前、月居中、日在后,段内用下划线连接。看到 2025_03_01,应读作2025年3月1日,而不是1月3日。定位日期段时,以“前缀之后、唯一标识之前”的两段 YYYY_MM_DD 为准;两段日期之间同样以下划线相连,不要把它误认为日期段内部的分隔。

唯一标识是什么、不是什么

官方说明,这个八位字母数字字符串是根据报告中选择的日期范围、时区以及事件(原文用词为 events)生成的。它承担的是区分作用:同一命名结构下,不同参数组合生成的报告会得到不同的标识,因此你不必只靠日期段来分辨两个文件名相似的文件。

需要明确的是,它不是一个可以自行解码出时区或事件内容的编码。材料只说明它“基于”这些选择生成,并没有给出从字符反推具体时区或事件的规则。因此核对时把它当作批次区分符即可,不要试图从八位字符里读出业务含义。至于字符如何组合,材料未作说明,也不应外推。

一个可复算的核对动作

拿到任何一份报告文件后,按以下步骤操作,不需要打开文件内容:

  1. 去掉扩展名,确认前缀是 payments_accounting_report_filtered;
  2. 取前缀之后的两段日期,按 YYYY_MM_DD 分别读成起始日和结束日,检查起始日不晚于结束日;
  3. 取最后一段,数一数字符数是否为八位、是否只含字母和数字;
  4. 若同一批下载中有多个文件,用唯一标识区分,而不是只比较日期段。

如果第3步字符数不对,先检查是否把扩展名或其他后缀误算进去,再确认文件名是否被下载工具或操作系统改写。这一步只做格式核对,不涉及报告内容是否正确,也不代表报表状态等同于客户到账、风控判定或发卡行承诺。

适用边界:只对这类报告成立

上述命名规则对应的是 payment accounting report 的文件名约定。材料同时提到,Interactive payment accounting report 的文件名格式在2025年2月发生了变化,且新生成的报告不再覆盖之前的报告。这说明不同报告类型可能有各自的命名安排,不能把本文的日期格式和八位标识规则直接套用到其他报告上,处理时应按你所使用的报告类型单独确认。

另外,报告支持的生成文件类型包括 CSV、XLS_GEN 或 TSV,默认扩展名是 .csv。扩展名不同不影响前缀、日期段和唯一标识的读法,但核对文件名时要把扩展名与前面三段分开处理,避免把扩展名误当作标识的一部分。

把文件名当作第一道核对关口,先确认范围与批次,再进入内容处理,能减少拿错报告或覆盖错文件的风险。

原始资料

docs.adyen.com

上一篇 Adyen付款会计报告对账发票为何要选CET时区和月初到月初