United Parcel Service (UPS)

United Parcel Service (UPS) offre des services de navigation intérieure et internationale par voie terrestre et aérienne à plus de 220 pays.

IMPORTANT
À compter de juin 2024, les marchands Adobe Commerce ne pourront plus traiter avec l’intégration UPS actuelle. En effet, les API UPS (United Parcel Service) utilisées par l’intégration native d’Adobe Commerce ne prennent actuellement pas en charge le modèle de sécurité OAuth 2.0 requis. Pour en savoir plus sur cette modification, consultez le Guide de migration des clés d’accès au portail des développeurs.
Les commerçants doivent appliquer une mise à jour de correctif de qualitéà leur magasin pour migrer de l’API SOAP vers l’API RESTful, qui prend en charge les protocoles d’authentification OAuth 2.0.
NOTE
UPS peut utiliser le poids dimensionnel pour déterminer certains tarifs de livraison. Cependant, Adobe Commerce ne prend en charge que le calcul des coûts d’expédition en fonction du poids.

Étape 1 : ouverture d’un compte d’expédition UPS

Pour proposer cette méthode d'expédition à vos clients, vous devez d'abord ouvrir un compte auprès d'UPS.

Étape 2 : activation d’UPS pour votre magasin

  1. Sur la barre latérale d’administration, accédez à Stores > Settings>Configuration.

  2. Dans le panneau de gauche, sous Sales, choisissez Delivery Methods.

  3. Développez la section Sélecteur d’extension sur UPS .

  4. Définissez Enabled for Checkout sur Yes.

  5. Pour un compte REST UPS (par défaut), procédez comme suit :

    • Saisissez vos informations d’identification UPS : UPS ClientID User ID, UPS Client Secret Password.

    • Définissez Mode sur Live pour envoyer des données au système d’expédition UPS via une connexion sécurisée. (Le mode de développement n’envoie pas de données via une connexion sécurisée.)

    • Vérifiez les Gateway URL requis pour envoyer des requêtes. Utilisez une URL d’environnement de test pour le mode test et une URL de production pour les requêtes en direct.

    • Vérifiez les Tracking URL nécessaires pour obtenir les informations de suivi. Utilisez une URL d’environnement de test pour le mode test et une URL de production pour les requêtes en direct.

    • Définissez Origin of the Shipment sur la région d’origine de l’envoi.

    • Si vous avez des taux spéciaux avec UPS, définissez Enable Negotiated Rates sur Yes et saisissez les Shipper Number à six chiffres qui vous ont été attribués par UPS.

    • Définissez Live Account sur l’une des options suivantes :

      • Yes : exécute UPS en mode de production et offre UPS comme méthode d’expédition à vos clients.
      • No : exécute UPS en mode test.
    note note
    NOTE
    Le type de service United Parcel standard est programmé pour l’obsolescence. Pour les nouvelles configurations, utilisez le type United Parcel Service REST par défaut. Le type REST est également nécessaire pour générer les libellés d'expédition.

    Pour la version 2.4.7, UPS Type est supprimé car les types UPS et UPS XML sont programmés pour l’obsolescence et UPS REST est la valeur par défaut. Les API UPS (United Parcel Service) utilisées par l’intégration native d’Adobe Commerce sont temporairement obsolètes, car elles ne prennent actuellement pas en charge le modèle de sécurité OAuth 2.0.
    note important
    IMPORTANT
    UPS interrompt la prise en charge du protocole HTTP, qui est utilisé dans la valeur par défaut actuelle (valeur système). Décochez la case Use system value et modifiez l’URL pour utiliser HTTPS. Exemple : https://www.ups.com/using/services/rave/qcostcgi.cgi
  6. Pour Title, saisissez le nom de cette option d’expédition tel que vous souhaitez le voir apparaître lors du passage en caisse.

    Par défaut, ce champ est défini sur United Parcel Service.

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

Étape 3 : compléter la description du conteneur

  1. Définissez Packages Request Type sur l’une des options suivantes :

    • Use origin weight (few requests)
    • Divide to equal weight (one request)
  2. Pour Container, indiquez le type de package type utilisé pour l’expédition :

    • 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. Définissez Weight Unit sur le système que vous utilisez pour mesurer le poids du produit.

    Le système de poids pris en charge par UPS varie selon les pays. En cas de doute, demandez à UPS quel système de poids vous devriez utiliser. Les options incluent :

    • LBS
    • KGS
  4. Définissez Destination Type sur l’une des options suivantes :

    • Residential - La plupart de vos envois sont destinés au consommateur (B2C).
    • Commercial - La plupart de vos envois sont des affaires à l’entreprise (B2B).
  5. Saisissez le Maximum Package Weight autorisé par l’opérateur.

  6. Définissez Pickup Method sur l’une des options suivantes :

    • Regular Daily Pickup
    • On Call Air
    • One Time Pickup
    • Letter Center
    • Customer Counter
  7. Saisissez le Minimum Package Weight autorisé par l’opérateur.

    Description du conteneur {width="600" modal="regular"}

