Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade eMAG Marketplace con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
API de eMAG Marketplace para vendedores en eMAG Rumanía, Bulgaria y Hungría (y Fashion Days): productos y ofertas, precios y stock, pedidos con confirmación y cambios de estado, etiquetas de envío AWB, devoluciones (RMA), categorías y características, campañas y facturas. eMAG debe autorizar la IP que llama.
Prueba a pedir
Prompts de ejemplo para eMAG Marketplace
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → eMAG Marketplace, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
eMAG Marketplace
API de eMAG Marketplace para vendedores en eMAG Rumanía, Bulgaria y Hungría (y Fashion Days): productos y ofertas, precios y stock, pedidos con confirmación y cambios de estado, etiquetas de envío AWB, devoluciones (RMA), categorías y características, campañas y facturas. eMAG debe autorizar la IP que llama.
Configuración
La configuración lleva unos 10 minutos, más el tiempo que eMAG tarde en autorizar tu dirección IP.
- En el área de vendedores de eMAG Marketplace usa (o pide al titular de la cuenta que cree) un usuario con derechos de API.
- Lista blanca de IP: eMAG solo acepta llamadas a la API desde direcciones IP registradas con ellos. Envía al soporte de eMAG Marketplace la IP pública desde la que llama este conector: en una instalación self-hosted, la dirección de tu servidor; en AnythingMCP Cloud, la dirección IPv4 fija
104.248.242.235, desde la que Cloud hace todas las llamadas. Hasta que eMAG la añada, cada llamada respondeYou are not allowed to use this API. - Pon en
EMAG_API_HOSTel host de tu plataforma, sin ruta:https://marketplace-api.emag.ro(Rumanía),https://marketplace-api.emag.bg(Bulgaria),https://marketplace-api.emag.hu(Hungría),https://marketplace-ro-api.fashiondays.comohttps://marketplace-bg-api.fashiondays.com(Fashion Days). Cada plataforma es una cuenta aparte, así que instala un conector por país. - Pon el usuario de API en
EMAG_USERNAMEy su contraseña enEMAG_PASSWORD(HTTP Basic auth). - Instala el conector y ejecuta
emag_marketplace_list_vat_rates: una llamada ligera que confirma credenciales e IP.
Cómo funciona la API: el conector usa la eMAG Marketplace API 3 (documentación v4.5.2). Cada recurso se llama como POST <resource>/read, count o save. Las lecturas reciben filtros y paginación como campos de primer nivel (currentPage, itemsPerPage como máximo 100); los guardados reciben una lista de objetos que el conector envuelve en data. Las lecturas están marcadas como de solo lectura aunque sean POST. Cada respuesta es {"isError": false, "messages": [], "results": [...]}; isError: true se informa como llamada fallida con los mensajes. Una excepción: al guardar un producto nuevo con un problema de documentación, eMAG responde isError: true pero la oferta se guarda igualmente, así que la IA la vuelve a leer con emag_marketplace_list_product_offers.
Qué lee: tus productos y ofertas con precio, stock por almacén, tiempo de preparación, estado, estado de validación de la documentación y de la oferta, doc_errors, posición en el buy button y campaña, filtrados por id, número de pieza, PNK o estado y contados con los mismos filtros; si un producto ya existe en eMAG por EAN (hasta 100 a la vez), para enganchar tu oferta al producto existente; categorías con sus características, valores permitidos y obligatoriedad; tipos de IVA y tiempos de preparación; pedidos con cliente, dirección de entrega, productos, vales, forma de pago, gastos de envío y adjuntos; la volumetría de los paquetes; AWB con mensajería, historial de estados, peso y contra reembolso, en PDF (A4, A5, A6) o ZPL; solicitudes de devolución con motivo, dirección de recogida y AWB; localidades, cuentas de mensajería, tus direcciones de recogida y devolución y los paquetes predefinidos; campañas con reglas y plazos, ofertas elegibles con el precio máximo de campaña, insignias de campaña y el precio Smart Deals; las facturas que eMAG te emite y las facturas de tus pedidos.
Pedidos y envío: estado del pedido 1 nuevo, 2 en curso, 3 preparado, 4 finalizado, 0 cancelado, 5 devuelto. El flujo: pedido nuevo, emag_marketplace_acknowledge_order (a 2), emag_marketplace_save_order con estado 3, un AWB con emag_marketplace_create_awb y después estado 4. emag_marketplace_save_order necesita el pedido entero tal como se leyó, con solo los campos cambiados distintos; los pedidos solo se pueden editar en estado 2 o 3. Los vales forman parte de los datos del pedido (vouchers, product_voucher_split). Para un AWB la IA elige la cuenta de mensajería, la dirección del remitente y los ids de localidad, y luego vuelve a leer la etiqueta.
Devoluciones (RMA): request_status 2 nueva, 3 confirmada, 6 recibida, 7 finalizada, 4 rechazada, 5 cancelada. emag_marketplace_save_return hace avanzar una devolución: de 2 a 3 o 5, de 3 a 6 o 5, de 6 a 4 o 7.
Qué escribe: precios, stock, tiempo de preparación y estado de las ofertas (emag_marketplace_update_offers, emag_marketplace_update_offer_stock), productos nuevos con su oferta (emag_marketplace_save_product_offers), medidas, confirmación y estado de pedidos, adjuntos de pedidos (factura tipo 1, garantía tipo 3), desbloqueo de mensajería, AWB, estado de devoluciones y propuestas de campaña. Actúan sobre la tienda en vivo y sobre mensajerías reales. Antes de cada escritura la IA muestra qué cambia (ids de oferta con precio o stock antiguo y nuevo, pedido y nuevo estado, datos del AWB) y espera tu sí. Al instalar no hay nada desactivado; un administrador puede apagar cualquier herramienta de escritura que el equipo no necesite.
Leer los datos: id en las ofertas es tu propio id de producto de vendedor (ext_id); part_number_key (PNK) es la clave de producto de eMAG. Una oferta solo está a la venta con stock mayor que 0, estado 1, offer_validation_status 1 y validation_status 3, 9, 11 o 12. Los precios van sin IVA en la moneda de la plataforma (RON en Rumanía, EUR en Bulgaria desde el 1 de enero de 2026, HUF en Hungría). Las fechas son YYYY-mm-dd HH:ii:ss en la hora local de la plataforma.
Paginación y límites: las listas devuelven como máximo 100 por página; la IA cuenta primero y pagina con currentPage. Las ofertas elegibles de campaña usan paginación por cursor con el último ext_id como lastId. Los filtros de fecha de pedidos en el conteo necesitan ambos extremos, con un mes como máximo entre ellos. Las llamadas de guardado admiten como máximo 50 entidades (se recomiendan de 10 a 50) y 4000 campos de entrada por petición. eMAG permite 12 peticiones por segundo para pedidos y 3 por segundo para el resto de recursos juntos; por encima responde 429.
Errores comunes: You are not allowed to use this API. o 403 significa que la IP aún no está en la lista blanca. 401 significa usuario o contraseña incorrectos, un usuario sin derechos de API o un host de otra plataforma distinta a la de la cuenta. 429 es el límite de frecuencia: espera un momento. Las demás respuestas isError traen los mensajes de eMAG, por ejemplo características que faltan o un precio no válido.
El conector no abre una cuenta de vendedor, no registra tu IP en eMAG y no trabaja entre plataformas: un conector sirve a un país.
Requisitos previos: EMAG_API_HOST, EMAG_USERNAME, EMAG_PASSWORD
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige eMAG Marketplace e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| 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… |
Ejemplos de prompts
- "¿Cuántas de nuestras ofertas en eMAG están inactivas o tienen un estado de validación de oferta no válido?"
- "Lista los pedidos nuevos de eMAG (estado 1) de hoy con productos y forma de pago."
- "Baja el precio de la oferta 10452 a 189,90 RON sin IVA y pon su stock en 25. Enséñame antes los valores antiguos y nuevos."
- "Emite un AWB para el pedido 412398765 con nuestra cuenta de mensajería y dame el PDF en A6. Enséñame antes los datos del AWB."
- "¿Qué ofertas nuestras pueden entrar en la campaña Black Friday y cuál es su precio máximo de campaña?"
Siguientes pasos
¿Te ha sido útil esta guía?