Guida al connettore11 minuti di lettura33 tool MCP7 lingue

Collegare refurbed MCP a Meta Muse

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.

HCA cura del team HelpCodeAggiornato 11 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

refurbed

refurbed

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

tool

33

Regione

INTL

Categoria

E-commerce

Autenticazione

API Key

Env vars richieste

REFURBED_API_TOKEN
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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 Meta Muse in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega refurbed con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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.

refurbed · live via MCP
Condividi
Opus 4.7

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 + Meta Muse

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.

  1. 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.
  2. Incollalo in REFURBED_API_TOKEN, installa e esegui refurbed_list_orders. Il connettore lo invia come Authorization: Plain seguito dal token.
  3. 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 Muse

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 mostra YOUR_SERVER_ID.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

  1. In Muse apri Settings → Connectors e scegli Add custom connector.
  2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
  4. In una chat, chiedi a Muse qualcosa che richiede i tool di refurbed.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Strumenti disponibili

StrumentoCosa fa
refurbed_list_ordersElenca 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_orderLeggi 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_itemsElenca gli articoli di un ordine: id, nome, stato, sku, totali, commissione, tassazione, dati dell'offerta (id offerta, classificazione, garanzia, spedizione…
refurbed_get_order_itemLeggi 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_itemAccetta un articolo dell'ordine NEW (stato ACCEPTED): confermi che lo spedirai. Risponde l'articolo aggiornato
refurbed_ship_order_itemContrassegna 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_itemCambia 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_statesCambia 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_itemRifiuta (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_refundSimulazione: mostra cosa significherebbe rimborsare un articolo dell'ordine (total_paid, total_refunded, refunded, le quote di refurbed e del venditore) senza…
refurbed_calculate_order_refundSimulazione: mostra cosa comporterebbe rimborsare tutti gli articoli rimborsabili di un ordine, senza rimborsare nulla
refurbed_list_shipping_labelsElenca 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_labelCrea 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_invoiceOttieni 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_returnsElenca i resi che utilizzano le etichette di ritorno refurbed: id, order_id, order_item_id, instance_name, identificatori, stato (INITIATED, IN_TRANSIT…
refurbed_list_ticketsElenca i ticket di supporto clienti: id, stato (OPEN, PENDING, SOLVED, CLOSED), argomento, urgenza, cliente, ordine e articolo dell'ordine…
refurbed_get_ticketLeggi un ticket di supporto con i suoi messaggi, argomento, stato, riferimenti all'ordine e note
refurbed_list_offersElenca le tue offerte: id, sku, instance_id e instance_name, stato (OK, UNVERIFIED, PENDING_REVIEW, REJECTED con rejection_reason), classificazione…
refurbed_get_offerLeggi 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_offerCrea 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_offerCambia 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_offersCambia 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_offerElimina 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_offersElenca 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_offerImposta 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_offerCambia il prezzo fisso di un'offerta in un mercato. Fornisci l'offerta per sku o offer_id e il market_code
refurbed_delete_market_offerRimuovi il prezzo fisso di un'offerta in un mercato; il prezzo torna al calcolo dal prezzo di riferimento. Installato disattivato
refurbed_get_instanceCerca 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_profilesElenca 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_carriersElenca 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_marketsElenca 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_addressesElenca 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_currencyLeggi 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.

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

Questa guida ti è stata utile?

Collega refurbed a Meta Muse in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega refurbed con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare refurbed MCP a ChatGPT: ordini e offerte

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.

Connettori

Collegare refurbed MCP a Claude: ordini e offerte

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.

Connettori

Collegare refurbed MCP a 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.

Connettori

Collegare refurbed MCP a Cursor: ordini e offerte

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.

Connettori

Collegare refurbed MCP a Gemini CLI

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.

Connettori

refurbed MCP Server: ordini, offerte e resi

refurbed Seller API per 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.