--- schema_version: "1" id: 19815aa5819f78bc41e5efe53a6cd02d51da1704c8cad39161d06e2f7eba98ea title: Reason Codes collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_cms_settings_reason_codes.md canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_cms_settings_reason_codes.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: e657d8a97b6152a2b4d2b8ff79302cbe8584aef978af20b9e2a1f7f50d0634be description: Configure reason codes in Point of Sale (POS) to track the reasons behind actions, such as discounts or inventory adjustments. products: - Commerce release: "264" --- # Reason Codes Configure reason codes in Point of Sale (POS) to track the reasons behind actions, such as discounts or inventory adjustments. - Modern POS App build: 5.5.2 and later - Platform Support: iPhone & iPad - Offline Support: partial with limitations - If an offline session is initiated as part of the user's login itself, the configured reason won’t be provided. - Any offline session initiated after login provides the configured reason codes. - Technical Prerequisites: not applicable POS allows store associates to enter or select the reasons corresponding to their actions while performing transactions. This article outlines the required configurations to set up these reason codes, as well as lists the use cases that use these reason codes. - **[Reason Code Use Cases](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_settings_reason_code_use_cases.htm&release=264.0.0&type=5)** View use cases for various reason codes in the Point of Sale (POS) app. ## Viewing Reason Codes 1. In CMS, go to **Store Management > Reason Codes**. 2. The modules page shows all the existing reason codes. ‌Select any of these to view, create, update, or delete the reason codes of that reason code type. 3. (Optional) Use the ALL tab to manually filter the reason codes instead. ## Creating Reason Codes 1. Select **Create**, located on the top right of the web page. 2. Fill out the configuration fields: 1. **Reason Code Type**—Select the type of Reason Code. 2. **Reason Code**—Enter a name that identifies the Reason Code. 3. **Display Text: Additional Text Input Allowed**—Users usually select this checkbox if the display text is 'Other'. 4. **Default Value:** Provide a default discount percentage corresponding to the reason code. 5. **Default Value Editable:** If selected, the CMS specified default value can be changed from the app while performing the transaction. 3. Select **Save**. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_note.png) Note You can edit an existing Reason Code by clicking on the pencil icon to the right of it. The Reason Code Type and Reason Code aren't modifiable values. To change these values, you'll need to delete them and create a new one. ## Reason Code Types Store Level - Corp Cancellation Transaction Level - Transaction Level Discount - Item Level Discount - Return - Pay In - [Void Cart](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_orders_process_export_suspend_void_data.htm&language=en_US) - Price Correction ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_note.png) Note For app builds 9.0.1 and greater, the Price Correction Reason Code is recorded not only in the [Electronic Journal](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_reports_electronic_journal_overview.htm&release=264.0.0&type=5 "Customize filters for transaction research and record store transactions in Retail Cloud.") but also in the [TLog](https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_export_tlog.htm&language=en_US). It includes the existing price and the corrected price. This is supported both online and offline. Inventory - Excludes From Cycle Count - Inventory Adjustment - Shipment Inventory Mismatch - No Sale Cash Management - Cash Register Variance Reasons - Cash Out - Bank Deposit Variance - Safe Float Update - Cash Register Float Update - Expense Update - Miscellaneous Expense 1 Update - Miscellaneous Expense 2 Update - Return Price Correction ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_note.png) Note For app builds 9.1.2 and greater, the Return Price Correction Reason Code is recorded in the [Electronic Journal](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_reports_electronic_journal_overview.htm&release=264.0.0&type=5 "Customize filters for transaction research and record store transactions in Retail Cloud.") as "Return Price Correction". It is recorded in the [TLog](https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_export_tlog.htm&language=en_US) and API Connector. It includes the price correction, before and after price, and any reason text. ## Additional Information Store associates can select the preconfigured reason codes while performing any of the below transactions. The reason codes are preconfigured in CMS. For more information, refer to [Enable App Settings.](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_settings_reason_codes.htm&release=264.0.0&type=5) - Transaction level discount - Item level discount - Till reconciliation - Cash-out - Inventory adjustment - Excluding item from cycle count ## Salient Features of Reason Codes - Support both reason code and reason text. The code can be used during backend processing, while the text can be used as a display string in reporting. - Support of default values. - Default values can be configured for reason codes and applied as a percentage discount. - For example, a percentage discount of 30% can be configured through the reason code itself by providing a default value of 30%. - The default value is limited to reason codes corresponding to a percentage discount. - POSLog export provides both reason code and reason text.