Dokumentation zur Rakuten Shop-API


setOrderReturned

Diese Methode trägt eine Retoure für eine Bestellung ein.

Mit dieser URL rufen Sie die API-Methode auf:

Authentifizierung

Für diese Methode ist eine Authentifizierung mit Schreibrechten erforderlich.
Empfohlen wird der Aufruf über HTTP-POST.

Parameter

Die mit * gekennzeichneten Parameter müssen übergeben werden.

key *

Authentifizierungs-Schlüssel

Datentyp: String
order_no *

Die Bestell-Nr der Bestellung, zu der die Retoure eingetragen werden soll.

Datentyp: String
Regeln: Das Format der Bestell-Nr. ist XXX-XXX-XXX.
type *

Retouren-Typ, entweder eine vollständige oder eine teilweise Retoure. Nach einer teilweisen Retoure ist keine vollständige Retoure mehr möglich.

Datentyp: String
Regeln: Für eine vollständige Retoure 'fully', sonst 'partly'
item_id

Die konkrete ID der Bestell-Position in der Bestellung. Diese kann über die Methode get_orders abgerufen werden.

Datentyp: Integer
Regeln: Eine ID der Bestell-Position, die zu dieser Bestellung gehört.
repay_shipping_costs

Entscheidet, ob die Versandkosten der Hinsendung komplett erstattet werden sollen.

Datentyp: Boolean
Regeln: Gibt an, ob Versandkosten zurückgezahlt werden sollen. Wird nicht beachtet, falls die Versandkosten schon vollständig zurückgezahlt wurden.
repay_return_costs

Die dem Kunden zu erstattenden Rücksendekosten

Datentyp: Float
Regeln: Betrag der Rücksendekosten, die erstattet werden sollen.
deterioration

Angabe der Wertminderung, falls Artikel in verschlechterten Zustand zurückgesendet wurden.

Datentyp: Float
Regeln: Betrag der Wertminderung darf den Wert der/des retournierten Artikel/s nicht übersteigen.

Antwort

Beispiel im XML-Format.

<?xml version="1.0" encoding="utf-8"?>
<result>
   <success>1</success>
</result>
Element Datentyp Bedeutung
result Container Container mit angeforderten Daten
success Boolean Kennzeichen für einen erfolgreichen Aufruf
1 = erfolgreich
-1 = fehlerhaft


Fehlermeldungen



Code Bedeutung
4605 Die Bestellung konnte nicht gefunden werden.
4610 Die Bestellung wurde noch nicht versendet, eine Retoure ist nicht möglich.
4615 Bitte geben Sie für die Teilretouren eine item_id an.
4620 Es wurde bereits eine Teilretoure eingetragen, eine vollständige Retoure ist nicht mehr möglich.
4625 Es konnten keine Produkte gefunden werden, die noch retourniert werden können.
4630 Der Wert der Retoure ist kleiner oder gleich 0.
4635 Es ist ein Fehler bei der Bearbeitung der Retoure aufgetreten. Die Retoure konnte nicht angelegt werden.
4640 Retouren sind nur innerhalb eines Zeitraums von 30 Tagen nach dem Versand der Bestellung möglich.