Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge eMAG Marketplace mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
eMAG Marketplace API für Verkäufer auf eMAG Rumänien, Bulgarien und Ungarn (und Fashion Days): Produkte und Angebote, Preise und Bestand, Bestellungen mit Bestätigung und Statuswechsel, AWB-Versandlabels, Retouren (RMA), Kategorien und Merkmale, Kampagnen und Rechnungen. eMAG muss die aufrufende IP freischalten.
Frag einfach
Beispiel-Prompts für eMAG 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. Einloggen, Connectors → eMAG Marketplace klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
eMAG Marketplace
eMAG Marketplace API für Verkäufer auf eMAG Rumänien, Bulgarien und Ungarn (und Fashion Days): Produkte und Angebote, Preise und Bestand, Bestellungen mit Bestätigung und Statuswechsel, AWB-Versandlabels, Retouren (RMA), Kategorien und Merkmale, Kampagnen und Rechnungen. eMAG muss die aufrufende IP freischalten.
Einrichtung
Die Einrichtung dauert etwa 10 Minuten, plus die Zeit, die eMAG für die Freischaltung deiner IP-Adresse braucht.
- Nutze im Verkäuferbereich von eMAG Marketplace einen Benutzer mit API-Rechten (oder lass ihn vom Kontoinhaber anlegen).
- IP-Freischaltung: eMAG nimmt API-Aufrufe nur von IP-Adressen an, die du dort registriert hast. Schick dem eMAG-Marketplace-Support die öffentliche IP-Adresse, von der dieser Connector aufruft: bei einer selbst gehosteten Installation die Adresse deines Servers, bei AnythingMCP Cloud die feste IPv4-Adresse
104.248.242.235, von der Cloud jeden Aufruf macht. Bis eMAG sie eingetragen hat, antwortet jeder Aufruf mitYou are not allowed to use this API. - Setze
EMAG_API_HOSTauf den Host deiner Plattform, ohne Pfad:https://marketplace-api.emag.ro(Rumänien),https://marketplace-api.emag.bg(Bulgarien),https://marketplace-api.emag.hu(Ungarn),https://marketplace-ro-api.fashiondays.comoderhttps://marketplace-bg-api.fashiondays.com(Fashion Days). Jede Plattform ist ein eigenes Konto, also installierst du einen Connector pro Land. - Trag den API-Benutzer in
EMAG_USERNAMEund sein Passwort inEMAG_PASSWORDein (HTTP Basic Auth). - Installiere den Connector und rufe
emag_marketplace_list_vat_ratesauf: ein günstiger Aufruf, der Zugangsdaten und IP bestätigt.
So funktioniert die API: Der Connector nutzt die eMAG Marketplace API 3 (Dokumentation v4.5.2). Jede Ressource wird als POST <resource>/read, count oder save aufgerufen. Lesezugriffe nehmen Filter und Paging als Felder auf oberster Ebene (currentPage, itemsPerPage höchstens 100); Speichervorgänge nehmen eine Liste von Objekten, die der Connector in data verpackt. Die Lesezugriffe sind als nur lesend markiert, obwohl sie POST sind. Jede Antwort ist {"isError": false, "messages": [], "results": [...]}; isError: true wird als fehlgeschlagener Aufruf mit den Meldungen gemeldet. Eine Ausnahme: Beim Speichern eines neuen Produkts mit einem Dokumentationsproblem antwortet eMAG mit isError: true, das Angebot ist aber trotzdem gespeichert, deshalb liest die KI es mit emag_marketplace_list_product_offers zurück.
Was er liest: deine Produkte und Angebote mit Preis, Bestand pro Lager, Bearbeitungszeit, Status, Dokumentations- und Angebotsvalidierungsstatus, doc_errors, Buy-Button-Rang und Kampagne, gefiltert nach ID, Teilenummer, PNK oder Status und mit denselben Filtern gezählt; ob Produkte per EAN schon auf eMAG existieren (bis zu 100 auf einmal), damit dein Angebot an das bestehende Produkt angehängt wird; Kategorien mit ihren Merkmalen, erlaubten Werten und Pflichtangaben; Mehrwertsteuersätze und Bearbeitungszeiten; Bestellungen mit Kunde, Lieferadresse, Produkten, Gutscheinen, Zahlungsart, Versandkosten und Anhängen; Paketmaße; AWBs mit Kurier, Statusverlauf, Gewicht und Nachnahme, als PDF (A4, A5, A6) oder ZPL; Retourenanfragen mit Grund, Abholadresse und AWBs; Orte, Kurierkonten, deine Abhol- und Retourenadressen und vordefinierte Pakete; Kampagnen mit Regeln und Fristen, teilnahmeberechtigte Angebote mit dem maximalen Kampagnenpreis, Kampagnen-Badges und den Smart-Deals-Preis; die Rechnungen, die eMAG dir stellt, und die Rechnungen zu deinen Bestellungen.
Bestellungen und Versand: Bestellstatus 1 neu, 2 in Bearbeitung, 3 vorbereitet, 4 abgeschlossen, 0 storniert, 5 retourniert. Der Ablauf: neue Bestellung, emag_marketplace_acknowledge_order (auf 2), emag_marketplace_save_order mit Status 3, ein AWB mit emag_marketplace_create_awb, dann Status 4. emag_marketplace_save_order braucht die ganze Bestellung so, wie sie gelesen wurde, nur die geänderten Felder anders; Bestellungen lassen sich nur in Status 2 oder 3 bearbeiten. Gutscheine sind Teil der Bestelldaten (vouchers, product_voucher_split). Für ein AWB wählt die KI Kurierkonto, Absenderadresse und Orts-IDs und liest das Label danach zurück.
Retouren (RMA): request_status 2 neu, 3 bestätigt, 6 eingegangen, 7 abgeschlossen, 4 abgelehnt, 5 storniert. emag_marketplace_save_return setzt eine Retoure weiter: 2 auf 3 oder 5, 3 auf 6 oder 5, 6 auf 4 oder 7.
Was er schreibt: Angebotspreise, Bestand, Bearbeitungszeit und Status (emag_marketplace_update_offers, emag_marketplace_update_offer_stock), neue Produkte mit ihrem Angebot (emag_marketplace_save_product_offers), Maße, Bestellbestätigung und -status, Bestellanhänge (Rechnung Typ 1, Garantie Typ 3), Kurierfreigabe, AWBs, Retourenstatus und Kampagnenvorschläge. Sie wirken auf den Live-Shop und auf echte Kuriere. Vor jedem Schreibzugriff zeigt die KI, was sich ändert (Angebots-IDs mit altem und neuem Preis oder Bestand, Bestellung und neuer Status, AWB-Daten), und wartet auf dein Ja. Bei der Installation ist nichts deaktiviert; ein Administrator kann jedes Schreib-Tool abschalten, das das Team nicht braucht.
Daten lesen: id bei Angeboten ist deine eigene Verkäufer-Produkt-ID (ext_id); part_number_key (PNK) ist der Produktschlüssel von eMAG. Ein Angebot ist nur im Verkauf mit Bestand über 0, Status 1, offer_validation_status 1 und validation_status 3, 9, 11 oder 12. Preise sind ohne Mehrwertsteuer in der Währung der Plattform (RON in Rumänien, EUR in Bulgarien seit 1. Januar 2026, HUF in Ungarn). Datumsangaben sind YYYY-mm-dd HH:ii:ss in der Ortszeit der Plattform.
Paging und Limits: Listen liefern höchstens 100 pro Seite; die KI zählt zuerst und blättert mit currentPage. Teilnahmeberechtigte Kampagnenangebote nutzen Cursor-Paging mit der letzten ext_id als lastId. Datumsfilter für Bestellungen beim Zählen brauchen beide Enden, höchstens einen Monat auseinander. Speicheraufrufe nehmen höchstens 50 Einträge (empfohlen 10 bis 50) und 4000 Eingabefelder pro Anfrage. eMAG erlaubt 12 Anfragen pro Sekunde für Bestellungen und 3 pro Sekunde für alle anderen Ressourcen zusammen; darüber antwortet es mit 429.
Häufige Fehler: You are not allowed to use this API. oder 403 heißt, die IP ist noch nicht freigeschaltet. 401 heißt falscher Benutzername oder falsches Passwort, ein Benutzer ohne API-Rechte oder ein Host einer anderen Plattform als der des Kontos. 429 ist das Rate-Limit: Warte einen Moment. Andere isError-Antworten enthalten die Meldungen von eMAG, etwa fehlende Merkmale oder einen ungültigen Preis.
Der Connector eröffnet kein Verkäuferkonto, registriert deine IP nicht bei eMAG und arbeitet nicht plattformübergreifend: Ein Connector bedient ein Land.
Voraussetzungen: EMAG_API_HOST, EMAG_USERNAME, EMAG_PASSWORD
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 eMAG Marketplace und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
emag_marketplace_list_vat_rates | List the VAT rates of the platform with their vat_id, which every offer you save must carry |
emag_marketplace_list_handling_times | List the handling time values (days until you hand an order to the courier) the platform accepts for the handling_time of an offer |
emag_marketplace_list_categories | Read eMAG categories |
emag_marketplace_count_categories | Count the eMAG categories you may read, to know how many pages emag_marketplace_list_categories has |
emag_marketplace_list_product_offers | Read your products and offers: price, stock per warehouse, handling time, status (1 active, 0 inactive, 2 end of life), documentation and… |
emag_marketplace_count_product_offers | Count your products and offers with the same filters as emag_marketplace_list_product_offers, e.g. how many are inactive or have an invalid… |
emag_marketplace_find_products_by_ean | Check whether products already exist on eMAG by EAN (up to 100 at once): part_number_key, name, brand, category, whether you may add an… |
emag_marketplace_list_orders | Read orders with customer, delivery address, products (price, quantity, status, campaign), vouchers, payment method, shipping tax and… |
emag_marketplace_count_orders | Count orders with the same filters as emag_marketplace_list_orders, e.g. how many new (status 1) orders wait |
emag_marketplace_list_order_attachments | Read the attachments of an order (invoices, warranties, manuals, AWBs) with their type and URL |
emag_marketplace_get_order_volumetry | Read the weight and dimensions eMAG knows for each product of an order, to fill the packages of an AWB |
emag_marketplace_get_awb | Read an AWB (shipping label) issued through the API: order or return id, AWB number and barcode, courier, status history, weight and cash… |
emag_marketplace_get_awb_pdf | Download an AWB issued through the API as a PDF in A4, A5 or A6 (or as ZPL), to print the shipping label |
emag_marketplace_get_awb_zpl | Read an AWB issued through the API in ZPL (base64), for thermal label printers |
emag_marketplace_list_returns | Read return requests (RMA) with order, products, return reason, pickup address, AWBs and status (1 incomplete, 2 new, 3 acknowledged, 4… |
emag_marketplace_count_returns | Count return requests with the same filters as emag_marketplace_list_returns, e.g. how many new (2) returns wait |
emag_marketplace_list_localities | Read localities (cities with their region, zip code and emag_id) for the sender and receiver of an AWB |
emag_marketplace_list_courier_accounts | List your courier accounts (id, courier name, type order or return, lockers or offices, status) to choose the courier_account_id of an AWB |
emag_marketplace_list_addresses | List your pickup, return and invoice addresses (address_id, type, locality, street) to use as sender or return address of an AWB or return |
emag_marketplace_list_awb_packages | List your predefined AWB packages (label, length, width, height, weight, default), used when issuing AWBs without explicit packages |
emag_marketplace_list_campaigns | Read the eMAG campaigns (Black Friday, discount, voucher, multi deals) with start, end and offer deadline and their participation rules… |
emag_marketplace_list_campaign_categories | Read the categories eligible for campaigns with restricted categories (participationRules.restrictedCategories true): id, name and parent.… |
emag_marketplace_list_campaign_eligible_offers | Read your offers that may join a campaign: current price, lowest price of the last 30 days (cmmp), maximum campaign price, stock… |
emag_marketplace_get_offer_campaign_badges | Read the campaign badges (Black Friday, Genius Days and others) active or planned for one of your offers, with label text and dates. eMAG… |
emag_marketplace_check_smart_deals_price | Get the price an offer must reach to qualify for the Smart Deals badge |
emag_marketplace_list_invoice_categories | List the categories of the invoices eMAG issues to you (e.g |
emag_marketplace_list_invoices | Read the invoices eMAG issued to you (commission, services and others): number, date, lines, totals with and without VAT and currency |
emag_marketplace_list_customer_invoices | Read the invoices issued to your customers on eMAG orders (normal or storno): order id, number, date, lines and totals |
emag_marketplace_update_offers | Update existing offers only (light offer API, up to 50 per call): price, recommended, minimum and maximum price, stock and handling time… |
emag_marketplace_update_offer_stock | Set the stock of one offer per warehouse (PATCH, stock only) |
emag_marketplace_save_product_offers | Create new products with their offer, or update offers, up to 50 per call |
emag_marketplace_save_measurements | Save the volume measurements of products (length, width, height in millimetres, weight in grams) |
emag_marketplace_acknowledge_order | Acknowledge a new order: moves it from 1 (new) to 2 (in progress) and stops eMAG notifying you about it |
emag_marketplace_save_order | Update an order: set status 3 (prepared), 4 (finalized) or 0 (canceled with reason_cancellation), remove or add products, or storno a… |
emag_marketplace_unlock_courier | Unlock the courier selection of an order so a different courier account can be used for its AWB |
emag_marketplace_save_order_attachments | Attach documents to orders by URL: invoice (type 1), warranty (type 3, with order_product_id) and other types |
emag_marketplace_create_awb | Issue an AWB (shipping label) with your eMAG courier account for an order or a return: sender, receiver (with locality_id), parcels or… |
emag_marketplace_save_return | Update a return request (RMA), mainly its request_status: 2 new to 3 acknowledged or 5 canceled, 3 to 6 received, 6 to 4 refused or 7… |
emag_marketplace_propose_campaign_offers | Propose your offers in a campaign with the campaign price (and voucher discount, maximum quantity per order or date intervals where the… |
Beispiel-Prompts
- „Wie viele unserer eMAG-Angebote sind inaktiv oder haben einen ungültigen Angebotsvalidierungsstatus?“
- „Liste die neuen eMAG-Bestellungen (Status 1) von heute mit Produkten und Zahlungsart.“
- „Senk den Preis von Angebot 10452 auf 189,90 RON ohne Mehrwertsteuer und setz den Bestand auf 25. Zeig mir vorher alte und neue Werte.“
- „Erstell ein AWB für Bestellung 412398765 mit unserem Kurierkonto und gib mir das PDF in A6. Zeig mir vorher die AWB-Daten.“
- „Welche unserer Angebote dürfen an der Black-Friday-Kampagne teilnehmen, und wie hoch ist ihr maximaler Kampagnenpreis?“
Nächste Schritte
War dieser Guide hilfreich?