Instruction OrderItemStatus
L'instruction OrderItemStatus est appelée en interne par les instructions OrderStatus, OrderConfirmStatus, OrderInvoiceStatus et OrderShippingStatus lorsqu'un message Update_WCS_OrderStatus, Update_NC_OrderStatus, ou Order Status Update est reçu en provenance d'un système principal. L'instruction met à jour les informations relatives au statut d'une commande existant déjà sur un article.
Paramètres
Vous trouverez ci-dessous la liste des paramètres relatifs à l'instruction. Chaque paramètre correspond à une zone de la table ORDISTAT :
- Gestion des versions : Chaîne "TRUE" ou "FALSE", facultatif, la valeur par défaut est
FALSE.
- Si la valeur est TRUE, la gestion des versions est activée.
- orderItemId : Type Integer
- Référence de commande WebSphere Commerce définie dans la colonne ORDERITMES_ID de la table ORDISTAT. Il s'agit d'une clé associée qui fait référence à la colonne ORDERITEMS_ID de la table ORDERITEMS.
- merchantItemNumber : Type String
- Référence d'article de commande générée dans le système dorsal, définie dans la colonne
OIMITEM.
- PartNumber : Type String
- Numéro de référence du produit (ou SKU), défini à la colonne PARTNUMBER.
- UnitOfMeasure : Type String
- Unité de mesure pour l'article, définie à la colonne OIUOFM.
- RequestQuantity : Type integer
- Quantité d'articles demandés, définie à la colonne OIQTREQUEST.
- ConfirmQuantity : Type Integer
- Quantité d'articles confirmés, définie à la colonne OIQTCONFIRM.
- ShipQuantity : Type Integer
- Quantité d'articles expédiés, définie à la colonne OIQTSHIP.
- Currency : Type String
- Type de devise ISO 4217 dans laquelle est exprimé le prix,
défini dans la colonne OICPCUR.
- UnitPrice : Type BigDecimal(20,4)
- Prix unitaire du produit, défini dans la colonne OIUNPRC.
- PriceTotal : Type BigDecimal(20,4)
- Prix de vente total du produit, défini dans la colonne
OIPRTOT.
- TaxTotal : Type BigDecimal(20,4)
- Total des taxes pour l'article, défini dans la colonne OITXTOT.
- ShippingTotal : Type BigDecimal(20,4)
- Total des frais de port pour l'article, défini dans la colonne OISHTOT.
- ShippingTaxTotal : Type BigDecimal(20,4)
- Total des taxes afférentes aux frais de port pour la commande, défini
dans la colonne OISHTXTOT.
- Status : Type String
- Etat de l'article, défini dans la colonne OISTATUS.
- PlaceDateTime : Type Timestamp
- Date à laquelle l'article est effectivement commandé, définie dans la colonne OIPLTIME.
- RequestShipDateTime : Type Timestamp
- Date à laquelle l'expédition de l'article est demandée, définie dans la colonne
OIRSTIME.
- ScheduleShipDateTime : Type Timestamp
- Date à laquelle l'expédition de l'article est planifiée, définie dans la colonne
OISSTIME.
- ActualShipDateTime : Type Timestamp
- Date à laquelle l'article est réellement expédié, définie dans la colonne OIASTIME.
- InvoiceDateTime : Type Timestamp
- Date à laquelle l'article est facturé, définie dans la colonne OIINVTIME.
- InvoiceValue : Type BigDecimal(20,4)
- Valeur nette de facturation de l'article, définie dans la colonne OIINVVAL.
- itemShipCondition : Type String
- Code indiquant si la livraison partielle de la commande est acceptée,
défini dans la colonne OISCOND. 'SC' : Ship Complete (livraison complète), 'SP':
Ship Partial (livraison partielle).
- itemComment : Type String
- Commentaires concernant l'état de l'article, définis dans la colonne OICMNT.
- field1 : Type Integer
- Zone 1 de personnalisation de l'état de l'article, définie dans la colonne FIELD1.
- field2 : Type BigDecimal(15,2)
- Zone 2 de personnalisation de l'état de l'article, définie dans la colonne FIELD2.
- field3 : Type String
- Zone 3 de personnalisation de l'état de l'article, définie dans la colonne FIELD3.
Comportement
- Le premier état de la commande d'un article doit indiquer les valeurs orderItemId et merchantItemNumber.
- Vérifiez si l'article commandé dans orderItemId existe dans la table ORDERITEMS.
- Dans chaque état successif d'une commande présentant déjà une entrée dans la table ORDISTAT, la valeur orderItemId n'est pas requise pour permettre la création d'un nouvel article par le système principal pour un article existant.
- Créez ou mettez à jour une ligne dans la table ORDISTAT à l'aide de l'information fournie.
- Si la gestion des versions est activée et s'il s'agit du premier état de la commande d'un article, une nouvelle ligne sera créée dans la table ORDISTAT. Dans le cas contraire, une copie du dernier état de la commande d'un article sera faite et sa version (OIVERNBR) sera définie en fonction du nombre maximal de versions +1. Une nouvelle ligne sera créée qui contiendra toutes les informations fournies et dont le numéro de version (OIVERNBR) sera 0.
Conditions d'exception
- La valeur ID de la commande indiquée n'est pas une référence de commande valide dans la table ORDERITEMS.
- La valeur ID de la commande ou la référence de l'article pour le commerçant n'est pas indiquée dans le premier état de la commande d'article d'un article commandé.
- Les valeurs ID de la commande et référence de l'article pour le commerçant ne correspondent pas à celles figurant déjà dans la table ORDISTAT pour un article commandé au cours d'une mise à jour consécutive de l'état de la commande d'un article.