In breve
API del venditore refurbed per i venditori di elettronica ricondizionata: ordini e articoli dell'ordine (accetta, spedizione con tracciamento e IMEI), simulazioni di rimborso, etichette di spedizione, fatture, resi, ticket di supporto, offerte con stock e prezzi, prezzi di mercato, ricerca di prodotti, profili di spedizione e corrieri. Token API da refurbed.
Configurazione guidata
Collega refurbed a Cursor in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega refurbed con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 refurbed
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 → refurbed, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
refurbed + Cursor
API del venditore refurbed per i venditori di elettronica ricondizionata: ordini e articoli dell'ordine (accetta, spedizione con tracciamento e IMEI), simulazioni di rimborso, etichette di spedizione, fatture, resi, ticket di supporto, offerte con stock e prezzi, prezzi di mercato, ricerca di prodotti, profili di spedizione e corrieri. Token API da refurbed.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
REFURBED_API_TOKEN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti. Hai bisogno della risposta di refurbed.
- Richiedi un token API con il modulo su supplier.refurbed.com/api-token-request (o chiedi al tuo account manager o a [email protected]). refurbed invia un token che assomiglia a un UUID.
- Incollalo in
REFURBED_API_TOKEN, installa e eseguirefurbed_list_orders. Il connettore lo invia comeAuthorization: Plainseguito dal token. - Un token non utilizzato per 2 mesi scade; quindi richiedi uno nuovo. Alcune chiamate devono anche essere abilitate da refurbed per il tuo account (etichette di spedizione, offerte di batterie nuove).
L'API funziona su https://api.refurbed.com. refurbed fornisce anche a ciascun venditore un sandbox su richiesta (supplier.refurbed.com/sandbox-request), a un indirizzo come https://grpc-<name>.qa.refurbed.io, con ordini di prova; un'installazione self-hosted può puntare una copia di questo connettore lì.
Dove iniziare: refurbed_list_orders con stati NEW mostra gli ordini da gestire; refurbed_get_order e refurbed_list_order_items mostrano gli articoli. Accetta con refurbed_accept_order_item, quindi spedisci con refurbed_ship_order_item (link di tracciamento, o slug del corriere da refurbed_list_available_carriers più numero di tracciamento, e l'IMEI o il seriale in item_identifiers). refurbed_batch_update_order_item_states gestisce fino a 50 articoli alla volta; refurbed_update_order_item cambia tracciamento, identificatori, note o dati doganali svizzeri in seguito; refurbed_get_order_item legge un articolo.
Stati degli articoli dell'ordine: NEW passa a ACCEPTED, REJECTED o CANCELLED; ACCEPTED passa a SHIPPED o CANCELLED; SHIPPED può diventare RETURNED. Saltare un passaggio fallisce con codice 9 (impossibile cambiare stato da new a shipped). REJECTED e CANCELLED sono finali e non rimborsano: refurbed_reject_order_item è installato disattivato, e refurbed si aspetta che tu informi il cliente tramite un ticket prima. Lo stato dell'ordine è calcolato dai suoi articoli. Non utilizzare i campi deprecati parcel_tracking_number, parcel_tracking_carrier e il singolo item_identifier.
Rimborsi: questo connettore non rimborsa mai. refurbed_calculate_item_refund e refurbed_calculate_order_refund sono simulazioni che mostrano gli importi; il rimborso stesso viene effettuato nell'interfaccia venditore (ha bisogno di un ticket aperto).
Etichette, fatture, resi, ticket: refurbed_list_shipping_labels fornisce link per etichette fresche; refurbed_create_shipping_label (disattivato) crea un'etichetta reale sull'accordo di spedizione di refurbed con ogni chiamata. refurbed_get_order_invoice collega la fattura che hai caricato. refurbed_list_returns elenca i resi con etichette di ritorno refurbed; imposta l'articolo su RETURNED quando il pacco arriva. refurbed_list_tickets e refurbed_get_ticket leggono i ticket dei clienti.
Offerte: refurbed_list_offers, refurbed_get_offer, refurbed_create_offer (trova il prodotto con refurbed_get_instance, il profilo con refurbed_list_shipping_profiles), refurbed_update_offer e refurbed_batch_update_offers per stock e prezzi. Identifica le offerte per SKU: gli id delle offerte cambiano quando un'offerta viene ricreata. Metti in pausa con stock 0; refurbed_delete_offer è disattivato. Prezzi fissi per mercato: refurbed_list_market_offers, refurbed_create_market_offer, refurbed_update_market_offer, refurbed_delete_market_offer (disattivato); solo i mercati del sito di refurbed_list_markets li accettano. Solo la garanzia M12 è accettata per nuove offerte; la classificazione è AA, A, B o C.
Altre ricerche: refurbed_list_merchant_addresses (id degli indirizzi del mittente per le etichette) e refurbed_get_currency (tassi di cambio; il controllo della configurazione lo utilizza).
Come funziona l'API: ogni chiamata è un POST di un corpo JSON a /refb.merchant.v1.<Service>/<Method>. I nomi dei campi sono snake_case; gli id sono numeri interi inviati e restituiti come stringhe ("3496079"); il denaro è una stringa decimale con un punto ("199.99", una virgola è rifiutata); i tempi sono RFC 3339 in UTC; gli enum sono inviati per nome. Fornisci un'offerta per sku o per id, mai entrambi. Le liste paginano con un cursore: passa l'ultimo id come starting_after mentre has_more è vero, fino a 100 righe. I batch prendono da 1 a 50 articoli e rispondono con uno stato per articolo.
Limiti ed errori: 10 richieste al secondo per impostazione predefinita (intestazioni X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset); oltre si ottiene 429 RESOURCE_EXHAUSTED. Gli errori rispondono con code e message con codici gRPC: 3 argomento non valido, 5 non trovato, 6 già esiste, 7 permesso negato, 9 precondizione non soddisfatta, 16 non autenticato.
Termini: i termini API di refurbed consentono agli integratori di agire per conto dei venditori, ma ogni azione deve essere tracciabile al venditore, e i dati API non possono essere rivenduti o utilizzati per benchmarking o intelligence di mercato.
Scritture: conferma prima. Accettare, spedire, tracciare, modifiche di stock e prezzo agiscono sull'account live. Prima di ogni chiamata mostra all'utente quali cambiamenti e attendi un sì.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Cursor
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
refurbed.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
refurbed_list_orders | Elenca gli ordini, i più recenti per primi per impostazione predefinita: id, released_at, stato (NEW, ACCEPTED, SHIPPED, FULFILLED, CANCELLED e altri), etichette (ad es.… |
refurbed_get_order | Leggi un ordine con tutti i suoi articoli: stato, etichette, email del cliente, indirizzo di spedizione e fatturazione (con numeri di partita IVA), totali e regolamento… |
refurbed_list_order_items | Elenca gli articoli di un ordine: id, nome, stato, sku, totali, commissione, tassazione, dati dell'offerta (id offerta, classificazione, garanzia, spedizione… |
refurbed_get_order_item | Leggi un articolo dell'ordine per il suo id (non l'id dell'ordine): stato, sku, prezzi e commissione, dati dell'offerta, link di tracciamento e corriere… |
refurbed_accept_order_item | Accetta un articolo dell'ordine NEW (stato ACCEPTED): confermi che lo spedirai. Risponde l'articolo aggiornato |
refurbed_ship_order_item | Contrassegna un articolo dell'ordine ACCEPTED come SHIPPED con il suo tracciamento: un URL completo di parcel_tracking_url, o parcel_carrier_tracking_number (slug del corriere e… |
refurbed_update_order_item | Cambia un articolo dell'ordine senza cambiare il suo stato: sostituisci il link di tracciamento o il numero di tracciamento del corriere, aggiungi identificatori (IMEI, seriale)… |
refurbed_batch_update_order_item_states | Cambia lo stato di fino a 50 articoli dell'ordine in una sola chiamata (accetta o spedisci diversi). Ogni aggiornamento ha i campi delle singole chiamate; la risposta… |
refurbed_reject_order_item | Rifiuta (articolo NEW) o annulla (articolo NEW o ACCEPTED) un articolo dell'ordine. Finale e non può essere annullato; non rimborsa il cliente da solo… |
refurbed_calculate_item_refund | Simulazione: mostra cosa significherebbe rimborsare un articolo dell'ordine (total_paid, total_refunded, refunded, le quote di refurbed e del venditore) senza… |
refurbed_calculate_order_refund | Simulazione: mostra cosa comporterebbe rimborsare tutti gli articoli rimborsabili di un ordine, senza rimborsare nulla |
refurbed_list_shipping_labels | Elenca le etichette di spedizione create per un ordine: id, link PDF della stampante (scadono dopo circa un'ora, chiama di nuovo per averne di fresche), tracciamento… |
refurbed_create_shipping_label | Crea un'etichetta di spedizione per un ordine sull'accordo di spedizione di refurbed (DHL Express oggi). Ogni chiamata crea una nuova etichetta reale e il suo… |
refurbed_get_order_invoice | Ottieni un link per il download (valido 24 ore) per la fattura che hai caricato per un ordine. NOT_FOUND quando non ce n'è |
refurbed_list_returns | Elenca i resi che utilizzano le etichette di ritorno refurbed: id, order_id, order_item_id, instance_name, identificatori, stato (INITIATED, IN_TRANSIT… |
refurbed_list_tickets | Elenca i ticket di supporto clienti: id, stato (OPEN, PENDING, SOLVED, CLOSED), argomento, urgenza, cliente, ordine e articolo dell'ordine… |
refurbed_get_ticket | Leggi un ticket di supporto con i suoi messaggi, argomento, stato, riferimenti all'ordine e note |
refurbed_list_offers | Elenca le tue offerte: id, sku, instance_id e instance_name, stato (OK, UNVERIFIED, PENDING_REVIEW, REJECTED con rejection_reason), classificazione… |
refurbed_get_offer | Leggi un'offerta per SKU o per id: stato, classificazione, garanzia, stock, profili di spedizione, tassazione, prezzi di riferimento e i prezzi di mercato con… |
refurbed_create_offer | Crea un'offerta per un prodotto: instance_id (refurbed_get_instance), o un gtin o mpn (l'offerta è quindi UNVERIFIED fino a quando refurbed controlla… |
refurbed_update_offer | Cambia un'offerta per SKU o id: stock, prezzo di riferimento e prezzo minimo, classificazione, garanzia, profilo di spedizione o tassazione; solo i campi forniti… |
refurbed_batch_update_offers | Cambia fino a 50 offerte in una sola chiamata (aggiornamenti di stock e prezzo). Ogni voce ha identificatore più i campi di refurbed_update_offer; la… |
refurbed_delete_offer | Elimina un'offerta per SKU o id. Non può essere annullato; per mettere in pausa un'offerta imposta stock 0 con refurbed_update_offer invece. Installato disattivato |
refurbed_list_market_offers | Elenca i prezzi per mercato di un'offerta: market_code, se è un mercato del sito, prezzo fisso o calcolato e prezzo minimo, valuta… |
refurbed_create_market_offer | Imposta un prezzo fisso per un'offerta in un mercato del sito invece del prezzo calcolato dal prezzo di riferimento. ALREADY_EXISTS quando il mercato… |
refurbed_update_market_offer | Cambia il prezzo fisso di un'offerta in un mercato. Fornisci l'offerta per sku o offer_id e il market_code |
refurbed_delete_market_offer | Rimuovi il prezzo fisso di un'offerta in un mercato; il prezzo torna al calcolo dal prezzo di riferimento. Installato disattivato |
refurbed_get_instance | Cerca un prodotto refurbed (istanza) per GTIN, MPN o id: id e nome. Usa l'id come instance_id quando crei offerte. Non esiste un prodotto… |
refurbed_list_shipping_profiles | Elenca i tuoi profili di spedizione: id, nome, paese di origine, mercati di destinazione con costi e tempi di consegna, e quanti articoli utilizzano ciascuno.… |
refurbed_list_available_carriers | Elenca i corrieri che refurbed può tracciare: nome e slug. Usa lo slug come corriere quando spedisci con un numero di tracciamento invece di un link. Cache… |
refurbed_list_markets | Elenca i mercati refurbed: codice (ad es. de, at, fr), nome, tipo, currency_code e is_site (un mercato con il proprio sito refurbed, dove i fissi… |
refurbed_list_merchant_addresses | Elenca i tuoi indirizzi: id, tipo (DELIVERY o RETURN), azienda, strada, città, codice postale e paese. L'id è l'indirizzo del mittente di un… |
refurbed_get_currency | Leggi una valuta e i suoi tassi di cambio. Non ha bisogno di dati del venditore; utilizzato per controllare che il token funzioni |
Esempi di prompt
- "Quali articoli dell'ordine refurbed stanno aspettando di essere accettati?"
- "Spedisci l'articolo dell'ordine 9123456 con tracciamento DHL 00340434161234567890 e IMEI 356789012345678."
- "Quali sono i miei prezzi delle offerte per mercato per l'iPhone 14 128 GB?"
- "Quali resi sono arrivati questa settimana?"
- "Quanto sarebbe un rimborso per l'articolo dell'ordine 9123456?"
FAQ
Da dove proviene il token API? Richiedilo con il modulo del token API di refurbed, dal tuo account manager o a [email protected]. I token non utilizzati scadono dopo due mesi.
Cosa copre? Ordini e articoli dell'ordine (accetta, spedizione con tracciamento e IMEI), simulazioni di rimborso, etichette di spedizione, fatture, resi, ticket di supporto, offerte con stock e prezzi, prezzi di mercato, ricerca di prodotti, profili di spedizione e corrieri.
Quali strumenti sono installati disattivati? refurbed_reject_order_item, refurbed_create_shipping_label, refurbed_delete_offer e refurbed_delete_market_offer. Attivali nella pagina del connettore solo se l'AI deve usarli.
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?