Befehl 'ReturnPrepare'
Dieser Befehl bereitet eine Artikelrückgabeberechtigung (RMA) vor, indem er die die zu erstattenden Steuern berechnet,
den Gesamtbetrag der Erstattung ermittelt, eine Gutschriftsmethode und eine Rückgabemethode bestimmt und
ein Fulfillment-Center für die Rückgabe festlegt .

Parameterwerte
- http://host_name/pfad/
- (Obligatorisch) Der vollständig qualifizierte Name Ihres WebSphere Commerce Servers und der Konfigurationspfad.
- 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
- Identisch mit "forUser"; hier wird jedoch der Benutzer mit
einer internen Benutzer-ID identifiziert, wie in der Tabelle
USERS angegeben.
- 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.
- RMAId
- (Obligatorisch) Die vorzubereitende RMA-Kennung.
- comment
- Ein Kommentar zur RMA.
- URL
- (Obligatorisch) Die URL-Adresse, die nach der erfolgreichen Ausführung des
Befehls aufgerufen werden soll.
Beispiel
In diesem Beispiel wird die RMA mit der Referenznummer 1 vorbereitet, und
zum Anzeigen dieser RMA erfolgt eine Umleitung zum Befehl ReturnDisplay.
http://myhostname/webapp/wcs/stores/servlet/ReturnPrepare?RMAId=1
&storeId=1&URL=ReturnDisplay
Verhalten
- Prüft, ob die RMA existiert. Ist dies nicht der Fall, wird ein Fehler zurückgegeben.
- Ruft den Task-Befehl RefreshExpiredRMAItemsCmd auf, um zu bestimmen, ob der Zeitrahmen
RMAGOODFOR für jeden RMA-Artikel abgelaufen ist.
Die
Gutschriftberechnung und die automatische Genehmigung werden für die Artikel erneut aufgerufen,
deren Haltbarkeitsdauer abgelaufen ist.
- Ruft den Task-Befehl CalculateReturnAdjustmentPolicyCmd
zur Berechnung der gemäß der Richtlinie bei der RMA anfallenden Spesen und Gutschriften
auf.
- Ruft den Task-Befehl CalculateReturnTaxCmd zur Berechnung der Steuern auf.
- Berechnet alle Summen, d. h. die Gesamtgutschrift in der RMA und die
Gesamtgutschrift in der Rückgabe.
- Wenn die Gesamtgutschrift der RMA größer als null ist, wird der Task-Befehl
DetermineReturnCreditVehicleCmd aufgerufen, um die Gutschriftsmethode für den Kunden
zu bestimmen, und der Wert wird in der RMA festgelegt. Wenn der Task-Befehl keine
Gutschriftsmethode bestimmen kann, wird ein Fehler zurückgegeben.
- Wenn Artikelkomponenten der Rückgabe als empfangen markiert sind, wird der Task-Befehl
ResolveReturnFulfillmentCenterCmd
aufgerufen, um ein Fulfillment-Center für die RMA
zu bestimmen, und der Wert wird in der RMA festgelegt. Andernfalls wird RMA.Ffmctr_id auf null gesetzt.
- Markiert die RMA als vorbereitet.
- Ruft den Task-Befehl ExtendReturnPrepareCmd auf.
- Nach erfolgreichem Abschluss wird die
angegebene URL-Adresse aufgerufen.
Ausnahmebedingungen
- Wenn die angegebene RMAId ungültig ist oder nicht den korrekten Status aufweist,
wird die Ausnahmebedingung ECApplicationException mit der Nachricht
_ERR_RMA_IN_INVALID_STATE_FOR_COMMAND ausgegeben.
- Wenn in der RMA keine Handels-ID angegeben ist, wird die Ausnahmebedingung
ECApplicationException mit der Nachricht message _ERR_BAD_MISSING_CMD_PARAMETER ausgegeben.
- Wenn keine Gutschriftsmethode bestimmt werden kann, wird die Ausnahmebedingung
ECSystemException mit der Nachricht _ERR_CANNOT_DETERMINE_CREDIT_VEHICLE ausgegeben.
- Wenn kein Fulfillment-Center für die Rückgabe festgelegt werden kann, wird die
Ausnahmebedingung ECSystemException mit der Nachricht _ERR_CANNOT_DETERMINE_RETURN_FFMCENTER ausgegeben.