In breve
API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi negli Stati Uniti, confronta tariffe e tempi di transito, trova luoghi di consegna e punti di accesso, stima il costo totale, recupera etichette e richiedi ritiri. La creazione di spedizioni, le annullazioni e i ritiri sono inclusi ma disattivati. ID client OAuth e segreto dal Portale Sviluppatori UPS.
Configurazione guidata
Collega UPS a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega UPS 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 UPS
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 → UPS, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
UPS
API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi negli Stati Uniti, confronta tariffe e tempi di transito, trova luoghi di consegna e punti di accesso, stima il costo totale, recupera etichette e richiedi ritiri. La creazione di spedizioni, le annullazioni e i ritiri sono inclusi ma disattivati. ID client OAuth e segreto dal Portale Sviluppatori UPS.
Configurazione
La configurazione richiede circa 10 minuti.
- Accedi a https://developer.ups.com con il profilo ups.com che possiede il tuo account spedizioni (registrane uno prima se necessario) e apri la pagina per creare un'applicazione.
- Dì che vuoi integrare la tecnologia UPS nella tua attività, scegli il numero di account UPS a cui l'app dovrebbe fatturare e dai un nome all'app.
- Aggiungi i prodotti utilizzati dal connettore: Tracciamento, Validazione Indirizzi, Valutazione, Tempo di Transito, Localizzatore, e, per gli strumenti disattivati, Spedizione, Ritiro e Preventivo Costo Totale. Un prodotto mancante restituisce errori 401 o 403 solo per i suoi strumenti.
- Copia il Client ID in
UPS_CLIENT_IDe il Client Secret inUPS_CLIENT_SECRET. - Inserisci il tuo numero di account UPS di 6 caratteri (numero spedizioniere) in
UPS_ACCOUNT_NUMBER.
Il connettore scambia l'ID client e il segreto a https://onlinetools.ups.com/security/v1/oauth/token (credenziali client, HTTP Basic) per un token bearer a breve termine e lo rinnova autonomamente. Queste sono credenziali di produzione; il sistema di test UPS (wwwcie.ups.com) non è utilizzato.
Da dove iniziare: ups_track_package con un numero di tracciamento. Per un prezzo, ups_shop_rates confronta tutti i servizi tra due indirizzi e ups_get_rate valuta un servizio; ups_get_time_in_transit fornisce date di consegna senza prezzi.
Tracciamento: ups_track_package (qualsiasi numero di tracciamento), ups_track_by_reference (il tuo riferimento, ad esempio un numero d'ordine, all'interno del tuo account) e ups_track_shipment_packages (tutti i pacchi di una spedizione multipla). Le date sono YYYYMMDD e gli orari HHMMSS nell'ora locale della scansione; gmtDate, gmtTime e gmtOffset forniscono lo stesso momento in UTC. Leggi lo stato da currentStatus.description e le scansioni da activity, le più recenti per prime.
Indirizzi e localizzazioni: ups_validate_address copre solo indirizzi stradali negli Stati Uniti e a Porto Rico. ups_find_locations trova luoghi di consegna e localizzazioni UPS Access Point vicino a un indirizzo in qualsiasi paese servito da UPS.
Tariffe: ups_shop_rates e ups_get_rate inviano il tuo numero di account come numero spedizioniere. Le tariffe pubblicate tornano per impostazione predefinita; passa rating_options con NegotiatedRatesIndicator per vedere le tariffe contrattuali del tuo account in NegotiatedRateCharges. Gli importi sono stringhe nella valuta indicata accanto a loro. I pesi sono in LBS o KGS e le dimensioni in IN o CM: usa le unità del paese di origine. ups_quote_landed_cost stima dazi e tasse per una spedizione transfrontaliera e funziona meglio con un codice HS per articolo.
Etichette e spedizioni: ups_recover_label restituisce nuovamente l'etichetta di una spedizione esistente e non costa nulla. ups_create_shipment crea una spedizione che UPS fattura all'account, e ups_void_shipment annulla una spedizione prima del ritiro; entrambi sono installati disattivati. Attivali nel connettore solo se l'assistente deve creare spedizioni reali. I nomi dei campi UPS differiscono tra le chiamate: gli strumenti di valutazione chiamano l'imballaggio PackagingType, lo strumento di spedizione Packaging.
Ritiri: ups_get_pickup_rate quota un ritiro su chiamata e ups_get_pending_pickups elenca quelli prenotati. ups_create_pickup prenota un autista per una tariffa e ups_cancel_pickup annulla tramite PRN; entrambi sono installati disattivati.
Errori: UPS risponde con response.errors, un elenco di code e message. 401 significa che le credenziali o il token sono stati rifiutati, 403 che l'app non ha accesso a quel prodotto o che UPS ha bloccato l'account, 404 su tracciamento che UPS non ha dati per il numero ancora (le etichette appaiono dopo la prima scansione o alcune ore dopo la creazione), 429 che la quota dell'app è esaurita.
Limiti: UPS imposta una quota per app e prodotto e non pubblica i numeri nei suoi file API; un 429 significa attendere e riprovare più tardi. Tracciare un numero per chiamata è l'uso documentato: non fare loop su lunghe liste rapidamente.
Prerequisiti: UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
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 UPS e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
ups_track_package | Traccia un pacco UPS tramite numero di tracciamento: stato attuale con codice e descrizione, ogni scansione (data come YYYYMMDD, ora locale come HHMMSS… |
ups_track_by_reference | Trova e traccia spedizioni del tuo account UPS tramite un numero di riferimento che hai messo sulla spedizione (numero d'ordine, numero di fattura). Restituisce lo stesso… |
ups_track_shipment_packages | Traccia ogni pacco di una spedizione multipla UPS da uno dei suoi numeri di tracciamento: per pacco il numero di tracciamento, stato attuale, ultima… |
ups_validate_address | Controlla un indirizzo stradale negli Stati Uniti o a Porto Rico contro i dati UPS. Restituisce ValidAddressIndicator, AmbiguousAddressIndicator… |
ups_get_rate | Valuta un servizio UPS per una spedizione. Restituisce RateResponse.RatedShipment con il codice del servizio, peso di fatturazione, trasporto, servizio… |
ups_shop_rates | Confronta ogni servizio UPS disponibile tra due indirizzi per una spedizione. Restituisce un RatedShipment per servizio con il suo codice, fatturazione… |
ups_get_time_in_transit | Elenca i servizi UPS disponibili tra due luoghi sotto emsResponse.services: serviceLevel e serviceLevelDescription… |
ups_find_locations | Trova luoghi di consegna UPS vicino a un indirizzo: localizzazioni UPS Access Point, The UPS Store, centri clienti e cassette postali. Restituisce… |
ups_quote_landed_cost | Stima dazi, tasse e spese di intermediazione per una spedizione internazionale prima che venga spedita (Preventivo Costo Totale UPS). Restituisce per merce il… |
ups_recover_label | Ottieni nuovamente l'etichetta di una spedizione che esiste già, tramite numero di tracciamento. Restituisce LabelRecoveryResponse.LabelResults con l'etichetta come… |
ups_get_pickup_rate | Quota quanto costerebbe un ritiro UPS su chiamata a un indirizzo, senza prenotarlo. Restituisce PickupRateResponse.RateResult con il tipo di tariffa… |
ups_get_pending_pickups | Elenca i ritiri prenotati sul tuo account UPS che non sono ancora avvenuti. Restituisce PickupPendingStatusResponse.PendingStatus con il ritiro… |
ups_create_shipment | Crea una spedizione UPS e la sua etichetta. UPS fattura la spedizione al tuo account non appena questa chiamata ha successo, quindi lo strumento è installato… |
ups_void_shipment | Annulla (cancella) una spedizione UPS che è stata creata ma non ancora ritirata, o pacchi singoli di essa. Non può essere annullato: le etichette diventano… |
ups_create_pickup | Prenota un ritiro UPS su chiamata: un autista viene all'indirizzo nel giorno indicato. UPS addebita una tariffa di ritiro al tuo account, quindi lo strumento è… |
ups_cancel_pickup | Annulla un ritiro UPS prenotato tramite il suo numero di richiesta di ritiro (PRN). Non può essere annullato; deve essere prenotato un nuovo ritiro. Restituisce… |
Esempi di richieste
- "Dove si trova il pacco UPS 1Z999AA10123456784?"
- "Confronta le tariffe UPS da Chicago 60601 a Austin 78701 per una scatola da 5 libbre."
- "1600 Amphitheatre Pkwy, Mountain View, CA 94043 è un indirizzo valido?"
- "Quando arriverebbe un pacco UPS Ground da Atlanta a Seattle se spedito oggi?"
- "Trova localizzazioni UPS Access Point vicino a 10115 Berlino."
Prossimi passi
Questa guida ti è stata utile?