United Parcel Service (UPS)

United Parcel Service (UPS) offre servizi di spedizione nazionali e internazionali via terra e via aria a più di 220 paesi.

IMPORTANT
A partire da giugno 2024, i commercianti di Adobe Commerce non potranno più negoziare con l’integrazione corrente del gruppo di continuità. Questo perché le API del servizio United Parcel Service (UPS) utilizzate dall’integrazione nativa di Adobe Commerce non supportano attualmente il modello di sicurezza OAuth 2.0 richiesto. Per ulteriori informazioni su questa modifica, fare riferimento alla Guida alla migrazione della chiave di accesso al portale per sviluppatori.
I commercianti devono applicare un aggiornamento della patch di qualità al proprio archivio per migrare dall'API SOAP all'API RESTful, che supporta i protocolli di autenticazione OAuth 2.0.
NOTE
UPS può utilizzare peso dimensionale per determinare alcune tariffe di spedizione. Tuttavia, Adobe Commerce supporta solo il calcolo delle spese di spedizione in base al peso.

Passaggio 1: aprire un conto di spedizione UPS

Per offrire questo metodo di spedizione ai tuoi clienti, devi prima aprire un account con UPS.

Passaggio 2: abilitare UPS per il tuo store

  1. Nella barra laterale Admin, vai a Stores > Settings>Configuration.

  2. Nel pannello a sinistra, in Sales, scegli Delivery Methods.

  3. Espandere Il selettore di espansione nella sezione UPS.

  4. Imposta Enabled for Checkout su Yes.

  5. Per un account REST UPS (impostazione predefinita), effettuare le seguenti operazioni:

    • Immettere le credenziali UPS: ID client UPS come User ID, segreto client UPS come Password

    • Impostare Mode su Live per inviare dati al sistema di spedizione UPS tramite una connessione protetta. La modalità di sviluppo non invia dati tramite una connessione protetta.

    • Verificare Gateway URL necessario per inviare le richieste. Utilizza un URL sandbox (https://wwwcie.ups.com/) per la modalità di test e un URL di produzione per le richieste live (https://onlinetools.ups.com). Assicurati di utilizzare i rispettivi endpoint per ogni richiesta con l’host specificato.

    • Verificare Tracking URL necessario per ottenere le informazioni di tracciamento. Utilizza un URL sandbox (https://wwwcie.ups.com/) per la modalità di test e un URL di produzione per le richieste live (https://onlinetools.ups.com). Assicurati di utilizzare i rispettivi endpoint per ogni richiesta con l’host specificato.

    • Impostare Origin of the Shipment sull'area di origine della spedizione.

    • Se si dispone di tariffe speciali con UPS, impostare Enable Negotiated Rates su Yes e immettere le sei cifre Shipper Number assegnate da UPS.

    • Imposta Live Account su uno dei seguenti:

      • Yes - Esegue UPS in modalità di produzione e offre UPS come metodo di spedizione ai tuoi clienti. Assicurati di utilizzare gli endpoint corretti in URL gateway e URL di tracciamento.
      • No - Esegue UPS in modalità di test. Assicurati di utilizzare gli endpoint corretti in URL gateway e URL di tracciamento.
    note note
    NOTE
    Il tipo di servizio United Parcel Service standard è impostato come obsoleto. Per le nuove configurazioni, utilizzare il tipo predefinito United Parcel Service REST. È inoltre necessario il tipo REST per generare etichette di spedizione.

    Per la versione 2.4.7, UPS Type è stato rimosso perché i tipi UPS e UPS XML sono pianificati per l'obsolescenza e UPS REST è l'impostazione predefinita. Le API di United Parcel Service (UPS) utilizzate dall’integrazione nativa di Adobe Commerce sono temporaneamente obsolete perché non supportano attualmente il modello di sicurezza OAuth 2.0.
    note important
    IMPORTANT
    UPS sta interrompendo il supporto di HTTP, utilizzato nell’impostazione predefinita corrente (valore di sistema). Deselezionare la casella di controllo Use system value e modificare l'URL per utilizzare HTTPS. Esempio: https://www.ups.com/using/services/rave/qcostcgi.cgi
  6. Per Title, immettere il nome dell'opzione di spedizione che si desidera venga visualizzata durante l'estrazione.

    Per impostazione predefinita, questo campo è impostato su United Parcel Service.

    Abilita UPS {width="600" modal="regular"}

Passaggio 3: completare la descrizione del contenitore

  1. Imposta Packages Request Type su uno dei seguenti:

    • Use origin weight (few requests)
    • Divide to equal weight (one request)
  2. Per Container, specificare il tipo di imballaggio tipico utilizzato per la spedizione:

    • Customer Packaging
    • UPS Letter Envelope
    • Customer Supplied Package
    • UPS Tube
    • PAK
    • UPS Express Box
    • UPS Worldwide 25 kilo
    • UPS Worldwide 10 kilo
    • Pallet
    • Small Express Box
    • Medium Express Box
    • Large Express Box
  3. Impostare Weight Unit sul sistema utilizzato per misurare il peso del prodotto.

    Il sistema di peso supportato da UPS varia in base al paese. In caso di dubbi, chiedere a UPS quale sistema di peso deve utilizzare. Le opzioni includono:

    • LBS
    • KGS
  4. Imposta Destination Type su uno dei seguenti:

    • Residential - La maggior parte delle spedizioni è da business a consumer (B2C).
    • Commercial - La maggior parte delle spedizioni sono business to business (B2B).
  5. Immetti il Maximum Package Weight consentito dal gestore.

  6. Imposta Pickup Method su uno dei seguenti:

    • Regular Daily Pickup
    • On Call Air
    • One Time Pickup
    • Letter Center
    • Customer Counter
  7. Immetti il Minimum Package Weight consentito dal gestore.

    Descrizione contenitore {width="600" modal="regular"}

Passaggio 4: impostare le commissioni di gestione

La tariffa di imballaggio è facoltativa e viene visualizzata come un costo aggiuntivo che viene aggiunto al costo di spedizione UPS. Se si desidera includere una tariffa di imballaggio, eseguire le operazioni seguenti:

  1. Impostare Calculate Handling Fee su uno dei metodi seguenti:

    • Fixed
    • Percent
  2. Per determinare la modalità di applicazione della tariffa di gestione, impostare Handling Applied su uno dei seguenti valori:

    • Per Order
    • Per Package
  3. Immettere l'importo di Handling Fee da addebitare.

    Per immettere una percentuale, utilizzare il formato decimale. Ad esempio, immettere 0.25 per il 25%.

    Spese di gestione {width="600" modal="regular"}

Passaggio 5: specificare i metodi consentiti e i paesi applicabili

  1. Per Allowed Methods, scegliere ogni metodo di spedizione UPS per renderlo disponibile ai clienti.

    I metodi vengono visualizzati in UPS durante il check-out. Per selezionare più metodi, tenere premuto Ctrl (PC) o Comando (Mac) e fare clic su ciascuna opzione.

  2. Se desideri fornire un'opzione Spedizione gratuita tramite UPS, imposta le opzioni di spedizione gratuita:

    • Impostare Free Method sul metodo da utilizzare per la spedizione gratuita. Se non si desidera offrire la spedizione gratuita tramite UPS, scegliere None.

    • Per richiedere un importo minimo dell'ordine che qualifichi un ordine per la spedizione gratuita con UPS, impostare Enable Free Shipping Threshold su Enable. Immettere quindi il valore minimo in Free Shipping Amount Threshold.

  3. Se necessario, modificare Displayed Error Message.

    Questa casella di testo è preimpostata con un messaggio predefinito, ma è possibile immettere un messaggio diverso da visualizzare se UPS non è più disponibile.

    Metodi consentiti {width="600" modal="regular"}

  4. Imposta Ship to Applicable Countries su uno dei seguenti:

    • All Allowed Countries - I clienti di tutti i paesi specificati nella configurazione dell'archivio possono utilizzare questo metodo di consegna.
    • Specific Countries - Quando si sceglie questa opzione, viene visualizzato l'elenco Spedisci a paesi specifici. Seleziona ogni paese nell’elenco in cui può essere utilizzato questo metodo di consegna.
  5. Imposta Show Method if Not Applicable su uno dei seguenti:

    • Yes - Elenca tutti i metodi di spedizione UPS disponibili durante il pagamento, inclusi i metodi non applicabili alla spedizione.
    • No - Elenca solo i metodi di spedizione UPS applicabili alla spedizione.

    Paesi applicabili {width="600" modal="regular"}

  6. Per creare un file di registro con i dettagli delle spedizioni UPS effettuate dal tuo archivio, imposta Debug su Yes.

  7. Per Sort Order, immettere un numero per determinare la sequenza di visualizzazione del gruppo di continuità quando viene elencato con altri metodi di consegna durante l'estrazione.

    0 = primo, 1 = secondo, 2 = terzo e così via.

  8. Fare clic su Save Config.

Passaggio 6: imposta l'indirizzo di origine della spedizione

  1. Assicurati che le Informazioni sullo store siano state completate.

  2. Nella barra laterale Admin, passa a Stores > Settings>Configuration.

  3. Nel pannello a sinistra, espandi Sales e seleziona Shipping Settings.

  4. Espandere Selettore di espansione Origin nella pagina e configurare l'indirizzo di origine della spedizione.

    Configurazione vendite - opzioni indirizzo origine spedizione {width="600" modal="regular"}

  5. Fare clic su Save Config.

NOTE
Commerce non dichiara il prezzo dell'ordine completo a UPS durante il calcolo delle spese di spedizione. Questo comportamento non può essere modificato.
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1