Ajout de la prise en charge d'une devise à un magasin basé sur Aurora avec l'API REST

Avec la devise ajoutée à HCL Commerce et le format et les facettes de recherche de devises définis dans la base de données sur l'environnement, vous pouvez maintenant ajouter la devise à la liste des devises prises en charge pour vos magasins de ressources et votre magasin ouvert au public. En ajoutant cette prise en charge, les utilisateurs de votre vitrine peuvent désormais sélectionner et afficher les prix dans la nouvelle devise.

Dans cette leçon, vous effectuez les tâches de haut niveau suivantes pour ajouter la prise en charge de la devise à un magasin :

Configurez vos magasins d'environnement (magasin de ressources de catalogue et magasins de site étendu ouverts au public) dans Management Center pour prendre en charge l'affichage des prix dans la nouvelle devise.
Mettez à jour les produits de magasin afin d'inclure des prix spécifiques pour les produits dans la devise.
Vous pouvez également choisir de définir comment les prix peuvent être convertis depuis la devise de magasin par défaut vers la nouvelle devise. Vous pouvez utiliser l'API REST pour définir le taux de conversion des devises.

Procédure

Composez la requête d'API REST pour ajouter la devise à un magasin spécifique.
Pour composer l'appel API, vous avez besoin des détails suivants pour identifier le magasin et la devise :
- ID du magasin. Cet ID identifie le magasin où vous ajoutez la prise en charge de la devise.
- Le code permettant d'identifier la devise dans votre environnement HCL Commerce.
Si vous souhaitez ajouter la devise à un magasin de sites étendu, vous devrez peut-être effectuer plusieurs appels POST. Si la devise est requise dans plusieurs magasins de sites étendus, vous devez ajouter la devise au magasin de ressources de catalogue, puis magasin de site étendu en question. Ajoutez la devise à ces magasins dans la séquence suivante.
Lorsque vous ajoutez des devises au magasin de ressources de catalogue ou au magasin de site étendu ouverts au public, vous devez utiliser l'API REST administrative suivante :
- Devises du magasin
Le corps de l'appel permettant d'ajouter la devise au magasin de ressources de catalogue et un magasin de site étendu peuvent ressembler à la structure de corps suivante :
```
{
    "items": [
       {
	  \"storeId\":{{catalogAssetStoreId}},
         \"currency\":\"{{code}}\"
	},
       {
	  \"storeId\":{{esiteStoreId}},
         \"currency\":\"{{code}}\"
       },
    ]
}
```
Exécutez vos appels d'API REST et ajoutez la devise à votre magasin.
Pour exécuter vos appels d'API REST, vous pouvez regrouper vos appels REST dans une collection JSON avec les appels API pour ajouter la devise à HCL Commerce afin d'exécuter tous les appels dans l'ordre. La collection suivante montre comment regrouper les appels d'API pour l'ajout d'une devise.
- Collection d'API pour l'ajout d'une devise
Pour utiliser cette collection, vous devez définir les variables d'environnement de l'API. Les appels API de la collection sont structurés avec des variables. Les valeurs utilisées pour les variables peuvent être incluses dans un fichier JSON distinct. Le fichier suivant comprend des exemples de valeurs pour définir la devise roupie indienne (INR) pour le magasin de ressources de catalogue Aurora par défaut et le magasin de site étendu.
- Variables d'environnement de collection d'API pour l'ajout d'une devise
Remplacez les exemples de valeurs définis dans le fichier par les valeurs des magasins et la devise que vous ajoutez à votre environnement. Vous pouvez ensuite utiliser la collection el les fichiers de valeurs pour exécuter les requête d'API afin d'ajouter la devise.
Vérifiez que votre devise est ajoutée à HCL Commerce et à votre magasin.
1. Ouvrez l'outil de gestion de magasin Management Center.
2. Depuis la vue de l'explorateur, cliquez sur Magasins.
3. Dans la liste des magasins disponibles, cliquez avec le bouton droit sur votre magasin de ressources de catalogue et cliquez sur Ouvrir.
4. Dans la vue des propriétés, consultez la liste des devises prises en charge pour le magasin.
  Votre nouvelle devise doit s'afficher dans cette liste.
5. Répétez les étapes précédentes pour vérifier que la langue est disponible pour votre magasin de site étendu.

Que faire ensuite

Mettez à jour les prix des produits de votre magasin pour inclure les prix dans la nouvelle devise. Vous pouvez utiliser l'API de prix de vente suivante pour définir les prix de vente dans la nouvelle devise.

https://{{ts-hostname}}:{{ts-port}}/rest/admin/v2/offer-prices

Vous devez remplacer les valeurs suivantes dans ces appels API par les valeurs de votre environnement :

ts-hostname: Le nom de l'hôte où votre serveur de transactions est hébergé.
ts-port: Le numéro de port de l'hôte de votre serveur de transactions.

Lorsque vous émettez la requête d'API, vous pouvez inclure plusieurs articles dans le corps pour définir les prix de vente pour différents produits et SKU de produits. Par exemple, l'exemple de corps suivant inclut des articles pour fixer les prix dans une nouvelle devise pour les produits qui ont le code GFR033_3301 et GFR033_3302 et les SKU de produits qui ont le code GFR033_330101 et GFR033_330201.


{
    "items": [
        {
            "offerId": 4000000000000004123,
            "currency": "{{code}}",
            "price": 21
        },
        {
            "offerId": 4000000000000002702,
            "currency": "{{code}}",
            "price": 11
        },
        {
            "offerId": 4000000000000004701,
            "currency": "{{code}}",
            "price": 21.5
        },
        {
            "offerId": 4000000000000002703,
            "currency": "{{code}}",
            "price": 11.5
        },
        {
            "offerId": 4000000000000004125,
            "currency": "{{code}}",
            "price": 15.5
        },
        {
            "offerId": 4000000000000002704,
            "currency": "{{code}}",
            "price": 5.5
        },
        {
            "offerId": 4000000000000004704,
            "currency": "{{code}}",
            "price": 16.5
        },
        {
            "offerId": 4000000000000002705,
            "currency": "{{code}}",
            "price": 6.5
        }
    ]
}

Créez vos index de recherche pour afficher les prix de vente des produits et des SKU de produits dans votre vitrine. Vous pouvez utiliser la requête d'API suivante pour regénérer l'index :
```
https://{{ts-hostname}}:{{ts-port}}/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001&fullBuild=true
```
Vous pouvez utiliser la requête d'API suivante pour surveiller le statut du processus de génération d'index :
```
https://{{ts-hostname}}:{{ts-port}}/wcs/resources/admin/index/dataImport/status?jobStatusId={{v9IndexingJobStatusId}}
```
Vous devez remplacer les valeurs suivantes dans ces appels API par les valeurs de votre environnement :

ts-hostname

Le nom de l'hôte où votre serveur de transactions est hébergé.

ts-port

Le numéro de port de votre hôte de serveur de transactions.

v9IndexingJobStatusId

L'ID du travail d'indexation de recherche. Cet ID est renvoyé dans la réponse lorsque vous émettez la requête d'API pour générer l'index.

Remarque : Pour supprimer une devise, utilisez une API REST similaire à l'API REST suivante pour les devises du magasin.

Devises du magasin