Befehl 'ReturnItemUpdate'
Dieser Befehl aktualisiert die Informationen über einen zurückgegebenen Artikel und
kann für mehrere Artikel einer Artikelrückgabeberechtigung (RMA) aufgerufen werden.

Parameterwerte
- http://host_name/pfad/
- (Obligatorisch) Der vollständig qualifizierte Name Ihres WebSphere Commerce Servers und der Konfigurationspfad.
- langId
- Setzt die bevorzugte Sprache für die Dauer der Sitzung oder setzt die bevorzugte
Sprache zurück; die unterstützten Sprachen sind in der Tabelle
STORELANG enthalten.
- storeId
- (Obligatorisch) Die Referenznummer des Geschäfts.
- forUser
- Die Anmelde-ID des Benutzers in dessen Namen der Befehl ausgeführt wird;
nur eine Person mit der Berechtigung, Bestellungen verarbeiten zu können,
kann diesen Parameter angeben.
- forUserId
- Die Anmelde-ID des Benutzers in dessen Namen der Befehl ausgeführt wird;
nur eine Person mit dem Sicherheitsaufgabenbereich
eines Kundendienstmitarbeiters kann diesen Parameter angeben. Der Benutzer
wird mit einer internen Benutzer-ID identifiziert,
wie in der Tabelle USERS angegeben.
- creditAdjustment_i
- Der Betrag, um den der Gutschriftsbetrag für das Produkt anzupassen ist. Das Format
dieser Zahl muss mit den Regeln für ein java.math.BigDecimal-Objekt übereinstimmen. Als
Dezimalzeichen muss ein Punkt verwendet werden. Dieser Betrag überschreibt eventuell vom
Task-Befehl CalculateReturnItemAdjustmentCmd
berechnete Beträge. Der Parameter
ist optional und nur dann gültig, wenn entweder der Parameter forUser oder der
Parameter forUserId angegeben wird.
- receive_i
- Gibt an, ob die Komponenten des Artikels an das Geschäft zurückgegeben werden sollen. Verdorbene Lebensmittel beispielsweise
müssen nicht an das Geschäft zurückgegeben werden, wohl aber ein Pullover.
- RMAItemId_i
- (Obligatorisch) Die RMAItem-Kennung.
- quantity_i
- Die zurückgegebene Menge.
- UOM_i
- Die Maßeinheit für quantity_i. Dieser Wert muss mit einem der primären
Schlüssel in der Tabelle QTYUNIT übereinstimmen. Wenn
dieser Parameter nicht angegeben wird, wird der Wert der Spalte QUANTITYMEASURE
in der Tabelle CATENTSHIP
für die Zeile verwendet, deren CATENTRY_ID mit dem Bestellartikel übereinstimmt, und
der Wert des Parameters quantity_i wird mit der Spalte NOMINALQUANTITY derselben Zeile
in der Tabelle CATENTSHIP multipliziert.
- comment_i
- Ein Kommentar zum zurückgegebenen Artikel.
- reason_i
- Der vom Käufer angegebene Grund für die Rückgabe. Dieser Wert
kann der Spalte CODE von Tabelle RTNREASON
mit dem Ursachentyp in 'B' oder 'C' entnommen werden.
- URL
- (Obligatorisch) Die URL-Adresse, die nach der erfolgreichen Ausführung des
Befehls aufgerufen werden soll.
- outRMAName
- Der Name für das Name/Wert-Paar, das an die umgeleitete URL übermittelt wird. Dieser
Parameter ist beim Verketten von Befehlen von Nutzen. Wenn dieser Parameter nicht angegeben
wird, wird "RMAId" verwendet.
Beispiel
Im folgenden Beispiel wird der RMA-Artikel 123 auf die Rückgabemenge 2 und der
RMA-Artikel 456 auf die Rückgabemenge 3 aktualisiert. Bei erfolgreicher
Ausführung wird die RMA angezeigt.
http://myhostname/webapp/wcs/stores/servlet/ReturnItemUpdate?RMAItemId_1=123&RMAItemId_2=456
&quantity_1=1&quantity_2=3&URL=ReturnDisplay&storeId=1
Verhalten
- Aktualisiert einen zurückgegebenen Artikel und kann für mehrere RMA-Artikel
aufgerufen werden. Wenn dieser Befehl mit mehreren RMA-Artikeln aufgerufen wird,
müssen alle RMA-Artikel zur selben RMA gehören.
- Die Markierung PREPARED der RMA wird auf 'N' gesetzt. Wenn der Parameter forUser oder
der Parameter forUserId angegeben wird,
muss die RMA zunächst den Status 'EDT', 'PND' oder 'APP'
aufweisen und wird auf 'EDT' gesetzt.
Andernfalls muss die Artikelrückgabeberechtigung
zunächst den Status 'PRC' aufweisen, und der Status wird in 'PRC' geändert.
- Jeder Artikel wird wie folgt verarbeitet:
- Stellt sicher, dass die RMA-Artikel dem Kunden nicht bereits gutgeschrieben wurden.
- Aktualisiert den RMA-Artikel. Wenn der Parameter quantity oder receive
für einen Artikel angegeben wird, werden die Komponenten (in der
Tabelle RMAITEMCMP) aktualisiert.
- Wenn der zurückgegebene Artikel auf einem Bestellartikel (OrderItem) basiert, ruft
der Befehl den Task-Befehl CalculateReturnItemCreditCmd
zur Berechnung des standardmäßigen
Gutschriftsbetrags auf und legt den Gutschriftsbetrag für den RMA-Artikel fest.
- Wenn der zurückgegebene Artikel auf einem Katalogeintrag basiert,
ruft der Befehl den Task-Befehl CalculateReturnItemCreditForCatEntryCmd
auf.
- Ruft den Task-Befehl AutoApproveReturnItemCmd
auf, um festzustellen, ob der Artikel
automatisch genehmigt wurde, und markiert den RMA-Artikel je nach Ergebnis des Task-Befehls entweder als "vom System
genehmigt" oder als "Genehmigung anstehend".
- Bei erfolgreicher Ausführung wird die Umleitung an die angegebene URL vorbereitet.
- Ruft den Task-Befehl ExtendReturnItemUpdateCmd auf.
Ausnahmebedingungen
- Wenn der Status der RMA nicht auf 'PRC' gesetzt ist
(wenn der Parameter forUser oder forUserId verwendet wird) oder nicht auf
'EDT', 'PND' oder 'APP' gesetzt ist (wenn der Parameter forUser oder forUserId
nicht verwendet wird), wird die Ausnahmebedingung ECApplicationException mit der Nachricht
_ERR_RMA_IN_INVALID_STATE_FOR_COMMAND ausgegeben.
- Wenn ein RMA-Artikel nicht zur selben RMA gehört wie andere bereits verarbeitete
RMA-Artikel, wird die Ausnahmebedingung ECApplicationException mit der Nachricht
_ERR_BAD_MISSING_CMD_PARAMETER generiert.
- Wenn ein RMA-Artikel bereits gutgeschrieben wurde, wird die Ausnahmebedingung
ECApplicationException mit der Nachricht _ERR_BAD_MISSING_CMD_PARAMETER generiert.