Auf dieser Seite finden Sie Informationen dazu, wie Sie Ihre Online-Rückgabebedingungen aufrufen können.
Die Merchant API unterstützt die folgenden Methoden zum Abrufen von Online-Rückgaberichtlinien:
- accounts.onlineReturnPolicies.get
- accounts.onlineReturnPolicies.list
- accounts.onlineReturnPolicies.create
Es empfiehlt sich, dafür zu sorgen, dass alle Besucher Ihrer Website Ihre Rückgabebedingungen problemlos aufrufen können – ohne Anmeldung, Registrierung oder Angabe personenbezogener Daten. Achten Sie außerdem darauf, dass die Rückgabebedingungen im Merchant Center und auf Ihrer Website einheitlich sind.
Vorhandene Online-Rückgabebedingungen abrufen
Wenn Sie eine vorhandene Online-Rückgaberichtlinie abrufen möchten, verwenden Sie die Methode accounts.onlineReturnPolicies.get.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}
Nachdem die Anfrage erfolgreich war, enthält die Antwort die Ressource OnlineReturnPolicy, wie im folgenden Beispiel gezeigt:
{
"onlineReturnPolicies": [
{
"returnPolicyId": "ONLINE_RETURN_POLICY_ID",
"label": "default",
"countries": [
"COUNTRY_CODE"
],
"policy": {
"type": "NO_RETURNS"
},
"restockingFee": {
"fixedFee": {
"amountMicros": "0",
"currencyCode": "USD"
}
},
"returnPolicyUri": "RETURN_POLICY_URI"
}
]
}
Der Wert NO_RETURNS gibt an, dass Rückgaben für das angegebene Land nicht unterstützt werden.
Das Feld restockingFee im Antworttext stellt die Gebühr für das Wiederauffüllen des Lagerbestands dar. Sie kann ein Pauschalbetrag oder ein Prozentsatz des Artikelpreises in Mikros sein.
Alle Online-Rückgabebedingungen auflisten
Wenn Sie alle Onlinerückgaberichtlinien auflisten möchten, verwenden Sie die Methode accounts.onlineReturnPolicies.list, wie in der folgenden Anfrage gezeigt:
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies
Nachdem die Anfrage erfolgreich war, enthält die Antwort alle vorhandenen Online-Rückgaberichtlinien für das Konto, wie in der folgenden Beispielantwort zu sehen ist:
{
"onlineReturnPolicies": [
{
"returnPolicyId": "7216992546",
"label": "default",
"countries": [
"IN"
],
"policy": {
"type": "NO_RETURNS"
},
"restockingFee": {
"fixedFee": {
"amountMicros": "0",
"currencyCode": "USD"
}
},
"returnPolicyUri": "http://example-pet-store.com/return"
},
{
"returnPolicyId": "7274318400",
"label": "default",
"countries": [
"GB"
],
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "15"
},
"restockingFee": {
"fixedFee": {
"amountMicros": "10000000",
"currencyCode": "GBP"
}
},
"returnMethods": [
"AT_A_KIOSK"
],
"itemConditions": [
"NEW"
],
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"amountMicros": "0",
"currencyCode": "GBP"
}
},
"returnPolicyUri": "http://example-pet-store.com/return-new",
"processRefundDays": 7,
"acceptExchange": true
}
]
}
Im Antworttextkörper steht das Feld returnPolicyId für die eindeutige Kennung der Online-Rückgabebedingungen.
Das Feld returnMethods gibt die Methoden an, die für die Rückgabe von Artikeln zulässig sind. AT_A_KIOSK gibt an, dass der Artikel an einem Kiosk zurückgegeben werden kann. Die anderen möglichen Werte sind IN_STORE und BY_MAIL.
Das Feld processRefundDays gibt die Anzahl der Tage an, die der Verkäufer für die Bearbeitung von Erstattungen benötigt.
Online-Rückgabebedingungen erstellen
Verwenden Sie die folgende Anfrage, um eine Rückgaberichtlinie zu erstellen:
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}
{
"label": "label", "countries": ["US"],
"policy": {"type": "NO_RETURNS"},
"returnPolicyUri": "https://www.uri.com"
}
Hier ist eine Beispielantwort für einen erfolgreichen Aufruf:
{
"name": "accounts/ACCOUNT_ID/onlineReturnPolicies/ONLINE_RETURN_POLICY",
"returnPolicyId": "ONLINE_RETURN_POLICY",
"label": "label",
"countries": ["US"],
"policy": {
"type": "NO_RETURNS"
},
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"amountMicros": "0",
"currencyCode": ""
}
},
"returnPolicyUri": "https://www.uri.com"
}
Sie können auch die Merchant Center-Benutzeroberfläche verwenden, um Rückgabebedingungen zu erstellen. Weitere Informationen zum Festlegen Ihrer Rückgabebedingungen für Shopping-Anzeigen und Produkteinträge Nachdem Sie im Merchant Center Rückgabebedingungen erstellt haben, kann es bis zu 10 Arbeitstage dauern, bis die Bedingungen überprüft und verfügbar sind.