Zusammenfassung
Betreibe deinen Shop auf dem Shop Apotheke 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 Deutschland, Österreich, Italien und Belgien; melde dich mit dem Shop-API-Schlüssel aus deinem Shop Apotheke Verkäufer-Backoffice an.
Geführte Einrichtung
Shop Apotheke Marketplace in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Shop Apotheke 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 Shop Apotheke 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 → Shop Apotheke Marketplace, füge deine Zugangsdaten ein, mint einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Shop Apotheke Marketplace
Betreibe deinen Shop auf dem Shop Apotheke 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 Deutschland, Österreich, Italien und Belgien; melde dich mit dem Shop-API-Schlüssel aus deinem Shop Apotheke Verkäufer-Backoffice an.
Einrichtung
Länder: Deutschland, Österreich, Italien und Belgien. Der Marktplatz ist in Deutschland und Österreich aktiv; Italien (redcare.it) und Belgien (farmaline.be) betreiben ein Partnerprogramm mit eigenen Verträgen.
Wer verkaufen kann: Shop Apotheke genehmigt jeden Partner, kann den Produktfeed zuerst überprüfen und schließt einen Vertrag pro Land ab; bewirb dich auf der Partnerseite. Der Connector benötigt ein Verkäuferkonto, das Shop Apotheke bereits eröffnet hat.
Nur die Shops in Deutschland und Österreich sind an dieser Adresse bestätigt; italienische und belgische Shops verwenden sie ebenfalls.
Die Einrichtung dauert etwa 5 Minuten.
- Melde dich im Shop Apotheke Verkäufer-Backoffice an:
https://shopapotheke.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
SHOP_APOTHEKE_API_KEYein. Der Schlüssel wird unverändert 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. - Shop Apotheke schließt einen separaten Vertrag für jedes Land ab, sodass ein Verkäufer in mehreren Ländern mehrere Shops hat. Wenn dein Benutzer mehr als einen Shop hat, setze
SHOP_APOTHEKE_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_idvonshop_apotheke_get_account); um an mehreren Shops zu arbeiten, installiere den Connector einmal pro Shop. Ohne ihn wird dein Standard-Shop verwendet. - Installiere und führe
shop_apotheke_get_accountaus: es gibt den Shop zurück, zu dem der Schlüssel gehört.
Wo du anfangen kannst: shop_apotheke_get_account zeigt den Shop hinter dem Schlüssel (ID, Name, Status, Währung und Kanäle). Für die tägliche Arbeit verwende shop_apotheke_list_orders mit order_state_codes=WAITING_ACCEPTANCE, shop_apotheke_list_offers für Preise und Lagerbestand und shop_apotheke_list_threads für Nachrichten, die auf eine Antwort warten.
Produkte und konkurrierende Angebote: shop_apotheke_get_products sucht Produkte im Shop Apotheke Katalog nach EAN oder einer anderen Referenz und gibt die Marktplatz-Produkt-SKU zurück; shop_apotheke_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. shop_apotheke_accept_order akzeptiert (oder lehnt ab) jede Zeile; nachdem der Kunde belastet wurde, wechselt die Bestellung zu SHIPPING. Dann speichert shop_apotheke_update_tracking den Versanddienstleister und die Sendungsnummer (Versanddienstleister-Codes stammen von shop_apotheke_list_carriers) und shop_apotheke_ship_order bestätigt den Versand (SHIPPED). Spätere Status sind TO_COLLECT, RECEIVED, CLOSED, REFUSED und CANCELED. Verwende shop_apotheke_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; shop_apotheke_resolve_incident schließt einen Vorfall zu einer Bestellzeile, sobald er gelöst ist. Dokumente, die an Bestellungen angehängt sind (Lieferscheine, Etiketten, Kundenrechnungen), werden von shop_apotheke_list_order_documents aufgelistet.
Schreiboperationen: zuerst bestätigen. shop_apotheke_accept_order, shop_apotheke_update_tracking, shop_apotheke_ship_order, shop_apotheke_resolve_incident, shop_apotheke_accept_return, shop_apotheke_receive_return, shop_apotheke_update_offers, shop_apotheke_reply_thread, shop_apotheke_create_order_thread und shop_apotheke_import_products wirken auf dem Live-Marktplatz. Vor jedem Aufruf zeige dem Benutzer, was sich ändern wird (Bestell-ID und Zeilen, Sendungsnummer, Angebots-SKU mit altem und neuem 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. shop_apotheke_import_offers kann Angebote löschen (der REPLACE-Modus löscht jedes Angebot, das nicht in der Datei vorhanden ist), daher wird es standardmäßig deaktiviert installiert.
Angebote aktualisieren (Preise und Lagerbestand): shop_apotheke_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 (shop_apotheke_get_offer oder shop_apotheke_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 shop_apotheke_get_offer_import, bevor du das Angebot erneut liest. Zustandscodes für state_code stammen von shop_apotheke_list_offer_conditions, Logistik-Klassencodes von shop_apotheke_list_logistic_classes.
Dateiimporte: shop_apotheke_import_products (P41) und shop_apotheke_import_offers (OF01) benötigen die URL einer CSV-, XLSX- oder XML-Datei im von Shop Apotheke geforderten Dateiformat; der Connector lädt sie herunter und lädt sie zu Shop Apotheke hoch. Verfolge sie mit shop_apotheke_list_product_imports / shop_apotheke_get_product_import und shop_apotheke_list_offer_imports / shop_apotheke_get_offer_import.
Rücksendungen: shop_apotheke_list_returns (RT11) listet Rücksendeanfragen auf. Wo Shop Apotheke den Shop entscheiden lässt, akzeptiert shop_apotheke_accept_return eine in WAITING_ACCEPTANCE oder lehnt sie ab, und shop_apotheke_receive_return bestätigt, dass die Waren angekommen sind. Rückerstattungen bleiben im Backoffice.
Nachrichten: shop_apotheke_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), shop_apotheke_get_thread liest einen mit seinen Nachrichten, shop_apotheke_reply_thread antwortet (Empfänger CUSTOMER oder OPERATOR, was Shop Apotheke ist) und shop_apotheke_create_order_thread eröffnet eine neue Konversation zu einer Bestellung. Grundcodes für Themen stammen von shop_apotheke_list_reasons; lasse sein locale leer, es sei denn, du weißt, dass der Marktplatz diese Sprache hat (eine inaktive Locale antwortet mit 400).
Geld: shop_apotheke_list_invoices (IV01) listet die Buchhaltungsdokumente auf, die Shop Apotheke dem Shop ausstellt, und shop_apotheke_list_transactions (TL02) die Transaktionszeilen (Verkäufe, Provisionen, Rückerstattungen, Auszahlungen). Wenn Shop Apotheke Enhanced Seller Invoicing verwendet, gibt IV01 keine neuen Dokumente zurück; verwende dann shop_apotheke_list_document_requests (DR11) und die Transaktionen.
Referenzlisten: shop_apotheke_list_channels (Länderseiten), shop_apotheke_list_carriers, shop_apotheke_list_shipping_zones, shop_apotheke_list_shipping_methods und shop_apotheke_list_logistic_classes ändern sich selten; lese sie einmal pro Konversation.
Seitenumbruch: 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 Shop Apotheke 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, shop_apotheke_get_account und die Referenzlisten etwa einmal am Tag. 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 das Recht für diese Aktion hat, 404, dass die Bestellung, das Angebot oder der Thread für diesen Shop nicht existiert, 400 ein falscher Parameter oder eine Bestellung in einem falschen Zustand (die Nachricht nennt es, z.B. ORDER_INVALID_STATE).
Voraussetzungen: SHOP_APOTHEKE_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 Shop Apotheke Marketplace und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
shop_apotheke_get_account | Lese den Shop hinter dem API-Schlüssel auf diesem Marktplatz (A01): Shop-ID und Name, Status, Kanäle, Währung, Bewertung und Genehmigungsquote, Kontakt… |
shop_apotheke_list_orders | Liste Bestellungen (OR11) mit ihren Zeilen, Kunden, Versandadresse, Preisen, Status und Vorfällen auf. Filtere nach Status (z.B. WAITING_ACCEPTANCE für… |
shop_apotheke_list_offers | Liste die Angebote des Shops (OF21): SKU, Produkt, Preis und Rabatt, alle Kanalpreise, Lagerbestand, Zustand, Vorlaufzeit und ob… |
shop_apotheke_get_offer | Lese ein Angebot vollständig nach seiner Angebots-ID (OF22): jedes Preisfeld, Rabatt, Menge, Zustand, Logistikklasse, Vorlaufzeit und benutzerdefinierte… |
shop_apotheke_list_offer_conditions | Liste 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 |
shop_apotheke_list_offer_imports | Liste Angebotsimporte und -aktualisierungen (OF04), aus Dateien und von shop_apotheke_update_offers: Status (WAITING, RUNNING, COMPLETE, FAILED), Zeilen… |
shop_apotheke_get_offer_import | Lese den Status eines Angebotsimports oder einer Angebotsaktualisierung (OF02) nach seiner import_id, wie sie von shop_apotheke_update_offers oder… |
shop_apotheke_export_offers | Startet einen Export aller Angebote des Shops als Dateien (OF52), um den ganzen Katalog (jede SKU mit Preis und Bestand) zu lesen, statt shop_apotheke_list_offers seitenweise abzurufen |
shop_apotheke_get_offer_export_status | Status eines mit shop_apotheke_export_offers gestarteten Angebotsexports (OF53): PENDING, COMPLETED oder FAILED, nach Abschluss mit den URLs der Dateien |
shop_apotheke_get_offer_export_file | Liest eine Datei eines abgeschlossenen Angebotsexports (OF54): die Angebote mit SKU, Produkt, Bestand, Preisen und den übrigen exportierten Feldern, als JSON oder CSV |
shop_apotheke_list_product_imports | Liste Produktimporte (P51) mit ihrem Status (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), den Transformationszahlen und den… |
shop_apotheke_get_product_import | Lese den Status eines Produktimports (P42) nach seiner import_id: Importstatus, Grund, Transformationszahlen und die Integrationsdetails… |
shop_apotheke_get_products | Suche Produkte im Marktplatzkatalog nach ihren Identifikatoren (P31), z.B. EAN, und erhalte die Marktplatz-Produkt-SKU, den Titel und die Kategorie.… |
shop_apotheke_list_product_offers | Liste die Angebote jedes Shops für gegebene Produkte (P11), sortiert nach dem besten Preis, um deinen Preis mit der Konkurrenz zu vergleichen. Gib product_ids… |
shop_apotheke_list_threads | Liste Nachrichten-Threads (M11) mit Kunden und Shop Apotheke: Thema, verknüpfte Bestellung oder Angebot, Teilnehmer, Datum der letzten Nachricht und seit wann ein… |
shop_apotheke_get_thread | Lese einen Nachrichten-Thread (M10) mit all seinen Nachrichten, Absendern, Empfängern, Anhängen und der verknüpften Bestellung oder dem Angebot |
shop_apotheke_list_returns | Liste Rücksendeanfragen (RT11) mit ihrem Status, Rücksendezeilen, Grund, RMA, Verfolgung und der verknüpften Bestellung. Filtere nach Status, Bestellung oder Datum.… |
shop_apotheke_list_reasons | Liste die Grundcodes des Marktplatzes (RE01): Vorfall, Stornierung, Rückerstattung und Nachrichtenursachen, mit ihren Bezeichnungen und ob der Shop… |
shop_apotheke_list_carriers | Liste die Versanddienstleister, die der Marktplatz kennt (SH21) mit ihrem Code, Label und Verfolgungs-URL. Verwende den Code als carrier_code in… |
shop_apotheke_list_invoices | Liste die Buchhaltungsdokumente auf, die Shop Apotheke dem Shop ausstellt (IV01): Rechnungen und Gutschriften mit Zeitraum, Gesamtsummen mit und ohne Steuer… |
shop_apotheke_list_transactions | Liste die Transaktionszeilen des Shops (TL02): Bestellbeträge, Versand, Provisionen, Rückerstattungen, manuelle Gutschriften und Auszahlungen, mit Betrag, Typ… |
shop_apotheke_list_document_requests | Liste Buchhaltungsdokumentanfragen (DR11) auf, die verwendet werden, wenn Shop Apotheke Enhanced Seller Invoicing durchführt: Rechnungen und Gutschriften, die Shop… |
shop_apotheke_list_order_documents | Liste die Dokumente auf, die an eine oder mehrere Bestellungen angehängt sind (OR72): Lieferscheine, Versandetiketten, Kundenrechnungen und andere Dateien, mit ID, Datei… |
shop_apotheke_list_channels | Liste die Vertriebskanäle des Marktplatzes (CH11) auf, normalerweise einer pro Länderseite, mit Code und Label. Verwende die Codes als channel_codes in… |
shop_apotheke_list_shipping_zones | Liste die aktiven Versandzonen des Marktplatzes (SH11) mit Code und Label, z.B. Festland Frankreich oder Korsika. Ändert sich selten: rufe es… |
shop_apotheke_list_shipping_methods | Liste die aktiven Versandmethoden des Marktplatzes (SH12) auf, z.B. Standard, Express oder Abholung, mit Code, Label, ob eine Sendungsnummer… |
shop_apotheke_list_logistic_classes | Liste die Logistikklassen des Marktplatzes (SH31) auf, die Größen- oder Gewichtsklassen, die die Versandpreise bestimmen, mit Code und Label. Verwende den Code als… |
shop_apotheke_accept_order | Akzeptiere oder lehne die Zeilen einer Bestellung ab, die auf Annahme wartet (OR21). Jede Zeile der Bestellung muss aufgelistet werden. Das Ablehnen einer Zeile storniert sie… |
shop_apotheke_update_tracking | Setze den Versanddienstleister und die Sendungsnummer einer Bestellung (OR23). Gib carrier_code von shop_apotheke_list_carriers an oder carrier_name mit… |
shop_apotheke_ship_order | Bestätige, dass eine Bestellung im STATUS "VERSAND" versendet wurde (OR24); sie wechselt zu "VERSENDET" und der Kunde wird benachrichtigt. Setze die Verfolgung zuerst mit… |
shop_apotheke_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… |
shop_apotheke_reply_thread | Antworte in einem Nachrichten-Thread (M12) an den Kunden oder Shop Apotheke. Die Nachricht wird sofort zugestellt und kann nicht zurückgenommen werden: zeige dem Benutzer… |
shop_apotheke_create_order_thread | Starte einen neuen Nachrichten-Thread zu einer Bestellung (OR43) mit dem Kunden, Shop Apotheke oder beiden. Die Nachricht wird sofort zugestellt: zeige dem Benutzer die… |
shop_apotheke_resolve_incident | Markiere den offenen Vorfall zu einer Bestellzeile als gelöst (OR64), sobald das Problem des Kunden gelöst ist. reason_code muss ein INCIDENT_CLOSE… |
shop_apotheke_accept_return | Akzeptiere oder lehne eine Rücksendeanfrage in WAITING_ACCEPTANCE (RT21) ab. Nur wenn Shop Apotheke Rücksendungen im Verkäufer-Backoffice bearbeitet und… |
shop_apotheke_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… |
shop_apotheke_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… |
shop_apotheke_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 vorhanden ist, und… |
Beispielaufforderungen
- "Welche Shop Apotheke Bestellungen warten auf meine Annahme?"
- "Setze den Lagerbestand meiner Magnesiumkapseln SKU MG-400-90 auf 120."
- "Welche Rücksendeanfragen warten auf meine Entscheidung?"
- "Füge DHL-Verfolgung 00340434161234567891 zur Bestellung 6604412-A hinzu und bestätige den Versand."
- "Zeige die Rechnungen an, die Shop Apotheke mir im Oktober ausgestellt hat."
Nächste Schritte
War dieser Guide hilfreich?