BeyondERP.Newsletter
Menu

Setup step on the Disposition codes page · Sales and marketing

Set up Disposition codes

Use this page to describe the condition of returned items and the follow-up action, such as scrap, credit or repair.

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
ReturnDispositionCode
Main table
ReturnDispositionCode
Data entity
ReturnDispositionCodeEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you create disposition codes that say how an item returned by a customer is handled.
What you do hereUse this page to describe the condition of returned items and the follow-up action, such as scrap, credit or repair.
ExampleBEAT receives 5 damaged units of BEAT-ITEM-009 on return order RMA-000145 worth 62.50. The inspector assigns disposition code SCRAP, linked to the Scrap action: when the packing slip is posted, the customer is credited 62.50 minus charges and the loss from scrapping is posted to the ledger.
Disposition 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 Disposition codes1 screen

Use this page to describe the condition of returned items and the follow-up action, such as scrap, credit or repair.

  1. Screen 1

    Create a return disposition code

    Go to Sales and marketing > Setup > Returns > Disposition codes

    1. Select New
    2. Enter the disposition code
    3. Select the action, such as Credit, Scrap or Return to customer
    4. Enter a description
    5. Select Save
    6. Use Charges to add charges that apply with the code, when needed
    1Disposition codeBEAT-DSP
    ActionCredit
    DescriptionCredit return
    Create a return disposition code (zoomed on the outlined fields)
    Show the full screenCreate a return disposition code
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to Sales and marketing > Setup > Returns > Disposition codes.
  2. Select New to create a disposition code.
  3. Enter a unique, descriptive name, select an action, and enter a description.
  4. To link customer charges to the code, select Charges.
  5. To match your codes with external codes, select External codes.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Disposition codeA descriptive name for the disposition code.Microsoft Learn SCRAPDispositionCodeId
ActionThe follow-up action for items given this code.Microsoft Learn CreditDispositionAction
DescriptionWhat kind of action the code covers.Microsoft Learn Credit returnDescription
ChargesCustomer charges linked to the code, such as a restocking fee.Microsoft Learn

Common errors and fixes

MessageWhat to do
No replacement sales order is created for a returned itemOnly disposition actions that start with Replace (Replace and credit, Replace and scrap) create a replacement order, when the return order packing slip is generated; fill in the Replacement item page for those lines. Microsoft Learn

Test checklist

  1. Create disposition codes for Credit, Scrap, Replace and credit and Return to customer.
  2. Create a return order with a return reason code, register arrival and assign each disposition code to a line.
  3. Post the packing slip and check that scrap lines post an inventory loss, credit lines go back to inventory and the Replace and credit line creates a replacement sales order.
  4. Invoice the return order and check the customer credit matches the actions.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Disposition codesOne disposition code per way you handle returned goods (for example Scrap, Repair, Resale), each linked to the built-in disposition action that matches the financial and physical result you want; use a Credit only code only where the customer keeps the itemYou can define as many disposition codes as you need, but each must reference one of six built-in actions, and that action decides the physical handling, the financial effect and whether a replacement order is created.Which disposition action should each code use?Linking a code to the wrong action. For example, actions containing "scrap" scrap the item and post the inventory loss to the ledger, and Return to customer gives no credit except fees or charges.Test: Disposition action drives return posting

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 undoneHard to reverse: The action is carried out when the return order packing slip (or invoice) is posted. Changing a code's action later doesn't reverse scrap postings or replacement orders already created.
If you change it laterThe disposition action decides the financial and physical result of each return line: credit, scrap with the loss posted to the ledger, replacement order, or return to the customer. A changed action applies to lines processed afterwards; posted packing slips keep their result. Microsoft Learn
Technical architect

6Technical

Menu itemReturnDispositionCode Checked in Dynamics 365
FormReturnDispositionCode Checked in Dynamics 365
TableReturnDispositionCodeShown as “Disposition code” in Record infoKey field: DispositionCodeId, DispositionActionChecked in Dynamics 365
Data entitiesReturnDispositionCodeEntityDisposition code 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=ReturnDispositionCode
Integrate withReturnDispositionCodeEntity data entity Microsoft data model
Data migrationReturnDispositionCodeEntity (Disposition code): loaded for each company, in Microsoft's default template 330 - Sales and marketing.Load order: Microsoft's default template 330 - Sales and marketing loads Disposition code at execution unit 1, level 30, sequence 10. Lower levels load first, and entities at the same level load in sequence order.Load first: the default templates at lower levels (System setup to General ledger)Microsoft Learn
Table definitionReturnDispositionCode columns and relations Microsoft data model
Everyone

8Sources