订单发票日志须单独建order_invoices表,含invoice_no、invoice_type、amount、tax_amount、status等核心字段;写入时机为税控接口成功返回后,事务内完成;状态单向流转且禁删,通过审计日志和定时对账保障一致性。
发票不是可选附加项,而是财务合规的强约束数据。直接在订单主表加字段会破坏范式、拖慢查询,也难以支持多发票(如分批开票)、红冲、作废等场景。必须单独建 order_invoices 表,并通过外键关联 order_id。
核心字段至少包括:invoice_no(发票代码+号码拼接,唯一索引)、invoice_(如
type"VAT" / "PLAIN")、amount(开票金额,decimal(12,2))、status("issued" / "cancelled" / "red")、created_at 和 updated_at。别漏掉 tax_rate 和 tax_amount —— 有些地区要求日志里精确拆分税额。
不能在用户点击“申请开票”时就插入数据库。那只是请求,不是结果。真正落库时机必须是调用开票接口成功、拿到税控系统返回的 invoice_no 和签名后。
"invoice_requested",再调第三方开票 SDK,成功后再插入 order_invoices 并更新订单为 "invoice_issued"
"INVALID_TAX_ID" 或 "QUOTA_EXCEEDED",这些要原样记进日志表的 error_message 字段,而不是笼统抛 Exception
INSERT ... ON DUPLICATE KEY UPDATE 或先 SELECT FOR UPDATE 锁住订单行发票数据属于审计证据,PHP 层不能提供任何删除或修改入口。所有变更只能是追加或状态变更。
status 字段只允许单向流转:"draft" → "issued"、"issued" → "red"、"issued" → "cancelled",禁止回退order_invoices 表撤掉 DELETE 权限,只保留 INSERT 和有限 UPDATE
invoice_audit_logs,包含操作人 ID、IP、时间、旧状态、新状态$pdo->prepare("INSERT INTO order_invoices (order_id, invoice_no, invoice_type, amount, tax_amount, status, created_at) VALUES (?, ?, ?, ?, ?, 'issued', NOW())")->execute([$orderId, $invoiceNo, $type, $amount, $taxAmount]);
常见错误是 JOIN 订单表时用了 LEFT JOIN 却没意识到:一张订单可能还没开票,但业务方想看“所有订单 + 对应发票(如有)”。这时应该用 LEFT JOIN order_invoices,但 WHERE 条件里不能写 oi.status = 'issued' —— 这会把没开票的订单也过滤掉。
正确写法是把状态条件移到 ON 子句:
SELECT o.order_no, oi.invoice_no, oi.amount, oi.status
FROM orders o
LEFT JOIN order_invoices oi ON o.id = oi.order_id AND oi.status IN ('issued', 'red');
另外注意时区:PHP 写入用 date('Y-m-d H:i:s')(服务器时区),但财务系统可能要求 UTC 时间戳,日志字段类型建议统一用 DATETIME 并在应用层明确时区转换逻辑。