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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega refurbed con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
refurbed. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?