更新于 2026-08-12 · 列名来自亚马逊 SP-API 官方文档。取值枚举官方并未公布,是从第三方文档和真实报告里收集的。有新的取值或发现错误,发我 support@nexusaistart.com,我加进来。
| 项 | 值 |
|---|---|
| 当前版本 | GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2(Seller Central 卖家) |
| 已弃用 | GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE、GET_V2_SETTLEMENT_REPORT_DATA_XML |
| 分隔符 | 制表符 |
| 怎么生成的 | 亚马逊自动排期生成,无法主动请求 |
| 去哪下载 | 卖家后台 → Payments → All Statements → Download Flat File V2 |
| 保留多久 | 大约最近 90 天(约六个结算周期) |
扩展名常见是 .txt 或 .csv,但里面是制表符分隔的。要按分隔符探测,别信扩展名。
settlement-id · settlement-start-date · settlement-end-date · deposit-date · total-amount · currency · transaction-type · order-id · merchant-order-id · adjustment-id · shipment-id · marketplace-name · amount-type · amount-description · amount · fulfillment-id · posted-date · posted-date-time · order-item-code · merchant-order-item-id · merchant-adjustment-item-id · sku · quantity-purchased · promotion-id
官方文档给了列名,但没给数据类型,也没说哪些可以为空。
| amount-type | 见到过的 amount-description |
|---|---|
ItemPrice | Principal · Shipping · GiftWrap · Goodwill · RestockingFee · Tax · ShippingTax |
ItemFees | Commission · FBAPerUnitFulfillmentFee · FBAWeightBasedFee · GiftwrapChargeback · ShippingChargeback · RefundCommission · VariableClosingFee · MarketplaceFacilitatorVAT-Principal · MarketplaceFacilitatorVAT-Shipping · DigitalServicesFee |
Shipment-Fees | FBAPerOrderFulfillmentFee · FBATransportationFee |
other-transaction | Current Reserve Amount · Previous Reserve Amount Balance · Storage Fee · Refund Reimbursal · StorageRenewalBilling · DisposalComplete · ShippingHB · Subscription Fee |
Promotion | (见过这个类型,具体描述各账号不同) |
大部分对账工具悄悄算错,根子都在这几个地方。直接摊开讲:
| 缺口 | 后果 |
|---|---|
transaction-type 没有官方枚举。网上流传的 Order / Refund / Transfer / Liquidations 找不到亚马逊出处。 | 硬编码这四个的工具,遇到没见过的值会静默丢行。这个工具不做归类,全部原样列出。 |
amount-type 和 amount-description 也没有官方枚举。 | 新费用代码随时会出现,硬编码的映射表会悄悄过期。 |
| 没有说明正负号规则。 | 费用是不是负数,只能靠推断。 |
| 没有说明文件编码。 | SKU 或商品名里有非 ASCII 字符时可能乱码。 |
| 没有说明汇总行结构。实测首行只有 settlement-id、日期、total-amount 和 currency。 | 当成数据行读进去,总额会被重复计一遍。 |
| 24 个列全都没给数据类型和可空性。 | 解析器只能靠猜。 |
amount-type = other-transaction 下面有 Current Reserve Amount 和 Previous Reserve Amount Balance。亚马逊压一部分钱,下期再放。只算「订单收入减费用」不算这块,总数永远等不上打款金额。这是最常被漏掉的一项。
posted-date 是单笔实际发生的时间,结算是按 settlement-start-date → settlement-end-date 切的。这两个不一定重合,跨月的时候基本都不重合。ERP 按发生日归集、亚马逊按周期结算,那是两套口径,不是数据出错。汇总按结算周期来。
同一个 order-id 会拆成多行——Principal 一行、Commission 一行、FBA 费一行。要归到 SKU,得按 order-id 加上 order-item-code。光按 order-id,一单买了两个不同东西就串成一个了。
quantity-purchased 在同属一个订单项的每一行上都会重写一遍。直接把这一列加起来,等于把数量乘以行数。要先按 order-id + order-item-code 去重。这个坑特别阴,因为它不报错,只是给你一个看起来很合理的错数——我自己写这个工具的时候就翻过一次车。
Flat File V2 只有一个 currency 列,没有汇率列。不同币种的结算不能相加,得按币种分开。
我做数据管道和对账工具,之前在跨境电商干过几年,再往前是工厂。当年拿 excel 硬啃这张表,啃到怀疑人生,所以后来干脆写了个东西专门拆它。
工具全部在浏览器里跑,是故意的——结算报告是你的财务数据,不该为了搞清楚一个数对不上,就先把它交给一个陌生人。
你要是碰到上面表里没有的费用代码,发我一份,我加进去,后面的人也能用上。如果你有好几个店、需要每个月自动归档合并(亚马逊只留 90 天,过了就没了),那是这件事的付费版本,可以找我:微信 nexusaistart(备注「结算工具」)
工具版本 v1.3 · 2026-08-12 · 联系:微信 nexusaistart(备注「结算工具」) · 邮箱 support@nexusaistart.com
下面那张费用代码对照表在持续补充。你手上这份是静态的,最新版在 nexusaistart.com/zh/tools/amazon-settlement-parser/