Skip to content
D
Documentation

Cancellation reasons

reference
6 min readUpdated

A cancellation reason is a sales configuration value assigned when sales work is cancelled. Maintain these values in Cancellation Reasons.

Overview

Use this page to review, add, edit, delete, filter, or reorder cancellation reasons.

If you need to…Go to
Prepare to maintain the listBefore you start
Open the listFind the cancellation-reason list
Identify the field and popupUnderstand the list and form
Choose a maintenance actionMaintain cancellation reasons
Add a reasonAdd a cancellation reason
Edit a reasonEdit a cancellation reason
Delete a reasonDelete a cancellation reason
Find or reorder a reasonSearch, filter, and use list tools
Check why a surface is absentHandle access and surface variations
Respond to a messageWhen an action does not work
Cancellation reasons list with the Name column and five rows

Before you start

The cancellation-reason list requires a signed-in session. Have the reason name ready before you add or change an entry, and confirm that your subscription and permissions provide the action you need.

TaskWhat you need first
Open the listA signed-in session
Add a reasonThe required subscription, visible New, and the reason name
Edit a reasonEdit permission and an existing row
Delete a reasonDelete permission and an existing row
Complete the formA value for required Name

Note: This list is filtered for cancelled sales work.

Find the cancellation-reason list

Prerequisites

  • You are signed in.

Steps

  1. Open Sales.
  2. Select Cancellation Reasons.
  3. Confirm that the list contains five rows when the same list composition is in use.
Cancellation reasons list with New, Refresh, Settings, and the Name column

Result: The Cancellation Reasons list is open.

Understand the list and form

The list contains available cancellation reasons, and the form edits the selected reason's Name.

Selecting a row opens its existing entry when editing is available.

SurfaceWhat you see
ListThe visible column is Name.
FormA required Name text box.
PopupNew Cancellation Reason with OK.

Filtering is enabled for Name. The form shows Name when the popup is open, an item is selected, and the field is available. Other record details are not shown as list columns or form fields.

New Cancellation Reason popup with the required empty Name field and OK

Maintain cancellation reasons

Choose the action that matches the change you need. The available actions depend on the surface and permission conditions.

NeedControlCondition or result
Create a reasonNewAvailable when the subscription includes this list and the action is available.
Enter or change a reasonNameAvailable in the new/edit popup.
Commit a new or changed reasonSaveSubmits when required fields are valid.
Leave the popupCancelCloses or cancels the popup.
Leave unsaved changesDon't SaveCloses the unsaved-changes choice.
Edit a rowedit action in the rowAvailable when editing is allowed.
Open deletiondelete action in the rowAvailable when deletion is allowed.
Confirm deletionDeleteSubmits only when more than one item remains.
Change display orderDrag and dropSaves the changed order when the configured list permits it.

Add a cancellation reason

Add a reason when cancelled sales work needs another selectable explanation.

Prerequisites

  • The Cancellation Reasons list is open.
  • New is visible.
  • You have the reason name to enter.

Steps

  1. Select New.
  2. In Name, enter the cancellation reason.
  3. Select Save.

The new reason is submitted after validation. A successful new record uses the message Data saved Successfully.

Result: The new cancellation reason is submitted through the new-item popup.

Edit a cancellation reason

Edit a reason when its wording needs to change.

Prerequisites

  • The Cancellation Reasons list is open.
  • An existing reason is available.
  • The row exposes an edit action in the row.

Steps

  1. Select the edit action in the row.
  2. Change the value in Name.
  3. Select Save.

The change is submitted after validation. A successful update uses the message Data updated Successfully.

Result: The selected cancellation reason is submitted with its changed Name.

Delete a cancellation reason

Delete a reason only when removing it is appropriate for the remaining choices. The list must contain more than one item for deletion to be submitted.

Prerequisites

  • The Cancellation Reasons list contains more than one item.
  • The row exposes a delete action in the row.
  • You have confirmed that removing the reason will not affect saved data.

Steps

  1. Select the delete action in the row.
  2. Select Delete in the confirmation menu.
IfThen
The deletion succeedsThe message is Data Deleted Successfully.
Only one item remainsKeep the item; the message is Must have at least one item.
Saved data is related to the reasonKeep the reason; the message is Related to Saved data, Can't be deleted.
The deletion failsCheck the list before taking another deletion action; the message is Failed to Delete.

Result: The selected reason is deleted only when more than one item remains and the request succeeds.

Search, filter, and use list tools

Tool or behaviourUse
Name filteringFilter by reason name.
RefreshRefresh the list.
SettingsOpen list settings.
ExportAvailable from Settings when Export is enabled.
Drag and dropReorder the list when the configured list permits it.

Handle access and surface variations

SurfaceWhat controls it
NewThe subscription includes the list and the action is available.
edit action in the rowYou are allowed to edit the selected row.
delete action in the rowYou are allowed to delete the selected row.
Name in the formThe new/edit popup is open, an item is selected, and Name is available.
Entire pageYou are signed in.

The shared list can display a subscription-unavailable surface instead of the list when the subscription does not include this configuration.

When an action does not work

Use the message on screen to correct the entry before submitting the action again.

MessageSafe next action
The Name field is required.Enter a value in Name, then select Save.
Forbidden characters detected. Please remove them and try again.Remove forbidden characters from Name, then select Save.
Must have at least one itemKeep at least one cancellation reason.
Related to Saved data, Can't be deletedKeep the related reason.
Failed to DeleteCheck the list before taking another deletion action.

Continue with the list that matches your next task:

For the broader sales-work context, see Missed, regretted, and cancelled jobs and Sales jobs lifecycle.

Was this page helpful?

Need help using the product?

Cancellation reasons — PAMS Fresh Generation