Loop Returns

In dieser Dokumentation erfährst du, wie du die Loop Returns API in melibo integrieren kannst, um Retouren-Informationen abzurufen oder neue Retouren zu erstellen.

---

🔐 1. Authentifizierung

Die Loop API bietet zwei verschiedene Methoden zur Authentifizierung:

a) API Key (empfohlen für Retourenverwaltung)

• Verwendungszweck: Dauerhafte Authentifizierung für alle Endpunkte der Returns API (z. B. Retourenstatus abfragen, Retoure erstellen).

• Gültigkeit: Unbegrenzt, bis der Key manuell widerrufen oder gelöscht wird.

• Verwendung: Der API-Key wird im Header der Anfrage übergeben:

  Authorization: Bearer <DEIN_API_TOKEN>

b) OAuth 2.0 (für Label- und Webhook-Endpunkte)

• Verwendungszweck: Temporäre Authentifizierung für sensible Endpunkte der Label API oder Webhook API.

• Gültigkeit: Kurzlebig (Token läuft nach einer Stunde ab).

Hinweis: Für die meisten Anwendungsfälle (z. B. Retourenstatus anzeigen oder Retoure erstellen) ist OAuth 2.0 nicht erforderlich. Für melibo genügt der dauerhafte API-Key.

---

⚙️ 2. API Key erstellen

Um einen API-Key zu generieren, gehe wie folgt vor:

1. Melde dich im Loop Admin Dashboard mit deinen Händler-Zugangsdaten an.

2. Öffne das Menü: Returns Management → Tools & Integrations → Developer Tools

3. Klicke auf „Generate API key“.

4. Scopes/Berechtigungen auswählen: Wähle die spezifischen Scopes (Rechte) aus, auf die dein API Schlüssel Zugriff haben sollte, um von der API Information zu lesen bzw. zu schreiben.

Nur benötigte Rechte aktivieren, um Sicherheit zu gewährleisten.

1. Vergib einen aussagekräftigen Namen und klicke auf Generate.

2. API Token speichernNach der Erstellung erscheint dein Token, z. B.: eyJhbGciOiJIUzI1NiIsInR5cCI6... Kopiere den Token sofort, da er später nicht mehr angezeigt wird.

---

🔗 3. Integration in melibo

1. Öffne in melibo das Menü: Integration → Loop Return

2. Füge deinen API Key in das entsprechende Feld ein:

   Authorization: Bearer <DEIN_API_TOKEN>

3. Speichere die Integration. Danach kann melibo:

   • Retouren anlegen oder abrufen

   • Status-Updates in Echtzeit anzeigen

   • Rückgabeprozesse automatisieren