TForce 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/tforceshipping
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.

TForce Freight 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 TForce

1. Se non avete ancora le credenziali API di TForce Freight, richiedetele su tforcefreight.com.
2. Andate su Admin Main Menu -> Extmag -> Settings -> Shipper Accounts.
   
3. Fate clic sul pulsante «Add New Shipper Account».
4. Scegliete TForce Freight come corriere, inserite Client ID, Client Secret e Shipper Number, poi fate clic su «Save». Lasciate Live Account su No finché provate contro la sandbox di TForce.

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 TForce Freight 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 -> TForce 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 prioritario e istruzioni di spedizione.
• Packaging — tipo di unità di movimentazione, tipo di imballaggio, classe merceologica e codice merce NMFC.
• References — i numeri di riferimento riportati sulla Bill of Lading e i relativi codici a barre.
• Payments — a chi viene addebitata la spedizione e i dati del conto del pagatore.
• Notification — gli eventi notificati da TForce 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.
• Automatic, Mass Actions e Manual Actions — quando le etichette vengono create senza operatore, in blocco dalla griglia degli ordini, oppure una alla volta.
• 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.

1.3.1

Shiplab: Replace raw filesystem calls in settings import with Magento file driver.

1.3.0

Shiplab: Replace raw filesystem calls in settings import with Magento file driver.

1.2.9

Shiplab: Added support for multiple label files per tracking number with -N suffix.

1.2.8

Shiplab: Added zero-weight guard and weight diagnostics for shipping rate calculation. Shiplab: Removed legacy Additional Price fields and migrated data to price rules.

1.2.7

Shiplab: Replaced multiselect categories with AJAX tree chooser in dimension config. Added support Magento 2.4.9 and Adobe Commerce 2.4.9

1.2.6

Shiplab: Fixed attribute ID retrieval order in category EAV setup patch.

1.2.5

Shiplab: Added response post-processing hook and fixed logo data handling.

1.2.4

Shiplab: Added BlackoutRules feature with full CRUD, date picker mixin, and schedule migration.

1.2.3

Fixed service array initialization in Rate response parser. Shiplab: Fixed null safety issues and added numeric attribute validation. Added support Magento 2.4.8-p4 and Adobe Commerce 2.4.8-p4

1.2.2

Fixed service code resolution to preserve value set during step three.

1.2.1

Optimized the algorithms for packing items into boxes to ensure better efficiency.

1.2.0

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.

1.1.9

Fixed loadedData check in DataProvider classes for PHP 8.x compatibility.

Fixed place order callback to pass data for proper Braintree payment handling.

1.1.8

Added support for PHP 8.4

1.1.7

Added support Magento 2.4.8-p3 and Adobe Commerce 2.4.8-p3

1.1.6

Added support Magento 2.4.8-p2 and Adobe Commerce 2.4.8-p2

1.1.5

Added support Magento 2.4.8-p1 and Adobe Commerce 2.4.8-p1

1.1.4

Added support Magento 2.4.8 and Adobe Commerce 2.4.8

1.1.3

Fixed a bug when the order has only virtual products

1.1.2

Added support Magento 2.4.7-p5 and Adobe Commerce 2.4.7-p5

1.1.1

Added support Magento 2.4.7-p4 and Adobe Commerce 2.4.7-p4

1.1.0

Added new shipping method TForce Freight Accelerated Guaranteed

1.0.9

Fixed a bug with SplitButton for the order view page in the admin panel

1.0.8

Added support Magento 2.4.7-p3 and Adobe Commerce 2.4.7-p3

1.0.7

Fixed the price format on the label creation page in the admin panel.

Improved the integration with the Hyva Theme.

1.0.6

Added email templates for Access Point address.

Fixed Tracking.php.

Fixed logs with config_snapshot.

Fixed zero baseSubTotal.

1.0.5

Fixed a bug with division by zero

1.0.4

Fixed a bug with a recursive function for shipping rates

1.0.3

Fixed a bug with shipping rates debugging.

Fixed CSP for printing by websocket.

1.0.2

Fixed bug with afterGetAPIUrl plugin

1.0.1

Added support Magento 2.4.7-p2 and Adobe Commerce 2.4.7-p2

1.0.0

The extension was created