Collegare UPS

allverto crea etichette UPS tramite l'interfaccia ufficiale di UPS (Shipping API). La fatturazione avviene con il tuo numero cliente UPS: porti il tuo contratto UPS.

#Prima di iniziare

• un account UPS con numero cliente (shipper number, 6 caratteri, riportato sulle tue fatture UPS),
• un utente nel UPS Developer Portal (developer.ups.com) con accesso a questo numero cliente,
• un'app nel Developer Portal con i prodotti Authorization (OAuth) e Shipping, collegata al tuo numero cliente. L'app ti mostra Client ID e Client secret.
• Per le spedizioni all'estero l'Indirizzo del mittente richiede un Numero di telefono.

#Creare un'app nel UPS Developer Portal

1. Accedi a developer.ups.com con il tuo account UPS.
2. Scegli Create Application (crea applicazione) e collegala al tuo numero cliente UPS.
3. Aggiungi i prodotti Authorization (OAuth) e Shipping.
4. Copia Client ID e Client Secret dai dettagli dell'app.

#Passo dopo passo

1. Apri Spedizione → Impostazioni → Corrieri e compila l'Indirizzo del mittente.
2. Clicca su Collega corriere e scegli UPS.
3. Indica un nome in allverto e scegli il Prodotto predefinito: UPS Standard, UPS Express Saver, UPS Express o UPS Expedited.
4. Inserisci Numero cliente UPS, Client ID e Client secret.
5. Scegli il Formato etichetta (PDF 10 × 15 cm, PDF su A4 o ZPL per stampanti Zebra).
6. La Modalità di prova usa l'ambiente di test UPS (CIE). Le etichette di test non sono valide.
7. Clicca su Prova accesso e poi su Collega.

#Annullare

Le spedizioni UPS le annulli in Spedizione → Spedizioni con clic destro → Annulla spedizione…, finché UPS non ha ancora ritirato il pacco. Se non è più possibile, allverto segnala “La spedizione non può più essere annullata”.

#Estero e dogana

Per destinazioni fuori dall'UE allverto trasmette elettronicamente a UPS la fattura commerciale: articolo, quantità, valore, codice doganale e paese d'origine dall'articolo (Spedizione e dogana). Con l'etichetta PDF la fattura commerciale di UPS è aggiunta come pagina successiva all'etichetta. Con ZPL la stampi separatamente.

#Domande frequenti

#“UPS rifiuta l'accesso”

Client ID o client secret non sono corretti, oppure l'app non è abilitata per l'ambiente di test o per il sistema live. Controlla l'app nel Developer Portal.

#“Il numero cliente UPS non è valido o non è autorizzato per questa app”

Il numero cliente non è collegato all'app. Aggiungilo all'app nel Developer Portal.

#C'è una chiusura giornaliera?

Con UPS non serve: UPS riceve i dati della spedizione subito alla creazione dell'etichetta. Una distinta di consegna (PDF) dei colli dall'ultima chiusura la ottieni comunque sull'accesso tramite Gestisci → Chiusura giornaliera (distinta di consegna).