United Parcel Service (UPS)

United Parcel Service (UPS) offre des services d'expédition nationaux et internationaux par voie terrestre et aérienne à plus de 220 pays.

IMPORTANT
À compter de juin 2024, les commerçants Adobe Commerce ne pourront plus effectuer de transactions avec l’intégration UPS actuelle. En effet, les API United Parcel Service (UPS) 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 activer l’intégration, créez une application sur la plateforme de développement UPS afin d’obtenir les informations d’identification requises pour OAuth 2.0. Utilisez les nouvelles informations d’identification comme username et password dans la configuration d’expédition UPS de Commerce. Pour en savoir plus sur le changement de modèle de sécurité, voir Developer Portal Access Key Migration Guide_.
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 poids dimensionnel pour déterminer certains tarifs d'expédition. Cependant, Adobe Commerce ne prend en charge que le calcul des coûts d’expédition en fonction du poids.

Étape 1 : Ouvrir un compte d'expédition UPS

Pour proposer cette méthode d'expédition à vos clients, vous devez d'abord ouvrir un compte UPS et remplir la demande pour obtenir un numéro de compte Expéditeur. Voir Ouvrir un compte UPS gratuit.

Étape 2 : obtenir des informations d’identification OAUTH UPS

Suivez les étapes du guide Prise en main des API UPS pour obtenir les informations d’identification d’API (identifiant client et secret client) afin d’activer l’intégration UPS. Vous devez créer une application UPS pour obtenir les informations d’identification.

Lorsque vous configurez les paramètres de l’onduleur dans l’administration, utilisez les valeurs d’identification des username et des password.

Étape 3 : Activer l'onduleur pour votre magasin

  1. Dans 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 Sélecteur d’extension la section 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 comme User ID, UPS Client Secret comme 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 requises pour envoyer des requêtes. Utilisez une URL de sandbox (https://wwwcie.ups.com/) pour le mode test et une URL de production pour les requêtes en direct (https://onlinetools.ups.com). Veillez à utiliser les points d’entrée respectifs pour chaque requête avec l’hôte donné.

    • Vérifiez le Tracking URL requis pour obtenir les informations de suivi. Utilisez une URL de sandbox (https://wwwcie.ups.com/) pour le mode test et une URL de production pour les requêtes en direct (https://onlinetools.ups.com). Veillez à utiliser les points d’entrée respectifs pour chaque requête avec l’hôte donné.

    • Définissez Origin of the Shipment dans la région d'origine de l'expédition.

    • Si vous disposez de tarifs spéciaux avec UPS, définissez Enable Negotiated Rates sur Yes et saisissez le Shipper Number à six chiffres qui vous est attribué par UPS.

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

      • Yes : exécute l’onduleur en mode de production et le propose comme méthode d’expédition à vos clients. Assurez-vous d’utiliser les points d’entrée appropriés sous URL de passerelle et URL de suivi.
      • No : exécute l’UPS en mode test. Assurez-vous d’utiliser les points d’entrée appropriés sous URL de passerelle et URL de suivi.
    note note
    NOTE
    Le type de service United Parcel standard est planifié en vue de son abandon. Pour les nouvelles configurations, utilisez le type de United Parcel Service REST par défaut. Le type REST est également requis pour générer des étiquettes d’expédition.

    Pour la version 2.4.7, UPS Type est supprimé, car les types UPS et UPS XML sont planifiés en vue de leur obsolescence, et UPS REST est la valeur par défaut. Les API United Parcel Service (UPS) 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
    L’onduleur cesse 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. Par Title, saisissez le nom de cette option d'expédition telle que vous souhaitez qu'elle apparaisse 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 : remplir 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. Par Container, spécifiez le type d’emballage 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 utilisé 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 devez utiliser. Les options incluent :

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

    • Residential - La plupart de vos envois sont de type B2C (business to consumer).
    • Commercial - La plupart de vos envois sont interentreprises (B2B).
  5. Saisissez le Maximum Package Weight autorisé par le transporteur.

  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 le transporteur.

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

Étape 5 : configurer les frais de gestion

Les frais de manutention sont facultatifs et apparaissent comme des frais supplémentaires qui s'ajoutent aux frais d'expédition de l'UPS. Si vous souhaitez inclure des frais de manutention, procédez comme suit :

  1. Définissez Calculate Handling Fee 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 la Handling Fee à facturer.

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

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

Étape 6 : spécifier les méthodes autorisées et les pays applicables

  1. Par Allowed Methods, choisissez chaque méthode d'expédition UPS disponible pour vos clients.

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

  2. Si vous souhaitez fournir une option 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 voulez pas offrir la livraison gratuite par UPS, choisissez None.

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

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

    Cette zone de texte est prédéfinie avec un message par défaut, mais vous pouvez saisir un message différent que vous souhaitez afficher si l’onduleur n’est plus disponible.

    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 la configuration de votre boutique peuvent utiliser cette méthode de diffusion.
    • Specific Countries - Lorsque vous sélectionnez cette option, la liste Livrer à des pays spécifiques s'affiche. Sélectionnez dans la liste chaque pays où ce mode de diffusion peut être utilisé.
  5. Définissez Show Method if Not Applicable sur l’une des options suivantes :

    • Yes - Répertorie tous les modes d'expédition UPS disponibles lors du passage en caisse, y compris les modes qui ne s'appliquent pas à l'expédition.
    • No - Répertorie uniquement les modes 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 expéditions UPS effectuées à partir de votre magasin, définissez Debug sur Yes.

  7. Par Sort Order, saisissez un nombre pour déterminer l'ordre dans lequel l'onduleur apparaît lorsqu'il est répertorié avec d'autres méthodes de diffusion lors du passage en caisse.

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

  8. Cliquez sur Save Config.

Étape 7 : Configurer l'adresse d'origine d'expédition

  1. Assurez-vous que les Informations de la boutique sont complètes.

  2. Dans 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 d’expédition.

    Configuration des ventes - Options d’adresse d’origine d’expédition {width="600" modal="regular"}

  5. Cliquez sur Save Config.

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