UPS Universal Shipping pour Magento® 2.x
UPS Universal Shipping est une extension Magento 2 qui vous permet de gérer l’ensemble du cycle d’expédition UPS via l’API UPS (United Parcel Service).
L’extension offre un large éventail de paramètres. Obtenez des tarifs d’expédition à jour et créez des étiquettes d’expédition UPS thermiques (ZPL, EPL) et PDF. Planifiez des enlèvements et suivez vos colis.
Les principaux avantages de l’extension UPS Universal Shipping :
Étiquettes d’expédition thermiques et PDF
La création d’étiquettes d’expédition est possible aussi bien manuellement qu’automatiquement, et même de manière planifiée. L’extension UPS Universal Shipping associe l’étiquette d’expédition à une commande, une livraison ou un avoir. Toutes les étiquettes sont stockées sur votre serveur et restent accessibles à tout moment via l’interface d’administration de votre site Magento.
Avant la création manuelle de chaque étiquette, vous pouvez choisir la méthode d’expédition souhaitée parmi celles proposées par UPS et voir immédiatement les frais d’expédition. En mode automatique, les étiquettes sont générées selon la méthode choisie par le client ou au prix minimal/maximal de toutes les méthodes UPS.
Paperless Commercial Invoice
UPS Universal Shipping prend en charge les envois internationaux. Pour les expéditions à l’étranger, l’émission de la facture douanière (International Invoice) au format dématérialisé (ou papier) est proposée. À cet effet, UPS Universal Shipping prend en charge les paramètres suivants : codes Harmonized et ScheduleB, Dangerous Goods et Hazardous Materials, conditions de livraison, Reason for Export, Sold To Address et bien d’autres.
Tarifs d’expédition & méthodes d’expédition
Obtenez des tarifs d’expédition au checkout comme sur ups.com. Les prix d’expédition dépendent généralement de l’assurance, de la valeur déclarée du colis, du poids, des dimensions, etc. — notre extension prend en compte tous ces éléments. Le coût d’une méthode peut être statique ou dynamique. Les prix comme l’affichage de la méthode sont ajustables via des limites. En option, vous pouvez afficher la méthode uniquement dans le panneau d’administration. Vous créez autant de méthodes que vous le souhaitez. Plus de détails ici.
Paiement, COD, assurance
Adaptez le payeur à vos processus métier. L’expédition peut être payée par l’expéditeur (Shipper) ou par un tiers (Third Party), les droits et taxes (Duty and Taxes) aussi bien par le destinataire que par l’expéditeur. Vous gérez également l’assurance (Insured) et utilisez Invoice Line Total. En cas de besoin, vous renseignez un numéro fiscal (Tins number — Taxpayer Identification). Si l’acheteur souhaite payer à la livraison, utilisez l’option COD (Cash on Delivery).
Étiquettes de retour et RMA
La création d’étiquettes de retour est aussi simple que celle des étiquettes d’expédition classiques. Avantage majeur : les étiquettes de retour peuvent être générées en même temps que l’étiquette d’expédition régulière.
L’administrateur peut offrir au client la possibilité de créer et d’imprimer lui-même les étiquettes de retour.
Enlèvement et suivi
Commandez l’enlèvement des colis directement depuis le panneau d’administration de votre boutique en ligne. Tout est simple et rapide. Vous choisissez les étiquettes créées pour lesquelles commander un enlèvement, et l’extension envoie la requête au service de livraison. Dans chaque enlèvement, vous voyez à tout moment ce qui a été expédié. Vous trouverez un exemple de document Pickup Slips pour plusieurs envois ici.
Une fois les colis expédiés, suivez-les avec notre extension UPS Universal Shipping. Vous voyez toutes les étapes traversées par le colis ainsi que sa position actuelle.
Impression
L’impression est l’une des étapes les plus importantes du travail avec les étiquettes d’expédition. Utilisez notre application pour imprimer les étiquettes thermiques et PDF sur des imprimantes locales et réseau. Vous l’obtenez ici.
Configuration
Les possibilités de notre module sont pratiquement illimitées grâce à des paramètres flexibles. En même temps, les paramètres sont intuitifs et nombre d’entre eux sont définis par défaut. Vous configurez l’extension pour une boutique ou un pays donné. Vous appliquez certains paramètres aux envois nationaux et d’autres aux envois internationaux. Des paramètres entièrement séparés pour les étiquettes régulières et les étiquettes de retour sont également possibles. Pour chaque continent, vous pouvez définir des paramètres dédiés — cela aussi est possible avec notre module.
Démo
Vous pouvez essayer cette extension pendant 30 jours. Demandez la démo sur cette page avec Demander une démo ; son fonctionnement est expliqué sur Essayez une extension pendant 30 jours.
Hyva Theme et Hyva Checkout
Compatible avec Hyva Theme et Hyva Checkout
| CMS | Magento 2 |
|---|---|
| Compatibilité | 2.4, 2.3 |
| Fonctionnalités |
|
L’extension s’installe avec Composer. Le dépôt à ajouter dépend de l’endroit où vous l’avez achetée — l’installation elle-même est identique dans les deux cas.
1. Connecter le dépôt
Achetée sur extmag.com. Votre page de compte affiche l’adresse du dépôt et vos identifiants personnels, ainsi que les deux commandes composer config à coller. Exécutez-les une fois par projet ; toutes les extensions que vous possédez sont ensuite disponibles depuis le même dépôt.
Achetée sur l’Adobe Commerce Marketplace. Le paquet est servi depuis repo.magento.com, déjà configuré sur la plupart des boutiques. Sinon, ajoutez les clés d’accès de votre compte Adobe sous My Profile -> Access Keys.
2. Installer l’extension
À la racine du projet, exécutez :
composer require extmag/upsshipping2 php bin/magento setup:upgrade php bin/magento cache:flush
Composer résout les paquets Extmag partagés dont dépend l’extension : rien d’autre n’est à exiger à la main.
Déconnectez-vous de l’admin puis reconnectez-vous, et l’extension est prête.
Impression des étiquettes
Pour imprimer les étiquettes sur une imprimante locale ou réseau, installez notre logiciel d’impression depuis cette page, puis suivez Installation et configuration d’el-Print.
Hyva Theme et Hyva Checkout
Les boutiques sous Hyva demandent un paquet de plus :
composer require extmag/shiplab-hyva composer require magewirephp/magewire
L’intégration remplace un template Hyva, view/frontend/templates/checkout/shipping/method-list.phtml. Si votre thème surcharge déjà ce fichier, fusionnez les modifications au lieu de le remplacer.
L’essayer avant d’acheter
Vous pouvez demander une démo de 30 jours de cette extension et l’installer exactement comme ci-dessus — même paquet, même dépôt, mêmes commandes. Comment fonctionnent les démos.
Installer sans Composer
L’archive peut être décompressée dans app/code/Extmag/, mais l’extension se retrouve alors hors de la gestion des dépendances : ses paquets partagés doivent être installés à la main et les mises à jour ne l’atteignent jamais. Utilisez Composer pour toute boutique que vous exploitez, démo comprise.
Pour toute question sur l’installation, contactez notre support technique.
-
User Guide User Guide.pdf · 1.1 MBTélécharger
-
Reference Manual Reference Manual.pdf · 403.0 KBTélécharger
-
Installation Guide Installation Guide.pdf · 1.0 MBTélécharger
UPS se configure depuis le menu Extmag de l’admin Adobe Commerce (Magento). Ajoutez le compte transporteur, les adresses d’expédition, les cartons dans lesquels vous emballez et les méthodes de livraison que voient les clients, puis affinez la configuration du transporteur.
Compte UPS
- Si vous n’avez pas encore d’identifiants UPS, obtenez-les auprès d’UPS. Il vous faut un Client ID, un Client Secret et un Shipper Number depuis le UPS Developer Portal.
- Allez dans Admin Main Menu -> Extmag -> Settings -> Shipper Accounts.
- Cliquez sur le bouton « Add New Shipper Account ».
- Saisissez vos identifiants et cliquez sur « Save ». Laissez Live Account sur No tant que vous testez sur le bac à sable du transporteur.
Adresses
- Allez dans Admin Main Menu -> Extmag -> Settings -> Addresses.
- Cliquez sur le bouton « Add New Address ».
- Renseignez la raison sociale, le contact, le téléphone et l’adresse complète, puis cliquez sur « Save ». Ajoutez une adresse par site d’expédition — l’adresse de facturation et l’adresse d’expédition se choisissent séparément.
Cartons d’emballage
- Allez dans Admin Main Menu -> Extmag -> Settings -> Package Boxes.
- Cliquez sur le bouton « Add New Box ».
- Indiquez les dimensions intérieures et extérieures, le poids à vide et la charge maximale, puis cliquez sur « Save ». Le calculateur d’emballage répartit la commande entre les colis à partir de ces cartons : plus vos cartons réels sont renseignés, plus le tarif annoncé est proche de celui qui vous sera facturé.
Méthodes de livraison
- Allez dans Admin Main Menu -> Extmag -> Shipping Methods.
- Cliquez sur le bouton « Add New Shipping Method ».
- Choisissez UPS comme transporteur, décidez quels services afficher — tous, une liste précise, ou seulement le moins cher ou le plus cher — et limitez la méthode par site web et groupe de clients si nécessaire. Cliquez sur « Save ».
Configuration
- Allez dans Admin Main Menu -> Extmag -> Settings -> UPS Configuration.
- Ouvrez d’abord l’onglet General et sélectionnez le compte expéditeur, l’adresse de facturation et l’adresse d’expédition créés plus haut.
- Parcourez les onglets restants en remplissant ce qui s’applique à votre compte.
Les onglets couvrent :
- General — compte, adresses, type de destination, méthode de livraison par défaut et consignes d’expédition.
- Packaging — type d’emballage, dimensions et répartition d’une commande entre les colis.
- Returns — étiquettes de retour et gestion des RMA.
- References — les numéros de référence imprimés sur l’étiquette et leurs codes-barres.
- Payments — qui paie l’expédition et les droits, et les coordonnées du compte payeur.
- Notification — les événements notifiés par le transporteur et leurs destinataires.
- Printing — formats de documents et imprimante utilisée par type de document.
- Pickups — enlèvements réservés automatiquement après création d’une étiquette, ou planifiés à la main.
- Tracking — fréquence d’interrogation des colis et écriture des statuts dans la commande.
- Access Point — livraison en UPS Access Point plutôt qu’à une adresse, avec les notifications associées.
- Freight — envois de 150 lbs et plus, avec leurs propres unités de manutention et classe de fret.
- International Invoice — la facture commerciale dématérialisée, son image de signature et le contenu douanier.
- Automatic — quand les étiquettes sont créées sans opérateur.
- Mass Actions — création d’étiquettes en lot depuis la grille des commandes.
- Manual Actions — création d’une étiquette unique depuis une commande.
- Other Options — journalisation et les autres réglages au niveau du transporteur.
Chaque réglage s’applique par site web et par pays de destination : une règle qui n’a de sens que pour un marché n’affecte pas les autres.
La référence complète champ par champ, avec les chemins de configuration exacts, figure dans le Reference Manual fourni avec l’extension.
3.9.3
Logged the UPS Locator API response via DataSave for diagnostics. Refreshed the Installation Guide, User Guide, and Reference Manual.
3.9.2
Replaced $block->escapeHtmlAttr calls with injected Escaper in Access Point admin button template. Refactored access-point locator iframe to load map JS externally for CSP compatibility and whitelisted Bing Maps hosts. Shiplab: Replace raw filesystem calls in settings import with Magento file driver.
3.9.1
Replaced $block->escapeHtmlAttr calls with injected Escaper in Access Point admin button template. Refactored access-point locator iframe to load map JS externally for CSP compatibility and whitelisted Bing Maps hosts. Shiplab: Replace raw filesystem calls in settings import with Magento file driver.
3.9.0
Shiplab: Added zero-weight guard and weight diagnostics for shipping rate calculation. Shiplab: Removed legacy Additional Price fields and migrated data to price rules.
3.8.9
Replaced multiselect with category chooser for dangerous goods product categories field. Shiplab: Replaced multiselect categories with AJAX tree chooser in dimension config. Added support Magento 2.4.9 and Adobe Commerce 2.4.9
3.8.8
Shiplab: Fixed attribute ID retrieval order in category EAV setup patch.
3.8.7
Shiplab: Added response post-processing hook and fixed logo data handling.
3.8.6
Shiplab: Added BlackoutRules feature with full CRUD, date picker mixin, and schedule migration.
3.8.5
Fixed service array initialization in Rate response parser to prevent data leakage between loop iterations. Shiplab: Fixed null safety issues and added numeric attribute validation. Added support Magento 2.4.8-p4 and Adobe Commerce 2.4.8-p4
3.8.4
Fixed service code resolution to preserve value set during step three.
3.8.3
Optimized the algorithms for packing items into boxes to ensure better efficiency.
3.8.2
Added email field to addresses and new macros for shipping description.
Added custom address attribute support and fixed config value handling.
Refactored AttributesOfCustomerAddress to use CollectionFactory.
Fixed duplicate Access Point creation by checking existing records before save.
3.8.1
Fixed bundle product handling for Ship Separately/Together and price/weight types.
Added config option to include zero-price bundle children in international invoices.
Fixed property type declarations for PHP 8.x compatibility.
3.8.0
Fixed loadedData check in DataProvider classes for PHP 8.x compatibility.
Fixed place order callback to pass data for proper Braintree payment handling.
3.7.9
Refactored code.
3.7.8
Added support for PHP 8.4
3.7.7
Fixed an issue with saving the Access Point address.
3.7.6
Added support Magento 2.4.8-p3 and Adobe Commerce 2.4.8-p3
3.7.5
Fixed a bug with the country code for Kosovo
3.7.4
Added support Magento 2.4.8-p2 and Adobe Commerce 2.4.8-p2
3.7.3
Fixed a bug with the Schedule New Update form on the category page
3.7.2
Fixed the discount price for the International invoice
3.7.1
Added the selected Access Point display to the checkout payment step.
3.7.0
Fixed a bug with the field City and the Access Point popup in the checkout page
3.6.9
Fixed the PhoneNumber field for UPS Location API
3.6.8
Fixed Distance Unit Of Measurement for the UPS Access Point
Added support Magento 2.4.8-p1 and Adobe Commerce 2.4.8-p1
Update the UPS API version in the module
Fixed QV Notification Services with new UPS API version
3.6.7
Added support Magento 2.4.8 and Adobe Commerce 2.4.8
3.6.6
Fixed a bug when the order has only virtual products
3.6.5
Added support Magento 2.4.7-p5 and Adobe Commerce 2.4.7-p5
3.6.4
Added support Magento 2.4.7-p4 and Adobe Commerce 2.4.7-p4
3.6.3
Fixed a bug with UPS Access Point Locator with non-UPS shipping methods
3.6.2
Fixed a bug with the Access Point Locator when the Drop Location is not an array
3.6.1
Fixed a bug with an empty Access Point country code
3.6.0
Fixed a bug with SplitButton for the order view page in the admin panel
3.5.9
Fixed logs for shipping rates
Added support Magento 2.4.7-p3 and Adobe Commerce 2.4.7-p3
3.5.8
Fixed the price format on the label creation page in the admin panel.
Improved the integration with the Hyva Theme.
3.5.7
Fixed formattedAccessPointAddress in email templates for Access Point
3.5.6
Added email templates for Access Point address.
Fixed Tracking.php. Fixed logs with config_snapshot.
Fixed zero baseSubTotal.
3.5.5
Fixed a bug with division by zero
3.5.4
Fixed a bug with the StateProvince code for the pickup location
3.5.3
Fixed a bug with a recursive function for shipping rates
3.5.2
Fixed a bug with shipping rates debugging.
Fixed CSP for printing by websocket.
3.5.1
Fixed bug with the deactivating module
3.5.0
Fixed bug with afterGetAPIUrl plugin
3.4.9
Fixed the z-index issue on the label details page.
Added support Magento 2.4.7-p2 and Adobe Commerce 2.4.7-p2
3.4.8
Fixed the z-index issue on the label details page.
Added support Magento 2.4.7-p2 and Adobe Commerce 2.4.7-p2
3.4.7
Fixed bug with Saturday Delivery
3.4.6
Removed polyfill javascript library for Google Maps
3.4.5
Added support Magento 2.4.7-p1 and Adobe Commerce 2.4.7-p1
3.4.4
Fixed cache for shipping rates
3.4.3
Fixed Locator API URL for the sandbox mode
3.4.2
The issue with printing return labels on the customer side has been fixed.
3.4.1
Fixed the packaging box selector
3.4.0
Fixed calculation of the estimated value of a parcel including a discount, which caused the error "Missing or Invalid Monetary Value of Commodity 1's Commodity Value"
3.3.9
Fixed the Origination Names
3.3.8
The issue related to the customer group and guest order creation in the admin panel has been fixed
3.3.7
Fixed bug with empty shipping method name
3.3.6
Added support Magento 2.4.7 and Adobe Commerce 2.4.7
3.3.5
Integration with Hyva Theme and Hyva Checkout has been added
3.3.4
Fixed the bug with OAuth token and Freight Rates
3.3.3
Added support Magento 2.4.6-p4 and Adobe Commerce 2.4.6-p4
3.3.2
Improve cache for the shipping rate request
3.3.1
Improve the speed of calculating rules
3.3.0
Fixed the JS bug with placing the order
3.2.9
Fixed a bug that occurred when mass-creating delivery labels
3.2.8
Fixed the bug with the commodity code for the International Invoice
3.2.7
Added messages for errors in saving shipping labels
3.2.6
Fixed the Carbon Neutral indicator
3.2.5
Fixed the bug with configuration and printing_character_set option
3.2.4
Updated linked modules
3.2.3
Added the ability to rename original courier shipping methods
3.2.2
Updated CSP politics for the UPS Access Point popup
3.2.1
Added support Magento 2.4.6-p3 and Adobe Commerce 2.4.6-p3
3.2.0
Added Google and Bing maps to the UPS Access Point popup.
3.1.4
Integrated the UPS Access Point in the IOSC Onestepcheckout module
3.1.3
Integrated the UPS Access Point in the IOSC Onestepcheckout module
3.1.2
Fixed the packer for packages of the shipment
3.1.1
Fixed a bug with downloading shipping logs
3.1.0
Fixed the data type of the Service Code
3.0.9
Added two options "Show Method if Not Applicable" and "Displayed Error Message" in the Extmag Shipping method configuration
3.0.8
Fixed bug with shipper_tax_number field in the UPS shipping method configuration
3.0.7
Set packaging type code by default in configuration with module installation
Fixed a bug when it was impossible to save the Shiplab configuration in Magento 2.4.6-p1
3.0.6
Fixed PDP printing with the QZ Tray program
3.0.5
Support the QZ Tray program for printing labels.
3.0.4
Fixed bug with Sales Rules.
Removed deprecated code.
3.0.3
Fixed sources for orders after saving the tracking number
Added support Magento 2.4.6-p2 and Adobe Commerce 2.4.6-p2
3.0.2
Added logging for OAuth generating token
3.0.1
Fixed calculating prices for shipping methods.
Fixed shipping price rules.
3.0.0
Added support for UPS API OAuth 2.0
Fixed minor bugs
2.8.7
Improved selection of Websites and Customer Groups for Shipping Methods
2.8.6
Fixed bugs of Access Point on the checkout page of the admin panel
2.8.5
Fixed Top Text for UPS Access Point popup on checkout page
2.8.4
Fixed shipping rates for UPS Access Points
Added top text for Access Point popup
2.8.3
Added support Adobe Commerce 2.4.6-p1
2.8.2
Added the functionality of substituting the default address for the country if the customer entered an incorrect delivery address.
2.8.1
Added the integration of the UPS Access Point with the BSS OneStepCheckout extension
2.8.0
Fix bug with musltiselect fields and values as type integer
2.7.9
Added the new buttons to the Shipping Label view page. These buttons lead to the corresponding shipping and order pages.
2.7.8
Fixed bug with calculating discount and tax for shipping rates
2.7.7
Fixed bug with the Volume Weight switcher
2.7.6
Support PHP 8.1
Improved supporting Adobe Commerce (Magento) 2.4.6
2.7.5
Support Adobe Commerce (Magento) 2.4.6
Fixed bug with the type of variables
2.7.4
Fixed some bugs to support PHP 8.1
2.7.3
Added max volumetric weight for a package.
Added type of volumetric weight value.
Fixed some bugs with volumetric weight.
2.7.2
Fixed a bug with the volumetric weight
2.7.1
Updated dependencies.
Fixed some minor bugs.
2.7.0
Added support for Product Volumetric Weight
2.6.3
Fixed the PHP warnings
2.6.2
Support Adobe Commerce (Magento) 2.4.5-p1
2.6.1
Fixed country_id condition type for shipping method rules
2.6.0
Fixed a few bugs linked with PHP 8.1
Added "Additional Price Actions" for applying multiple rules for the shipping method.
2.5.5
Support Magento 2.4.4
2.5.4
Added carrier logo to shipping methods.
Fixed some bugs.
Support PHP 8
2.5.3
Added carrier logo to shipping methods.
Fixed some bugs.
2.5.2
Improve PHP code.
Removed json_request_data field from the form of creating labels
2.5.1
Fixed js for the form of step two
2.5.0
Go to subscription
2.4.0
Change the display of prices with and without duties and taxes
2.3.0-2.3.4
Sending email with creating return labels and added a new email template
Changed code for compatibility PHP version 7.4 and high
Changed UPS Access Point popup
Added Freight Shipping
Added Custom UPS Access Point popup
2.2.0
By default, the address specified in the store settings is used, if the address is not created and selected in the extension settings.
When deleting a label, its tracking number is also removed from the order and shipping.
If the product is configurable, then the name of its child is used for the international invoice.
Added the ability to enable the use of a direct link to the carrier's website to receive tracking information in the admin panel and in letters sent to customers.
For international invoices, added the ability to specify the Discount / Rebate amount.
2.0.0-2.1.0
Added the ability to control the display of shipping methods by date, time of day, and days of the week.
Added the ability to download log files from the log list page.
Added EORI Number
1.3.0-1.9.0
The new option "Allowed areas" was added. It shows the shipping method in admin only
Added "country from" and "country to" in the Directions column on the labels grid page
Added Consignee VAT/Tax/EORI ID
Support UK Brexit
Added links to order, shipment, creditmemo, and user account in the grid of shipping labels
Added the Create a new label item in the Action column to the grid of shipping labels, which allows you to create another shipping label for the same order and shipment
Added dependency from Core module
Fixed bug with system configuration
Fixed bug with access control list
Fixed access control list and admin menu
Added additional print button on order and shipment page in admin
Added PHP library textalk/websocket.
Added print by the network.
Added auto print.
