BeyondERP.Newsletter
Menu

Setup page · Sales and marketing

Return reason codes

A setup page where you create return reason codes that describe why a customer returns an item.

Used by
Accounts receivable clerk, Accounts receivable manager, Accounts receivable centralized payments clerk and 11 more roles
Business process
Process customer returns and exchanges
Menu item
ReturnReasonCode
Main table
ReturnReasonCode
Data entity
ReturnCustomerReturnReasonCodeEntity
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 return reason codes that describe why a customer returns an item.
What you do hereUse this page to record the reason for a return on return orders, with optional charges linked to each reason.
ExampleBEAT's customer returns 2 units of BEAT-ITEM-016 on return order RMA-000152 (29.80) because they arrived damaged. The order desk selects reason code DAMAGED in group QUALITY; the restocking charge linked to the code is added to the return order header automatically.
Return 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.

Step by step, with screenshots

Set up Return reason codes1 screen

Use this page to record the reason for a return on return orders, with optional charges linked to each reason.

  1. Screen 1

    Create a return reason code

    Go to Sales and marketing > Setup > Returns > Return reason codes

    1. Make sure the reason code group exists (Sales and marketing > Setup > Returns > Return reason code groups)
    2. Select New
    3. Enter the reason code and description
    4. Select the return reason code group
    5. Select Save
    6. Use Charges to add charges that apply with the reason, when needed
    1Return reason codeBEAT-RRC
    DescriptionDamaged in transit
    Return reason code groupBEAT-RRG
    Create a return reason code (zoomed on the outlined fields)
    Show the full screenCreate a return reason code
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to Sales and marketing > Setup > Returns > Return reason codes.
  2. Create a new return reason code line.
  3. In the Return reason code field, enter text that identifies the code.
  4. In the Description field, describe the reason.
  5. In the Return reason code group field, select the group the code belongs to.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Return reason codeThe code for the customer's reason for returning the item.Microsoft Learn DAMAGEDReasonCodeId
DescriptionA description of the reason code.Microsoft Learn Damaged in transitDescription
Return reason code groupThe group the reason code belongs to.Microsoft Learn QUALITYReasonCodeGroupId
ChargesCharges linked to the reason code; they are added automatically to the return order header when the code is assigned.Microsoft Learn RESTOCK

Common errors and fixes

MessageWhat to do
A charge stays on the return order after the reason code is changedChanging the reason code doesn't remove the charge that the earlier code added; a new charge may be added for the new code. Remove the old charge by hand. Microsoft Learn

Test checklist

  1. Create a return reason code group, then a return reason code linked to it.
  2. Create a return order and select the new return reason code.
  3. Check the code shows on the return order and can be used to filter return orders.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Return reason codesOne return reason code per reason customers give for a return (for example damaged, wrong item, not as expected), each placed in a return reason code groupEvery return order needs a return reason code to say why the product is being returned, and grouping the codes keeps them organized for analysis.Should reason codes carry charges?Linking a charge to a reason code without telling the order desk; the charge is added automatically and isn't removed if the code is changed afterwards.Test: Reason code adds its charge

Feature management and licence

Licence or add-inOn the live system, Sales clerk, Sales manager, Sales representative, Customer service representative, Customer service manager, the Accounts receivable roles, Retail service, Retail store manager and the Rental roles use this page.

Checked in Dynamics 365

Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneReversible: You can add or rename reason codes at any time. They describe the reason for a return and don't drive posting, which comes from the disposition code. Microsoft Learn
If you change it laterCharges linked to a reason code are added to return orders when the code is assigned; changing the code on an order later doesn't remove the existing charge. What happens to the item and the credit comes from the disposition code. Microsoft Learn
Technical architect

6Technical

Menu itemReturnReasonCode Checked in Dynamics 365
FormReturnReasonCode Checked in Dynamics 365
TableReturnReasonCodeShown as “Return reason codes” in Record infoKey field: ReasonCodeId, ReasonCodeGroupIdChecked in Dynamics 365
Data entitiesReturnCustomerReturnReasonCodeEntityReturn reason codes Microsoft data model
Who can open itPrivilegesMaintain disposition codes, reason codes, and reason code groups ReturnDispositionCodeMaintainView disposition codes, reason codes, and reason code groups ReturnDispositionCodeViewDutiesEnable quotation to sales order process RentalSalesQuotationToSlsOrdProcessEnableInquire into sales return order progress ReturnSalesReturnOrderProgressInquireEnable quotation to sales order process SalesQuotationToSalesOrderProcessEnableInquire into quotation to sales order reference data SalesQuotationToSalesOrderRefDataInquir
15 security rolesAccounts receivable clerk CustInvoiceAccountsReceivableClerkAccounts receivable manager CustInvoiceAccountsReceivableManager MCRTestUserRoleAccounts receivable centralized payments clerk PaymAccountsReceivableCentralPaymClerkAccounts receivable payments clerk PaymAccountsReceivablePaymentsClerkRental coordinator agent RentalCoordinatorAgentRental manager RentalManagerRental sales manager RentalSalesManagerRetail service RetailServiceRetail store manager RetailStoreManagerCustomer service manager TradeCustomerServiceManagerCustomer service representative TradeCustomerServiceRepresentativeSales clerk TradeSalesClerkSales manager TradeSalesManagerSales representative TradeSalesRepresentative
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSales manager TradeSalesManagerRental manager RentalManagerRental coordinator agent RentalCoordinatorAgentRental sales manager RentalSalesManagerAccounts receivable manager CustInvoiceAccountsReceivableManagerTo use itAccounts receivable clerk CustInvoiceAccountsReceivableClerkSales clerk TradeSalesClerkSales representative TradeSalesRepresentativeCustomer service representative TradeCustomerServiceRepresentativeAccounts receivable centralized payments clerk PaymAccountsReceivableCentralPaymClerkGive people one of these roles. On this system, 14 roles can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=ReturnReasonCode
Integrate withReturnCustomerReturnReasonCodeEntity data entity Microsoft data model
Data migrationReturnCustomerReturnReasonCodeEntity (Return reason codes): loaded for each company, in Microsoft's default template 330 - Sales and marketing.Load order: Microsoft's default template 330 - Sales and marketing loads Return reason codes at execution unit 1, level 40, sequence 10. Lower levels load first, and entities at the same level load in sequence order.Load first: Return reason code groups, the default templates at lower levels (System setup to dependency bands 30 to 90)Microsoft Learn
Table definitionReturnReasonCode columns and relations Microsoft data model
Everyone

8Sources