Deployment guidelines for Advance Invoice report printing for Czech Republic, Hungary, and Poland

Article
09/29/2023

Warning

You should implement the steps that are described in this article only if you're using Commerce version 10.0.34 or earlier. As of version 10.0.35, all required Commerce channel components for Advance Invoice report printing are enabled out of the box. If you're using Commerce version 10.0.34 or earlier, and are migrating to Commerce version 10.0.35 or later, follow the steps in the Migrate to Commerce version 10.0.35 or later section.

This article shows how to enable the Dynamics 365 Commerce localization for Czech Republic, Hungary, and Poland. The localization consists of several extensions of Commerce components. These extensions let you print the Advance Invoice report from Point of Sale (POS). For more information about localization for Czech Republic, Hungary, and Poland, see Advance invoices for Commerce for Eastern Europe.

The localization is part of the Retail software development kit (SDK). For information, see the Retail software development kit (SDK) architecture.

The localization consists of extensions for the Commerce runtime (CRT) and POS. To enable this localization, you must modify the CRT configuration file and modify and build POS projects. We recommend that you use an unmodified Retail SDK to make the changes that are described in this article. We also recommend that you use a source control system, such as Microsoft Visual Studio Team Services, where no files have been changed yet.

Development environment

Complete these procedures to set up a development environment, so that you can test the functionality.

CRT extension components

Find the extensions configuration file for CRT.

The file is named commerceruntime.ext.config, and is located in the bin\ext folder under the IIS Commerce Scale Unit site location.
Register the CRT change in the extensions configuration file.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.UseAdvanceInvoice" />
```
Warning

Do not edit the commerceruntime.config file. This file isn't intended for any customizations.

Modern POS extension components

Open the solution at RetailSdk\POS\ModernPOS.sln, and make sure that it can be compiled without errors. Additionally, make sure that you can run Modern POS from Microsoft Visual Studio by using the Run command.

Note

Modern POS must not be customized. You must enable User Account Control (UAC), and you must uninstall previously installed instances of Modern POS as required.
Enable the extensions to be loaded in extensions.json by adding the following lines in the appropriate location.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/AdvanceInvoice"
        }
    ]
}
```
Rebuild the solution.
Run Modern POS in the debugger and test the functionality.

Cloud POS extension components

Open the solution at RetailSdk\POS\CloudPOS.sln, and make sure that it can be compiled without errors.
Enable the extensions to be loaded in extensions.json by adding the following lines in the appropriate location.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/AdvanceInvoice"
        }
    ]
}
```
Rebuild the solution.
Run Cloud POS in the debugger and test the functionality.

Set up required parameters in Headquarters

For more information, see Advance invoices for Commerce for Eastern Europe.

Production environment

Follow these steps to create deployable packages that contain Commerce components, and to apply those packages in a production environment.

Complete the steps in the Cloud POS extension components or Modern POS extension components sections earlier in this article.
Make the following change in the package configuration files under the RetailSdk\Assets folder.

In the commerceruntime.ext.config configuration files, add the following lines to the composition section.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.UseAdvanceInvoice" />
```
Run msbuild for the Retail SDK to create deployable packages.
Apply the packages via Microsoft Dynamics Lifecycle Services (LCS) or manually. For more information, see Create deployable packages.

Migrate to Commerce version 10.0.35 or later

The steps that are described in this section are required if you're using Commerce version 10.0.34 or earlier, and are migrating to version 10.0.35 or later. You must follow these steps to correctly update your Commerce environment.

Update Commerce headquarters.
Enable the Advance invoice report printing feature in the Feature management workspace, and distribute the changes to channels.
Update the Commerce runtime, Cloud POS, and Modern POS, and exclude the following legacy extensions:
- Commerce runtime extensions in the commerceruntime.ext.config and CommerceRuntime.MPOSOffline.Ext.config files:
  - Microsoft.Dynamics.Commerce.Runtime.UseAdvanceInvoice
- POS extensions in the extensions.json file:
  - Microsoft/AdvanceInvoice