URL OrderCancel

Annulez la commande spécifiée en modifiant son statut de commande, en annulant toute allocation de stock et en annulant tout article commandé en amont. Cette URL ne supprime pas la commande de la base de données. OrderCancel peut annuler les commandes avec un statut de commande de A, B, C, I, L, M, N.

Structure de l'adresse URL

http:// host_name/ path/: Nom entièrement qualifié de votre Transaction server et du chemin de configuration.

Ce diagramme affiche la structure de l'adresse URL OrderCancel.

Valeurs des paramètres

langId

Définit ou redéfinit la langue préférée pour la durée de la session. Les langues prises en charge pour un magasin sont répertoriées dans la table STORELANG.

forUser

ID de connexion de l'utilisateur pour lequel est exécutée l'instruction.

forUserId

Identique à forUser, mais identifiant l'utilisateur par son ID interne, répertorié dans la table USERS.

URL

Obligatoire : Adresse URL à appeler une fois que la commande a abouti.

storeId

Magasin associé à la commande.

orderId

Obligatoire : Numéro de référence de la commande à annuler.

forcedCancel

Facultatif : Ce paramètre est utilisé pour annuler une commande qui a déposé le paiement. S'il y a des transactions de dépôt pour une commande, la commande ne peut être annulée que si le paramètre est défini sur forcedCancel=true. La valeur par défaut est false.

forcedCancelWithRefund

Facultatif : Ce paramètre est utilisé pour effectuer le remboursement du paiement lors de l'annulation d'une commande. Les conditions préalables à ce paramètre sont les suivantes :

Il doit y avoir des transactions de paiement déposées dans la commande avant l'annulation de la commande.
Le paramètre forcedCancel doit être défini sur true.

Si ces conditions préalables existent, le paiement est remboursé avec le mode de paiement d'origine. La valeur par défaut du paramètre forcedCancelWithRefund est false.

Exemple

L'exemple suivant annule une commande avec un numéro de référence de 1 et affiche le panier.

 http://myhostname/webapp/wcs/stores/servlet/OrderCancel? orderId=1&URL=/webapp/commerce/InterestItemDisplay

Comportement

Vérifie si la commande existe et si son attribut de statut spécifie A, B, C, I, L, M, N ou W. Si ce n'est pas le cas, renvoie une erreur.
Annule la commande spécifiée en remplaçant son statut de commande par X.
Annule l'attribution du stock existant et prévu en appelant l'instruction de tâche AllocateInventory et en spécifiant tous les articles de commande de la commande dans le paramètre reverseOrderItems.
Annule le paiement.
S'il y a une requête d'approbation de commande en attente pour un client B2B, cette URL l'annule.
Si la commande a déposé des paiements et que le paramètre forcedCancel est true, la commande est annulée et aucune action de remboursement du paiement n'est déclenchée. Si la commande a déposé des paiements et que les deux paramètres forcedCancel et forcedCancelWithRefund sont true, la commande est annulée et l'action de remboursement du paiement est effectuée.

Conditions d'exception

Si l'ID de commande spécifié n'est pas valide ou si le statut de commande n'est pas A, B, C, I, L, M, N ou W, aucun traitement ne se produit et l'exécution de la commande échoue.