Befehl 'ReturnProcess'
Dieser Befehl bestimmt den Genehmigungsstatus einer RMA (Return Merchandise
Authorization, Berechtigung für Warenrückgabe)
auf der Basis
des Status der Rückgabeartikel. Wenn die RMA genehmigt wurde, leitet der Befehl
an die URL um, die über den URL-Wert angegeben wurde. Wenn die RMA nicht
genehmigt wurde, leitet der Befehl an den Wert URL2 um. Wenn die RMA abgelaufen ist
und eine Ablauf-URL angegeben wurde, leitet der Befehl an den Wert RMAExpiryURL um.
Dieser Befehl sollte nach der Vorbereitung der RMA ausgeführt werden (indem der
Befehl ReturnPrepare ausgeführt wird). Dieser Befehl
hat in etwa die Funktion, die RMA "fertig zu stellen".

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 zu verarbeitende RMA-Kennung.
- URL
- (Obligatorisch) Die URL, an die umgeleitet werden soll, wenn die RMA genehmigt wird.
- URL2
- Die URL, an die umgeleitet werden soll, wenn die RMA nicht genehmigt wird. Wenn
keine URL angegeben wird, wird der für den Parameter 'URL' angegebene Wert verwendet.
- refundPolicyId
- Die ID der Richtlinien, die für die Erstattungszahlungsmethode anzuwenden ist. Dieser
Parameter ist optional, wenn der Vertrag nur eine Erstattungszahlungsmethode enthält.
Andernfalls muss beim ersten Aufrufen des Befehls ein Wert angegeben werden.
- RMAExpiryURL
- Die URL, an die umgeleitet werden soll, wenn die RMA abgelaufen ist. Wenn diese
URL angegeben wird und RMGOODFOR abgelaufen ist, wird der Befehl ReturnPrepareCmd
aufgerufen und es erfolgt eine Umleitung an diese URL. Wenn die URL nicht angegeben wird,
wird der Befehl ReturnProcessCmd auch dann ausgeführt, wenn ReturnPrepareCmd aufgerufen wird,
weil der Zeitrahmen RMGOODFOR für den RMA abgelaufen ist.
Beispiel 1
Der folgende Befehl verarbeitet eine Bestellung unter Verwendung von zwei Umleitungs-URLs.
http://myhostname/webapp/wcs/stores/servlet/ReturnProcess?RMAId=1&storeId=1
&URL=ReturnDisplay&URL2=ReturnListDisplay
Verhalten
- Überprüft, ob die RMA existiert. Ist dies nicht der Fall, wird ein Fehler zurückgegeben.
- Überprüft, ob eine Erstattungsrichtlinie angegeben wurde, und zwar entweder
beim Aufrufen des Befehls oder vorab, oder weil nur eine Auswahlmöglichkeit besteht. Ist dies nicht der Fall, wird ein Fehler zurückgegeben.
- Überprüft, ob die RMA vorbereitet wurde. Ist dies nicht der Fall, wird eine
Ausnahmebedingung zurückgegeben.
- Ruft den Task-Befehl RePrepareExpiredRMACmd auf, um zu prüfen, ob der Zeitrahmen
RMAGOODFOR für jeden Rückgabeartikel abgelaufen ist. Wenn dies der Fall ist, wird der
Befehl ReturnPrepare aufgerufen und es erfolgt eine Umleitung an die RMAExpiryURL,
sofern angegeben. Wenn der Parameter RMAExpiryURL nicht angegeben wird, wird der
Befehl ReturnProcess normal ausgeführt.
- Ruft den Task-Befehl CalculateRMAApprovalCmd
zur Berechnung des Gesamtstatus der RMA auf. Wenn die RMA genehmigt wurde, markiert sie der Befehl als genehmigt. Er protokolliert
den Genehmigungshinweis und leitet an die angegebene URL um. Wenn die RMA nicht genehmigt wurde, markiert sie der Befehl als anstehend. In diesem
Fall leitet der Befehl an URL2 um.
Ausnahmebedingungen
Wenn die folgenden Bedingungen vorliegen, schlägt die Befehlsausführung fehl:
- Wenn die angegebene RMAId ungültig ist oder nicht den korrekten Status aufweist,
wenn sie z. B. nicht vorbereitet wurde, wird die Ausnahmebedingung ECApplicationException mit der Nachricht
_ERR_RMA_IN_INVALID_STATE_FOR_COMMAND ausgegeben.
- Wenn keine Erstattungsrichtlinie angegeben wurde oder wenn die angegebene Richtlinie
für die RMA nicht gültig ist, wird die Ausnahmebedingung ECApplicationException
mit der Nachricht _ERR_BAD_MISSING_CMD_PARAMETER ausgegeben.