POST `/admin/billing/invoice/{invoice_number}/credit-note`

对已有发票开具红字冲销发票，用于退款、折扣等负向金额调整。参考：GAAP/IFRS (Double-Entry Accounting Principles)。

计费服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`invoice_number`	`path`	`string`	是				原发票编号

请求体

Schema： service-billing/internal/handler/dto.CreditNoteRequest

字段	类型	必填	示例	约束	描述
`amount`	`number`	是	`99`
`invoice_number`	`string`	是	`INV-2026-001`
`reason`	`string`	是	`服务取消`

响应

状态	描述	Schema
200	红字发票创建成功	`service-billing/internal/handler/dto.CreditNoteDetailResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未授权	`dto.SimpleResponse`
403	无权限	`dto.SimpleResponse`
500	服务器内部错误	`dto.SimpleResponse`

引用的 Schema

dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-billing/internal/handler/dto.CreditNoteDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-billing/internal/handler/dto.CreditNoteResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-billing/internal/handler/dto.CreditNoteResponse

字段	类型	必填	示例	约束	描述
`amount`	`number`	否	`99`
`applied_at`	`string`	否	`2026-04-15T12:00:00Z`
`credit_note_number`	`string`	否	`CN-2026-001`
`invoice_number`	`string`	否	`INV-2026-001`
`issued_at`	`string`	否	`2026-04-15T10:00:00Z`
`reason`	`string`	否	`服务取消`
`status`	`string`	否	`issued`
`tenant_id`	`string`	否	`tnt_abc123`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