Connector-Anleitung6 Minuten Lesezeit16 MCP-Tools7 Sprachen

Éxito MCP-Server: Produkte, Angebote und Bestellungen

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.

HCVom HelpCode-TeamAktualisiert 6 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Grupo Éxito Marketplace

Grupo Éxito Marketplace

Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.

Tools

16

Region

INTL

Kategorie

E-Commerce

Authentifizierung

Sign-in token

Benötigte Env-Vars

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

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.

Grupo Éxito Marketplace · live via MCP
Teilen
Opus 4.7

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.

  1. Füge den API-Benutzer (eine E-Mail-Adresse) in EXITO_USERNAME und das API-Passwort in EXITO_PASSWORD ein, beides aus den Anweisungen von Éxito.
  2. Füge den x-api-key aus denselben Anweisungen in EXITO_API_KEY ein.
  3. Füge die vollständige https://-Adresse der Token-Anfrage in EXITO_LOGIN_URL ein. Sie ist auf developers.exito.com nicht veröffentlicht, also kopiere sie aus dem Dokument, das Éxito dir geschickt hat.
  4. Trage deine numerische Seller-ID (idSeller, z. B. 11795) in EXITO_SELLER_ID ein. exito_marketplace_get_bulk_upload_status zeigt sie ebenfalls als data.idSeller an.
  5. Installiere den Connector. Führe exito_marketplace_list_categories aus, 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:

  1. Wähle mit exito_marketplace_list_categories die spezifischste Kategorie aus und lies mit exito_marketplace_get_category_features ihre Spezifikationen. Erforderliche Spezifikationen müssen gesendet werden; eine Spezifikation mit einer Werteliste akzeptiert nur diese Werte.
  2. 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.
  3. Verfolge den Batch mit exito_marketplace_get_bulk_upload_status. Solange ein Batch startet oder verarbeitet wird, wird kein neuer akzeptiert.
  4. Das Content-Team von Éxito prüft jedes Produkt. exito_marketplace_get_products_waiting listet die Produkte in Prüfung auf, exito_marketplace_get_products_rejected die abgelehnten mit Begründung und exito_marketplace_get_products_pending_seller_approval jene, 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.
  5. Gib freigegebenen Produkten mit exito_marketplace_upsert_offers oder, für eine einzelne EAN, mit exito_marketplace_update_offer_price_stock einen Preis und Bestand. exito_marketplace_load_products_and_offers sendet 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

ToolWas es tut
exito_marketplace_get_productsListet die Produkte des Verkäufers im Éxito-Marketplace mit Name, EAN, VTEX PLU, Bild, Erstellungs- und Aktualisierungsdatum, Preis, Verkaufspreis, Bestand…
exito_marketplace_get_products_waitingProdukte, die auf die Freigabe durch das Content-Team von Éxito warten (Moderation), mit EAN, Name, Bild, Verarbeitungsdatum und Parent-Referenz
exito_marketplace_get_products_rejectedProdukte, 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_approvalProdukte, 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_statusStatus deines letzten Batches zur Produkterstellung (exito_marketplace_create_products). data.status: 4 startet, 1 in Verarbeitung, 2 abgeschlossen…
exito_marketplace_list_categoriesAlle Kategorien des Éxito-Marketplace mit Id, IdParent, Name und ProductType (Technology oder Clothing)
exito_marketplace_get_categoryEine Kategorie nach ID: Id, IdParent, Name und ProductType
exito_marketplace_get_category_featuresSpezifikationsgruppen 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_billsAuszahlungsabrechnungen (Billing) des Verkäufers: Abrechnungsnummer, Bestellnummer, Zahlungsauftrag, Konzept, Zahlungsdatum, Provision, Summe, IVA und…
exito_marketplace_create_productsErstellt Produkte (oder ändert bestehende: dieselbe EAN erneut senden; ModifyImage "1" ersetzt die Bilder) mit Titel, HTML-Beschreibung…
exito_marketplace_load_products_and_offersSendet 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_offersErstellt 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_trackingMarkiert Produkte einer Bestellung als versendet, mit Versanddienstleister und Sendungsnummer (Bestellungen mit Standardlieferung)
exito_marketplace_upload_order_invoiceHä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?

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.

Verwandte Anleitungen

Connectors

Éxito per MCP mit ChatGPT verbinden: Angebote und Bestand

Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-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.

Connectors

Éxito per MCP mit Claude verbinden: Produkte und Bestellungen

Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-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.

Connectors

Éxito per MCP mit Microsoft Copilot verbinden

Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-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.

Connectors

Éxito per MCP mit Cursor verbinden: Katalog-Uploads

Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-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.

Connectors

Éxito per MCP mit Gemini CLI verbinden: Bestellungen

Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-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.

Connectors

Éxito per MCP mit Meta Muse verbinden: Shop-Bestellungen

Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-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.