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.
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_.É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
-
Dans la barre latérale d’administration, accédez à Stores > Settings>Configuration.
-
Dans le panneau de gauche, sous Sales, choisissez Delivery Methods.
-
Développez
-
Définissez Enabled for Checkout sur
Yes
. -
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 typesUPS
etUPS XML
sont planifiés en vue de leur obsolescence, etUPS 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
-
-
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
.
Étape 3 : remplir la description du conteneur
-
Définissez Packages Request Type sur l’une des options suivantes :
Use origin weight (few requests)
Divide to equal weight (one request)
-
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
-
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
-
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).
-
Saisissez le Maximum Package Weight autorisé par le transporteur.
-
Définissez Pickup Method sur l’une des options suivantes :
Regular Daily Pickup
On Call Air
One Time Pickup
Letter Center
Customer Counter
-
Saisissez le Minimum Package Weight autorisé par le transporteur.
É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 :
-
Définissez Calculate Handling Fee l’une des méthodes suivantes :
Fixed
Percent
-
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
-
Saisissez le montant de la Handling Fee à facturer.
Pour saisir un pourcentage, utilisez le format décimal. Par exemple, saisissez
0.25
pour 25 %.
Étape 6 : spécifier les méthodes autorisées et les pays applicables
-
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.
-
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.
-
-
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.
-
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é.
-
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.
-
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
. -
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. -
Cliquez sur Save Config.
Étape 7 : Configurer l'adresse d'origine d'expédition
-
Assurez-vous que les Informations de la boutique sont complètes.
-
Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Dans le panneau de gauche, développez Sales et sélectionnez Shipping Settings.
-
Développez
-
Cliquez sur Save Config.