Resumen
Deja que tu IA gestione tu tienda del marketplace de exito.com en Colombia a través de la API para vendedores de Grupo Éxito: lista tus productos y su estado de aprobación, crea productos con imágenes, descripciones y atributos, define precios y stock, y consulta pedidos y extractos de pago.
Configuración guiada
Conecta Grupo Éxito Marketplace a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Grupo Éxito Marketplace con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Grupo Éxito 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.
💡 ¿No quieres instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Grupo Éxito Marketplace, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Grupo Éxito Marketplace
Deja que tu IA gestione tu tienda del marketplace de exito.com en Colombia a través de la API para vendedores de Grupo Éxito: lista tus productos y su estado de aprobación, crea productos con imágenes, descripciones y atributos, define precios y stock, y consulta pedidos y extractos de pago.
Configuración
La configuración lleva unos 10 minutos una vez que Éxito te ha concedido acceso a la API. Junto con ese acceso, Éxito envía las instrucciones de autenticación: un nombre de usuario, una contraseña, una clave de API y la dirección que emite el token. También necesitas tu identificador numérico de vendedor.
No hay sandbox: Éxito no documenta ninguno, así que cada llamada, incluidas las de escritura, actúa sobre tu tienda real.
- Pega el usuario de la API (una dirección de correo electrónico) en
EXITO_USERNAMEy la contraseña de la API enEXITO_PASSWORD, ambos tal como figuran en las instrucciones de Éxito. - Pega el
x-api-keyde esas mismas instrucciones enEXITO_API_KEY. - Pega la dirección completa
https://de la solicitud del token enEXITO_LOGIN_URL. No está publicada en developers.exito.com, así que cópiala del documento que te envió Éxito. - Introduce tu identificador numérico de vendedor (idSeller, p. ej.
11795) enEXITO_SELLER_ID.exito_marketplace_get_bulk_upload_statustambién lo muestra comodata.idSeller. - Instala el conector. Ejecuta
exito_marketplace_list_categoriespara comprobar la conexión.
Cómo inicia sesión: el conector solicita un token a la dirección del token con tu usuario, contraseña y clave de API, y lo envía junto con la clave de API en cada llamada. Los tokens se renuevan automáticamente, como máximo cada hora. La contraseña y la clave se almacenan cifradas y nunca se muestran a la IA.
La nube y el autoalojamiento funcionan igual: las credenciales son las mismas y no hay que configurar ninguna URL de redirección.
Vender en Éxito es asíncrono:
- Elige la categoría más específica con
exito_marketplace_list_categoriesy consulta sus especificaciones conexito_marketplace_get_category_features. Las especificaciones obligatorias deben enviarse; una especificación con una lista de valores solo acepta esos valores. - Crea productos con
exito_marketplace_create_products, hasta 400 EAN por llamada. Las imágenes son URL públicas de 1000x1000 px (733x1000 px para ropa). La marca debe existir ya en Éxito; tu gestor de cuenta de Éxito crea las que falten. - Sigue el lote con
exito_marketplace_get_bulk_upload_status. No se acepta ningún lote nuevo mientras otro se está iniciando o procesando. - El equipo de contenido de Éxito revisa cada producto.
exito_marketplace_get_products_waitinglista los que están en revisión,exito_marketplace_get_products_rejectedlos rechazados con el motivo, yexito_marketplace_get_products_pending_seller_approvallos que difieren del mismo producto que ya está en el marketplace. Tras la aprobación, un producto necesita hasta una hora antes de poder recibir una oferta. - Asigna precio y stock a los productos aprobados con
exito_marketplace_upsert_offerso, para un solo EAN, conexito_marketplace_update_offer_price_stock.exito_marketplace_load_products_and_offersenvía productos y ofertas en una sola solicitud. Las ofertas llegan a los sitios en unas 4 horas.
Precios y stock: los precios son pesos colombianos enteros superiores a 8000, sin separadores (45000). El precio de oferta debe ser inferior al precio. Para cambiar solo el precio, envía el stock actual con IsUpdatedStock 0. Un cambio de precio superior al 30 % devuelve el código PEX y hay que enviarlo de nuevo con aprobación de precio: la IA te pregunta antes de hacerlo. Para dejar de vender un producto, pon su stock en 0: la API no permite eliminar.
Pedidos y pagos: exito_marketplace_get_orders lista los pedidos de exito.com, carulla.com y otros sitios de Éxito, con estado, totales, comisión y tipo de entrega. exito_marketplace_get_bills lista los extractos de pago. Las listas se paginan con paginationToken.
Desactivadas al instalar: exito_marketplace_set_order_tracking (marcar como enviados los productos de un pedido, con transportista y número de seguimiento) y exito_marketplace_upload_order_invoice (adjuntar la factura a un pedido). Actívalas en la página del conector cuando quieras que la IA gestione pedidos; la IA te pide confirmación en cada llamada. La creación de productos y la definición de precios y stock están activadas (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Lee cada respuesta: las escrituras por lotes responden con HTTP 200 y un mensaje por cada EAN rechazado, así que un 200 no significa que todos los productos u ofertas fueran aceptados. Las solicitudes y las respuestas están en español.
No cubierto: etiquetas de envío, la moderación de Éxito y las notificaciones de ofertas, y cualquier cosa que haga la aplicación web Seller Center y que la API no ofrezca.
Errores comunes: si no se emite ningún token, comprueba el usuario, la contraseña y la clave de API con las instrucciones de Éxito, y que EXITO_LOGIN_URL sea la dirección del token de ese documento. 401 significa que el token fue rechazado. 403 suele significar que falta la clave de API o es incorrecta, o que la API no está habilitada para tu usuario: pregunta a Éxito qué API cubre tu acceso.
Requisitos previos: EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Instala el conector en local
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 Grupo Éxito Marketplace y pega las variables de entorno indicadas en Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
exito_marketplace_get_products | Lista los productos del vendedor en el marketplace de Éxito con nombre, EAN, PLU de VTEX, imagen, fechas de creación y actualización, precio, precio de oferta, stock… |
exito_marketplace_get_products_waiting | Productos pendientes de aprobación por el equipo de contenido de Éxito (moderación), con EAN, nombre, imagen, fecha de procesamiento y referencia padre |
exito_marketplace_get_products_rejected | Productos que el equipo de contenido de Éxito rechazó y que deben corregirse, con EAN, nombre, imagen, Reason y Comment del rechazo |
exito_marketplace_get_products_pending_seller_approval | Productos que requieren tu decisión porque difieren del mismo producto que ya está en el marketplace: cada fila tiene oldProduct y… |
exito_marketplace_get_bulk_upload_status | Estado de tu último lote de creación de productos (exito_marketplace_create_products). data.status: 4 iniciando, 1 procesando, 2 completado… |
exito_marketplace_list_categories | Todas las categorías del marketplace de Éxito con Id, IdParent, Name y ProductType (Technology o Clothing) |
exito_marketplace_get_category | Una categoría por id: Id, IdParent, Name y ProductType |
exito_marketplace_get_category_features | Grupos de especificaciones de una categoría: para cada especificación, su specName, label, si es obligatoria y sus valores permitidos (values[].label; un… |
exito_marketplace_get_orders | Pedidos recibidos a través de los sitios de Éxito (exito.com, carulla.com y otros) con número de pedido, canal, fechas, estado, totales, comisión… |
exito_marketplace_get_bills | Extractos de pago (facturación) del vendedor: número de facturación, número de pedido, orden de pago, concepto, fecha de pago, comisión, total, IVA y… |
exito_marketplace_create_products | Crea productos (o modifica los existentes: envía de nuevo el mismo EAN; ModifyImage "1" reemplaza las imágenes) con título, descripción HTML… |
exito_marketplace_load_products_and_offers | Envía productos junto con sus ofertas en una sola solicitud: cada elemento tiene un Product (los campos de exito_marketplace_create_products) y un… |
exito_marketplace_upsert_offers | Crea o actualiza ofertas (precio, precio de oferta, stock, envío y promesa de entrega) para EAN que Éxito ya aprobó, en todos los sitios de Éxito… |
exito_marketplace_update_offer_price_stock | Cambia el precio y/o el stock de una oferta existente (un EAN). Éxito necesita EAN, Stock y Price en cada actualización: para cambiar solo el precio… |
exito_marketplace_set_order_tracking | Marca productos de un pedido como enviados con el transportista y el número de seguimiento (pedidos con entrega estándar) |
exito_marketplace_upload_order_invoice | Adjunta la factura de un pedido como PDF o ZIP en base64 |
Ejemplos de prompts
- "¿Qué productos míos rechazó Éxito y por qué?"
- "Muéstrame los pedidos que me han asignado esta semana y que todavía hay que enviar."
- "¿Cuál es el precio y el stock del EAN 7701234567890 en exito.com?"
- "Pon el stock del EAN 7701234567890 en 25 unidades y mantén el precio."
- "Suma la comisión de mis extractos de pago de octubre."
Siguientes pasos
¿Te ha sido útil esta guía?