Zusammenfassung
Betreibe deinen Shop auf dem Yves Rocher-Marktplatz von einem KI-Agenten aus: Bestellungen, Annahme, Verfolgung und Versand, Vorfälle, Angebote mit Preisen und Lagerbestand, Importe, Nachrichten, Rücksendungen, Rechnungen und Transaktionen. Der Marktplatz verkauft in Frankreich; melde dich mit dem Shop-API-Schlüssel aus deinem Yves Rocher Verkäufer-Backoffice an.
Geführte Einrichtung
Yves Rocher Marketplace in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Yves Rocher Marketplace in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Yves Rocher Marketplace
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 → Yves Rocher Marketplace, füge deine Zugangsdaten ein, mint ein MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Yves Rocher Marketplace
Betreibe deinen Shop auf dem Yves Rocher-Marktplatz von einem KI-Agenten aus: Bestellungen, Annahme, Verfolgung und Versand, Vorfälle, Angebote mit Preisen und Lagerbestand, Importe, Nachrichten, Rücksendungen, Rechnungen und Transaktionen. Der Marktplatz verkauft in Frankreich; melde dich mit dem Shop-API-Schlüssel aus deinem Yves Rocher Verkäufer-Backoffice an.
Einrichtung
Länder: Frankreich.
Wer verkaufen kann: Yves Rocher wählt eine kleine Anzahl von Partnermarken aus: schreibe an das Marktplatz-Team ([email protected]). Produkte müssen den Natürlichkeitsstandards der CSR-Charta von Yves Rocher entsprechen und dürfen keine umstrittenen Inhaltsstoffe enthalten. Es gibt keine Einrichtungsgebühr; Yves Rocher erhebt eine monatliche Gebühr und eine Provision pro Verkauf. Verkäufer beantworten Kundenmeldungen innerhalb von 48 Stunden. Der Connector benötigt ein Verkäuferkonto, das Yves Rocher bereits eröffnet hat.
Die Verkäuferadresse dieses Connectors ist die, die die Plattform diesem Einzelhändler zuweist; kein Verkäuferhandbuch nennt sie bisher. Wenn dein Verkäufer-Backoffice an einer anderen Adresse geöffnet wird, teile uns dies im Chat mit, damit wir es korrigieren können.
Die Einrichtung dauert etwa 5 Minuten.
- Melde dich im Yves Rocher Verkäufer-Backoffice an:
https://yvesrocherfr-prod.mirakl.net/login. - Öffne im Backoffice deinen Benutzernamen (oben rechts) > Meine Benutzereinstellungen > API-Schlüssel und klicke auf Neuen Schlüssel generieren (oder kopiere den vorhandenen Schlüssel). Füge ihn in
YVES_ROCHER_API_KEYein. Der Schlüssel wird so wie er ist imAuthorization-Header gesendet, ohneBearer. Das Generieren eines neuen Schlüssels macht den alten ungültig, sodass jedes andere Tool, das ihn verwendet, nicht mehr funktioniert. - Lass
YVES_ROCHER_SHOP_IDleer. Nur wenn dein Benutzer mehrere Shops auf Yves Rocher verwaltet, setzeYVES_ROCHER_SHOP_IDauf die numerische ID des Shops, auf dem dieser Connector arbeiten soll (angezeigt im Dashboard des Backoffice neben Identifier oder Shop-ID, und zurückgegeben alsshop_idvonyves_rocher_get_account). Ohne diese wird dein Standard-Shop verwendet. - Installiere und führe
yves_rocher_get_accountaus: es gibt den Shop zurück, zu dem der Schlüssel gehört.
Wo du anfangen kannst: yves_rocher_get_account zeigt den Shop hinter dem Schlüssel (ID, Name, Status, Währung und Kanäle). Für die tägliche Arbeit verwende yves_rocher_list_orders mit order_state_codes=WAITING_ACCEPTANCE, yves_rocher_list_offers für Preise und Lagerbestand und yves_rocher_list_threads für Nachrichten, die auf eine Antwort warten.
Produkte und konkurrierende Angebote: yves_rocher_get_products sucht Produkte im Yves Rocher-Katalog nach EAN oder einer anderen Referenz und gibt die Marktplatz-Produkt-SKU zurück; yves_rocher_list_product_offers listet die Angebote jedes Shops für gegebene Produkte auf, bestes Preis zuerst, bei etwa 5 Aufrufen pro Minute.
Bestellworkflow: Eine neue Bestellung wartet in WAITING_ACCEPTANCE. yves_rocher_accept_order akzeptiert (oder verweigert) jede Zeile; nachdem der Kunde belastet wurde, wechselt die Bestellung zu SHIPPING. Dann speichert yves_rocher_update_tracking den Versanddienstleister und die Sendungsnummer (Versanddienstleister-Codes stammen von yves_rocher_list_carriers) und yves_rocher_ship_order bestätigt den Versand (SHIPPED). Spätere Status sind TO_COLLECT, RECEIVED, CLOSED, REFUSED und CANCELED. Verwende yves_rocher_list_orders mit order_state_codes=WAITING_ACCEPTANCE für die tägliche To-Do-Liste und has_incident=true für offene Vorfälle; yves_rocher_resolve_incident schließt einen Vorfall auf einer Bestellzeile, sobald er gelöst ist. Dokumente, die an Bestellungen angehängt sind (Lieferscheine, Etiketten, Kundenrechnungen), werden von yves_rocher_list_order_documents aufgelistet.
Schreiboperationen: zuerst bestätigen. yves_rocher_accept_order, yves_rocher_update_tracking, yves_rocher_ship_order, yves_rocher_resolve_incident, yves_rocher_accept_return, yves_rocher_receive_return, yves_rocher_update_offers, yves_rocher_reply_thread, yves_rocher_create_order_thread und yves_rocher_import_products wirken auf dem Live-Marktplatz. Zeige dem Benutzer vor jedem Aufruf, was sich ändern wird (Bestell-ID und Zeilen, Sendungsnummer, Angebots-SKU mit dem alten und neuen Preis oder Lagerbestand, den Nachrichtentext und die Empfänger) und warte auf ein Ja. Das Ablehnen einer Bestellzeile storniert sie endgültig. Kein Tool hier erstattet, storniert Bestellungen oder bewegt Geld; das machst du im Backoffice. yves_rocher_import_offers kann Angebote löschen (der REPLACE-Modus löscht jedes Angebot, das nicht in der Datei ist), daher wird es standardmäßig deaktiviert installiert.
Angebote aktualisieren (Preise und Lagerbestand): yves_rocher_update_offers (OF24) ersetzt das gesamte Angebot. Jedes Feld, das du auslässt, wird zurückgesetzt: eine fehlende quantity wird zu 0, ein fehlender discount oder description wird gelöscht. Lese immer zuerst das Angebot (yves_rocher_get_offer oder yves_rocher_list_offers mit sku) und sende es vollständig mit nur der beabsichtigten Änderung zurück: shop_sku, product_id und product_id_type (aus product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (seinen Code), min_quantity_alert, description, discount, all_prices, available_started / available_ended (gelesen als available_start_date / available_end_date) und alle offer_additional_fields. Lass update_delete leer oder setze es auf update. Der Aufruf gibt eine import_id zurück; die Änderung wird asynchron angewendet, also überprüfe sie mit yves_rocher_get_offer_import, bevor du das Angebot erneut liest. Zustandscodes für state_code stammen von yves_rocher_list_offer_conditions, Logistik-Klassencodes von yves_rocher_list_logistic_classes.
Dateiimporte: yves_rocher_import_products (P41) und yves_rocher_import_offers (OF01) nehmen die URL einer CSV-, XLSX- oder XML-Datei im von Yves Rocher geforderten Dateiformat; der Connector lädt sie herunter und lädt sie zu Yves Rocher hoch. Verfolge sie mit yves_rocher_list_product_imports / yves_rocher_get_product_import und yves_rocher_list_offer_imports / yves_rocher_get_offer_import.
Rücksendungen: yves_rocher_list_returns (RT11) listet Rücksendeanfragen auf. Wo Yves Rocher den Shop entscheiden lässt, akzeptiert yves_rocher_accept_return eine in WAITING_ACCEPTANCE oder verweigert sie und yves_rocher_receive_return bestätigt, dass die Waren angekommen sind. Rückerstattungen bleiben im Backoffice.
Nachrichten: yves_rocher_list_threads listet Konversationen (filtere mit entity_type=MMP_ORDER und entity_id=<order id> für eine Bestellung; entity_id ohne entity_type wird abgelehnt), yves_rocher_get_thread liest einen mit seinen Nachrichten, yves_rocher_reply_thread antwortet (Empfänger CUSTOMER oder OPERATOR, was Yves Rocher ist) und yves_rocher_create_order_thread eröffnet eine neue Konversation zu einer Bestellung. Grundcodes für Themen stammen von yves_rocher_list_reasons; lasse locale leer, es sei denn, du weißt, dass der Marktplatz diese Sprache hat (eine inaktive Locale antwortet mit 400).
Geld: yves_rocher_list_invoices (IV01) listet die Buchhaltungsdokumente auf, die Yves Rocher dem Shop ausstellt, und yves_rocher_list_transactions (TL02) die Transaktionszeilen (Verkäufe, Provisionen, Rückerstattungen, Auszahlungen). Wenn Yves Rocher Enhanced Seller Invoicing verwendet, gibt IV01 keine neuen Dokumente zurück; verwende dann yves_rocher_list_document_requests (DR11) und die Transaktionen.
Gesamter Katalog: Um jedes Angebot zu lesen (eine Lager- oder Preisprüfung über den Katalog, Zählen von Angeboten), starte einen Export mit yves_rocher_export_offers, poll yves_rocher_get_offer_export_status etwa einmal pro Minute, bis er COMPLETED ist, und lese die Dateien nacheinander mit yves_rocher_get_offer_export_file; include_fields behält nur die Spalten, die du benötigst. Ein vollständiger Export ist einmal täglich erlaubt; für das, was sich seitdem geändert hat, übergebe last_request_date (ein differentieller Export, höchstens einmal pro Minute). Durchlaufe nicht jedes Angebot mit yves_rocher_list_offers: es ist für einige Angebote gleichzeitig gedacht und antwortet mit 429, wenn es durch einen großen Katalog paginiert wird.
Mehrere Shops: Jedes Tool nimmt eine optionale shop_id. Ein Benutzer, der mehrere Shops auf diesem Marktplatz verwaltet (eine Agentur oder ein Shop pro Land), kann mit einer Installation an allen arbeiten: übergebe die ID des Shops bei jedem Aufruf und überprüfe, welcher Shop es ist, mit yves_rocher_get_account und derselben shop_id. Ohne shop_id verwendet ein Aufruf YVES_ROCHER_SHOP_ID oder den Standard-Shop des Benutzers, wenn dieser leer ist. Frage den Benutzer nach den IDs ihrer Shops; das Backoffice zeigt sie an.
Referenzlisten: yves_rocher_list_channels (Länderseiten), yves_rocher_list_carriers, yves_rocher_list_shipping_zones, yves_rocher_list_shipping_methods und yves_rocher_list_logistic_classes ändern sich selten; lese sie einmal pro Konversation.
Pagination: Bestellungen, Angebote, Rechnungen und Produktimporte paginieren mit max (höchstens 100) und offset. Threads, Rücksendungen, Transaktionen, Dokumentanfragen und Angebotsimporte geben ein next_page_token zurück; übergebe es als page_token, um die nächste Seite zu erhalten (alle anderen Filter werden dann ignoriert), bis es fehlt.
Daten sind im ISO 8601-Format, z.B. 2026-10-01T00:00:00Z; Antworten sind in UTC.
Ratenlimits: Jede API hat ihr eigenes Limit und Yves Rocher kann diese verschärfen. Das Auflisten von Angeboten und Bestellungen ist für die interaktive Nutzung gedacht, Produkt- und Angebotsimporte höchstens alle 15 Minuten, yves_rocher_get_account und die Referenzlisten etwa einmal täglich. Ein 429 enthält einen Retry-After-Header mit den Sekunden, die gewartet werden sollen; versuche nicht, in einer Schleife erneut zu versuchen.
Fehler: 401 bedeutet, dass der Schlüssel falsch ist oder durch einen neueren ersetzt wurde, 403, dass dein Benutzer nicht die Berechtigung für diese Aktion hat, 404, dass die Bestellung, das Angebot oder der Thread für diesen Shop nicht existiert oder dass der Marktplatz diese Funktion nicht nutzt, wie z.B. Rücksendungen, 400 ein falscher Parameter oder eine Bestellung im falschen Zustand (die Nachricht nennt es, z.B. ORDER_INVALID_STATE).
Voraussetzungen: YVES_ROCHER_API_KEY
Installiere den Connector lokal
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
Öffne http://localhost:3000/connectors/store, wähle Yves Rocher Marketplace und füge die Umgebungsvariablen ein, die unter Voraussetzungen aufgeführt sind.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
yves_rocher_get_account | Lies den Shop hinter dem API-Schlüssel auf diesem Marktplatz (A01): Shop-ID und Name, Status, Kanäle, Währung, Note und Genehmigungsrate, Kontakt… |
yves_rocher_list_orders | Listet Bestellungen (OR11) mit ihren Zeilen, Kunden, Versandadresse, Preisen, Status und Vorfällen auf. Filtere nach Status (z.B. WAITING_ACCEPTANCE für… |
yves_rocher_list_offers | Listet die Angebote des Shops (OF21): SKU, Produkt, Preis und Rabatt, alle Kanalpreise, Menge auf Lager, Zustand, Vorlaufzeit und ob… |
yves_rocher_get_offer | Lies ein Angebot vollständig nach seiner Angebots-ID (OF22): jedes Preisfeld, Rabatt, Menge, Zustand, Logistikklasse, Vorlaufzeit und benutzerdefinierte… |
yves_rocher_list_offer_conditions | Listet die Angebotsbedingungen (OF61) auf, die der Marktplatz akzeptiert, z.B. neu oder gebraucht, mit dem Code, der in state_code beim Aktualisieren von Angeboten eingegeben werden muss |
yves_rocher_list_offer_imports | Listet Angebotsimporte und -aktualisierungen (OF04) auf, aus Dateien und von yves_rocher_update_offers: Status (WAITING, RUNNING, COMPLETE, FAILED), Zeilen… |
yves_rocher_get_offer_import | Lies den Status eines Angebotsimports oder einer Angebotsaktualisierung (OF02) nach seiner import_id, wie von yves_rocher_update_offers oder… |
yves_rocher_export_offers | Starte einen Export aller Angebote des Shops als Dateien (OF52), um den gesamten Katalog zu lesen (jede SKU mit Preis und Lagerbestand) anstelle von… |
yves_rocher_get_offer_export_status | Status eines Angebotsexports, der mit yves_rocher_export_offers gestartet wurde (OF53): PENDING, COMPLETED oder FAILED (mit error.code und error.detail)… |
yves_rocher_get_offer_export_file | Lies eine Datei eines abgeschlossenen Angebotsexports (OF54): die Angebote mit ihrer SKU, Produkt, Menge, Preisen und den anderen exportierten Feldern, wie… |
yves_rocher_list_product_imports | Listet Produktimporte (P51) mit ihrem Status (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), den Transformationszahlen und den… |
yves_rocher_get_product_import | Lies den Status eines Produktimports (P42) nach seiner import_id: Importstatus, Grund, Transformationszahlen und die Integrationsdetails… |
yves_rocher_get_products | Suche Produkte im Marktplatzkatalog nach ihren Identifikatoren (P31), z.B. EAN, und erhalte die Marktplatz-Produkt-SKU, Titel und Kategorie.… |
yves_rocher_list_product_offers | Listet die Angebote jedes Shops für gegebene Produkte (P11) auf, sortiert nach dem besten Preis, um deinen Preis mit der Konkurrenz zu vergleichen. Gib product_ids… |
yves_rocher_list_threads | Listet Nachrichten-Threads (M11) mit Kunden und Yves Rocher auf: Thema, verknüpfte Bestellung oder Angebot, Teilnehmer, Datum der letzten Nachricht und seit wann ein… |
yves_rocher_get_thread | Lies einen Nachrichten-Thread (M10) mit all seinen Nachrichten, Absendern, Empfängern, Anhängen und der verknüpften Bestellung oder dem Angebot |
yves_rocher_list_returns | Listet Rücksendeanfragen (RT11) mit ihrem Status, Rücksendelinien, Grund, RMA, Verfolgung und der verknüpften Bestellung. Filtere nach Status, Bestellung oder Datum.… |
yves_rocher_list_reasons | Listet die Grundcodes des Marktplatzes (RE01): Vorfall, Stornierung, Rückerstattung und Nachrichtenursachen, mit ihren Bezeichnungen und ob der Shop… |
yves_rocher_list_carriers | Listet die Versanddienstleister, die der Marktplatz kennt (SH21) mit ihrem Code, Bezeichnung und Verfolgungs-URL. Verwende den Code als carrier_code in… |
yves_rocher_list_invoices | Listet die Buchhaltungsdokumente auf, die Yves Rocher dem Shop ausstellt (IV01): Rechnungen und Gutschriften mit Zeitraum, Gesamtsummen mit und ohne Steuer… |
yves_rocher_list_transactions | Listet die Transaktionszeilen des Shops (TL02): Bestellbeträge, Versand, Provisionen, Rückerstattungen, manuelle Gutschriften und Auszahlungen, mit Betrag, Typ… |
yves_rocher_list_document_requests | Listet Anfragen für Buchhaltungsdokumente (DR11) auf, die verwendet werden, wenn Yves Rocher Enhanced Seller Invoicing durchführt: Rechnungen und Gutschriften, die Yves Rocher… |
yves_rocher_list_order_documents | Listet die Dokumente auf, die an einer oder mehreren Bestellungen angehängt sind (OR72): Lieferscheine, Versandetiketten, Kundenrechnungen und andere Dateien, mit ID, Datei… |
yves_rocher_list_channels | Listet die Vertriebskanäle des Marktplatzes (CH11) auf, normalerweise einer pro Länderseite, mit Code und Bezeichnung. Verwende die Codes als channel_codes in… |
yves_rocher_list_shipping_zones | Listet die aktiven Versandzonen des Marktplatzes (SH11) mit Code und Bezeichnung auf, z.B. Festlandfrankreich oder Korsika. Ändert sich selten: rufe es… |
yves_rocher_list_shipping_methods | Listet die aktiven Versandmethoden des Marktplatzes (SH12) auf, z.B. Standard, Express oder Abholung, mit Code, Bezeichnung, ob eine Sendungsnummer… |
yves_rocher_list_logistic_classes | Listet die Logistikklassen des Marktplatzes (SH31) auf, die Größen- oder Gewichtsklassen sind, die die Versandpreise bestimmen, mit Code und Bezeichnung. Verwende den Code als… |
yves_rocher_accept_order | Akzeptiere oder verweigere die Zeilen einer Bestellung, die auf Annahme wartet (OR21). Jede Zeile der Bestellung muss aufgelistet werden. Das Ablehnen einer Zeile storniert sie… |
yves_rocher_update_tracking | Setze den Versanddienstleister und die Sendungsnummer einer Bestellung (OR23). Gib carrier_code von yves_rocher_list_carriers an oder carrier_name mit carrier_url… |
yves_rocher_ship_order | Bestätige, dass eine Bestellung im STATUS SHIPPING versendet wurde (OR24); sie wechselt zu SHIPPED und der Kunde wird benachrichtigt. Setze die Sendungsverfolgung zuerst mit… |
yves_rocher_update_offers | Erstelle oder aktualisiere Angebote, einschließlich Preis und Lagerbestand (OF24). Ersetzt jedes Angebot vollständig: jedes ausgelassene Feld wird zurückgesetzt (eine fehlende… |
yves_rocher_reply_thread | Antworte in einem Nachrichten-Thread (M12) an den Kunden oder Yves Rocher. Die Nachricht wird sofort zugestellt und kann nicht zurückgenommen werden: zeige dem Benutzer… |
yves_rocher_create_order_thread | Starte einen neuen Nachrichten-Thread zu einer Bestellung (OR43) mit dem Kunden, Yves Rocher oder beiden. Die Nachricht wird sofort zugestellt: zeige dem Benutzer die… |
yves_rocher_resolve_incident | Markiere den offenen Vorfall auf einer Bestellzeile als gelöst (OR64), sobald das Problem des Kunden gelöst ist. reason_code muss ein INCIDENT_CLOSE… |
yves_rocher_accept_return | Akzeptiere oder verweigere eine Rücksendungsanfrage in WAITING_ACCEPTANCE (RT21). Nur wenn Yves Rocher Rücksendungen im Verkäufer-Backoffice bearbeitet und… |
yves_rocher_receive_return | Bestätige, dass die Waren einer akzeptierten Rücksendung in deinem Lager angekommen sind (RT25). Die Rücksendung wechselt zu RECEIVED. Wirkt auf dem Live-Marktplatz… |
yves_rocher_import_products | Sende eine Produktdatei an den Marktplatz (P41), um Produkte in seinem Katalog zu erstellen oder zu bereichern. file_url ist die Adresse einer CSV-, XLSX- oder XML… |
yves_rocher_import_offers | Importiere eine Angebotsdatei (OF01), um Angebote in großen Mengen zu erstellen, zu aktualisieren oder zu löschen. Der REPLACE-Modus löscht jedes Angebot, das nicht in der Datei ist, und… |
Beispielaufforderungen
- "Welche Yves Rocher-Bestellungen warten auf meine Annahme?"
- "Welche Kundenmeldungen sind älter als 48 Stunden und haben noch keine Antwort?"
- "Setze den Lagerbestand meines Bio-Gesichtsöls SKU YR-OIL-30 auf 45 und behalte den Preis."
- "Füge die Colissimo-Sendungsverfolgung 6A89012345678 zur Bestellung 1101234-A hinzu und bestätige den Versand."
- "Zeige die Rechnungen an, die Yves Rocher mir in diesem Monat ausgestellt hat."
Nächste Schritte
War dieser Guide hilfreich?