Zusammenfassung
Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Seller-API von Grupo Éxito betreiben: Liste deine Produkte und ihren Freigabestatus auf, erstelle Produkte mit Bildern, Beschreibungen und Attributen, lege Preise und Bestand fest und lies Bestellungen und Auszahlungsabrechnungen aus.
Geführte Einrichtung
Grupo Éxito Marketplace in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Grupo Éxito 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 Grupo Éxito 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 direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Grupo Éxito Marketplace, füge deine Zugangsdaten ein, erzeuge einen MCP-API-Key und fertig. Kein Docker, kein
git clone, kein lokaler Server.
Grupo Éxito Marketplace
Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Seller-API von Grupo Éxito betreiben: Liste deine Produkte und ihren Freigabestatus auf, erstelle Produkte mit Bildern, Beschreibungen und Attributen, lege Preise und Bestand fest und lies Bestellungen und Auszahlungsabrechnungen aus.
Einrichtung
Die Einrichtung dauert etwa 10 Minuten, sobald Éxito dir API-Zugriff gewährt hat. Mit diesem Zugriff schickt Éxito Anweisungen zur Authentifizierung: einen Benutzernamen, ein Passwort, einen API-Key und die Adresse, die das Token ausstellt. Außerdem brauchst du deine numerische Seller-ID.
Es gibt keine Sandbox: Éxito dokumentiert keine, daher wirkt jeder Aufruf, auch Schreibzugriffe, auf deinen Live-Shop.
- Füge den API-Benutzer (eine E-Mail-Adresse) in
EXITO_USERNAMEund das API-Passwort inEXITO_PASSWORDein, beides aus den Anweisungen von Éxito. - Füge den
x-api-keyaus denselben Anweisungen inEXITO_API_KEYein. - Füge die vollständige
https://-Adresse der Token-Anfrage inEXITO_LOGIN_URLein. Sie ist auf developers.exito.com nicht veröffentlicht, also kopiere sie aus dem Dokument, das Éxito dir geschickt hat. - Trage deine numerische Seller-ID (idSeller, z. B.
11795) inEXITO_SELLER_IDein.exito_marketplace_get_bulk_upload_statuszeigt sie ebenfalls alsdata.idSelleran. - Installiere den Connector. Führe
exito_marketplace_list_categoriesaus, um die Verbindung zu prüfen.
So funktioniert die Anmeldung: Der Connector fordert an der Token-Adresse mit deinem Benutzernamen, Passwort und API-Key ein Token an und sendet es bei jedem Aufruf zusammen mit dem API-Key mit. Tokens werden automatisch erneuert, spätestens jede Stunde. Das Passwort und der Key werden verschlüsselt gespeichert und der KI nie angezeigt.
Cloud und self-hosted funktionieren gleich: Die Zugangsdaten sind dieselben, und es muss keine Redirect-URL gesetzt werden.
Der Verkauf auf Éxito läuft asynchron ab:
- Wähle mit
exito_marketplace_list_categoriesdie spezifischste Kategorie aus und lies mitexito_marketplace_get_category_featuresihre Spezifikationen. Erforderliche Spezifikationen müssen gesendet werden; eine Spezifikation mit einer Werteliste akzeptiert nur diese Werte. - Erstelle Produkte mit
exito_marketplace_create_products, bis zu 400 EANs pro Aufruf. Bilder sind öffentliche URLs, 1000x1000 px (733x1000 px für Kleidung). Die Marke muss bei Éxito bereits existieren; dein Éxito-Account-Manager legt eine fehlende an. - Verfolge den Batch mit
exito_marketplace_get_bulk_upload_status. Solange ein Batch startet oder verarbeitet wird, wird kein neuer akzeptiert. - Das Content-Team von Éxito prüft jedes Produkt.
exito_marketplace_get_products_waitinglistet die Produkte in Prüfung auf,exito_marketplace_get_products_rejecteddie abgelehnten mit Begründung undexito_marketplace_get_products_pending_seller_approvaljene, die sich vom gleichen, bereits im Marketplace vorhandenen Produkt unterscheiden. Nach der Freigabe dauert es bis zu eine Stunde, bis ein Produkt ein Angebot erhalten kann. - Gib freigegebenen Produkten mit
exito_marketplace_upsert_offersoder, für eine einzelne EAN, mitexito_marketplace_update_offer_price_stockeinen Preis und Bestand.exito_marketplace_load_products_and_offerssendet Produkte und Angebote in einer Anfrage. Angebote erreichen die Sites innerhalb von etwa 4 Stunden.
Preise und Bestand: Preise sind ganze kolumbianische Pesos über 8000, ohne Trennzeichen (45000). Ein Verkaufspreis muss niedriger sein als der Preis. Um nur den Preis zu ändern, sende den aktuellen Bestand mit IsUpdatedStock 0. Eine Preisänderung von mehr als 30 % kommt mit dem Code PEX zurück und muss mit Preisfreigabe erneut gesendet werden: Die KI fragt dich, bevor sie das tut. Um den Verkauf eines Produkts zu beenden, setze seinen Bestand auf 0: Die API hat kein Löschen.
Bestellungen und Auszahlungen: exito_marketplace_get_orders listet Bestellungen von exito.com, carulla.com und den anderen Sites von Éxito mit Status, Summen, Provision und Lieferart auf. exito_marketplace_get_bills listet Auszahlungsabrechnungen auf. Listen werden mit paginationToken seitenweise abgerufen.
Bei der Installation ausgeschaltet: exito_marketplace_set_order_tracking (Produkte einer Bestellung mit Versanddienstleister und Sendungsnummer als versendet markieren) und exito_marketplace_upload_order_invoice (die Rechnung an eine Bestellung anhängen). Schalte sie auf der Connector-Seite ein, wenn die KI Bestellungen bearbeiten soll; die KI bittet dich, jeden Aufruf zu bestätigen. Das Erstellen von Produkten sowie das Festlegen von Preisen und Bestand ist eingeschaltet (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Lies jede Antwort: Batch-Schreibvorgänge antworten mit HTTP 200 und einer Meldung pro abgelehnter EAN, daher bedeutet ein 200 nicht, dass jedes Produkt oder Angebot akzeptiert wurde. Anfragen und Antworten sind auf Spanisch.
Nicht abgedeckt: Versandetiketten, die Moderations- und Angebotsbenachrichtigungen von Éxito sowie alles, was die Seller-Center-Web-App kann und die API nicht anbietet.
Häufige Fehler: Wenn kein Token ausgestellt wird, prüfe Benutzername, Passwort und API-Key anhand der Anweisungen von Éxito und kontrolliere, dass EXITO_LOGIN_URL die Token-Adresse aus diesem Dokument ist. 401 bedeutet, dass das Token abgelehnt wurde. 403 bedeutet meist, dass der API-Key fehlt oder falsch ist oder die API für deinen Benutzer nicht aktiviert ist: Frage Éxito, welche APIs dein Zugang abdeckt.
Voraussetzungen: EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Den Connector lokal 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
Öffne http://localhost:3000/connectors/store, wähle Grupo Éxito Marketplace und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
exito_marketplace_get_products | Listet die Produkte des Verkäufers im Éxito-Marketplace mit Name, EAN, VTEX PLU, Bild, Erstellungs- und Aktualisierungsdatum, Preis, Verkaufspreis, Bestand… |
exito_marketplace_get_products_waiting | Produkte, die auf die Freigabe durch das Content-Team von Éxito warten (Moderation), mit EAN, Name, Bild, Verarbeitungsdatum und Parent-Referenz |
exito_marketplace_get_products_rejected | Produkte, die das Content-Team von Éxito abgelehnt hat und die korrigiert werden müssen, mit EAN, Name, Bild, Reason und Comment der Ablehnung |
exito_marketplace_get_products_pending_seller_approval | Produkte, die deine Entscheidung brauchen, weil sie sich vom gleichen, bereits im Marketplace vorhandenen Produkt unterscheiden: Jede Zeile hat oldProduct und… |
exito_marketplace_get_bulk_upload_status | Status deines letzten Batches zur Produkterstellung (exito_marketplace_create_products). data.status: 4 startet, 1 in Verarbeitung, 2 abgeschlossen… |
exito_marketplace_list_categories | Alle Kategorien des Éxito-Marketplace mit Id, IdParent, Name und ProductType (Technology oder Clothing) |
exito_marketplace_get_category | Eine Kategorie nach ID: Id, IdParent, Name und ProductType |
exito_marketplace_get_category_features | Spezifikationsgruppen einer Kategorie: für jede Spezifikation ihr specName, label, ob sie erforderlich ist, und ihre erlaubten Werte (values[].label; ein… |
exito_marketplace_get_orders | Über die Sites von Éxito (exito.com, carulla.com und weitere) eingegangene Bestellungen mit Bestellnummer, Kanal, Daten, Status, Summen, Provision… |
exito_marketplace_get_bills | Auszahlungsabrechnungen (Billing) des Verkäufers: Abrechnungsnummer, Bestellnummer, Zahlungsauftrag, Konzept, Zahlungsdatum, Provision, Summe, IVA und… |
exito_marketplace_create_products | Erstellt Produkte (oder ändert bestehende: dieselbe EAN erneut senden; ModifyImage "1" ersetzt die Bilder) mit Titel, HTML-Beschreibung… |
exito_marketplace_load_products_and_offers | Sendet Produkte zusammen mit ihren Angeboten in einer Anfrage: Jedes Element hat ein Product (die Felder von exito_marketplace_create_products) und ein… |
exito_marketplace_upsert_offers | Erstellt oder aktualisiert Angebote (Preis, Verkaufspreis, Bestand, Versand und Lieferversprechen) für EANs, die Éxito bereits freigegeben hat, in allen Éxito-Sites… |
exito_marketplace_update_offer_price_stock | Ändert Preis und/oder Bestand eines bestehenden Angebots (eine EAN). Éxito braucht bei jeder Aktualisierung EAN, Stock und Price: Um nur den Preis zu ändern… |
exito_marketplace_set_order_tracking | Markiert Produkte einer Bestellung als versendet, mit Versanddienstleister und Sendungsnummer (Bestellungen mit Standardlieferung) |
exito_marketplace_upload_order_invoice | Hängt die Rechnung einer Bestellung als Base64-PDF oder -ZIP an |
Beispiel-Prompts
- „Welche meiner Produkte hat Éxito abgelehnt, und warum?"
- „Zeige die mir diese Woche zugewiesenen Bestellungen, die noch versendet werden müssen."
- „Wie hoch sind Preis und Bestand der EAN 7701234567890 auf exito.com?"
- „Setze den Bestand der EAN 7701234567890 auf 25 Einheiten und behalte den Preis bei."
- „Addiere die Provision in meinen Auszahlungsabrechnungen für Oktober."
Nächste Schritte
War dieser Guide hilfreich?