In breve
API venditore di Back Market per rigeneratori: ordini con accettazione e spedizione con tracciamento, inserzioni con prezzo e stock, prezzi di Backbox e concorrenti, categorie, cartelle e messaggi di assistenza clienti, consegne BackShip e ordini di BuyBack. Token API, per piattaforma (Europa, Stati Uniti, Asia-Pacifico).
Configurazione guidata
Collega Back Market a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Back Market 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 Back Market
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 Connettori → Back Market, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Back Market
API venditore di Back Market per rigeneratori: ordini con accettazione e spedizione con tracciamento, inserzioni con prezzo e stock, prezzi di Backbox e concorrenti, categorie, cartelle e messaggi di assistenza clienti, consegne BackShip e ordini di BuyBack. Token API, per piattaforma (Europa, Stati Uniti, Asia-Pacifico).
Configurazione
La configurazione richiede circa 3 minuti.
- Accedi al back office di Back Market della tua piattaforma:
https://www.backmarket.fr/bo-seller(Europa),https://www.backmarket.com/bo-seller(Stati Uniti) ohttps://www.backmarket.co.jp/bo-seller(Giappone e Australia). L'accesso API è fornito con un account venditore validato da Back Market. - Apri la pagina Integrazioni sotto Opzioni e crea un token API.
- Incolla il token come mostrato in
BACK_MARKET_TOKEN, senza la parola Basic davanti: il connettore lo invia comeAuthorization: Basicseguito dal token. - Scegli la tua piattaforma in
BACK_MARKET_HOSTe il tuo mercato principale inBACK_MARKET_MARKET(ad esempio fr-fr per l'Europa, en-us per gli Stati Uniti, ja-jp per l'Asia-Pacifico). Il mercato deve appartenere alla piattaforma.
Ogni chiamata porta il mercato in Accept-Language e l'User-Agent BM-AnythingMCP-Connector, che Back Market richiede. Gli strumenti con un argomento market possono guardare un altro mercato della stessa piattaforma per una chiamata.
Da dove iniziare: back_market_list_orders con stato 1 mostra ordini pagati le cui righe devi accettare, stato 3 gli ordini da spedire. back_market_list_listings mostra le tue offerte; back_market_list_backbox indica quali di esse detengono il Backbox.
Flusso di lavoro degli ordini: un ordine arriva in stato 1 una volta che il pagamento è stato convalidato (non spedire mai negli stati 0, 8 o 10). Accetta ogni riga con back_market_accept_order_line (da stato 1 a 2); l'ordine poi passa allo stato 3. Spedisci con back_market_ship_order e un numero di tracciamento (tutte le righe vanno in un pacco, stato ordine 9). back_market_get_order mostra gli stati delle righe. back_market_set_order_line_identifiers memorizza l'IMEI o il numero di serie del dispositivo; non può essere corretto in seguito. back_market_cancel_order_line e back_market_refund_order_line sono installati disattivati: entrambi rimborsano il cliente e non possono essere annullati, e le cancellazioni pesano sul Backbox.
Inserzioni: un'inserzione copre tutti i mercati della piattaforma. La quantità è condivisa; prezzo, commento e garanzia sono per mercato. back_market_get_listing trova un'inserzione per SKU; back_market_update_listing cambia prezzo o stock in tempo reale (quantità 0 la rende offline). back_market_import_listings (disattivato) invia un CSV per molte inserzioni contemporaneamente e risponde con un id di attività per back_market_get_task. back_market_get_competitors mostra il prezzo necessario per vincere il Backbox per mercato. back_market_get_category_tree e back_market_get_category_branch forniscono le categorie e gli attributi di cui un nuovo prodotto ha bisogno.
Assistenza clienti: back_market_list_care_folders e back_market_get_care_folder leggono i casi post-vendita con i loro messaggi; back_market_send_care_message risponde al cliente. back_market_create_care_refund è installato disattivato.
BackShip e BuyBack: back_market_list_deliveries e back_market_list_returns restituiscono solo dati per i venditori che utilizzano le etichette di BackShip di Back Market. back_market_list_buyback_orders e back_market_get_buyback_order leggono gli ordini di permuta; convalidare o controbattere uno decide quanto viene pagato al cliente e non è incluso.
Formati: i prezzi sono stringhe decimali con tasse, nella valuta del mercato (160.99). Gli id degli ordini e gli id delle righe degli ordini sono interi; gli id delle inserzioni sono UUID (l'id numerico listing_id è deprecato). Le date sono RFC 3339; i filtri delle cartelle di assistenza utilizzano YYYY-MM-DD-hh-mm. Le liste rispondono con count, next, previous e results; next è nullo nell'ultima pagina.
Limiti: più di 200 chiamate in 10 secondi sono bloccate per 10 secondi (chiamate al catalogo: 20 in 10 secondi), con un 429. Gli aggiornamenti delle inserzioni sono limitati a circa 2.000 righe SKU all'ora. Le chiamate di assistenza hanno limiti giornalieri (lista cartelle 4.000 al giorno, rimborsi 500 al giorno).
Risposte 403: Back Market si trova dietro Cloudflare. Un 403 con una pagina HTML o il codice bot-need-challenge significa che il firewall ha bloccato il chiamante, non che il token è errato: invia il valore cf-ray della risposta al tuo contatto di Back Market. Un token errato o mancante risponde anch'esso con 403 o 401, con un errore JSON.
Prerequisiti: BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET
Installa il connettore 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
Apri http://localhost:3000/connectors/store, scegli Back Market e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
back_market_list_orders | Elenca gli ordini, senza quelli non pagati (gli stati degli ordini 0 e 8 sono esclusi per impostazione predefinita). La risposta ha count, next, previous e results[]… |
back_market_get_order | Legge un ordine: order_id, stato, date_creation, date_modification, date_payment, date_shipping, expected_dispatch_date, prezzo e… |
back_market_accept_order_line | Accetta una riga di ordine pagata (da stato 1 a stato 2), che conferma che hai l'oggetto e lo spedirai. Accetta ogni riga dell'ordine, una… |
back_market_ship_order | Segna un ordine accettato come spedito con il suo numero di tracciamento (stato 3). Tutte le righe dell'ordine vanno in un pacco e sono impostate come spedite… |
back_market_cancel_order_line | Annulla una riga di ordine pagata che non puoi consegnare (da stato 1 a stato 4). Back Market rimborsa il cliente per quella riga, l'annullamento non può… |
back_market_refund_order_line | Rimborso di una riga d'ordine attraverso il flusso di lavoro dell'ordine: stato 5 per una riga accettata non ancora spedita, stato 6 per una riga spedita. Il cliente… |
back_market_set_order_line_identifiers | Registra l'IMEI e/o il numero di serie del dispositivo venduto su una riga d'ordine. Fornisci almeno uno dei due. Attenzione: una volta registrato, un… |
back_market_list_listings | Elenca le tue inserzioni (offerte): id (UUID), listing_id (vecchio id numerico), sku, titolo, product_id, grado (PREMIUM, EXCELLENT, VERY_GOOD, GOOD… |
back_market_get_listing | Legge un'inserzione per il tuo SKU o per il suo id di Back Market: id, listing_id, sku, titolo, product_id, grado, quantità, prezzo, min_price… |
back_market_update_listing | Cambia un'inserzione in tempo reale: prezzo, quantità di stock, commento, garanzia o il prezzo minimo per il BackPricer. Solo i campi forniti… |
back_market_import_listings | Crea o aggiorna molte inserzioni (e propone nuovi prodotti) da testo CSV, fino a 15.000 righe. Ogni riga ha bisogno del tuo sku; una nuova inserzione deve… |
back_market_get_task | Legge il risultato di un'attività batch avviata da back_market_import_listings: task_id, action_status (0 o 2 = in attesa o in esecuzione, 8 = fallita, 9… |
back_market_list_backbox | Elenca i dati di Backbox per inserzione: sku, prodotto, prezzo, quantità, buybox (vero quando la tua inserzione detiene il Backbox), price_for_buybox (il… |
back_market_get_competitors | Legge la concorrenza del Backbox di un'inserzione, una riga per mercato: is_winning, prezzo, min_price, price_to_win e winner_price (ognuno con… |
back_market_get_category_tree | Legge l'intero albero delle categorie: category_id, category_name, marketplace_category_id (il valore che la categoria di un prodotto deve corrispondere), is_leaf e… |
back_market_get_category_branch | Legge una categoria con gli stessi campi dell'albero: category_id, category_name, marketplace_category_id, is_leaf e attributes[] con… |
back_market_list_care_folders | Elenca le cartelle di assistenza clienti (casi post-vendita, SAV), 10 per pagina: id, orderline, stato (0 aperto, 9 chiuso), date_creation… |
back_market_get_care_folder | Legge una cartella di assistenza clienti: stato, date, il cliente (nome, cognome, email), la riga d'ordine con il suo ordine e indirizzi, il… |
back_market_send_care_message | Invia un messaggio al cliente in una cartella di assistenza (solo testo, senza allegato). Il cliente lo vede sulla piattaforma post-vendita di Back Market… |
back_market_create_care_refund | Rimborso di una riga d'ordine dall'assistenza clienti: rimborso totale di una riga pagata (tipo 4), rimborso totale di una riga accettata (tipo 5), o un rimborso parziale o… |
back_market_list_deliveries | Elenca le consegne di BackShip (solo per venditori iscritti al servizio di spedizione BackShip di Back Market): ordine, shipmentId, orderlines… |
back_market_list_returns | Elenca i resi di prodotto di BackShip (solo per venditori iscritti a BackShip): orderId, orderlineId, shipmentId, carrierName, trackingNumber… |
back_market_list_buyback_orders | Elenca gli ordini di BuyBack (permuta), i dispositivi che i clienti ti vendono: orderPublicId, stato, mercato, creationDate, shippingDate, receivalDate… |
back_market_get_buyback_order | Legge un ordine di BuyBack (permuta): stato, mercato, date (creazione, spedizione, ricezione, pagamento, controproposta), l'inserzione, il… |
Esempi di richieste
- "Quali ordini di Back Market hanno righe in attesa della mia accettazione?"
- "Quali delle mie inserzioni hanno perso il Backbox, e quale prezzo lo riconquisterebbe?"
- "Imposta lo stock della mia inserzione di iPhone 13 rigenerato da 128 GB a 12."
- "Spedisci l'ordine 41234567 con tracciamento Colissimo 6A12345678901 e l'IMEI di ogni riga."
- "Quali cartelle di assistenza clienti sono aperte, e cosa chiedono i clienti?"
Prossimi passi
Questa guida ti è stata utile?