Merge pull request #4862 from lucciz01/Migrate28CommerceAarticles

Changes to 28 D365 Commerce migrated articles from public repo

Author: lucciz01

support/dynamics-365/commerce/commerce-headquarters-operations/customer-record-not-appearing.md

@@ -1,37 +1,35 @@
 ---
 title: Customer records don't appear in Commerce headquarters
-description: This article provides troubleshooting guidance that can help when customer records don't immediately appear in Commerce headquarters.
-author: Reza-Assadi
+description: Provides a resolution for an issue where customer records don't immediately appear in Commerce headquarters.
+author: josaw1 
 ms.author: josaw
-ms.topic: troubleshooting
-ms.date: 03/11/2021
-
+ms.reviewer: rassadi, brstor
+ms.date: 09/01/2023
 ---
-
 # Customer records don't appear in Commerce headquarters
 
-This article provides troubleshooting guidance that can help when customer records don't immediately appear in Commerce headquarters.
+This article provides a resolution for an issue where customer records don't immediately appear after they're created in Commerce headquarters.
 
-## Description
+## Symptoms
 
-When you create a new customer record by using the sign-up flow in the e-commerce storefront, the corresponding customer record doesn't immediately appear in Commerce headquarters.
+When you create a new customer record by using the [sign-up flow](/dynamics365/commerce/create-user-flow-policies#create-a-sign-up-and-sign-in-user-flow-policy) in the [e-commerce storefront](/dynamics365/commerce/commerce-architecture#e-commerce-storefront), the corresponding customer record doesn't immediately appear in Commerce headquarters.
 
 ## Resolution
 
-### Disable customer creation in async mode
+To solve this issue, disable customer creation in asynchronous (or async) mode.
 
 > [!IMPORTANT]
-> If you disable asynchronous customer creation, system performance could be affected, because creation of each record will produce a real-time request to Commerce headquarters. In addition, if Commerce headquarters is down (for example, during servicing flows), any new customer creation flows will produce errors.
+> If you disable asynchronous customer creation, system performance could be affected, because the creation of each record will produce a real-time request to Commerce headquarters. In addition, if Commerce headquarters is down (for example, during servicing flows), new customer creation flows will produce errors.
 
-To disable customer creation in async mode in Commerce headquarters, follow these steps.
+To disable customer creation in async mode in Commerce headquarters, follow these steps:
 
-1. Go to **Retail and Commerce \> Channel setup \> Online store setup \> Functionality profiles**.
-1. If you aren't already using a functionality profile for your online channel, create one.
+1. Go to **Retail and Commerce** > **Channel setup** > **Online store setup** > **Functionality profiles**.
+1. If you don't have a functionality profile for your online channel, create one.
 1. Make sure that the **Create customer in async mode** option is set to **No**.
-1. Go to **Retail and Commerce \> Channels \> Online stores**.
-1. Select the online store to disable asynchronous customer creation for.
+1. Go to **Retail and Commerce** > **Channels** > **Online stores**.
+1. Select the online store for which you want to disable asynchronous customer creation.
 1. On the **General** tab, make sure that the **Functionality profile** field is set to the functionality profile that you're using for your online channel.
 
-## Additional resources
+## More information
 
-[Setup a B2C tenant in Commerce](/dynamics365/commerce/set-up-b2c-tenant)
+For more information, see [Set up a B2C tenant in Commerce](/dynamics365/commerce/set-up-b2c-tenant).

support/dynamics-365/commerce/commerce-headquarters-operations/summary-taxes-custom-modules-10.0.27.md

@@ -1,52 +1,46 @@
 ---
-# required metadata
-
 title: Order summary subtotal doesn't include taxes on charges when using customized order summary modules
-description: This article provides troubleshooting guidance that can help when you use customized order summary modules and the order summary subtotal doesn't include taxes on charges in the "price includes sales tax" scenario.
-author: gvrmohanreddy
+description: Resolves an issue where the order summary subtotal doesn't include taxes on charges in the price includes sales tax scenario in Microsoft Dynamics Commerce.
+author: josaw1
 ms.author: josaw
-ms.topic: troubleshooting
-ms.date: 05/17/2022
-
+ms.reviewer: brstor
+ms.date: 09/01/2023
 ---
-
 # Order summary subtotal doesn't include taxes on charges when using customized order summary modules
 
-This article provides troubleshooting guidance that can help when you use customized order summary modules and the order summary subtotal doesn't include taxes on charges in the "price includes sales tax" scenario.
+This article provides a resolution for an issue where the order summary subtotal doesn't include taxes on charges in the "price includes sales tax" scenario when you use customized order summary modules in Microsoft Dynamics Commerce.
 
-## Description
+## Symptoms
 
-As of the Microsoft Dynamics 365 Commerce version 10.0.27 release, the following changes have been made to the "price includes sales tax" scenario to provide a consistent experience in order summary modules across e-commerce site pages.
+As of Microsoft Dynamics 365 Commerce version 10.0.27, the following changes have been made to the "price includes sales tax" scenario to provide a consistent experience in order summary modules across e-commerce site pages.
 
-- Two new fields have been added: **TaxOnShippingCharge** and **TaxOnNonShippingCharges**.
-- The **GetSalesOrderBySalesId** and **GetSalesOrderByTransactionId** application programming interfaces (APIs) have accurate values for the following fields in the "price includes sales tax" scenario:
+- Two new fields have been added: `TaxOnShippingCharge` and `TaxOnNonShippingCharges`.
+- The `GetSalesOrderBySalesId` and `GetSalesOrderByTransactionId` application programming interfaces (APIs) have accurate values for the following fields in the "price includes sales tax" scenario:
 
-    - SubtotalSalesAmount
-    - SubtotalAmountWithoutTax
-    - SubtotalAmount
-    - ShippingChargeAmount
-    - OtherChargeAmount
+  - `SubtotalSalesAmount`
+  - `SubtotalAmountWithoutTax`
+  - `SubtotalAmount`
+  - `ShippingChargeAmount`
+  - `OtherChargeAmount`
 
-However, if you're using customized order summary modules, these changes might affect order summary subtotal values by not including taxes on charges.
+However, if you use customized order summary modules, these changes might affect order summary subtotal values by not including taxes on charges.
 
 ## Resolution
 
-If you're using customized order summary modules and don't want to inherit the changes that have been made to the "price includes sales tax" scenario in Commerce version 10.0.27 and later, follow the instructions in this section.
-
-By reverting to the previous (before version 10.0.27) order summary behavior of the **salesTransaction.SubtotalAmount** and **salesTransaction.SubtotalAmountWithoutTax** fields, you restore the inclusion of the total charge tax amount (**TaxOnShippingCharge** and **TaxOnNonShippingCharges**) in the subtotal amounts (**SubtotalAmount** and **SubtotalAmountWithoutTax**).
+If you use customized order summary modules and don't want to inherit the changes that have been made to the "price includes sales tax" scenario in Dynamics 365 Commerce version 10.0.27 and later, you can revert to the previous (before version 10.0.27) order summary behavior of the `salesTransaction.SubtotalAmount` and `salesTransaction.SubtotalAmountWithoutTax` fields. This will restore the inclusion of the total charge tax amount (`TaxOnShippingCharge` and `TaxOnNonShippingCharges`) in the subtotal amounts (`SubtotalAmount` and `SubtotalAmountWithoutTax`).
 
-To revert to the previous order summary behavior, follow these steps.
+To revert to the previous order summary behavior, follow these steps:
 
-1. In Commerce headquarters, open the Commerce parameters page (**Retail and Commerce \> Headquarters setup \> Parameters \> Commerce parameters**).
+1. In Commerce headquarters, go to **Retail and Commerce** > **Headquarters setup** > **Parameters** > **Commerce parameters** to open the **Commerce parameters** page.
 1. In the left navigation pane, select **Configuration parameters**.
 1. Add the following configuration parameters, and set the value of each to **true**:
 
-    - IsLegacyTaxOnChargeInSubtotalAmountIncludedInTaxIncusiveEnabled
-    - IsLegacyOrderSummaryHydrationEnabled
+    - `IsLegacyTaxOnChargeInSubtotalAmountIncludedInTaxIncusiveEnabled`
+    - `IsLegacyOrderSummaryHydrationEnabled`
 
 > [!NOTE]
-> If you've previously used the **IsUpdatedPriceIncludesTaxSubtotalCalculationEnabled** configuration parameter and want to retain the same behavior for the **order.NetAmountWithoutTax** property, you should also add the **IsLegacyPriceIncludesTaxNetAmountWithoutTaxCalculationEnabled** configuration parameter and set its value to **true**.
+> If you've previously used the `IsUpdatedPriceIncludesTaxSubtotalCalculationEnabled` configuration parameter and want to retain the same behavior for the `order.NetAmountWithoutTax` property, you should also add the `IsLegacyPriceIncludesTaxNetAmountWithoutTaxCalculationEnabled` configuration parameter and set its value to **true**.
 
-## Additional resources
+## More information
 
-[Hide tax breakup information in order summaries](/dynamics365/commerce/hide-taxes-breakup)
+For more information, see [Hide tax breakup information in order summaries](/dynamics365/commerce/hide-taxes-breakup).

support/dynamics-365/commerce/development-sdks/media/set-up-dev-environment-debugging/debugger-tools-error.png

@@ -1,48 +1,47 @@
 ---
-
-title: Set up an e-commerce development environment to debug against a Tier 1 Retail Server virtual machine
-description: This article explains how to set up an e-commerce development environment to debug against a Tier 1 Retail Server virtual machine (VM).
-author: Reza-Assadi
+title: Errors when debugging against a Tier 1 Retail Server virtual machine
+description: Resolves errors that occur when you debug a Tier 1 Retail Server VM in an e-commerce development environment in Microsoft Dynamics 365 Commerce.
+author: josaw1 
 ms.author: josaw
-ms.topic: troubleshooting
-ms.date: 03/11/2021
-
+ms.reviewer: rassadi, brstor
+ms.date: 09/04/2023
 ---
+# Errors when you debug against a Tier 1 Retail Server virtual machine in an e-commerce development environment
 
-# Set up an e-commerce development environment to debug against a Tier 1 Retail Server virtual machine
+This article provides a resolution for an issue where you might receive an error when you debug against a Tier 1 Retail Server virtual machine (VM) in an e-commerce development environment in Microsoft Dynamics 365 Commerce.
 
-This article explains how to set up an e-commerce development environment to debug against a Tier 1 Retail Server virtual machine (VM).
+## Introduction
 
-## Description
+Microsoft Dynamics 365 Commerce Tier 1 environments are typically deployed for [Commerce runtime (CRT)](/dynamics365/commerce/dev-itpro/crt-services) and [point of sale (POS) extension](/dynamics365/commerce/dev-itpro/pos-extension/pos-extension-overview) development. They are standalone environments. Because of the software as a service (SaaS) nature of the architecture, they don't include e-commerce components.
 
-Microsoft Dynamics 365 Commerce Tier 1 environments are typically deployed for Commerce runtime (CRT) and point of sale (POS) extension development. They are standalone environments. Because of the software as a service (SaaS) nature of the architecture, they don't include e-commerce components.
+In some scenarios, you might need to test calls to extensions in a Tier 1 environment so that you can debug extensions from e-commerce components. For general instructions, see [Debug against a Tier 1 Commerce development environment](/dynamics365/commerce/e-commerce-extensibility/debug-tier-1).
 
-In some scenarios, you might want to test calls to extensions in a Tier 1 environment, so that you can debug extensions from e-commerce components. For general instructions, see [Debug against a Tier 1 Commerce development environment](/dynamics365/commerce/e-commerce-extensibility/debug-tier-1).
+## Symptoms
 
 When you debug against a Tier 1 environment, because the site is now calling a different Retail Server, cross-server calls might cause various errors that are related to the content security policy.
 
-The following illustration shows an example of an error that might occur when a variant is selected on a product details page.
+The following screenshot shows an example of an error that might occur when a variant is selected on a product details page.
 
-![Error when a variant is selected on a product details page.](../../../media/common/unhandled-rejection-error.jpg)
+> Unhandled Rejection (ActionError): Error
 
-The following illustration shows an example of a similar error in a browser's debugger tools (F12 Developer Tools). The error message mentions violation of the content security policy directive.
+:::image type="content" source="media/set-up-dev-environment-debugging/unhandled-rejection-error.png" alt-text="Screenshot that shows an Unhandled Rejection Action error.":::
 
-![Debugger tools error.](../../../media/common/debugger-tools-error.jpg)
+The following screenshot shows an example of a similar error in a browser's debugger tools (F12 Developer Tools). The error message mentions a violation of the content security policy directive.
+
+:::image type="content" source="media/set-up-dev-environment-debugging/debugger-tools-error.png" alt-text="Screenshot that shows an error that mentions a violation of the content security policy directive in a browser's debugger tools.":::
 
 ## Resolution
 
-### Disable the content security policy for the site in Commerce site builder
+To solve this issue, disable the [content security policy (CSP)](/dynamics365/commerce/manage-csp) for the site in Dynamics 365 Commerce site builder.
 
 1. Select the site that you're working on.
-1. Select **Settings**, and then select **Extensions**.
+1. Select **Settings** > **Extensions**.
 1. On the **Content security policy** tab, select **Disable content security policy**.
 1. Select **Save and publish**.
 
 > [!NOTE]
 > Business-to-consumer (B2C) sign-in won't work in a local development environment. However, you can use guest checkouts or build page mocks to simulate a user sign-in as required.
 
-## Additional resources
+## More information
 
 [Get started with e-commerce online extensibility development](/dynamics365/commerce/e-commerce-extensibility/sdk-getting-started)
-
-[Manage content security policy (CSP) on e-commerce site](/dynamics365/commerce/manage-csp)

support/dynamics-365/commerce/development-sdks/media/set-up-dev-environment-debugging/unhandled-rejection-error.png

@@ -1,38 +1,32 @@
 ---
-
-title: Items without inventory can be checked out
-description: This article provides troubleshooting guidance that can help when customers can add out-of-stock items to their cart and proceed to checkout.
-author: Reza-Assadi
+title: Items without inventory can be checked out in Dynamics 365 Commerce
+description: Provides a resolution for an issue where you can add out-of-stock items to your cart and proceed to check out in Microsoft Dynamics 365 Commerce.
+author: josaw1 
 ms.author: josaw
-ms.topic: troubleshooting
-ms.date: 03/11/2021
-
+ms.reviewer: rassadi, brstor
+ms.date: 09/01/2023
 ---
-
 # Items without inventory can be checked out
 
-This article provides troubleshooting guidance that can help when customers can add out-of-stock items to their cart and proceed to checkout.
+This article provides a resolution for an issue where you can add out-of-stock items to your cart and proceed to check out without stock-related errors in Microsoft Dynamics 365 Commerce.
 
-## Description
+## Symptoms
 
-Users can add an item to their cart, even though there is no on-hand inventory in the store, and then proceed to the checkout page.
+You can add an item to your cart, even though there's no on-hand inventory in the store, and then proceed to the checkout page.
 
 ## Resolution
 
-### Enable the Show Out Of Stock Errors property in Commerce site builder
-
-To enable the **Show Out Of Stock Errors** property in Commerce site builder, follow these steps.
+To solve this issue, follow these steps to enable the [Show out of stock errors](/dynamics365/commerce/add-cart-module#cart-module-properties-and-slots) property in Dynamics 365 Commerce site builder:
 
 1. Select the site that you're working on.
 1. In the left navigation, select **Pages**.
 1. Select **CartPage** to open it.
-1. Select the **Cart 1** slot, select **Edit**, and then, in the properties pane, select the **Show Out Of Stock Errors** check box.
+1. Select the **Cart 1** slot and select **Edit**.
+1. In the properties pane, select the **Show Out Of Stock Errors** check box.
 1. Save and publish the page.
 
-## Additional resources
-
-[Apply inventory settings](/dynamics365/commerce/inventory-settings)
-
-[Calculate inventory availability for retail channels](/dynamics365/commerce/calculated-inventory-retail-channels)
+## More information
 
-[Configure inventory buffers and inventory levels](/dynamics365/commerce/inventory-buffers-levels)
+- [Apply inventory settings](/dynamics365/commerce/inventory-settings)
+- [Calculate inventory availability for retail channels](/dynamics365/commerce/calculated-inventory-retail-channels)
+- [Configure inventory buffers and inventory levels](/dynamics365/commerce/inventory-buffers-levels)