Instruction OrderProcess

Cette instruction transmet une commande. La commande doit avoir été verrouillée par OrderPrepare. Lorsque l'instruction OrderProcess est lancée, la commande ne peut plus être annulée par OrderCancel.  

proproce.gif (7483 octets)

Valeurs des paramètres

http://host_name/path/
(Obligatoire) Nom qualifié complet de votre serveur WebSphere Commerce Server et chemin de configuration.
forUser
ID de connexion de l'utilisateur au nom duquel l'instruction est exécutée. Seule une personne disposant des droits de traitement des commandes peut spécifier ce paramètre.
forUserId
Identique à forUser, mais identifie l'utilisateur par l'ID d'utilisateur interne, tel qu'il est indiqué dans la table USERS.
langId
Définit ou restaure la langue préférée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG.
storeId
Référence du magasin concerné par l'instruction. Cette valeur est ignorée si aucune erreur ne se produit pendant le traitement de la commande. Elle n'est alors utilisée que pour lancer le gestionnaire d'exception du magasin approprié.
orderId
(Obligatoire) numéro de référence de la commande.
billtoAddressId
Numéro de référence de l'adresse de facturation.
field1, field2 et field3
Zones personnalisables
notifyMerchant
Indique si le magasin doit avoir notification de la fin du traitement de la commande.
1=Oui
0=Non
notifyShopper
Indique si le client doit avoir notification de la fin du traitement de la commande.
1=Oui
0=Non
quoteExpiredURL
Spécifie l'URL de réacheminement si le total de la commande a expiré conformément aux modalités d'expiration spécifiées par le paramètre quoteExpiryPolicy
quoteExpiryPolicy
Définit le comportement de l'instruction si le total de la commande expire ou si le centre de distribution d'un article de commande change pendant l'attribution de stock. C'est le cas lorsque l'heure actuelle est supérieure ou égale à l'horodatage de la dernière mise à jour de la commande majoré du nombre de secondes spécifié dans la colonne QUOTEGOODFOR de la table STORE. Ce paramètre peut avoir trois valeurs :
notifyOrderSubmitted
Indique si le client doit être averti lorsque la commande a bien été transmise pour traitement.
1
=Oui
0=Non (par défaut)
availabilityChangeURL
Indique l'URL de réacheminement lorsque l'heure de disponibilité et le délai de livraison prévus pour un article de commande ont dépassé (à la suite d'attribution de stock ou de stock en amont) la variation spécifiée dans le paramètre maxAvailabilityChange. Ce paramètre est ignoré si l'attribution de stock n'est pas activée.
maxAvailabilityChange
Indique l'intervalle de temps, en secondes, mentionné dans la description du paramètre availabilityChangeURL. La valeur par défaut est 3600 (une heure). Ce paramètre est ignoré si le paramètre availabilityChangeURL n'est pas précisé, ou si l'attribution de stock ATP n'est pas activée.
noInventoryURL
Indique l'URL de réacheminement lorsqu'un des articles de la commande ne peut être attribué ou mis en amont. Ce paramètre est ignoré si l'attribution de stock n'est pas activée.
tcId
Identificateur des modalités (voir la table TERMCOND). Si cet ID est indiqué et qu'il identifie un PaymentTC, et si ce PaymentTC indique les valeurs memberId et address nickName (reportez-vous à la rubrique consacrée au mappage de PaymentTC), les valeurs memberId et address nickName sont utilisées pour déterminer l'adresse de facturation, auquel cas le paramètre billToAddressId est ignoré.

Remarques à propos des paiements
L'instruction OrderProcess ne gère pas seule les paiements. Pour cela, utilisez la classe d'interface DoPaymentCmd, implémentée par l'instruction d'activité DoPayment. Les paramètres qui sont affectés de l'instruction OrderProcess à cette instruction peuvent être quelconques, bien que généralement ils mettraient en application les informations relatives aux cartes de crédit.

WebSphere Commerce fournit deux classes d'implémentation de l'instruction OH , les classes DoPaymentCmdImpl et DoPaymentMPFCmdImpl. La classe DoPaymentCmdImpl est un exemple d'implémentation permettant d'afficher le mode d'écriture de l'implémentation de l'instruction d'activité DoPayment qui fonctionne avec l'instruction OrderProcess. La classe DoPaymentMPFCmdImpl est la classe d'implémentation standard conçue pour être utilisée avec IBM WebSphere Payment Manager, version 3.1 et inclut une prise en charge des fonctions de commerce interentreprises introduites par cette version de WebSphere Commerce Business Edition.

Remarques sur la notification des commandes

Si vous devez configurer la notification de commande, vous devrez :

  1. activer la fonction de messagerie sortante,
  2. créer des modèles de composition de messages afin de composer des messages de notification de commandes. 

Exemple 1
L'instruction ci-après traite le passage d'un commande dont le numéro de référence est 3.
    http://myhostname/webapp/wcs/stores/servlet/OrderProcess?orderId=3

Exemple 2
Si l'on suppose que Payment Manager a déjà été configuré, cette instruction affecte les informations relatives au paiement du client à Payment Manager. Le paramètre policyId=200 renvoie à la méthode OfflineCard utilisée par défaut par Payment Manager.
    http://myhostname/webapp/wcs/stores/servlet/OrderProcess?storeId=34
    &orderId=556677&policy=200&cardBrand=Visa
    &cardNumber=41111111111111111&cardExpiryMonth=12&cardExpiryYear=2001

Remarque : le paramètre payMethodId est uniquement pris en charge pour la comptabilité en amont. Pour les nouvelles cassettes Payment Manager et les nouvelles fonctions de commerce interentreprises, utilisez plutôt le paramètre policyId (comme dans l'exemple 2). Pour voir une liste de règles de paiement définies, reportez-vous au lien connexe ci-dessous.

La classe DoPaymentMPFCmdImpl prend en charge un autre paramètre appelé tcId, utilisé pour préciser l'ID des modalités de paiement à utiliser pour une commande. Les modalités doivent faire partie des modalités de paiement courantes précisées dans les contrats associés aux articles commandés. Pour vous assister dans la sélection d'un fichier JSP de modalités de paiement courantes, utilisez UsablePaymentTCListDataBean. Le paramètre tcId est obligatoire si les contrats utilisés pour les OrderItems est associé à des modalités de paiement.

Comportement

Conditions d'exception

Rubriques connexes

Référence connexe

IBM copyright