Zusammenfassung
refurbed Seller API für Verkäufer von refurbished Elektronik: Bestellungen und Bestellpositionen (akzeptieren, versenden mit Tracking und IMEI), Rückerstattungs-Dry-Runs, Versandetiketten, Rechnungen, Rücksendungen, Support-Tickets, Angebote mit Lagerbeständen und Preisen, Marktpreise, Produktabfragen, Versandprofile und -dienstleister. API-Token von refurbed.
Geführte Einrichtung
refurbed in 2 Minuten mit Meta Muse verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde refurbed in der geführten Einrichtung und trag deine MCP-URL in Meta Muse ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für refurbed
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → refurbed, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
refurbed + Meta Muse
refurbed Seller API für Verkäufer von refurbished Elektronik: Bestellungen und Bestellpositionen (akzeptieren, versenden mit Tracking und IMEI), Rückerstattungs-Dry-Runs, Versandetiketten, Rechnungen, Rücksendungen, Support-Tickets, Angebote mit Lagerbeständen und Preisen, Marktpreise, Produktabfragen, Versandprofile und -dienstleister. API-Token von refurbed.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
REFURBED_API_TOKEN
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 5 Minuten. Du benötigst die Antwort von refurbed.
- Fordere ein API-Token mit dem Formular unter supplier.refurbed.com/api-token-request an (oder frage deinen Account-Manager oder [email protected]). refurbed sendet ein Token, das wie eine UUID aussieht.
- Füge es in
REFURBED_API_TOKENein, installiere und führerefurbed_list_ordersaus. Der Connector sendet es alsAuthorization: Plaingefolgt vom Token. - Ein Token, das 2 Monate lang nicht verwendet wird, läuft ab; fordere dann ein neues an. Einige Aufrufe müssen auch von refurbed für dein Konto aktiviert werden (Versandetiketten, Angebote für neue Batterien).
Die API läuft unter https://api.refurbed.com. refurbed stellt jedem Verkäufer auf Anfrage eine Sandbox zur Verfügung (supplier.refurbed.com/sandbox-request), unter einer Adresse wie https://grpc-<name>.qa.refurbed.io, mit Testbestellungen; eine self-hosted Installation kann eine Kopie dieses Connectors dort hinweisen.
Wo anfangen: refurbed_list_orders mit dem Status NEW zeigt Bestellungen zur Bearbeitung an; refurbed_get_order und refurbed_list_order_items zeigen die Artikel. Akzeptiere mit refurbed_accept_order_item, versende dann mit refurbed_ship_order_item (Tracking-Link oder Carrier-Slug von refurbed_list_available_carriers plus Tracking-Nummer und die IMEI oder Seriennummer in item_identifiers). refurbed_batch_update_order_item_states verarbeitet bis zu 50 auf einmal; refurbed_update_order_item ändert Tracking, Identifikatoren, Notizen oder Schweizer Zollinformationen später; refurbed_get_order_item liest einen Artikel.
Bestellstatus der Artikel: NEW wird zu ACCEPTED, REJECTED oder CANCELLED; ACCEPTED wird zu SHIPPED oder CANCELLED; SHIPPED kann RETURNED werden. Das Überspringen eines Schrittes schlägt mit Code 9 fehl (kann den Status nicht von neu auf versendet ändern). REJECTED und CANCELLED sind endgültig und erstatten nicht: refurbed_reject_order_item ist installiert und deaktiviert, und refurbed erwartet, dass du den Kunden zuerst über ein Ticket informierst. Der Bestellstatus wird aus seinen Artikeln berechnet. Verwende nicht die veralteten Felder parcel_tracking_number, parcel_tracking_carrier und den einzelnen item_identifier.
Rückerstattungen: dieser Connector erstattet niemals. refurbed_calculate_item_refund und refurbed_calculate_order_refund sind Dry-Runs, die die Beträge anzeigen; die Rückerstattung selbst erfolgt in der Verkäuferoberfläche (es benötigt ein offenes Ticket).
Etiketten, Rechnungen, Rücksendungen, Tickets: refurbed_list_shipping_labels gibt frische Etikettenlinks; refurbed_create_shipping_label (deaktiviert) erstellt ein echtes Etikett gemäß der Versandvereinbarung von refurbed mit jedem Aufruf. refurbed_get_order_invoice verlinkt die Rechnung, die du hochgeladen hast. refurbed_list_returns listet Rücksendungen mit refurbed Rücksendetiketten auf; setze den Artikel auf RETURNED, wenn das Paket ankommt. refurbed_list_tickets und refurbed_get_ticket lesen Kundentickets.
Angebote: refurbed_list_offers, refurbed_get_offer, refurbed_create_offer (finde das Produkt mit refurbed_get_instance, das Profil mit refurbed_list_shipping_profiles), refurbed_update_offer und refurbed_batch_update_offers für Lagerbestände und Preise. Identifiziere Angebote nach SKU: Angebots-IDs ändern sich, wenn ein Angebot neu erstellt wird. Pausiere mit Lagerbestand 0; refurbed_delete_offer ist deaktiviert. Festpreise pro Markt: refurbed_list_market_offers, refurbed_create_market_offer, refurbed_update_market_offer, refurbed_delete_market_offer (deaktiviert); nur Standortmärkte von refurbed_list_markets akzeptieren sie. Nur Garantie M12 wird für neue Angebote akzeptiert; die Einstufung ist AA, A, B oder C.
Weitere Abfragen: refurbed_list_merchant_addresses (Absenderadresse-IDs für Etiketten) und refurbed_get_currency (Wechselkurse; die Einrichtungsprüfung verwendet es).
Wie die API funktioniert: jeder Aufruf ist ein POST eines JSON-Körpers an /refb.merchant.v1.<Service>/<Method>. Feldnamen sind snake_case; IDs sind ganze Zahlen, die als Strings gesendet und zurückgegeben werden ("3496079"); Geld ist ein Dezimalstring mit einem Punkt ("199.99", ein Komma wird abgelehnt); Zeiten sind RFC 3339 in UTC; Enums werden nach Namen gesendet. Gib ein Angebot nach SKU oder ID an, niemals beides. Listen seitenweise mit einem Cursor: übergebe die letzte ID als starting_after, solange has_more wahr ist, bis zu 100 Zeilen. Batches nehmen 1 bis 50 Artikel und antworten mit einem Status pro Artikel.
Limits und Fehler: 10 Anfragen pro Sekunde standardmäßig (Header X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset); darüber hinaus erhältst du 429 RESOURCE_EXHAUSTED. Fehler antworten mit code und message mit gRPC-Codes: 3 ungültiges Argument, 5 nicht gefunden, 6 bereits vorhanden, 7 Berechtigung verweigert, 9 fehlende Vorbedingungen, 16 nicht authentifiziert.
Bedingungen: Die API-Bedingungen von refurbed erlauben Integratoren, die für Verkäufer handeln, aber jede Aktion muss auf den Verkäufer zurückverfolgt werden können, und API-Daten dürfen nicht weiterverkauft oder für Benchmarking oder Marktanalysen verwendet werden.
Schreibvorgänge: zuerst bestätigen. Akzeptieren, versenden, verfolgen, Lager- und Preisänderungen wirken sich auf das Live-Konto aus. Zeige dem Benutzer vor jedem Aufruf, welche Änderungen vorgenommen werden, und warte auf ein Ja.
Schritt 2 — Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Connector in Muse hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.
- Öffne in Muse Settings → Connectors und wähle Add custom connector.
- Füge die MCP-Server-URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein. - Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
- Bitte Muse im Chat um etwas, wofür es die
refurbed-Tools braucht.
Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
refurbed_list_orders | Listet Bestellungen, standardmäßig die neuesten zuerst: id, released_at, status (NEW, ACCEPTED, SHIPPED, FULFILLED, CANCELLED und andere), Etiketten (z.B.… |
refurbed_get_order | Liest eine Bestellung mit all ihren Artikeln: Status, Etiketten, Kunden-E-Mail, Versand- und Rechnungsadresse (mit USt-Nummern), Gesamtsummen und Abrechnung… |
refurbed_list_order_items | Listet die Artikel einer Bestellung auf: id, name, status, sku, Gesamtsummen, Provision, Besteuerung, Angebotsdaten (Angebots-id, Einstufung, Garantie, Versand… |
refurbed_get_order_item | Liest einen Bestellartikel anhand seiner eigenen ID (nicht der Bestell-ID): Status, sku, Preise und Provision, Angebotsdaten, Tracking-Link und Dienstleister… |
refurbed_accept_order_item | Akzeptiert einen NEUEN Bestellartikel (Status ACCEPTED): du bestätigst, dass du ihn versenden wirst. Antwortet mit dem aktualisierten Artikel |
refurbed_ship_order_item | Markiert einen AKZEPTIERTEN Bestellartikel als VERSENDET mit seinem Tracking: eine vollständige parcel_tracking_url oder parcel_carrier_tracking_number (Carrier-Slug und… |
refurbed_update_order_item | Ändert einen Bestellartikel, ohne seinen Status zu ändern: ersetzt den Tracking-Link oder die Carrier-Tracking-Nummer, fügt Identifikatoren hinzu (IMEI, Seriennummer)… |
refurbed_batch_update_order_item_states | Ändert den Status von bis zu 50 Bestellartikeln in einem Aufruf (akzeptiere oder versende mehrere). Jedes Update hat die Felder der einzelnen Aufrufe; die Antwort… |
refurbed_reject_order_item | Lehnt einen Bestellartikel ab (NEUER Artikel) oder storniert (NEUER oder AKZEPTIERTER Artikel). Endgültig und kann nicht rückgängig gemacht werden; es erstattet den Kunden nicht von sich aus… |
refurbed_calculate_item_refund | Dry Run: zeigt, was die Rückerstattung eines Bestellartikels bedeuten würde (total_paid, total_refunded, refunded, die Anteile von refurbed und dem Händler) ohne… |
refurbed_calculate_order_refund | Dry Run: zeigt, was die Rückerstattung aller erstattungsfähigen Artikel einer Bestellung kosten würde, ohne etwas zurückzuerstatten |
refurbed_list_shipping_labels | Listet die Versandetiketten auf, die für eine Bestellung erstellt wurden: id, Drucker-PDF-Links (sie laufen nach etwa einer Stunde ab, rufe erneut auf, um frische zu erhalten), Tracking… |
refurbed_create_shipping_label | Erstellt ein Versandetikett für eine Bestellung gemäß der Versandvereinbarung von refurbed (DHL Express heute). Jeder Aufruf erstellt ein neues echtes Etikett und dessen… |
refurbed_get_order_invoice | Erhält einen Download-Link (gültig 24 Stunden) für die Rechnung, die du für eine Bestellung hochgeladen hast. NOT_FOUND, wenn es keine gibt |
refurbed_list_returns | Listet Rücksendungen auf, die mit refurbed Rücksendetiketten laufen: id, order_id, order_item_id, instance_name, Identifikatoren, Status (INITIATED, IN_TRANSIT… |
refurbed_list_tickets | Listet Kundensupport-Tickets auf: id, Status (OPEN, PENDING, SOLVED, CLOSED), Thema, Dringlichkeit, Kunde, Bestellung und Bestellartikel… |
refurbed_get_ticket | Liest ein Support-Ticket mit seinen Nachrichten, Thema, Status, Bestellreferenzen und Notizen |
refurbed_list_offers | Listet deine Angebote auf: id, sku, instance_id und instance_name, Status (OK, UNVERIFIED, PENDING_REVIEW, REJECTED mit rejection_reason), Einstufung… |
refurbed_get_offer | Liest ein Angebot nach SKU oder ID: Status, Einstufung, Garantie, Lagerbestand, Versandprofile, Besteuerung, Referenzpreise und die Marktpreise mit… |
refurbed_create_offer | Erstellt ein Angebot für ein Produkt: instance_id (refurbed_get_instance), oder eine gtin oder mpn (das Angebot ist dann UNVERIFIED, bis refurbed es überprüft… |
refurbed_update_offer | Ändert ein Angebot nach SKU oder ID: Lagerbestand, Referenzpreis und Mindestpreis, Einstufung, Garantie, Versandprofil oder Besteuerung; nur die angegebenen Felder… |
refurbed_batch_update_offers | Ändert bis zu 50 Angebote in einem Aufruf (Lager- und Preisupdates). Jeder Eintrag hat Identifikator plus die Felder von refurbed_update_offer; die… |
refurbed_delete_offer | Löscht ein Angebot nach SKU oder ID. Kann nicht rückgängig gemacht werden; um ein Angebot zu pausieren, setze den Lagerbestand mit refurbed_update_offer auf 0. Installiert deaktiviert |
refurbed_list_market_offers | Listet die Marktpreise eines Angebots auf: market_code, ob es sich um einen Standortmarkt handelt, festgelegter oder berechneter Preis und Mindestpreis, Währung… |
refurbed_create_market_offer | Setzt einen Festpreis für ein Angebot in einem Standortmarkt anstelle des aus dem Referenzpreis berechneten Preises. ALREADY_EXISTS, wenn der Markt… |
refurbed_update_market_offer | Ändert den Festpreis eines Angebots in einem Markt. Gib das Angebot nach SKU oder offer_id und den market_code an |
refurbed_delete_market_offer | Entfernt den Festpreis eines Angebots in einem Markt; der Preis fällt auf die Berechnung vom Referenzpreis zurück. Installiert deaktiviert |
refurbed_get_instance | Sucht ein refurbed Produkt (Instanz) nach GTIN, MPN oder ID: id und name. Verwende die id als instance_id, wenn du Angebote erstellst. Es gibt kein Produkt… |
refurbed_list_shipping_profiles | Listet deine Versandprofile auf: id, name, Herkunftsland, Zielmärkte mit Kosten und Lieferzeiten und wie viele Angebote jedes verwenden.… |
refurbed_list_available_carriers | Listet die Dienstleister auf, die refurbed verfolgen kann: name und slug. Verwende den slug als Carrier, wenn du mit einer Tracking-Nummer anstelle eines Links versendest. Cache… |
refurbed_list_markets | Listet refurbed Märkte auf: code (z.B. de, at, fr), name, typ, currency_code und is_site (ein Markt mit seiner eigenen refurbed Seite, wo feste… |
refurbed_list_merchant_addresses | Listet deine Adressen auf: id, typ (DELIVERY oder RETURN), firma, straße, stadt, postleitzahl und land. Die id ist die Absenderadresse eines… |
refurbed_get_currency | Liest eine Währung und ihre Wechselkurse. Benötigt keine Verkäuferdaten; wird verwendet, um zu überprüfen, ob das Token funktioniert |
Beispielaufforderungen
- "Welche refurbed Bestellartikel warten auf Akzeptanz?"
- "Versende Bestellartikel 9123456 mit DHL-Tracking 00340434161234567890 und IMEI 356789012345678."
- "Wie hoch sind meine Angebotspreise pro Markt für das iPhone 14 128 GB?"
- "Welche Rücksendungen sind diese Woche eingegangen?"
- "Wie viel würde eine Rückerstattung des Bestellartikels 9123456 kosten?"
FAQ
Woher kommt das API-Token? Fordere es mit dem API-Token-Formular von refurbed an, von deinem Account-Manager oder [email protected]. Unbenutzte Tokens laufen nach zwei Monaten ab.
Was deckt es ab? Bestellungen und Bestellpositionen (akzeptieren, versenden mit Tracking und IMEI), Rückerstattungs-Dry-Runs, Versandetiketten, Rechnungen, Rücksendungen, Support-Tickets, Angebote mit Lagerbeständen und Preisen, Marktpreise, Produktabfragen, Versandprofile und -dienstleister.
Welche Tools sind deaktiviert installiert? refurbed_reject_order_item, refurbed_create_shipping_label, refurbed_delete_offer und refurbed_delete_market_offer. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.
Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.
Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.
Nächste Schritte
War dieser Guide hilfreich?