UPS Universal Shipping per Magento® 2.x

L’estensione si installa con Composer. Quale repository aggiungere dipende da dove l’avete acquistata — l’installazione in sé è identica nei due casi.

1. Collegare il repository

Acquistata su extmag.com. La pagina del vostro account mostra l’indirizzo del repository e le vostre credenziali personali, insieme ai due comandi composer config da incollare. Eseguiteli una volta per progetto; da quel momento ogni estensione che possedete è disponibile dallo stesso repository.

Acquistata sull’Adobe Commerce Marketplace. Il pacchetto viene servito da repo.magento.com, già configurato nella maggior parte degli store. In caso contrario, aggiungete le access key del vostro account Adobe in My Profile -> Access Keys.

2. Installare l’estensione

Eseguite nella radice del progetto:

composer require extmag/upsshipping2
php bin/magento setup:upgrade
php bin/magento cache:flush

Composer risolve i pacchetti Extmag condivisi da cui l’estensione dipende: non c’è altro da richiedere a mano.

Uscite dall’admin e rientrate: l’estensione è pronta.

Stampa delle etichette

Per stampare le etichette su una stampante locale o di rete, installate il nostro software di stampa da qui, poi seguite Installazione e configurazione di el-Print.

Hyva Theme e Hyva Checkout

Gli store su Hyva richiedono un pacchetto in più:

composer require extmag/shiplab-hyva
composer require magewirephp/magewire

L’integrazione sostituisce un template Hyva, view/frontend/templates/checkout/shipping/method-list.phtml. Se il vostro tema sovrascrive già quel file, unite le modifiche invece di sostituirlo.

Provarla prima di acquistare

Potete richiedere una demo di 30 giorni di questa estensione e installarla esattamente come sopra: stesso pacchetto, stesso repository, stessi comandi. Come funzionano le demo.

Installare senza Composer

L’archivio può essere scompattato in app/code/Extmag/, ma così l’estensione resta fuori dalla gestione delle dipendenze: i pacchetti condivisi vanno installati a mano e gli aggiornamenti non la raggiungono mai. Usate Composer per qualsiasi store che gestite, demo compresa.

Per qualsiasi domanda sull’installazione, scrivete al nostro supporto tecnico.

UPS si configura dal menu Extmag dell’admin Adobe Commerce (Magento). Aggiungete l’account del corriere, gli indirizzi da cui spedite, le scatole in cui imballate e i metodi di spedizione che i clienti vedono, poi mettete a punto la configurazione del corriere.

Account UPS

1. Se non avete ancora le credenziali UPS, richiedetele a UPS. Servono Client ID, Client Secret e Shipper Number dal UPS Developer Portal.
2. Andate su Admin Main Menu -> Extmag -> Settings -> Shipper Accounts.
   
3. Fate clic sul pulsante «Add New Shipper Account».
4. Inserite le vostre credenziali e fate clic su «Save». Lasciate Live Account su No finché provate contro la sandbox del corriere.

Indirizzi

1. Andate su Admin Main Menu -> Extmag -> Settings -> Addresses.
   
2. Fate clic sul pulsante «Add New Address».
3. Compilate ragione sociale, referente, telefono e indirizzo completo, poi fate clic su «Save». Aggiungete un indirizzo per ogni sede da cui spedite: l’indirizzo di fatturazione e quello di partenza si scelgono separatamente.

Scatole per l’imballaggio

1. Andate su Admin Main Menu -> Extmag -> Settings -> Package Boxes.
2. Fate clic sul pulsante «Add New Box».
3. Inserite le misure interne ed esterne, il peso a vuoto e il carico massimo, poi fate clic su «Save». L’algoritmo di imballaggio ripartisce l’ordine tra i colli sulla base di queste scatole: più scatole reali sono censite, più la tariffa mostrata si avvicina a quella che vi verrà addebitata.

Metodi di spedizione

1. Andate su Admin Main Menu -> Extmag -> Shipping Methods.
2. Fate clic sul pulsante «Add New Shipping Method».
3. Scegliete UPS come corriere, decidete quali suoi servizi mostrare — tutti, un elenco specifico, oppure solo il più economico o il più costoso — e limitate il metodo per sito web e gruppo di clienti se serve. Fate clic su «Save».

Configurazione

1. Andate su Admin Main Menu -> Extmag -> Settings -> UPS Configuration.
   
2. Aprite per prima la scheda General e selezionate l’account mittente, l’indirizzo di fatturazione e l’indirizzo di partenza creati sopra.
3. Percorrete le schede restanti compilando ciò che riguarda il vostro account.

Le schede coprono:

• General — account, indirizzi, tipo di destinazione, metodo di spedizione predefinito e istruzioni di spedizione.
• Packaging — tipo di imballaggio, dimensioni e ripartizione dell’ordine tra i colli.
• Returns — etichette di reso e gestione RMA.
• References — i numeri di riferimento stampati sull’etichetta e i relativi codici a barre.
• Payments — chi paga spedizione e dazi, e i dati del conto del pagatore.
• Notification — gli eventi notificati dal corriere e i destinatari.
• Printing — formati dei documenti e stampante usata per ciascun tipo.
• Pickups — se i ritiri vengono prenotati automaticamente dopo la creazione dell’etichetta o pianificati a mano.
• Tracking — con quale frequenza i colli vengono interrogati e come gli stati vengono riscritti nell’ordine.
• Access Point — consegna presso un UPS Access Point anziché a un indirizzo, con le notifiche relative.
• Freight — spedizioni da 150 lbs in su, con proprie unità di movimentazione e classe merceologica.
• International Invoice — la fattura commerciale senza carta, la sua immagine di firma e il contenuto doganale.
• Automatic — quando le etichette vengono create senza operatore.
• Mass Actions — creazione di etichette in blocco dalla griglia degli ordini.
• Manual Actions — creazione di una singola etichetta da un ordine.
• Other Options — log e gli altri interruttori a livello di corriere.

Ogni impostazione può essere applicata per sito web e per paese di destinazione, così una regola che ha senso solo per un mercato non tocca gli altri.

Il riferimento completo campo per campo, con i percorsi di configurazione esatti, è nel Reference Manual fornito con l’estensione.

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.