Instructions de déploiement de caisses enregistreuses pour la France

Article
11/13/2023

Avertissement

Vous ne devez mettre en œuvre les étapes décrites dans cet article que si vous utilisez Commerce version 10.0.28 ou antérieure. À partir de la version 10.0.29, tous les composants de canal de Commerce requis pour la France sont activés par défaut. Si vous utilisez la version 10.0.28 ou une version antérieure de Commerce et que vous migrez vers la version 10.0.29 ou une version ultérieure, vous devez suivre les étapes décrites dans Migrer vers Commerce version 10.0.29 ou ultérieure.

Cet article fournit des conseils sur la façon d’activer la fonctionnalité de caisse enregistreuse pour la localisation de Microsoft Dynamics 365 Commerce pour la France. La localisation consiste en plusieurs extensions des composants. Ces extensions vous permettent d’effectuer des actions comme imprimer des champs personnalisés sur les reçus, enregistrer des événements d’audit supplémentaires, des transactions de vente et des transactions de paiement dans le point de vente (PDV), signer numériquement les transactions de vente et imprimer des rapports X et Z dans des formats locaux. Pour plus d’informations sur la localisation pour la France, voir Fonctionnalité de caisse enregistreuse pour la France. Pour plus d’informations sur la configuration de Commerce pour la France, voir Configurer Commerce pour la France.

Remarque

Cette version de la fonctionnalité de caisse enregistreuse de Commerce pour la France est basée sur le cadre de l’intégration fiscale. Pour plus d’informations sur l’exemple de signature numérique hérité pour la France, voir Instructions de déploiement de caisses enregistreuses pour la France (héritées). Pour obtenir des instructions sur la façon d’activer la fonctionnalité d’intégration fiscale pour la France dans les environnements existants qui utilisent l’exemple de signature numérique hérité, voir Effectuer une migration depuis l’ancienne fonctionnalité Commerce pour la France.

Environnement de développement

Suivez ces étapes pour configurer un environnement de développement afin de pouvoir tester et étendre la fonctionnalité de localisation.

Activer les composants d’extension Commerce Runtime

Composant RegisterAuditEventFrance

Pour activer le composant RegisterAuditEventFrance, suivez ces étapes.

Recherchez le fichier de configuration d’extension pour Commerce Runtime (CRT) :
- Retail Server : le fichier est intitulé commerceruntime.ext.config et se trouve dans le dossier bin\ext sous l’emplacement du site Microsoft Internet Information Services (IIS) Retail Server.
- CRT local dans Modern POS : le fichier est intitulé CommerceRuntime.MPOSOffline.Ext.config et se trouve sous l’emplacement du courtier client CRT local.
Enregistrez la modification CRT dans le fichier de configuration de l’extension, comme illustré dans l’exemple suivant.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RegisterAuditEventFrance" />
```

Composant ReceiptsFrance

Pour activer le composant ReceiptsFrance, suivez ces étapes.

Recherchez le fichier de configuration de l’extension pour CRT :
- Retail Server : Le fichier est intitulé commerceruntime.ext.config et se trouve dans le dossier bin\ext sous l’emplacement du site IIS Retail Server.
- CRT local dans Modern POS : le fichier est intitulé CommerceRuntime.MPOSOffline.Ext.config et se trouve sous l’emplacement du courtier client CRT local.
Enregistrez la modification CRT dans le fichier de configuration de l’extension, comme illustré dans l’exemple suivant.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ReceiptsFrance" />
```

Composant XZReportsFrance

Pour activer le composant XZReportsFrance, suivez ces étapes.

Recherchez le fichier de configuration de l’extension pour CRT :
- Retail Server : Le fichier est intitulé commerceruntime.ext.config et se trouve dans le dossier bin\ext sous l’emplacement du site IIS Retail Server.
- CRT local dans Modern POS : le fichier est intitulé CommerceRuntime.MPOSOffline.Ext.config et se trouve sous l’emplacement du courtier client CRT local.
Enregistrez la modification CRT dans le fichier de configuration de l’extension, comme illustré dans l’exemple suivant.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.XZReportsFrance" />
```

Composant RestrictingShiftDuration

Pour activer le composant RestrictingShiftDuration, suivez ces étapes.

Recherchez le fichier de configuration de l’extension pour CRT :
- Retail Server : Le fichier est intitulé commerceruntime.ext.config et se trouve dans le dossier bin\ext sous l’emplacement du site IIS Retail Server.
- CRT local dans Modern POS : le fichier est intitulé CommerceRuntime.MPOSOffline.Ext.config et se trouve sous l’emplacement du courtier client CRT local.
Enregistrez la modification CRT dans le fichier de configuration de l’extension, comme illustré dans l’exemple suivant.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RestrictShiftDuration" />
```

