UPS Live Shipping (REST)¶
Con il plugin UPS Live Shipping (REST), calcola i costi di spedizione in tempo reale tramite l'API UPS REST ufficiale (OAuth 2.0) – direttamente nel pagamento di Shopware 5. I costi si basano sulle tariffe UPS reali per l'indirizzo di destinazione, il peso e il servizio scelto, inclusi i prezzi negoziati facoltativi.
Il plugin assegna ogni metodo di spedizione di Shopware a un servizio UPS, divide automaticamente gli ordini pesanti in più pacchi e fornisce un risultato tramite impostazioni di fallback anche se l'indirizzo del cliente o l'API non sono disponibili.
Highlights
- 🚚 Costi di spedizione in tempo reale tramite l'API UPS REST ufficiale (OAuth 2.0)
- 🔀 Modalità Sandbox e Production
- 🧭 Assegnazione di ogni metodo di spedizione a un servizio UPS
- ⚖️ Divisione automatica dei pacchi a partire da 70 kg
- 💶 Prezzi UPS standard o negoziati
- 🛟 Paese di fallback, codice postale e costi di spedizione di sostituzione
- 🐞 Registrazione di debug dettagliata (
[UPS])
❓ FAQ¶
Da dove vengono i costi di spedizione?
Direttamente da UPS: Il plugin interroga l'API UPS REST ufficiale (OAuth 2.0) al runtime e calcola i costi in base all'indirizzo di destinazione, al peso e al servizio UPS scelto.
Ho bisogno di un account UPS?
Sì. Registri l'ID client e il segreto client dal portale sviluppatori UPS. Per i prezzi negoziati, si consiglia il vostro numero mittente (numero cliente UPS).
Come si collegano i metodi di spedizione di Shopware ai servizi UPS?
Tramite l'attributo welo_ups_service_id: Ogni metodo di spedizione è assegnato a un ID servizio UPS (ad es. 65 → UPS Worldwide Saver). Senza ID servizio non è possibile alcun calcolo.
Cosa succede per gli ordini superiori a 70 kg?
UPS consente un massimo di 70 kg per pacco. Il plugin rileva automaticamente i pesi totali più elevati e li divide in più pacchi (ad es. 210 kg → 3 × 70 kg).
Cosa succede se l'API UPS non è raggiungibile?
Le impostazioni di fallback includono un paese di destinazione standard, un codice postale standard e costi di spedizione di sostituzione definiti, in modo che il checkout continui a funzionare.
Posso tracciare il calcolo?
Sì. Con il debug abilitato, il plugin registra, tra le altre cose, il peso, il codice servizio, la chiave cache, il payload, la risposta grezza e i codici di errore. Tutte le voci sono contrassegnate con [UPS].
🔧 Installazione¶
- Installazione tramite il gestore plugin di Shopware
- Installa e attiva il plugin
- Esegui la configurazione nel backend (vedere Configurazione di seguito)
Quindi fai clic sull'icona per attivare il plugin:
⚙️ Impostazioni generali¶
| # | Impostazione | Descrizione |
|---|---|---|
| 1 | Seleziona negozio | Seleziona il negozio corrispondente. |
| 2 | Attiva plugin | Attiva il calcolo dei costi di spedizione UPS in tempo reale. |
| 3 | Modalità | Scelta tra Sandbox (ambiente di test) e Production (operazione in diretta). |
| 4 | ID client | ID client dal portale sviluppatori UPS. |
| 5 | Segreto client | Segreto client dal portale sviluppatori UPS. |
| 6 | Numero mittente | Numero cliente UPS (consigliato per i prezzi negoziati). |
| 7 | Timeout API | Timeout in secondi per la richiesta API di UPS. |
| 8 | Paese mittente | Codice ISO del paese di spedizione (ad es. DE). |
| 9 | Codice postale mittente | Codice postale del magazzino di spedizione. |
| 10 | Selezione prezzi | Forza prezzi standard, Forza prezzi negoziati o Prezzi negoziati se disponibili. |
| 11 | Salva impostazioni | Salva la configurazione. |
🧭 Assegna metodi di spedizione¶
Ogni metodo di spedizione di Shopware deve essere assegnato a un servizio UPS. Per questo viene utilizzato l'attributo welo_ups_service_id.
| ID servizio | Servizio UPS |
|---|---|
65 | UPS Worldwide Saver |
11 | UPS Standard |
07 | UPS Express |
Senza ID servizio, senza calcolo
Se un metodo di spedizione non ha un welo_ups_service_id assegnato, non è possibile alcun calcolo in tempo reale per quel metodo di spedizione.
⚖️ Peso e divisione¶
UPS consente un massimo di 70 kg per pacco. Il plugin rileva automaticamente i pesi totali più elevati e li divide in più pacchi.
| Peso totale | Divisione automatica |
|---|---|
| 100 kg | 2 × 50 kg |
| 210 kg | 3 × 70 kg |
| 350 kg | 5 × 70 kg |
| # | Impostazione | Descrizione |
|---|---|---|
| 1 | Peso predefinito | Utilizzato se un articolo non ha peso. |
| 2 | Peso minimo | Limite inferiore per il calcolo. |
| 3 | Peso massimo per pacco | Standard: 70 kg. |
| 4 | Salva impostazioni | Salva la configurazione. |
🛟 Impostazioni di fallback¶
Se il cliente non è connesso o non è disponibile un indirizzo completo, si applicano le seguenti impostazioni:
| # | Impostazione | Descrizione |
|---|---|---|
| 1 | Paese di fallback | Paese standard per gli ospiti. |
| 2 | Codice postale di fallback | Codice postale standard per gli ospiti. |
| 3 | Costi di spedizione di sostituzione | Utilizzato se l'API di UPS non è raggiungibile. |
| 4 | Salva impostazioni | Salva la configurazione. |
Indirizzo di destinazione dinamico
Se il cliente seleziona un paese o un codice postale diverso nel carrello, questo viene utilizzato dinamicamente per il calcolo.
🐞 Debug e logging¶
| # | Impostazione | Descrizione |
|---|---|---|
| 1 | Abilita debug | Abilita i log dettagliati. |
| 2 | Salva impostazioni | Salva la configurazione. |
I log includono, tra le altre cose:
- Peso
- Codice servizio
- Chiave cache
- Payload a UPS
- Risposta grezza API
- Codici di errore
- Eccezioni API
Tutti i log sono contrassegnati con [UPS].
💡 Casi d'uso tipici¶
Costi di spedizione internazionali esatti¶
Mostra ai clienti al pagamento le tariffe UPS reali per il loro indirizzo di destinazione – invece di costi di spedizione forfettari.
Ordini pesanti e ingombranti¶
Gli ordini grandi vengono automaticamente divisi in pacchi conformi a UPS (max. 70 kg) e calcolati correttamente.
Usa le condizioni UPS negoziate¶
Con il numero mittente registrato, il plugin calcola i vostri prezzi UPS negoziati individualmente.
⭐ Vantaggi per i proprietari di negozi¶
- Costi di spedizione precisi e esatti direttamente da UPS
- Meno sovrafatturazione o sottofatturazione dei costi di spedizione
- Divisione automatica dei pacchi senza sforzo manuale
- Checkout affidabile grazie alle impostazioni di fallback
- Trasparenza completa attraverso la registrazione di debug dettagliata
🧩 Portata funzionale¶
- Calcolo dei costi di spedizione in tempo reale tramite l'API REST di UPS (OAuth 2.0)
- Modalità Sandbox e Production
- Assegnazione di ogni metodo di spedizione a un servizio UPS
- Prezzi standard o negoziati
- Divisione automatica dei pacchi a partire da 70 kg
- Paese di fallback, codice postale e costi di spedizione di sostituzione
- Registrazione di debug dettagliata con identificazione
[UPS]
📬 Supporto¶
Per qualsiasi domanda, suggerimento di miglioramento o personalizzazione, contattaci via email a support@cnk-plugins.de.