BeyondERP.Newsletter
Menu

Setup page · Service management

Stage reason codes

A setup page where you create reason codes (code and description) that explain why the stage of a service order was changed, why an SLA was canceled, or why an SLA time limit was exceeded.

Used by
Service dispatcher, Service delivery manager
Business process
Receive service requests
Menu item
SMAReasonCodeTable
Main table
SMAReasonTable
Data entity
SMAServiceStageReasonCodeEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you create reason codes (code and description) that explain why the stage of a service order was changed, why an SLA was canceled, or why an SLA time limit was exceeded.
What you do hereUse this page to define the codes that users select when a service stage flagged with Reason is updated, or when the parameters require a reason on canceling an SLA or exceeding its time.
ExampleFor example, when a dispatcher cancels a service order, they select a reason code for the cancellation, and the Service order progress report lists it.
Stage reason codes page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Stage reason codes

Use this page to define the codes that users select when a service stage flagged with Reason is updated, or when the parameters require a reason on canceling an SLA or exceeding its time.

Steps from Microsoft

  1. Go to Service management > Setup > Service orders > Stage reason codes.
  2. Select New to create a new reason code.
  3. In the Stage reason code field, enter a unique stage reason code.
  4. In the Description field, enter a description of the stage reason code.
  5. Close the page to save your changes.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Stage reason codeThe unique identifier of the reason code.Microsoft Learn ReasonId
DescriptionA short description of the reason.Microsoft Learn Description

Test checklist

  1. Create stage reason codes for cancellation and late completion.
  2. Select Reason on a service stage and move a service order to it; check a reason code is requested.
  3. Turn on Reason code on exceeding time, let an order exceed its SLA and sign it off; check a code is required.
  4. Run the Service order progress report and check the codes show.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Stage reason codesA short list of codes for order cancellation, SLA cancellation and SLA overrun, created before turning on Reason code on canceling or Reason code on exceeding timeReason codes explain stage changes, SLA cancellation and SLA overrun, and the Service order progress report lists them.Turning on the parameters without agreeing the codes. Users then must enter a code when an order moves to a stage that stops SLA time recording, when it is signed off and when time recording is stopped manually.
Solution architect

5Design impact

Can it be undoneReversible: Codes can be added or changed, and requiring them is a parameter (Reason code on canceling, Reason code on exceeding time) or the Reason flag on a stage, all of which can be switched off. Microsoft Learn
If you change it laterOnce reason codes are required, users must enter one when a service order moves to a stage that stops SLA time recording, when the order is signed off, and when time recording is stopped manually. Microsoft Learn
Technical architect

6Technical

Menu itemSMAReasonCodeTable Checked in Dynamics 365
FormSMAReasonCodeTable Checked in Dynamics 365
TableSMAReasonTableShown as “STAGE REASON CODES” in Record infoChecked in Dynamics 365
Data entitiesSMAServiceStageReasonCodeEntityStage reason codes Microsoft data model
Who can open itPrivilegesMaintain stage reason codes SMAReasonCodeTableMaintainView stage reason codes SMAReasonCodeTableViewDutiesEnable service order process SMAServiceOrderProcessEnableInquire into service order reference data SMAServiceOrderReferenceDataInquire
2 security rolesService dispatcher SMADispatcherService delivery manager SMAServiceDeliveryManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itService delivery manager SMAServiceDeliveryManagerTo use itService dispatcher SMADispatcherGive people one of these roles. On this system, 2 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SMAReasonCodeTable
Integrate withSMAServiceStageReasonCodeEntity data entity Microsoft data model
Data migrationSMAServiceStageReasonCodeEntity (Stage reason codes): loaded for each company.Microsoft Learn
Table definitionSMAReasonTable columns and relations Microsoft data model
Everyone

8Sources