Activer les composants d’extension Modern POS

Pour activer les composants d’extension Modern POS, suivez ces étapes.

Ouvrez la solution sur RetailSdk\POS\ModernPOS.sln et assurez-vous qu’elle peut être compilée sans erreur. De plus, confirmez que vous pouvez exécuter Modern POS de Visual Studio en utilisant la commande Exécuter.

Remarque

Modern POS ne doit pas être personnalisé. Vous devez activer le contrôle de compte d’utilisateur (UAC) et désinstaller les instances précédemment installées de Modern POS si nécessaire.
Dans le fichier extensions.json, ajoutez les lignes suivantes pour activer les extensions qui doivent être chargées.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/Receipts.FR"
        }, 
        {
            "baseUrl": "Microsoft/FifAuditEvent.FR"
        },
        {
            "baseUrl": "Microsoft/RestrictShiftDuration"
        }
    ]
}
```
Remarque

Pour obtenir plus d’informations et des exemples montrant comment inclure des dossiers de code source et permettre le chargement d’extensions, consultez les instructions du fichier readme.md dans le projet Pos.Extensions.
Recréez la solution.
Exécutez Modern POS dans le débogueur et testez la fonctionnalité.

Activer les composants d’extension Cloud POS

Pour activer les composants d’extension Cloud POS, suivez ces étapes.

Ouvrez la solution sur RetailSdk\POS\CloudPOS.sln et assurez-vous qu’elle peut être compilée sans erreur.
Dans le fichier extensions.json, ajoutez les lignes suivantes pour activer les extensions qui doivent être chargées.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/Receipts.FR"
        }, 
        {
            "baseUrl": "Microsoft/FifAuditEvent.FR"
        },
        {
            "baseUrl": "Microsoft/RestrictShiftDuration"
        }
    ]
}
```
Remarque

Pour obtenir plus d’informations et des exemples montrant comment inclure des dossiers de code source et permettre le chargement d’extensions, consultez les instructions du fichier readme.md dans le projet Pos.Extensions.
Recréez la solution.
Exécutez la solution en utilisant la commande Exécuter, puis suivez les étapes du manuel du Kit de développement logiciel (SDK) Retail.

Environnement de production

Pour créer des packages déployables qui contiennent des composants Commerce et pour appliquer ces packages dans un environnement de production, suivez ces étapes.

Dans les fichiers de configuration de package commerceruntime.ext.config et CommerceRuntime.MPOSOffline.Ext.config, sous le dossier RetailSdk\Assets, ajoutez les lignes suivantes à la section composition.

<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ReceiptsFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RegisterAuditEventFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RestrictShiftDuration" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.XZReportsFrance" />

Dans le fichier extensions.json, sous le dossier RetailSDK\POS\Extensions, ajoutez les lignes suivantes pour activer l’extension POS.

{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/Receipts.FR"
        }, 
        {
            "baseUrl": "Microsoft/FifAuditEvent.FR"
        },
        {
            "baseUrl": "Microsoft/RestrictShiftDuration"
        }
    ]
}

Ouvrez l’invite de commande MSBuild pour l’utilitaire Visual Studio et exécutez msbuild sous le dossier Kit de développement logiciel (SDK) Retail pour créer des packages déployables.
Appliquer les packages via Microsoft Dynamics Lifecycle Services (LCS) ou manuellement. Pour plus d’informations, voir Créer des packages déployables.

Migrer vers Commerce version 10.0.29 ou ultérieure

Les étapes décrites dans cette section sont requises si vous utilisez Commerce version 10.0.28 ou antérieure et que vous migrez vers la version 10.0.29 ou ultérieure. Vous devez suivre les étapes ci-dessous pour mettre à jour correctement votre environnement Commerce.

Mettez à jour Commerce Headquarters.
Activez les fonctionnalités spécifiques à la France dans l’espace de travail Gestion des fonctionnalités et distribuez les modifications aux canaux.
Mettez à jour Commerce Runtime, Cloud POS et Modern POS et excluez les extensions héritées spécifiques à la France suivantes :
- Extensions Commerce Runtime dans les fichiers commerceruntime.ext.config et CommerceRuntime.MPOSOffline.Ext.config :
  - Microsoft.Dynamics.Commerce.Runtime.ReceiptsFrance
  - Microsoft.Dynamics.Commerce.Runtime.RegisterAuditEventFrance
  - Microsoft.Dynamics.Commerce.Runtime.RestrictShiftDuration
  - Microsoft.Dynamics.Commerce.Runtime.XZReportsFrance
- Extensions POS dans le fichier extensions.json :
  - Microsoft/Receipts.FR
  - Microsoft/FifAuditEvent.FR
  - Microsoft/RestrictShiftDuration

Partager via