TikTok Shop结算对账

适用场景与前置条件

适用于TikTok Shop US商家或创作者从Seller Center导出结算、Affiliate Orders和payout/on-hold报表后，核对订单级佣金、退款、reserve和回款差异。前置条件：Python 3.10+、买家有权提供且已脱敏的CSV；不覆盖其他区域或其他平台。

输入与输出

输入：结算CSV、联盟订单CSV、付款/留置CSV。输出：tiktok_shop_settlement_reconciliation.json，含订单、statement、payment、佣金、refund、reserve和人工复核标记。

安装与执行

无第三方依赖。运行 python scripts/reconcile_settlement.py --settlement examples/settlement.csv --affiliate examples/affiliate.csv --payout examples/payout.csv --output examples/tiktok_shop_settlement_reconciliation.json。

错误恢复

金额、订单ID或payment字段缺失时保留REVIEW；不猜平台欠款、不修改账单、不提现、不联系达人；补齐脱敏导出后重跑。

权限与隐私边界

只处理买家有权使用的本地脱敏财务文件，不读取TikTok账号、Cookie、银行信息或税务资料，不连接Seller Center。

验收

样例应输出订单级结算行、佣金差异和reserve标记，并固定保留external_write_executed=false。