Befehl 'OrderItemStatus'
Der Befehl 'OrderItemStatus' wird intern durch die
Befehle 'OrderStatus', 'OrderConfirmStatus',
'OrderInvoiceStatus' und
'OrderShippingStatus' aufgerufen, wenn eine Nachricht
'Update_WCS_OrderStatus',
'Update_NC_OrderStatus' oder 'Aktualisierung des Bestellstatus' von
einem Back-End-System empfangen wird. Der Befehl aktualisiert Informationen über den Status einer
vorhandenen Bestellung für einen Artikel.
Parameter
Die folggende Liste enthält die Parameter für den Befehl. Jeder
Parameter entspricht einem Feld in der Tabelle
ORDISTAT:
- versioning: String "TRUE" oder "FALSE". Optional, Standardwert ist
FALSE.
- Bei TRUE wird das Versioning aktiviert.
- orderItemId: Integer
- Die WebSphere Commerce-Bestellartikelreferenznummer, wie in Spalte ORDERITMES_ID
der Tabelle ORDISTAT definiert. Dies
ist ein Fremdschlüssel, der auf Spalte
ORDERITEMS in Tabelle ORDERITEMS verweist.
- merchantItemNumber: String
- Die im Back-End-System generierte Bestellartikelnummer, wie in der Spalte OIMITEM definiert.
- PartNumber: String
- Artikelnummer, wie in der Spalte PARTNUMBER definiert.
- UnitOfMeasure: String
- Maßeinheit für den Artikel, wie in der Spalte OIUOFM definiert.
- RequestQuantity: Integer
- Menge der angeforderten Artikel, wie in der Spalte OIQTREQUEST definiert.
- ConfirmQuantity: Integer
- Menge der bestätigten Artikel, wie in der Spalte OIQTCONFIRM definiert.
- ShipQuantity: Integer
- Menge der versendeten Artikel, wie in der Spalte OIQTSHIP definiert.
- Currency: String
- Die Art der Währung, in der die Preisangabe erfolgt, als
ISO 4217-Code, wie in der Spalte OICPCUR definiert.
- UnitPrice: BigDecimal(20,4)
- Der Einheiten- oder Stückpreis des Produkts, wie in der Spalte OIUNPRC definiert.
- PriceTotal: BigDecimal(20,4)
- Der Gesamtproduktpreis des Artikels, wie in der Spalte OIPRTOT definiert.
- TaxTotal: BigDecimal(20,4)
- Der Steuergesamtbetrag für den Artikel, wie in der Spalte
OITXTOT definiert.
- ShippingTotal: BigDecimal(20,4)
- Der Gesamtbetrag der Versandspesen für den Artikel, wie in
der Spalte OISHTOT definiert.
- ShippingTaxTotal: BigDecimal(20,4)
- Der Steuergesamtbetrag auf die Versandspesen für
den Artikel, wie in der Spalte OISHTXTOT definiert.
- Status: String
- Der Status des Artikels, wie in der Spalte OISTATUS definiert.
- PlaceDateTime: Timestamp
- Tatsächliches Aufgabedatum der
Artikelbestellung, wie in der Spalte OIPLTIME definiert.
- RequestShipDateTime: Timestamp
- Vorgesehenes Datum und vorgesehene Uhrzeit für den Versand des
Artikels, wie in der Spalte OIRSTIME definiert.
- ScheduleShipDateTime: Timestamp
- Vorgesehenes Datum und vorgesehene Uhrzeit für den Versand des
Artikels, wie in der Spalte OISSTIME definiert.
- ActualShipDateTime: Timestamp
- Tatsächliches Versanddatum des
Artikels, wie in der Spalte OIASTIME definiert.
- InvoiceDateTime: Timestamp
- Tatsächliches Datum, an dem der Artikel
in Rechnung gestellt wird, wie in der Spalte OIINVTIME definiert.
- InvoiceValue: BigDecimal(20,4)
- Der Nettobetrag, mit dem der Artikel
in Rechnung gestellt wird, wie in der Spalte OIINVVAL definiert.
- itemShipCondition: String
- Code, um kennzuzeichnen, ob ein Teilversand des Artikels
akzeptiert wird, wie in der Spalte
OISCOND definiert. 'SC': Versand vollständig (Ship Complete), 'SP':
Teilversand (Ship Partial).
- itemComment: String
- Kommentare zum Artikelstatus, wie in der
Spalte OICMNT definiert.
- field1: Integer
- Angepasstes Preisfeld 1 zum Artikelstatus, wie in der Spalte FIELD1 definiert.
- field2: BigDecimal(15,2)
- Angepasstes Preisfeld 2 zum Artikelstatus, wie in der Spalte FIELD2 definiert.
- field3: String
- Angepasstes Preisfeld 3 zum Artikelstatus, wie in der Spalte FIELD3 definiert.
Verhalten
- Für den ersten Bestellartikelstatus einer Bestellung
muss orderItemId
und merchantItemNumber angegeben sein.
- Es wird geprüft, ob der in orderItemId angegebene
Bestellartikel in der Tabelle
ORDERITEMS vorhanden ist.
- Bei jedem nachfolgenden Bestellartikelstatus, für
den bereits ein Eintrag in der Tabelle ORDISTAT vorhanden
ist, ist
orderItemId nicht erforderlich, damit durch das Back-End-System eine
neue Einzelposition
für eine vorhandene Einzelposition erstellt
werden kann.
- Mit den bereitgestellten Informationen wird eine Zeile in der
Tabelle ORDISTAT erstellt oder aktualisiert.
- Wenn das Versioning aktiviert ist und es sich um den ersten
Bestellartikelstatus für die Bestellung handelt, wird in der
Tabelle ORDISTAT eine neue Zeile erstellt. Andernfalls der letzte Bestellartikelstatus
kopiert und seine Version (OIVERNBR) auf den Maximalwert der
vorhandenen Versionen + 1 gesetzt. Es wird eine neue Zeile erstellt,
die alle bereitgestellten Informationen enthält und deren Version
(OIVERNBR) auf 0 gesetzt ist.
Ausnahmebedingungen
- Die angegebene orderItemId ist keine gültige Bestellnummer in
der Tabelle
ORDERITEMS.
- Entweder orderItemId oder merchantItemNumber ist nicht im
ersten Bestellartikelstatus für einen bestimmten Bestellartikel
angegeben.
- Bei einer nachfolgenden Aktualisierung für den
Bestellartikelstatus stimmen orderItemId und
merchantItemNumber nicht mit dem Wert
überein, der in der Tabelle ORDISTAT für einen bestimmten
Bestellartikel angegeben ist.