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 Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde refurbed in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot 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 + Microsoft Copilot
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 Microsoft Copilot 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.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
refurbed-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, 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.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?