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 Cursor verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde refurbed in der geführten Einrichtung und trag deine MCP-URL in Cursor 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 + Cursor
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 Cursor 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.
Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte Cursor neu.
- Öffne Cursor → Settings → MCP und prüfe, ob
anythingmcpaufgeführt und verbunden ist. - Leg los: Der Agent kann jetzt die
refurbed-Tools aufrufen.
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.
Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja — MCP gibt es in den Tarifen Hobby, Pro und Business.
Nächste Schritte
War dieser Guide hilfreich?