电商利润核算 · ecommerce-profit-calculator

一键把"看不见的成本"算进利润：售价 − 商品成本 − 平台佣金 − 支付手续费 − 运费 − 包装 − 广告分摊 − 退款损失 − 税，得出真实净利润、利润率与保本点。

适用场景

• 上架新品前，算清楚"卖一单到底赚多少"
• 整店/多 SKU 复盘，找出表面走量实则亏损的品
• 评估投流（广告）是否划算、退款率吃掉多少利润
• 给定固定成本，反推"至少要卖多少件才不亏"

子命令

calc — 单品 / 批次净利润

python scripts/ecommerce_profit_calculator.py calc \
  --price 100 --quantity 100 --cost 40 \
  --commission-rate 0.05 --payment-rate 0.006 \
  --shipping 5 --packaging 2 --ad-total 300 \
  --refund-rate 0.03 --tax-rate 0.05 --fixed-costs 0

输出：实收货款、各项成本分解、毛利、税、净利润、利润率、单件净利、单位贡献、保本销量/额。
加 --json 输出机器可读结构。

成本模型（per 批次）
- 实收货款 = 售价 × 销量 × (1 − 退款率) （退款部分退回货款）
- 商品成本 = 单件成本 × 销量（已发货均发生）
- 平台佣金/支付 = 售价 × 销量 × (佣金率 + 支付费率)
- 运费/包装 = (运费 + 包装) × 销量
- 广告分摊 = 整批广告费（按销量摊到单件）
- 退款处理损失 = 售价 × 销量 × 退款率 × 处理系数（退回件贬值，0~1）
- 税 = 净利润 × 税率（仅利润为正时计）
- 净利润 = 实收货款 − 总成本 − 税

batch — 多 SKU 利润表（CSV）

python scripts/ecommerce_profit_calculator.py batch --csv skus.csv

CSV 表头：sku,price,quantity,cost,commission_rate,payment_rate,shipping,packaging,ad_total,refund_rate,refund_handling,tax_rate,fixed_costs
输出逐 SKU 利润行 + 合计 + 整体利润率 + 亏损品清单。加 --json 输出结构化。

breakeven — 保本测算

python scripts/ecommerce_profit_calculator.py breakeven \
  --fixed-costs 2000 --price 100 --cost 40 --ad-per-unit 3

单位贡献 = 售价×实收率 − 成本 − 佣付 − 履约 − 单件广告；保本量 = 固定成本 ÷ 单位贡献。

review — 利润体检

python scripts/ecommerce_profit_calculator.py review --price 100 --quantity 100 --cost 95 ...

检查项：净利润为负（风险，exit 1）、利润率负、佣金+支付>8%、退款率超警戒线、广告占货款比超 30%、未计税费。存在风险项时退出码为 1，可用于自动化把关。

templates — 平台成本项参考

python scripts/ecommerce_profit_calculator.py templates

输出主流平台（淘宝/天猫、京东、抖音/快手、拼多多、跨境）佣金与支付费率经验区间、通用成本项说明。仅为参考区间，非强制，请以实际合同为准。

参数约定

• 比率既可写小数（0.05）也可写百分数（5），>1 自动按百分数处理。
• 金额单位：元（CNY）。默认支付费率 0.6%（0.006）。

边界与声明

• 本工具仅作经营测算参考，不构成财务审计、税务申报或法律结论。
• 税费以"对净利润征收"简化建模，实际税负（增值税、个税、企业所得税）请以财税专业人士意见为准。
• 纯标准库实现，零第三方依赖，不联网。