IssueInvoice 开具(approved→issued;换开票校验原票已 reversed;触发交付,1-4-3/4)
courier_company 纸质快递公司(纸质场景)
courier_no 纸质快递单号
file_format 版式格式:pdf | ofd
file_key 版式文件 key(电子票必填、纸质可选;前端 presigned PUT 后回填)
file_key_xml 数电票 XML 数据文件 key(选填,§十-3)
invoice_no 发票号码(必填)
OK
AdminInvoice 管理员视图发票(含内部审计字段与文件 key)。 AdminInvoice 管理端发票投影:暴露 fileKey/内部审计字段。
时间字段口径:本 message 全部时间字段(reviewed_at/issued_at/cancelled_at/ reversed_at/applied_at/created_at/updated_at/paid_at)均为 RFC3339 字符串、空值为空串, 刻意对齐 admin 域既有 sibling(topup_admin/currency_admin)的字符串风格; 而 console 侧 invoice.v1.Invoice 用 google.protobuf.Timestamp(对齐 payment)。 两端不一致是有意为之,前端 admin 按字符串解析、console 按 Timestamp 解析,勿盲目统一。