Editing subscription contracts
Goal
Know what you can change after a contract is created — and what you cannot.
Who it is for
Users with subscription_billing.manage (lifecycle) or subscription_billing.view (read-only detail).
Preconditions
- Contract already exists on the list.
Current product behavior
BlueMatrix does not offer an in-app edit form or contract update API for subscription headers/lines after create:
- The create dialog is create-only.
- Detail dialog / detail page are read-only (
can-editis false). - Route
/subscriptions/:id/editmay exist in the registry for consistency, but no editable form is wired.
What to do instead
- Wrong draft before activation — Cancel the draft contract and create a corrected one.
- Need to stop billing — Pause or Cancel rather than editing amounts mid-flight.
- Wrong invoice after billing — Correct through the sales invoice / credit note path after the pending document is issued, not by mutating the contract.
- Policy defaults — Change tenant defaults under Subscription billing setup (
subscription_billing.admin); that does not rewrite existing contracts.
Result
You avoid expecting silent header edits; lifecycle and commerce documents own corrections.