Addons of a Service

80 vues Markdown

Handle every extra sold alongside a service from a single tab, so adding an option, correcting a price or issuing a renewal invoice never sends you through the client's whole order history.

Opening the Screen

Open a service from Orders › Services, then pick the Addons tab: {admin}/services/detail?id={service}&content=addons.

The tab is rendered for every service, domain services included, whether or not the product defines addons. A service with no extras shows an empty list and the Add New button.

What Is on the Screen

A heading line carries Service Addons with the sentence "Add-ons purchased with this service" underneath, and Add New on the right. The list below arrives with the page.

The Addon List

The panel-wide Service Addons list, narrowed to one service. Client and service are known here, so those columns and the bulk-selection box are not drawn, which is why this tab has no bulk action bar.

Column	What it shows	Sorting
Addon	Addon name, option name below it. A quantity above one is printed in front of the option as a badge.	No
End Date	The addon's own due date, or a dash when it has none.	Yes
Price	Total amount when one was calculated, otherwise the unit amount, with the cycle below.	Yes
Status	Active, Pending Approval, In Progress, Suspended or Cancelled.	Sorted first
(actions)	Row menu with View and, with the operation privilege, Delete.	No

Rows needing attention carry a faint tint: red for Pending Approval, blue for In Progress, amber for Suspended. Search and rows-per-page sit above the list, with a download icon once it holds an addon.

The Addon Details Window

View opens the Addon Details window, titled with the addon's record number, holding four cards and a Save Changes button that stays disabled until you change something.

Client & Service holds the client card, a link to the parent service, the status badge, the module's last status message and the Manage selector. Addon Information holds the linked addon product with a Change button, that row being hidden on domain services, plus the free-text names and, on domain addons, the registration period beside the addon name. Date Details holds the three dates. Billing Details holds the invoice buttons, payment method, pricing type, pricing line and subscription block.

Apply via API appears in the action panels only when the service is bound to a module, and Activate Addon leaves Manage once the addon is active.

The Add New Addon Window

Add New opens a window built from the addons the parent product offers. On a domain service it is built from DNS Management, Email Forwarding and Whois Privacy instead, listing only what the extension allows and the service does not carry yet; with nothing left it opens on "No add-ons available for this product." and no form.

Until an addon is picked only the selector shows and Add stays disabled. Choosing one reveals the option control, requirement fields, Invoice Options with its Paid or Unpaid choice, Price Override, Addon Status, the dates and a running total. Paid moves a pending addon to Active; when the addon follows the service's billing period the dates come from the service and are locked.

Fields

Controls of the Addon Details window. The option name, start date, suspension reason and notification switch sit beside them and are edited the same way.

Manage Optional, empty by default. A choice opens its own panel: Activate, Suspend, Cancel or Delete.

Apply via API Ticked by default, shown only with a module. Unticked, only the record here changes.

Select Addon Disabled until Change is pressed. A new choice rewrites the name, option and module parameters.

Select Option Filled from the chosen addon. A selection copies its cycle and price into the pricing line.

Addon Name Free text, prefilled. The name the client sees; it does not change the product behind it.

Renewed On Date of the last renewal. Disabled when the addon follows the service's billing period.

Next Due Date The date the next renewal invoice is written against; disabled under the same condition. Cleared, it is never renewed.

Payment Method Defaults to None. Stamped on the addon's own renewal invoices.

Pricing Type Linked Addon locks cycle, amount and currency and prices renewals from the catalogue; Custom Price uses the stored amount.

Pricing Cycle, unit amount, currency and quantity on one line. Quantity stays editable in both pricing types and never drops below one; the total is amount times quantity. The cycle is fixed on domain addons and on addons following the service period.

Subscription Optional agreement reference. A known one links the addon, emptying it unlinks; a linked agreement also shows its status and payments.

Tasks

Adding an Addon to the Service

Press Add New at the right of the heading line and pick the addon.
Set the option, quantity and requirement fields, decide on Generate Invoice with its Paid or Unpaid choice, and check Addon Status.
Press Add. The window closes and the list reloads. An addon created as active is also set up on the server, but only when the service carries a module and the chosen option defines parameters for that module; otherwise the row is a billing record and nothing leaves the panel.

Changing the Option, the Price or the Dates

Open the row menu and choose View.
For another product or option press Change, then use Select Addon and Select Option; for the price alone set Pricing Type to Custom Price.
Press Save Changes. The window closes, the list reloads, and every changed field is written to the service history.

Activating, Suspending or Cancelling

Open View and pick the action in Manage; a panel opens underneath.
For a suspension write the reason, and decide on Apply via API and Send Notification there.
Press Save Changes. The status badge changes, the row tint follows it, and a suspension keeps its reason atop the window.

Issuing a Renewal Invoice for the Addon

Open View and find the Invoice line in Billing Details; View all invoices shows what was billed so far.
Press Invoice this service on that line.
You land on the new invoice. When nothing could be written the reason replaces it: already invoiced, renewal switched off, an unusable period or missing client data.

Detaching the Addon from Its Subscription

Open View and find the subscription block at the bottom of Billing Details.
Press Cancel next to the status badge; it exists only while the agreement is active.
The window reloads by itself, the addon leaves the agreement, and the gateway line is dropped or repriced.

Deleting an Addon

Open the row menu and choose Delete; the Delete Addon Confirmation window opens with the addon's name on it.
Decide on Apply via API, offered only with a module, ticked by default.
Press Delete. The row leaves the list at once and the removal is written to the activity log. The same removal sits in Manage as well, and taken from there it also records a line in the service history.

Things to Watch

Deleting is not the same as cancelling

Cancel leaves the record with a cancelled status, so the history stays readable. Delete removes it and, with Apply via API ticked, the resource on the server too. Neither can be undone here.

On an active addon the module answers first

Changing the product, option or quantity of an active addon is sent to the module before anything is written. If the module refuses, the window reports its message and no edit is saved.

Required Privileges

Opening the tab and the details window needs SERVICES_LOOK. Adding, editing, changing status, issuing a renewal invoice, detaching a subscription and deleting need SERVICES_OPERATION; without it Delete is not printed in the row menu.

Cet article vous a-t-il été utile ?

Merci pour votre retour !

Besoin d'aide supplémentaire ?

Notre équipe d'assistance est disponible 24h/24 pour tout ce que vous ne trouvez pas ci-dessus.

Nous contacter Ouvrir un ticket