利润统计

01 功能介绍：先核对月事实，再解释利润

进入「财务分析 → Finance → 利润统计」，查看已保存的 ERP 利润月事实。这里用于按月份、国家、店铺和商品核对收入、费用、商品成本及毛利润；打开页面或点击刷新只读取已有数据，不会重新向领星同步。

默认打开 MSKU 列表，可切换 ASIN 树形列表。数据来自利润同步或固定模板导入，属于可更新的事实数据，不是采购预算，也不是锁定后不可变化的历史财务结账结果。当前页面没有单行新增、编辑、删除或结账操作。

与利润报表对账时，先统一月份、店铺身份、商品粒度、币种与字段口径；不要把本页的原始月事实、跨月汇总和经营分析结果直接当作同一张表。

02 查询前：确认月份、店铺与数据身份

1. 确认账号有利润统计读取权限。无权限时页面提示“当前账号没有配置读取权限”，此时不是数据为空，应由管理员核对权限。
2. 先检查月份范围。未指定月份时默认取事实表中最新可用月份，并不保证就是本月。当前只支持「按月」，「按周」「按天」不可用。
3. 展开日期范围，依次点选开始月和结束月，第二次点选即应用范围；选择单月时点选同一月份两次。同一个月读取月事实，多个月则返回跨月汇总；因此条数、比例和商品资料代表值可能变化。
4. 准备店铺 SID、MSKU、ASIN 与月份等定位信息。一个有效月事实由同一租户内的“月份＋店铺 SID＋MSKU＋ASIN”共同识别；同名 MSKU 在不同店铺不是同一条记录。

本页没有独立的“业务视图”选择器。实际经营范围由当前租户及国家、店铺和商品条件决定，不能把其他经营报表的视图选择自动套用到这里。

03 查询定位：国家、店铺、月份与商品

1. 选择「全部国家」「全部店铺」中的实际选项。两者支持多选，应用选择后重新查询；国家范围变化会移除已选店铺中明确不属于该国家范围的项目。候选范围随月份变化。
2. 使用商品搜索左侧字段选择器。MSKU 页可搜索 MSKU、ASIN、标题、型号、品名、SKU；ASIN 页增加父 ASIN 搜索，但不提供 MSKU 搜索字段。输入后按当前字段查询，不是同时匹配所有字段。
3. 核对筛选标签，再查看底部分页。修改条件会回到第 1 页；可调整每页条数或翻页。无匹配结果时先缩小搜索内容、清除标签，再核对月份和店铺。
4. 点击「重置」清除国家、店铺和商品搜索；它保留月份范围，不是恢复全部默认参数。需要换月请直接操作日期控件。
5. 点击刷新图标重新读取列表及相关状态。刷新不发起外部同步，也不保证上游资料刚刚更新。

「Listing标签」「原币种」「更多筛选」「常用筛选」等灰色控件尚未接入，不能依靠它们完成过滤或换汇。页面上出现某个筛选名称，不等于已有查询能力。

04 原始数据：MSKU 与 ASIN 树分别怎么读

MSKU 单月列表：一行对应一条有效月事实。跨月时，按 SID、MSKU、ASIN、父 ASIN 聚合；若父 ASIN 在期间改变，可能形成不同汇总行。不能只按 MSKU 名称自行合并或删除“重复”行。

ASIN 单月列表：父行按 ASIN、父 ASIN、交易状态及状态码分组，展开后查看组成该行的 MSKU 事实。相同 ASIN 因交易状态不同出现多行有其分组依据；它不是“一个 ASIN 永远一行”，也不是 ASIN＋区域分析。

ASIN 跨月列表：父行按 ASIN＋父 ASIN 聚合，子行按 SID＋MSKU＋ASIN＋父 ASIN 聚合；状态不一致可显示“多状态”。底部总条数按父行计数，展开的子行不应再次加入父行总额。

1. 选择「ASIN」页签，展开目标 ASIN，先检查店铺和商品身份，再核对父子数量及金额。
2. 拖动表头边界调整列宽，横向滚动查看后续费用列。打开列设置图标，在「列配置」选择显示字段后应用；必需身份列不能隐藏，MSKU 与 ASIN 的显示配置分别保留在当前浏览器。
3. 字段未显示时先检查列配置及当前范围是否有值。部分指标列会根据数据是否有非零值决定显示，隐藏不等于指标不存在或业务未发生。

页签中其他不可用维度以及「显示占比」「隐藏合计0」「全部交易状态」等禁用项，不应写入操作步骤。工具栏“未结账”是固定显示提示，不能作为所有行都未结账、系统已完成结账校验的证据；应核对行内真实交易状态。

05 金额、费用与比例：不要跨口径相加

