Skip to content

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-edit is false).
  • Route /subscriptions/:id/edit may exist in the registry for consistency, but no editable form is wired.

What to do instead

  1. Wrong draft before activation — Cancel the draft contract and create a corrected one.
  2. Need to stop billingPause or Cancel rather than editing amounts mid-flight.
  3. Wrong invoice after billing — Correct through the sales invoice / credit note path after the pending document is issued, not by mutating the contract.
  4. 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.

BlueMatrix Help — product documentation for tenants