亚马逊ASIN利润报表生成器

要解决的问题

把亚马逊后台导出的几类原始数据拼成一份能直接用的 SKU 利润表，难点通常不在公式本身，而在对齐：交易报告里 ASIN 与 SKU 混在一起，退款和调整项散落在多行，仓储费、服务费、清仓损耗这类共享费用又没有天然归属。手工算很容易做到「这一次口径对、下一次又不一样」。这个技能要解决的就是同一套口径、一次跑出 50 列的报表生成问题。

核心能力

• 读取三类输入：Unified Transaction 月报、采购成本表（含 采购成本(USD)、头程运费(USD)、总成本（USD））、商品推广报告（按 广告SKU 对齐花费）。
• 从 amzn.gr.XXX- 前缀的字符串里提取真实 SKU，同时过滤掉 Transfer 行与广告费行。
• 按 SKU 聚合订单、退款、调整项；建立 SKU→成本 映射；按 广告SKU 聚合花费、销售与订单量。
• 将共享费用按净销售额占比分摊，再逐列计算全部 50 列（A–AX），最后按货币、百分比、整数等类型写入格式。
• 输出结果后，回显一张关键指标汇总表，例如 净销售额、毛利润(I)、毛利率(J)、平均毛利润(K)、广告占比(L)，附带合计行。

工作流程

1. 校验三份数据文件与模板是否齐全，确认表头字段符合预期。
2. 用内置脚本 scripts/generate_report.py 跑批，把实际文件路径传进去。
3. 脚本执行完毕后，把汇总表呈现给用户做一次口径核对。

适用边界

• 模板 sale_profit_asin_template.xlsx 是必需的，四份输入缺任意一份都要先补齐。
• 列名与文档不一致时，需要先改脚本里的字段引用再运行，脚本不会自动适配别名。
• 分摊口径固定为净销售额占比；如果业务上存在更细的分摊规则（按体积、按件数等），需要自行调整。
• 50 列的逐列定义与公式解释放在 references/template_mapping.md，需要时再加载。