In breve
Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.
Configurazione guidata
Collega Grupo Éxito Marketplace a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Grupo Éxito Marketplace con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Grupo Éxito Marketplace
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Grupo Éxito Marketplace, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, nessun server locale.
Grupo Éxito Marketplace
Lascia che la tua AI gestisca il tuo negozio marketplace su exito.com in Colombia tramite l'API per venditori di Grupo Éxito: elenca i tuoi prodotti e il loro stato di approvazione, crea prodotti con immagini, descrizioni e attributi, imposta prezzi e giacenze e leggi ordini ed estratti dei pagamenti.
Configurazione
La configurazione richiede circa 10 minuti, una volta che Éxito ti ha concesso l'accesso all'API. Insieme all'accesso, Éxito invia le istruzioni di autenticazione: un nome utente, una password, una chiave API e l'indirizzo che emette il token. Ti serve anche il tuo ID venditore numerico.
Non esiste una sandbox: Éxito non ne documenta alcuna, quindi ogni chiamata, comprese le scritture, agisce sul tuo negozio reale.
- Incolla l'utente API (un indirizzo e-mail) in
EXITO_USERNAMEe la password API inEXITO_PASSWORD, entrambi presenti nelle istruzioni di Éxito. - Incolla la
x-api-keydelle stesse istruzioni inEXITO_API_KEY. - Incolla in
EXITO_LOGIN_URLl'indirizzohttps://completo della richiesta del token. Non è pubblicato su developers.exito.com, quindi copialo dal documento inviato da Éxito. - Inserisci il tuo ID venditore numerico (idSeller, ad es.
11795) inEXITO_SELLER_ID. Ancheexito_marketplace_get_bulk_upload_statuslo mostra comedata.idSeller. - Installa il connettore. Esegui
exito_marketplace_list_categoriesper verificare la connessione.
Come effettua l'accesso: il connettore richiede un token all'indirizzo del token con il tuo nome utente, la password e la chiave API, e lo invia insieme alla chiave API a ogni chiamata. I token vengono rinnovati automaticamente, al più tardi ogni ora. La password e la chiave sono memorizzate in forma cifrata e non vengono mai mostrate all'AI.
Cloud e self-hosted funzionano allo stesso modo: le credenziali sono le stesse e non c'è alcun URL di reindirizzamento da impostare.
Vendere su Éxito è asincrono:
- Scegli la categoria più specifica con
exito_marketplace_list_categoriese leggi le sue specifiche conexito_marketplace_get_category_features. Le specifiche obbligatorie devono essere inviate; una specifica con un elenco di valori accetta solo quelli. - Crea i prodotti con
exito_marketplace_create_products, fino a 400 EAN per chiamata. Le immagini sono URL pubblici, di 1000x1000 px (733x1000 px per l'abbigliamento). Il marchio deve già esistere presso Éxito; il tuo account manager di Éxito crea quelli mancanti. - Segui il lotto con
exito_marketplace_get_bulk_upload_status. Non viene accettato nessun nuovo lotto finché uno è in avvio o in elaborazione. - Il team dei contenuti di Éxito revisiona ogni prodotto.
exito_marketplace_get_products_waitingelenca quelli in revisione,exito_marketplace_get_products_rejectedquelli rifiutati con il motivo, eexito_marketplace_get_products_pending_seller_approvalquelli che differiscono dallo stesso prodotto già presente nel marketplace. Dopo l'approvazione, un prodotto richiede fino a un'ora prima di poter ricevere un'offerta. - Assegna un prezzo e una giacenza ai prodotti approvati con
exito_marketplace_upsert_offersoppure, per un singolo EAN, conexito_marketplace_update_offer_price_stock.exito_marketplace_load_products_and_offersinvia prodotti e offerte in un'unica richiesta. Le offerte raggiungono i siti entro circa 4 ore.
Prezzi e giacenze: i prezzi sono in pesos colombiani interi superiori a 8000, senza separatori (45000). Un prezzo scontato deve essere inferiore al prezzo. Per modificare solo il prezzo, invia la giacenza attuale con IsUpdatedStock 0. Una variazione di prezzo superiore al 30% restituisce il codice PEX e va inviata di nuovo con l'approvazione del prezzo: l'AI te lo chiede prima di farlo. Per smettere di vendere un prodotto, imposta la sua giacenza a 0: l'API non prevede l'eliminazione.
Ordini e pagamenti: exito_marketplace_get_orders elenca gli ordini di exito.com, carulla.com e degli altri siti di Éxito, con stato, totali, commissione e tipo di consegna. exito_marketplace_get_bills elenca gli estratti dei pagamenti. Gli elenchi sono paginati con paginationToken.
Disattivati all'installazione: exito_marketplace_set_order_tracking (segna come spediti i prodotti di un ordine, con corriere e numero di tracciamento) e exito_marketplace_upload_order_invoice (allega la fattura a un ordine). Attivali nella pagina del connettore quando l'AI deve gestire gli ordini; l'AI ti chiede di confermare ogni chiamata. La creazione di prodotti e l'impostazione di prezzi e giacenze sono attive (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Leggi ogni risposta: le scritture in blocco rispondono con HTTP 200 e un messaggio per ogni EAN rifiutato, quindi un 200 non significa che ogni prodotto o offerta sia stato accettato. Richieste e risposte sono in spagnolo.
Non coperto: etichette di spedizione, moderazione e notifiche delle offerte di Éxito, e tutto ciò che l'app web Seller Center fa e l'API non offre.
Errori comuni: se non viene emesso alcun token, controlla nome utente, password e chiave API rispetto alle istruzioni di Éxito e verifica che EXITO_LOGIN_URL sia l'indirizzo del token indicato in quel documento. 401 significa che il token è stato rifiutato. 403 di solito significa che la chiave API manca o è errata, oppure che l'API non è abilitata per il tuo utente: chiedi a Éxito quali API copre il tuo accesso.
Prerequisiti: EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Installare il connettore in locale
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
Apri http://localhost:3000/connectors/store, scegli Grupo Éxito Marketplace e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Tool | Cosa fa |
|---|---|
exito_marketplace_get_products | Elenca i prodotti del venditore nel marketplace di Éxito con nome, EAN, VTEX PLU, immagine, date di creazione e aggiornamento, prezzo, prezzo scontato, giacenza… |
exito_marketplace_get_products_waiting | Prodotti in attesa di approvazione da parte del team dei contenuti di Éxito (moderazione), con EAN, nome, immagine, data di elaborazione e riferimento padre |
exito_marketplace_get_products_rejected | Prodotti che il team dei contenuti di Éxito ha rifiutato e che devono essere corretti, con EAN, nome, immagine, Reason e Comment del rifiuto |
exito_marketplace_get_products_pending_seller_approval | Prodotti che richiedono una tua decisione perché differiscono dallo stesso prodotto già presente nel marketplace: ogni riga ha oldProduct e… |
exito_marketplace_get_bulk_upload_status | Stato del tuo ultimo lotto di creazione prodotti (exito_marketplace_create_products). data.status: 4 in avvio, 1 in elaborazione, 2 completato… |
exito_marketplace_list_categories | Tutte le categorie del marketplace di Éxito con Id, IdParent, Name e ProductType (Technology o Clothing) |
exito_marketplace_get_category | Una categoria per id: Id, IdParent, Name e ProductType |
exito_marketplace_get_category_features | Gruppi di specifiche di una categoria: per ogni specifica il suo specName, l'etichetta, se è obbligatoria e i suoi valori ammessi (values[].label; an… |
exito_marketplace_get_orders | Ordini ricevuti tramite i siti di Éxito (exito.com, carulla.com e altri) con numero d'ordine, canale, date, stato, totali, commissione… |
exito_marketplace_get_bills | Estratti dei pagamenti (fatturazione) del venditore: numero di fatturazione, numero d'ordine, ordine di pagamento, causale, data di pagamento, commissione, totale, IVA e… |
exito_marketplace_create_products | Crea prodotti (o modifica quelli esistenti: invia di nuovo lo stesso EAN; ModifyImage "1" sostituisce le immagini) con titolo, descrizione HTML… |
exito_marketplace_load_products_and_offers | Invia prodotti insieme alle loro offerte in un'unica richiesta: ogni elemento ha un Product (i campi di exito_marketplace_create_products) e un… |
exito_marketplace_upsert_offers | Crea o aggiorna offerte (prezzo, prezzo scontato, giacenza, spedizione e tempi di consegna promessi) per gli EAN già approvati da Éxito, su tutti i siti di Éxito… |
exito_marketplace_update_offer_price_stock | Modifica il prezzo e/o la giacenza di una singola offerta esistente (un EAN). Éxito richiede EAN, Stock e Price a ogni aggiornamento: per modificare solo il prezzo… |
exito_marketplace_set_order_tracking | Segna come spediti i prodotti di un ordine con corriere e numero di tracciamento (ordini con consegna standard) |
exito_marketplace_upload_order_invoice | Allega la fattura di un ordine come PDF o ZIP in base64 |
Prompt di esempio
- "Quali dei miei prodotti ha rifiutato Éxito, e perché?"
- "Mostra gli ordini che mi sono stati assegnati questa settimana e che devono ancora essere spediti."
- "Qual è il prezzo e la giacenza dell'EAN 7701234567890 su exito.com?"
- "Imposta la giacenza dell'EAN 7701234567890 a 25 unità e mantieni il prezzo."
- "Somma la commissione nei miei estratti dei pagamenti di ottobre."
Prossimi passi
Questa guida ti è stata utile?