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

Issue a credit invoice against an existing invoice for negative amount adjustments such as refunds and discounts. Reference: GAAP/IFRS (Double-Entry Accounting Principles).

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
invoice_number	path	string	Yes				Original invoice number

Request Body

Schema: dto.CreditNoteRequest

Field	Type	Required	Example	Constraints	Description
amount	number	Yes	99
invoice_number	string	Yes	INV-2026-001
reason	string	Yes	Service cancellation

Responses

Status	Description	Schema
200	Credit invoice created successfully	dto.CreditNoteDetailResponse
400	Invalid request parameters	dto.SimpleResponse
401	Unauthorized	dto.SimpleResponse
403	No permission	dto.SimpleResponse
500	Internal server error	dto.SimpleResponse

Referenced Schemas

dto.CreditNoteDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.CreditNoteResponse	No
message	string	No
timestamp	string	No

dto.CreditNoteResponse

Field	Type	Required	Example	Constraints	Description
amount	number	No	99
applied_at	string	No	2026-04-15T12:00:00Z
credit_note_number	string	No	CN-2026-001
invoice_number	string	No	INV-2026-001
issued_at	string	No	2026-04-15T10:00:00Z
reason	string	No	Service cancellation
status	string	No	issued
tenant_id	string	No	tnt_abc123

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No