• 收入与费用：按表头区分销售额、退款、广告、平台费用、商品成本、税费及毛利润。本页主要展示来源字段，不根据屏幕可见几列重新推导一套会计利润。总项与其拆分项不可重复相加。
• 币种：标准同步向上游请求人民币 CNY，但模板可以携带其他币种；读取和分组没有按币种拆分或自动换汇。灰色“原币种”控件不能证明所有行同币种。跨店铺或历史导入存在混币时，先缩小到已确认同币种的记录，再依据导出中的 currency_code 对账。
• 空、零、负：单条明细的空值显示“-”，真实零显示 0，负费用、退款或负利润保留负号。负数不能直接视为错误，也不要把空白补成零掩盖来源缺失。聚合时部分加总字段会把空值按零参与，因此汇总为零不能证明每条来源完整。
• 显示精度：表格数字最多显示两位小数；毛利率、退款率、成本占比、ROI 等以比例值乘 100 显示百分比。模板数值规范化到四位小数，显示舍入后的小计相加可能与底层合计有微小差异。
• 单月与跨月比率：单月 MSKU 展示来源比率；单月 ASIN 父行对比率取非空平均，不是加权毛利率。跨月汇总则对指定比率重新计算，不能用单月百分比相加或简单平均替代。

跨月毛利率按汇总毛利润除以汇总销售额、运费收入、促销折扣、库存赔偿、补偿款、礼品包装收入、其他收入及销售退款的合计；退款等保留来源正负号，分母为零时返回 0。跨月退款率以退款量除以销量加补发量。采购单价等指定成本单价按汇总成本与成本数量重算，其他代表资料取较新记录。上述规则只用于对应聚合，不应倒推所有单月来源字段。

自定义费用有按字段及费用名称匹配的展示规则。导出保存模板原字段，屏幕上的拆分费用列未必在导出中逐列同名出现；应核对原始费用明细，避免把代表值、均值和加总值混在一起。

06 分析模式：先确认是否有可达入口

当前版本默认进入原始列表；没有从该列表切换到独立“分析模式”的可操作入口。“分析”列中的图标也不是下钻按钮。MSKU/ASIN 页签切换仍属于原始数据阅读，不能据此认为已经进入“利润 ABC 验数视图”。

独立分析的实现使用最近 36 个自然月（含当前月）的月事实，通过店铺 SID＋MSKU 映射商品与区域，再按 ASIN＋区域或 SID＋MSKU 归集毛利润；未映射或冲突的事实另计质量信息，不应与原始列表直接比较总条数。其近 3 月毛利率由对应月份的金额汇总计算，不取月毛利率平均，也不是三个最近有数据月份。

这些口径用于解释与分析结果对账时的差异，不表示当前页面能进入该模式。当前不能从本页操作该模式；若需要该视图，请先确认产品入口是否已开放。不要通过点击无交互图标反复尝试，也不要将其他利润报表当作这份验数结果。

07 模板导入：先核对覆盖范围，再提交

1. 前提是同时具备读取和写入权限。点击「导入表格」，打开「导入 ERP 利润模板」，准备约定的 .xlsx 文件；文件首个工作表的表头名称和列顺序必须完全一致。
2. 本导入抽屉没有“下载模板”按钮，也没有字段映射或预检预览步骤。使用已确认版本的固定模板，不要自行删列、改中文表头，或将跨月汇总导出直接当成单月导入文件。
3. 至少逐行检查 report_month、sid、msku、asin；月份使用 YYYY-MM。核对币种、数量、金额和 gross_rate 等比例原值，例如 0.25 表示 25%，不要填带百分号的文本。数量字段要求整数，金额字段要求可解析数字。
4. 选择文件后点击「开始导入」。服务先校验所有行，再批量写入；表头或任一行格式不合格会拒绝，不是跳过坏行继续导入。修复报错所指字段及同类行后重新提交。
5. 成功后核对页面“导入完成：共…行，成功…行，失败…行”回执，再按月份、SID、MSKU、ASIN 抽查结果。当前成功路径返回失败 0、错误列表为空；不要把界面支持显示错误摘要理解成已有逐错误行下载或部分成功流程。

导入是按主键覆盖，不是只追加。同一租户内相同月份＋SID＋MSKU＋ASIN 更新已有行；新键新增。导入列中的空白可覆盖旧值，并非仅补非空字段。同一文件重复键按输入顺序写入，后面的记录覆盖前面的记录；成功行数不代表新增了同样数量的唯一记录。

导入接口将整次请求包在同一事务中，服务端校验或写入异常会回滚，不提供保留成功行的部分提交模式。若只是网络中断、回执丢失，客户端仍可能不知道提交结果；保留文件与错误信息，先查询目标键核对再重传。导入成功会刷新原始列表，但不承诺所有独立分析、冻结结果或经营报表立刻更新。

08 同步治理：区分请求受理、提取与事实写入

1. 点击「同步治理」，先看同步状态、jobId、lastUpdate、apiSeenAt，以及存在时的 Extractor Run。lastUpdate 是任务记录更新时间；apiSeenAt 是浏览器获取响应的时间，不是利润发生日期。
2. 有发起同步权限且来源已启用时点击「手动同步」。显示“同步任务已创建”只代表请求受理，不是数据同步完成。已有排队、提取或写入任务时不能再并发创建；遇到冲突或超时先查看运行中任务，避免反复点击。
3. 状态依次可能出现「排队中」「提取中」「写入中」，最后「已完成」或「失败」。页面约每 5 秒查询活动任务，任务转为已完成后刷新原始数据；还需核对月份、记录和金额。
4. 失败时保留 jobId、runId、错误信息、阶段、队列原因和心跳时间。底层提取显示“部分成功”并不等于利润月事实已成功更新；本页没有单独的部分重试按钮，不要把反复点击手动同步当作自动补齐失败分片。

