Skip to content

feat(sellfox_settlement): 账期业绩报表设计与只读核对 - #355

Open
keyapi wants to merge 5 commits into
mainfrom
claude/happy-wilson-146092
Open

keyapi wants to merge 5 commits into
mainfrom
claude/happy-wilson-146092

Conversation

@keyapi

@keyapi keyapi commented Nov 18, 2026

Copy link
Copy Markdown
Owner

Summary

  • 新增「账期业绩(渠道账号维度)」设计文档:以钉钉 OA 账期(04–03)应收/销售额为基准,扣通途写回四段成本(绍兴产品/头程/国外二次加工/尾程),Tax/附加费另列。
  • 新增只读核对脚本 sellfox_settlement/scripts/build_account_period_performance.py:读 OA 外币层/人民币层/原始、渠道账号主表、通途写回(含次月 1–3 日窗口)、账号 ws 对照;输出本地 xlsx/json,不写任何 Google Sheet。
  • 覆盖 202608/202609/202610:账号覆盖、单边账号、UNMATCHED、17 项恒等式与勾稽;202609 与并行 A/B 双算对齐到 0.03 元。

Key conclusions

  • 主成本用 写回,账号 ws 是旧快照(202609 少约 55.6 万),仅作对照;202608–202610 无 -特殊规则 副本,不含 1.7.0。
  • 四段成本用各自系数列,不拿 产品成本*系数*数量 一档切。
  • 收入并列两套基准(应收 / 剔预留)× 含税/不含税;Tax 含税未证实,不写死。
  • 附加费只单列,另给「扣附加费后」列;已验证不重复计入收款费用。
  • 期间错配如实并列:自然月成本 vs 04–03 窗口成本;FBA 无发货日期,窗口按整月计入并标记。
  • 尾程是 EN 预估、退货未冲 COGS、FBA 配送费未证实,均在表内显式标记。

Test plan

  • python -m py_compile sellfox_settlement/scripts/build_account_period_performance.py
  • --month 202608/202609/202610 均 17/17 校验通过
  • 202609 与仓库外 A/B 双算对照(应收 3,184,047.19 / 成本 2,092,622.79 / 业绩 1,091,424.41)
  • python scripts/check_secrets.py 零凭证
  • 未写线上 Google Sheet、未改 Colab 生产逻辑

Open questions (for 财务 ZJ / 用户)

  • Tax 是否含在 OA 销售额?主列默认扣不扣?
  • 附加费主列不扣、另列扣,是否同意?
  • 对账用应收、考核用剔预留,是否同意?
  • 202610 附加费为 0:无费用还是未录入?
  • 尾程何时接实际账单;退货 COGS 是否本期接受「不冲回」并标注。

🤖 Generated with Claude Code

keyapi and others added 5 commits November 18, 2026 17:13
以钉钉 OA 账期应收/销售额为基准,扣通途写回四段成本,输出渠道账号维度
业绩核对表;含两套收入基准、Tax/附加费双列、04-03 期间对齐、边界矩阵、
202608-202610 只读核对结论与 Colab 上线 diff。脚本默认只读,不写 GS。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
保留 UNMATCHED 成本行;窗口-only 账号不被 active-only 丢弃;补逐行/逐账号
恒等式校验;空 FBA 聚合不再崩溃;dry-run 不写 ID 缓存;429 配额退避。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
202609 双边 60 / 仅OA 17(窗口-only 账号计入订单侧后);校验 17/17。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
成本按整月、不做 04-03 二次过滤;默认不使用 1.7.0(即使存在 -特殊规则副本);
工作表统一命名 账号-按应收;补 202607 无规则口径重算(业绩 -636,505.58)。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
成本按整月、不做 04-03 二次过滤;--include-window 改为可选;
补 202607 无 1.7.0 重算(成本 3,086,081.27、业绩 -636,505.58);
尾程/退货按用户口径不再列为缺口;202610 本轮不纳入。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant