Service de mise à jour du cache de stock

Le service de mise à jour du cache de stock est un service Web entrant responsable de l'ajout et de la mise à jour du cache de stock et de la table de base de données INVENTORY pour les modèles de stock non-ATP dans HCL Commerce. Ce service met à jour le cache de stock et la table de base de données lorsqu'un magasin est configuré pour utiliser un système externe pour la gestion des stocks.

Ce service Web entrant est généralement appelé par le système externe pour effectuer des ajustements précis des niveaux de stock mis en cache dans HCL Commerce. Le système de gestion des stocks externe peut utiliser l'utilitaire massload ou l'utilitaire Chargement des données pour les ajustements grossiers tels que les actualisations régulières de l'ensemble du cache de stock.

Cas d'utilisation typiques

Les niveaux de stock de certains produits ont changé et le cache local de HCL Commerce doit être mis à jour en conséquence.
Les niveaux de stock de certains produits changent rapidement et ne doivent plus être mis en cache par HCL Commerce.

URL du point d'extrémité et opération du service Web

L'URL de nœud final par défaut de ce service Web entrant est https:// hostname:8000/webapp/wcs/services/InventoryServices. L'opération mise à disposition par ce service Web entrant est SyncProductAvailability, avec le BOD SyncProductAvailability pour la requête et le BOD ConfirmBOD pour la réponse.

Demande

Les requêtes adressées à ce service Web entrant ont la forme de documents BOD (Business Object Documents) ProcessOrder. Elles sont mappées à la commande InventoryBalanceUpdate et doivent contenir les informations suivantes :


XPath*	Type	Mappé au paramètre de commande suivant	Description	Requis
`DataArea/Sync/ActionCriteria/ActionExpression` `/@actionCode`	chaîne	`ActionCode`	Le code d'action. Elles doivent être "`Update`" (à mettre en cache) ou "`Delete`" (à supprimer du cache).	O
`DataArea/ProductAvailability[i]` `/ProductIdentifier/SKU`	chaîne	`SKU_i`	SKU du produit.	O
`DataArea/ProductAvailability[i]/QuantityOnHand`	double	`GlobalQuantityOnHand_i`	Valeur de quantité en stock au niveau global.	N
`DataArea/ProductAvailability[i]/QuantityOnHand/@uom`	chaîne	`GlobalUOMOnHand_i`	Unité de mesure de la valeur de quantité ; par exemple, "C62" pour l'absence d'unité. Voir Unités de quantité.	N
`DataArea/ProductAvailability[i]/ExpectedInventory[j]/Quantity`	double	`GlobalQuantityExpected_i_j`	Valeur de quantité prévue au niveau global.	N
`DataArea/ProductAvailability[i]/ExpectedInventory[j]/Quantity/@uom`	chaîne	`GlobalUOMExpected_i_j`	Unité de mesure de la valeur de quantité.	N
`DataArea/ProductAvailability[i]/ExpectedInventory[j]/AvailableDateTime`	dateTime	`GlobalEstimatedAvailableDateTime_i_j`	Date de disponibilité estimée du stock prévu.	N
`DataArea/ProductAvailability[i]/FulfillmentCenterInventory[m]/@fulfillmentCenterID`	int	`FulfillmentCenterId_i_m`	ID du centre de distribution HCL Commerce.	N
`DataArea/ProductAvailability[i]/FulfillmentCenterInventory[m]/QuantityOnHand`	double	`QuantityOnHand_i_m`	Valeur de quantité en stock au niveau du centre de distribution.	N
`DataArea/ProductAvailability[i]/FulfillmentCenterInventory[m]/QuantityOnHand/@uom`	chaîne	`UOMOnHand_i_m`	Unité de mesure de la valeur de quantité.	N
`DataArea/ProductAvailability[i]/FulfillmentCenterInventory[m]/ExpectedInventory[n]/Quantity`	double	`QuantityExpected_i_m_n`	Quantité prévue au niveau du centre de distribution.	N
`DataArea/ProductAvailability[i]/FulfillmentCenterInventory[m]/ExpectedInventory[n]/Quantity/@uom`	chaîne	`UOMExpected_i_m_n`	Unité de mesure de la valeur de quantité.	N
`DataArea/ProductAvailability[i]/FulfillmentCenterInventory[m]/ExpectedInventory[n]/AvailableDateTime`	dateTime	`GlobalEstimatedAvailableDateTime` `_i_m_n`	Date de disponibilité estimée du stock prévu.	N

* Les préfixes d'espace de noms sont omis pour simplifier la présentation.

Exemples

Exemple de BOD SyncProductAvailability 1 - mettre en cache le niveau de stock d'un produit au niveau global
Exemple de BOD SyncProductAvailability 2 - mettre en cache le niveau de stock de produits au niveau du centre de distribution
Exemple de BOD SyncProductAvailability 3 - supprimer le niveau de stock d'un produit du cache

Réponse

Les réponses de ce service Web entrant ont la forme de documents BOD AcknowledgeOrder. Elles contiennent les informations suivantes :


XPath*	Type	Description
DataArea/BOD/BODSuccessMessage	-	Cet élément est présent si la demande a été traitée avec succès.

* Les préfixes d'espace de noms sont omis pour simplifier la présentation.

Exemples

Exemple de BOD ConfirmBOD 1 - réponse lorsque la mise à jour du cache de stock a réussi

Exceptions

Toutes les exceptions sont renvoyées sous forme de documents BOD ConfirmBOD avec un élément ResponseCriteria sous le verbe Confirm. Elles contiennent les informations suivantes :


XPath*	Type	Description
`DataArea/Confirm/ResponseCriteria/ChangeStatus/Code`	chaîne	L'identificateur de corrélation. Peut être utilisé pour identifier de manière unique une exception dans les journaux du serveur.
`DataArea/Confirm/ResponseCriteria/ChangeStatus/ReasonCode`	chaîne	Le code raison, qui est soit un HCL Commercecode d'erreur système HCL Commercecode d'erreur système plus un code d'erreur secondaire en option, si le code d'erreur système de HCL Commerce n'est pas disponible (ce qui est généralement le cas lorsque l'exception est émise par l'application).
`DataArea/Confirm/ResponseCriteria/ChangeStatus/Reason`	chaîne	Le message de l'exception.

* Les préfixes d'espace de noms sont omis pour simplifier la présentation.

Exemples

Exemple de BOD ConfirmBOD 2 - réponse avec exception lorsqu'il manque un paramètre obligatoire.

Remarque : Les attributs releaseID et versionID doivent être à blanc lorsque le service de mise à jour du cache de stock est appelé. Ignorez ceux qui sont renvoyés dans le BOD de réponse.