手动同步不使用当前列表的国家、店铺、商品和月份筛选。没有历史事实时按近 36 个月处理；已有事实时，以事实最新月份为锚向前取近 3 个月。最新事实较旧时，不应以为点一次就一定补到本月，应核对任务目标月份和来源。

同步不是纯追加：同键且来源内容变化会更新，目标月份内本次来源不再出现的记录会被移出当前有效列表。模板导入记录也可能被后续来源同步覆盖或移出；维护前应确认谁负责该范围，保留导出证据。

09 自动同步配置：保存配置不等于完成同步

1. 前提是具有同步配置管理权限。进入「同步治理」，核对固定来源 profit_report_sku 的「同步优先级」「执行时间」「时区」。默认优先级 100、时间 01:00、时区 Asia/Shanghai，以实际已保存配置为准。
2. 优先级填写 1 至 10000 的整数，时间使用合法 HH:mm，时区填写有效时区名称。点击「保存配置」，看到“同步配置已更新”后重新打开核对。
3. 配置对应每日调度，但实际运行还依赖调度服务和来源启用状态。当前抽屉没有启用/停用开关，也不提供按周、按月的频率选择；不能把保存时间写成已经执行任务。
4. 保存失败检查权限、格式及服务错误；任务未按期运行时，记录配置与时区并联系管理员核对调度状态，不自行连续发起同步代替排查。

10 导出与对账：按原始筛选导出，不按屏幕截取

1. 先选择月份、国家、店铺及商品条件，核对币种后点击「导出表格」。导出使用读取权限，不要求导入权限。
2. 导出包含符合原始查询条件的完整结果，不限当前页，也不按已隐藏列或列宽裁剪。ASIN 页导出的仍是原始明细或跨月 MSKU 聚合，不是屏幕上的父子树结构。
3. 文件使用固定利润模板列。单月按事实行导出；跨月按 SID＋MSKU＋ASIN＋父 ASIN 汇总，report_month 可能是范围文字，因此不能原样重新导入。
4. 按月份范围、SID、MSKU、ASIN、currency_code 对齐，再比较销量、销售额、退款、成本与毛利润。当前导出没有绑定冻结版本；导出前后发生同步或导入，结果可能变化。
5. 下载失败先检查权限、筛选范围与请求错误，重试读取即可；不要为了修复下载失败而先执行同步或导入。

独立分析组件即使另行开放，顶层导出处理也仍使用原始列表查询，不会自动携带分析维度及其筛选，不能称为“当前分析全量导出”。与采购预算及利润报表比较时，还要对齐事实、预测、历史结果的责任边界；它们不是相互替代的数据版本。

11 权限与状态边界

• 读取：查看月事实、ASIN 树、筛选选项、同步配置/任务以及导出，需要 erp_profit:read。
• 导入：同时需要读取与 erp_profit:write；只有读取权限时「导入表格」禁用。
• 发起同步：同时需要读取与 erp_profit:sync；管理配置权限不能自动替代发起权限。
• 配置管理：同时需要读取与 erp_profit:sync_manage；只读人员可查看同步治理，但不能保存配置。

前端按钮限制之外，后端也校验相应权限。灰色控件还可能代表加载中、正在提交或功能未接入，不能一概解释为缺权限。当前页面无单行编辑、删除、人工结账、利润审批或历史冻结按钮。

同步治理读取的是活动任务，不是完整历史任务列表。显示“空闲”不证明从未运行；底层任务心跳告警也不是确认永久失败，应结合最后更新时间和错误详情判断。

12 常见异常：先定位范围，再定位来源

• 列表空白：先看错误提示、读取权限和月份，再清除国家/店铺/搜索。月事实、筛选项、配置和任务独立请求，部分请求失败可能只影响其中一块，不能把所有空区域当作零业务量。
• 相同 MSKU 或 ASIN 出现多行：核对 SID、月份、父 ASIN 和交易状态分组，不按名称去重。ASIN 父子层级也不能同时计入总额。
• 毛利率与自己计算不同：先区分单月来源值、单月 ASIN 比率平均和跨月指定公式，再核对退款符号、币种及显示精度。
• 字段不见或显示“-”：检查列配置、范围内非零数据及来源值；汇总的零值不能证明单条记录完整。不要用批量填零掩盖缺失。
• 导入后又变化：核对同键覆盖和后续同步时间，检查源数据责任方；保留文件和导出，不通过反复导入与同步互相覆盖。
• 同步已受理但数据未更新：检查提取/写入是否结束、目标月份是否覆盖所需月份、是否部分失败，再刷新读取。不要把请求成功或最近心跳当成数据写入成功。

无法解释的差异，请保留月份范围、SID、MSKU、ASIN、币种、字段名、文件回执或任务标识，按数据异常自查交接。

13 常见问题