平台回款对账
开始识别附件前,读取 references/execution-evidence.md,按证据、确认、核算、交接顺序执行;该规范不替代以下业务门禁。
本 Skill 可单独启用,只处理本次上传的业务材料,不安装、调用或要求先运行其他 Skill。文中的业务角色表示可选标准结果或核算角色;原始事实、确认口径与可追溯证据齐全时,由本 Skill 完成识别、确定性计算及验证。独立使用不免除材料与金额门禁。
任务目标
把本次对话上传的平台附件整理为可追溯的标准应收底表,并固定区分:
gross_sales:销售总额;platform_fees:来源费用先按签名求净额,再按支出方向正数披露;费用返还先冲减费用。净返还超出常规正数口径时记录NET_FEE_CREDIT/REVIEW,待确认披露方式,不得再取绝对值变成费用;refunds:退款的正数绝对额;net_revenue:净收入(销售额扣减退款后,未扣平台费)。
执行并验证:net_revenue = gross_sales - refunds
保留来源签名金额和费用明细。不得把平台费和退款合并为“其他扣减”。退款已在 net_revenue 中扣减,利润核算不得再次扣减退款;平台费不计入 net_revenue,而是作为独立字段 platform_fees 交给利润核算在利润链中单列扣减一次,费用核算不得再把平台费列为运营费用。
数据安全门禁
- 只可先查看附件 basename、格式和表头候选行,不得先读取、展示或统计任何样例业务值。
- 开始读取业务正文前,要求用户确认附件已经企业批准的方式脱敏,或明确说明附件是测试模拟数据。
- 提醒用户 Amazon 文件可能含订单号、SKU、商品描述和订单地区等可识别业务信息。
- 用户未确认时,不读取业务行、不计算金额,只返回脱敏提醒和
DATA_SECURITY_GATE = NOT_RUN。 - 用户确认后,只读取本次对话上传的附件;不要扫描本地目录、项目目录或历史会话。
- 不在输出中记录附件临时路径;来源只写 basename、Sheet 或 CSV 源行。
场景路由
- 展示附件角色表,列出 basename、Sheet/CSV、候选平台、期间、币种和数据角色。
- 按表头、字段语义、元信息和样例行判断交易明细、结算明细、退款明细、付款明细或参考汇总;文件名只作辅助。
- 多个附件角色无法唯一判断时,展示候选映射并询问用户,不自动选择第一个文件。
- Amazon Unified Transaction CSV 使用本 Skill 的新版规则;详细字段契约见 references/amazon_csv_schema.md。
- TikTok、沃尔玛、BOL 等平台继续按各自表头、Sheet 和方向契约处理;不要强制要求 Amazon 专属字段。
- 含
period、entity、platform、store、交易币种、报告币种、汇率、方向、生效期和确认状态等字段的附件识别为“口径/汇率候选证据”;revenue_context_202601.csv仅是建议 basename,仍按字段语义判断角色。 - 多平台混合前先确认币种、期间、时区和汇率来源;缺汇率不得默认使用 1。
- XLSX 目标单元格含公式时,同时读取公式表达式、可用的已计算值和当前引用输入;有计算值时按计算值核算并独立复算引用关系,不得把
=...公式文本当作金额。没有可用计算值且平台不能重算时记录FORMULA_VALUE_UNAVAILABLE并将受影响控制标记NOT_RUN;计算值与当前引用输入重算不一致时记录FORMULA_VALUE_STALE并标记FAIL。两种情况都保留附件 basename、Sheet 和单元格/源行定位,不得补 0 或把公式解析失败直接误报为业务差异。
正式核算前确认
向用户展示并确认:
- 实际采用的附件角色、Sheet/表头行和来源行范围;
- 平台、店铺、币种、时区、核算期间和期间口径;
- 汇率采用交易日、释放日、月均、期末、固定期间汇率或其他企业口径,以及该口径的来源、生效期和适用平台;
- 标准字段与来源字段映射;
- 金额的原始正负方向以及费用、退款的标准化方向;
- 口径/汇率候选附件中的实体、店铺、交易币种、报告币种、汇率、生效期、状态范围、收入确认依据和
confirmation_status; - Amazon 使用“posted 视图”还是“released 结算视图”;
- 重复行候选、未知交易类型和缺失的条件必需字段;
- 各平台、期间适用的退款率和扣费率阈值、比较方向、单位及来源;缺阈值仅披露比率,相应阈值检查
REVIEW/NOT_RUN,不得套用行业默认值。
确认前只输出预检查,不生成正式金额结果。
口径与汇率候选附件
- 候选附件只提供待确认口径,不因位于某个预置目录或文件名匹配而自动生效;先把每行与实际平台附件建立唯一映射并展示给用户。
- 最小字段为
period, entity, platform, store, transaction_currency, report_currency, rate_to_report, direction_contract, effective_start, effective_end, released_deferred_scope, recognition_basis, confirmation_status;可保留rate_source说明固定期间汇率或外部汇率来源。 confirmation_status=REVIEW表示必须在当前会话取得用户确认。除候选数值外,还必须询问用户本次采用交易日、释放日、月均、期末、固定期间汇率或其他企业汇率口径,并在报告中记录exchange_rate_basis、来源、生效期和适用范围。确认前可以验证源币逐行守恒,但折算、跨平台合并和利润核算交接均为NOT_RUN。- 按用户确认的汇率口径选择业务日期和有效汇率,再执行
report_amount = source_amount × rate_to_report;先在源币验证 Amazon 15 分项与total,不得用折算后的相等替代源币行级守恒。 - 只有
transaction_currency = report_currency且该恒等换算口径已确认时,rate_to_report=1才可使用;不得把缺失汇率补成 1。 - 附件或本次会话确认均可提供范围和汇率口径;逐项记录真实来源、值、方向、生效期及适用范围。既无有效附件证据也无完整会话确认时,各平台仅按可确认源币输出;受影响的跨币种总额和利润核算
TOTAL为 NOT_RUN。同币种且已确认恒等口径时无需虚构汇率附件。
统一状态
机器可读状态只允许 PASS、FAIL、NOT_RUN、REVIEW。页面可显示“通过(PASS)”等中文文案,CSV 中仍保留上述原始状态字符串。未执行不是通过:任一必做控制为 FAIL 或 NOT_RUN 时,受影响的正式结果不得标记 PASS;尚待人工口径决策时用 REVIEW。
Amazon 处理
本场景先读 references/amazon_csv_schema.md,按实际表头和元信息定位,不按固定行列读取。
- 核对 32 字段契约;逐行以 15 个签名分项对来源
total守恒,Deferred 和 Transfer 也保留来源检查。 - 先保留符号,再按已确认的 type/分项映射销售、退款、费用与排除项;未知类型或净费用返还未定口径时停止受影响分类。
- Released 按释放日期归期;Deferred 单列待释放池。posted 视图与 released 视图分开,状态/日期矛盾不得自动补值。
- 执行来源金额桥接、SKU/无 SKU 完整平台费桥接;不得重复扣退款或把费用计入净收入贡献。
- 完全重复、近似重复及跨期状态迁移分别列候选;未有证据前不自动删除、择一或把迁移当重复。
- 原件字段仅在本次运行内部使用,输出按白名单投影,不输出订单号、地址、邮编或原附件全行。
其他平台处理
- 对 TikTok 等“销售/退款/付款”多 Sheet 结算,先验证 Sheet 角色、关联键、数量×单价、佣金、退款和结算批次付款。
- 对沃尔玛、BOL 或其他平台,按语义映射销售、费用、退款、付款、店铺、SKU、期间和币种。
- 来源采用“费用为正数绝对额”时,展示方向契约并经用户确认后再转为标准字段;不得与 Amazon 签名金额直接混算。
- 平台汇总表或历史结果默认作为参考,不得与原始交易重复入账。
- BOL 等字段示例缺主链期间或汇率时,只完成字段识别,跨平台金额汇总标记
NOT_RUN。
异常与停机边界
- 脱敏未确认:全部业务处理
NOT_RUN。 - 必需字段缺失、字段冲突、金额解析失败或逐行 total 不守恒:该行
FAIL,正式 Amazon 汇总NOT_RUN。 - 条件必需字段缺失:保留可完成的来源检查,受影响的 SKU、批次、期间或税务输出
NOT_RUN。 - 未知类型、方向不清或重复候选未确认:进入异常池,受影响的正式分类和汇总
NOT_RUN。 - 多币种缺少已确认的汇率、生效期、实体或店铺映射:各源币可独立输出,折算、跨币种汇总和利润核算单一币种交接
NOT_RUN,不得默认汇率为 1。 - 数量或单价缺失:乘法校验
NOT_RUN;字段齐全但乘积不等于来源金额时FAIL。仅缺数量/单价不得自动否定已按来源完成对账的金额或阻断交接;交接仍按 TOTAL、四项公式、来源桥接和适用平台金额残差等金额门禁判断。 - 付款记录可位于同一结算附件中,须先按角色识别实际 Transfer/付款行,不能只找独立付款表。付款记录没有结算关联键:付款勾稽
NOT_RUN;有关联键但金额不相等时FAIL。 - 汇总表与明细表角色冲突:停止合并并询问用户,不重复入账。
折算汇率必须为有限正数且来源、方向、有效期唯一;零、负数或不可解析汇率属于无效证据,停止受影响折算,不阻断可独立完成的原币检查。
同一会话中用户已明确确认的口径,在展示实际映射并核实一致后直接沿用,不重复索要同一确认;仅对新歧义、冲突或范围变化补问。多个附件同名时分配会话内 attachment_id,来源保留 basename、Sheet 和行号;无法唯一匹配时停止,不以最新文件或附件顺序猜选。
运行能力分级
- 开始时记录平台是否具备附件读取、确定性计算、文件产物返回、代码执行和最终产物可读本地路径;不得把某项能力默认为存在。
- 逐行金额清洗、Amazon 15 分项求和、桥接、分类与汇总必须使用可重复的确定性工具,不得由 Agent 心算多行金额。优先使用平台原生表格、公式或分析能力;若平台提供代码执行,可使用仅限本次附件、运行期、通用且参数显式的轻量计算步骤。它与报告测试入口分属两层,不得扫描目录、依赖固定路径、写入 Skill/项目目录、猜字段、补 0 或硬编码特定结果。
- 平台无确定性计算能力时,仍完成附件角色、字段映射、口径确认、材料缺口和异常定位;所有受影响金额、比率、守恒和交接项记录
DETERMINISTIC_COMPUTE_UNAVAILABLE并标记NOT_RUN,不生成正式金额结果。 - 平台只能读取公式文本或只能读取缓存值时,
FORMULA_VALUE_STALE检测标记NOT_RUN,但不阻断不依赖该单元格的独立检查。
报告交付
生成报告时必须先读 references/report-contract.md,按其 HTML/CSV、安全、控制记录及验收规则交付。该规范随本 Skill 自带,不依赖其他 Skill。
- 当前会话唯一附件:
revenue_settlement_report.html;复用assets/report-shell.html,不手写另一套页面或导出器。 - 页内完整 CSV:
revenue_attachment_mapping.csv,revenue_receivable_detail.csv,revenue_platform_fee_bridge.csv,revenue_amazon_amount_bridge.csv,revenue_profit_standard_result.csv,revenue_deferred_pool.csv,revenue_source_lineage_bridge.csv,revenue_exception_pool.csv,revenue_validation_results.csv。 - 业务状态与技术验收分开;缺材料保留 FAIL/NOT_RUN/REVIEW,不因页面生成成功而改判。能力不足时采用规范中的沙箱兼容输出。
输出内容
以下内容在 HTML 中给出可读结论,并通过对应按钮导出完整 CSV:
- 数据安全门禁与附件角色表。
- 字段映射与口径确认表。
- 标准应收明细:期间、实体、币种、平台、店铺、SKU、四项金额、状态、审计状态和来源定位。
- Amazon 15 分项与
total守恒表、Released 明细和 Deferred 待释放池。 - Amazon 平台费桥接表:SKU 费用、无 SKU 费用、其他已确认费用调整、完整平台费和差异;每项保留来源类型与源行。
- 平台×店铺×SKU×月份汇总;posted 与 released 视图分开。存在无 SKU 费用时,SKU 表必须标明“非完整平台费视图”。
- 异常池:异常类型、来源行、原值、影响、处理状态和证据。
- 验证表按 report-contract 的九列输出:
control_code/control/status/evidence/left/right/diff/result_status/coverage_status;无数值比较时 left/right/diff 显式留空,结果和覆盖状态分别保留。
收入核算到利润核算标准交接
当来源无店铺字段时,marketplace 只表示站点,不是卖家店铺,不要求与店铺编码相等。可用本次上传的口径材料及明确的“该附件全部属于该店铺”确认补充范围元数据;确认须能唯一覆盖附件、平台、期间和币种,并保留来源与依据。多店铺、多个候选或范围未确认时不得推定归属。
revenue_profit_standard_result.csv 是利润核算可接收的唯一收入核算结果数据集,固定字段为:
record_type, handoff_key, period, entity, currency, gross_sales, platform_fees, refunds, net_revenue, audit_status, result_dataset, result_row, source_bridge_dataset, lineage_status, dimension_grain, dimension_key, privacy_status, released_deferred_scope, recognition_basis
- 每个
period + entity + currency必须且只能有一行record_type=TOTAL,handoff_key必须恰为规范化的period|entity|currency,不得追加TOTAL或任何维度。四项金额、范围、唯一键、汇率和来源桥接等影响金额的门禁通过后才可为PASS。退款率/扣费率风险提示分别保留REVIEW/NOT_RUN,不得因仅缺风险阈值就改写已验证金额,也不得因金额正确而把未运行筛查写为通过。 - 本次要求平台、店铺或商品拆解且来源归属足够时,从本次收入与完整平台费明细生成
DIMENSION;无 SKU 费用不能丢弃或伪造商品,需按已确认且可完整归属的粒度核对。分项用于平台、店铺、SKU 拆解,并保留其所属TOTAL完全相同的handoff_key;另以dimension_grain + dimension_key在该handoff_key下唯一定位,禁止把维度值拼入handoff_key。完整维度字段仍在revenue_receivable_detail.csv中;不得用维度行代替或重复累加TOTAL,利润核算默认只消费TOTAL。 result_dataset固定为revenue_profit_standard_result.csv;result_row是不含表头、从 1 开始的稳定数据行号。source_bridge_dataset固定为revenue_source_lineage_bridge.csv,最小字段为bridge_line_key, handoff_key, standard_amount_field, standard_amount, source_file, source_sheet, source_row, source_field, source_signed_amount, source_currency, rate_to_report, report_currency, rate_source_file, rate_source_sheet, rate_source_row, rate_source_field, effective_start, effective_end, direction_transform, mapping_basis, source_status, scope_inclusion, lineage_status;bridge_line_key在文件内唯一,CSV 来源的source_sheet固定写CSV。standard_amount_field只允许四项标准字段;source_signed_amount保留来源正负号,standard_amount是按该标准字段口径折算后的可求和金额,转换规则写入direction_transform。- 每条桥接行都必须披露源币、报告币、实际采用汇率及真实证据类型、生效期与适用范围;附件证据保留来源定位,会话证据用 SESSION_CONFIRMATION,已确认同币种用 IDENTITY_CONFIRMED,不虚构附件字段。
source_status记录 Released、Deferred、结算状态或等价来源状态;scope_inclusion明确INCLUDED或EXCLUDED_CONTROL。同币种恒等换算也必须引用已确认的口径证据,不得把缺失汇率静默补为 1。 - 来源桥接行一律使用所属
TOTAL的handoff_key。按handoff_key + standard_amount_field汇总standard_amount,必须分别等于该TOTAL的gross_sales、platform_fees、refunds、net_revenue;其中前三项按标准披露方向为正,net_revenue贡献按“销售为正、退款为负”生成(平台费不进入net_revenue贡献),并注明公式转换,不得把它作为 Amazon 分项的直接mapping_target。排除或勾稽证据仅以standard_amount=0且scope_inclusion=EXCLUDED_CONTROL出现。任一项不可反向求和、桥接键重复、汇率来源不完整或状态范围不明时lineage_status不得为PASS。 privacy_status只允许OUTPUT_WHITELIST_ONLY。白名单允许 basename、Sheet/CSV、来源行、来源字段名、平台、店铺、SKU、期间、实体、币种、标准金额、状态和必要的脱敏异常说明;不允许地址、邮编、订单号、绝对路径和原附件全行。released_deferred_scope必须明示本行为RELEASED_ONLY、POSTED_CONFIRMED或其他已确认口径;recognition_basis用中文记录确认的收入确认依据,不得把 Deferred 默认当作已结算。- 多平台存在不同交易币种时,只有全部纳入平台都已按有效且确认的
rate_to_report折算到同一report_currency,才可为该period + entity + report_currency生成一行TOTAL;不得同时把源币行和折算行累加到该TOTAL。 audit_status是本范围金额交接结论,不得复制报告总体状态。四项公式、完整范围、唯一键、四项来源桥接、适用平台金额残差和汇率均已实际通过时,交接为 PASS;REV-08 缺独立单价、外部银行验真缺凭据或仅风险筛查未运行,分别保留原检查状态,不改变上述已证实金额的交接结论。存在金额、范围或来源矛盾仍停止。生成时另记audit_basis,列出实际金额门禁依据与独立缺项。- 标准 DIMENSION 只能随通过本次适用金额与来源门禁的所属 TOTAL 发布;父 TOTAL 未通过时,可保留已计算的店铺明细,但不能在该完整范围下发布正式 PASS 的 DIMENSION。
TOTAL唯一性、四项公式、来源桥接和适用平台的金额残差任一为FAIL、NOT_RUN或REVIEW时,利润核算交接状态不得为PASS。
必做验证
- REV-01 行级守恒:来源业务行 = 已处理行 + 异常行;不得把 Deferred、Transfer 或未知类型记作丢失。
- REV-02 Amazon 逐行守恒:15 个签名金额分项之和 = 来源
total。 - REV-03 状态守恒:来源行 = Released 行 + Deferred 行 + 状态异常行。
- REV-04 收入核算金额守恒:
net_revenue = gross_sales - refunds;platform_fees单独披露、不进入net_revenue,由利润核算在利润链中单列扣减。 - REV-05 来源桥接:Amazon 非 Transfer 的来源
total与已分类经营项目、调整项目及未分类项目逐项对账;其他平台按本次已确认的独立来源结算总额与实际分类金额逐项核对。Amazon 专属子检查不适用时仍记 NOT_RUN,但不阻断其他平台已通过的适用交接;非 Amazon 的适用金额检查缺依据仍阻断。 - REV-06 平台费桥接:
完整 platform_fees = SKU 费用净额 + 无 SKU 费用净额 + 其他已确认费用调整。各部分先按签名求净额,按支出方向转换,费用返还贡献保留负号;不得对分组分别取绝对值再相加。整体净扣费才正数披露,净返还遵循前述确认边界;差异超过已确认币种最小单位容差时,该控制 FAIL 并记录INTERNAL_CROSSCHECK_FAILED,正式扣费率与platform_fees结论NOT_RUN,受影响的利润核算交接NOT_RUN。 - REV-07 SKU 完整性:无 SKU 的
Service Fee、FBA Inventory Fee、Amazon Fees、FBA Transaction fees等已确认费用必须进入完整平台费,但不得伪造 SKU;不得用 SKU 汇总代替完整平台费。 - 单价证据只接收本次该平台/商品/期间可唯一对应的原始价目或订单资料;不得用销售额÷数量倒算单价再验证同一销售额,也不得借用其他平台售价。缺价仍保留 NOT_RUN。
- REV-08 乘法校验:按本次实际平台/Sheet 子范围分别记录数量×单价与销售/退款金额检查;某平台缺数量或单价必须有独立
NOT_RUN记录,不能用另一平台的通过代替,不能仅写有字段平台的 PASS 后宣称覆盖完成。可重复使用本控制码并加scope列。此缺口只停止对应乘法校验,交接仍按适用金额和来源门禁判断。 - REV-09 结算内付款勾稽:同一批次可释放经营净额与原始付款记录核对;Amazon 的 Transfer 行和 TikTok 的 Payments 都可承担该角色。它们与经营明细可以在同一附件,不因缺一张独立付款表或银行流水而跳过。批次、方向及可释放范围仍须一致,缺关联时 NOT_RUN,已关联但差额不符为 FAIL。银行实际到账验真另列,不能由结算内勾稽冒充;本次未上传银行材料时该验真仍 NOT_RUN。
- REV-10 退款率=
refunds/gross_sales,扣费率=platform_fees/gross_sales;分母为 0 时NOT_RUN。逐平台、期间按已确认阈值比较,超限写入异常池并将阈值检查记REVIEW;未确认阈值记NOT_RUN。比率计算、阈值检查与金额守恒分别给状态;未确认阈值不伪装为通过,也不改写已执行的金额检查。 - REV-11 汇率验证:平台源币金额 × 已确认且在生效期内的汇率 = 报告币种金额;保留源币金额、汇率和报告币种金额三者。
- REV-12 多平台汇总等于各平台折算结果之和,且实体、报告币种、期间及确认口径一致;源币明细不与折算结果重复累加。
- REV-13 所有数字可追溯到附件 basename、Sheet/CSV 源行和来源字段。 最终导出必须实际包含四项金额桥接,尤其
net_revenue的销售正贡献与退款负贡献;按字段分别反向求和回 TOTAL,不能只验证总额公式后宣称桥接通过。缺整项桥接时先修正本次生成过程,无法补足则停止交接。
只有控制项已经实际运行、证据完整且差异在确认容差内时才标记 PASS。已运行但不满足规则标记 FAIL;因缺字段、缺口径、缺关联键或安全门禁未执行而无法运行时标记 NOT_RUN。
“应收”在本 Skill 中指平台结算核对,不等同应收账款余额或法定营业收入。未提供期初应收、完整应收增减及实际收款时,不生成应收账款余额。平台销售净额按销售减退款列示,结算净额按已确认分项及调整桥接,不凭名称另造金额。