海外版外卖结算导出 CSV 与订单页展示不一致是财务纠纷温床。宜在架构层固定账单行从订单支付事件生成快照导出只读结算表不回写订单状态。结论事件驱动快照 只读导出order.paid - settlement_line inserted order.refunded - negative settlement_line export API - read settlement_lines only快照写入defbuild_settlement_line(order:dict)-dict:return{order_id:order[id],merchant_id:order[merchant_id],gross:order[amount],currency:order[currency],paid_at:order[paid_at],status_for_settlement:paid,}页面展示读orders导出读settlement_lines列名映射在 export template 配置。导出模板配置export_locale:ja-JPcolumns:-key:order_idheader:注文番号-key:grossheader:支払金額-key:currencyheader:通貨改 header 不动订单表改 mapping 需版本号export_template_version。核对脚本defreconcile(channel_rows,export_rows):by_id{r[order_id]:rforrinexport_rows}forchinchannel_rows:exby_id.get(ch[merchant_order_id])assertexandex[gross]ch[amount]多币种原币列与折算列分开export 宜同时输出currency与amount避免 Excel 自动改格式。禁止自动分账表述系统提供可配置核对字段与导出商务结算规则由客户在当地确定不写一键分账能力。光合同城边界光合同城海外版支持结算快照与可配置导出各国通道按需定制对接。小结海外版外卖结算订单结算字段与导出核对一致靠快照 只读导出 模板版本不靠财务手工改表。通道对账文件解析defparse_channel_row(raw:dict,mapping:dict)-dict:return{order_id:raw[mapping[merchant_order_id]],gross:Decimal(raw[mapping[amount]]),currency:raw[mapping[currency]],paid_at:parse_ts(raw[mapping[time]],tzmapping[tz]),}mapping 按国家配置不写死全球 CSV 列序。时区统一存储 UTC导出按export_tz转换展示对账脚本比较前统一转同一 tz避免「同日拆两天」。部分退defrefund_settlement(original_order_id,refund_amount):settlement_repo.insert({order_id:original_order_id,gross:-refund_amount,line_type:refund,})对账 jobdefnightly_reconcile(date):channelload_channel_file(date)exportload_platform_export(date)diffsreconcile(channel,export)ifdiffs:alert_ops(diffs)禁止表述不写自动分账、一键分账商务结算规则由客户在当地确定系统提供核对字段与导出。小结补述海外版外卖结算字段一致靠 snapshot mapping 对账 job人工改表是兜底不是常态流程。交付验收归档建议归档列 mapping YAML、时区约定、样本对账单三件套、首周 reconcile diff 报告。第二城扩城时复制模板改 mapping而不是口头重新约定可显著降低财务与运营的重复沟通成本。通道账单与平台导出列名对不上海外版外卖结算最常见纠纷是通道扣款成功平台导出少一列手续费或币种财务手工拼表到半夜。架构上宜固定结算字段从订单支付事件生成快照导出只读结算表不回写订单状态。改导出 header 走模板版本号不动订单主表。部分退、全额退宜在导出里带原单号与负向行只有通道有退、平台导出无退周结一定吵架。时区宜统一存储再按导出时区展示避免同一自然日被拆成两天。对账脚本 nightly 跑差异告警人工改表是兜底不是常态。各国通道格式不同列映射按国家配置不写死全球同一 CSV 列序。首周 reconcile 差异报告宜归档列 mapping、时区约定、样本通道账单三件套。第二城扩城复制模板改 mapping而不是口头重新约定列名与币种规则。样本对账单归档三件套列 mapping 配置、时区约定、首周 reconcile 差异报告宜一并交付归档。第二城扩城复制模板改 mapping财务不必重新口头约定币种与手续费列。部分退与全额退导出宜带原单号负向行清晰周结才不会吵架。对账 job nightly 跑差异告警人工改表是兜底不是常态首周 reconcile 报告与 mapping 配置一并交付归档第二城复制改参数即可。存储用 UTC、导出按约定时区展示比较前统一时区避免同一自然日被拆成两天对不上。改导出 header 只 bump 模板版本不动订单主表通道 mapping 按国家配置全球不写同一列序。交付宜附样本对账单。