Étape 4 : configuration des frais de gestion

Les frais de gestion sont facultatifs et s’affichent sous la forme de frais supplémentaires, ajoutés aux frais d’expédition UPS. Si vous souhaitez inclure des frais de traitement, procédez comme suit :

  1. Définissez Calculate Handling Fee sur l’une des méthodes suivantes :

    • Fixed
    • Percent
  2. Pour déterminer comment les frais de gestion sont appliqués, définissez Handling Applied sur l’une des options suivantes :

    • Per Order
    • Per Package
  3. Saisissez le montant de Handling Fee à charger.

    Pour saisir un pourcentage, utilisez le format décimal . Par exemple, saisissez 0.25 pour 25 %.

    Frais de gestion {width="600" modal="regular"}

Étape 5 : spécification des méthodes autorisées et des pays applicables

  1. Pour Allowed Methods, choisissez chaque méthode d’expédition UPS à la disposition de vos clients.

    Les méthodes apparaissent sous UPS lors du passage en caisse. Pour sélectionner plusieurs méthodes, maintenez la touche Ctrl (PC) ou la touche Commande (Mac) enfoncée, puis cliquez sur chaque option.

  2. Si vous souhaitez fournir une option de livraison gratuite via UPS, définissez les options de livraison gratuite :

    • Définissez Free Method sur la méthode que vous souhaitez utiliser pour la livraison gratuite. Si vous ne souhaitez pas proposer la livraison gratuite par UPS, choisissez None.

    • Pour exiger un montant minimum de commande qui qualifie une commande de livraison gratuite avec UPS, définissez Enable Free Shipping Threshold sur Enable. Ensuite, saisissez la valeur minimale dans Free Shipping Amount Threshold.

  3. Si nécessaire, modifiez le Displayed Error Message.

    Cette zone de texte est prédéfinie avec un message par défaut, mais vous pouvez saisir un autre message que vous souhaitez afficher si UPS devient indisponible.

    Méthodes autorisées {width="600" modal="regular"}

  4. Définissez Ship to Applicable Countries sur l’une des options suivantes :

    • All Allowed Countries - Les clients de tous les pays spécifiés dans votre configuration de magasin peuvent utiliser cette méthode de diffusion.
    • Specific Countries - Lorsque vous sélectionnez cette option, la liste Ship to Specific Countries s’affiche. Sélectionnez chaque pays de la liste dans lequel ce mode de diffusion peut être utilisé.
  5. Définissez Show Method if Not Applicable sur l’une des options suivantes :

    • Yes - Répertorie toutes les méthodes d’expédition UPS disponibles lors du passage en caisse, y compris les méthodes qui ne s’appliquent pas à l’expédition.
    • No - Répertorie uniquement les méthodes d’expédition UPS applicables à l’expédition.

    Pays applicables {width="600" modal="regular"}

  6. Pour créer un fichier journal contenant les détails des envois UPS effectués à partir de votre magasin, définissez Debug sur Yes.

  7. Pour Sort Order, saisissez un nombre afin de déterminer la séquence dans laquelle UPS apparaît lorsqu'il est répertorié avec d'autres méthodes de diffusion lors du passage en caisse.

    0 = premier, 1 = second, 2 = troisième, etc.

  8. Cliquez sur Save Config.

Étape 6 : configuration de l’adresse d’origine de la livraison

  1. Assurez-vous que vos informations de magasin sont terminées.

  2. Sur la barre latérale Admin, accédez à Stores > Settings>Configuration.

  3. Dans le panneau de gauche, développez Sales et sélectionnez Shipping Settings.

  4. Développez Sélecteur d’extension Origin sur la page et configurez l’adresse d’origine de l’expédition.

    Configuration des ventes - options d’adresse d’origine de livraison {width="600" modal="regular"}

  5. Cliquez sur Save Config.

NOTE
Commerce ne déclare pas le prix complet de la commande à UPS lors du calcul des frais de livraison. Ce comportement ne peut pas être modifié.
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1