TForce Universal Shipping for Magento® 2.x

The extension is installed with Composer. Which repository you add depends on where you bought it — the install itself is the same either way.

1. Connect the repository

Bought on extmag.com. Your account page shows the repository address and your personal credentials, together with the two composer config commands to paste. Run them once per project; every extension you own is then available from the same repository.

Bought on the Adobe Commerce Marketplace. The package is served from repo.magento.com, which most stores already have configured. If not, add the access keys from your Adobe account under My Profile -> Access Keys.

2. Install the extension

Run in the project root:

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

Composer resolves the shared Extmag packages the extension depends on, so there is nothing else to require by hand.

Log out and log back into the admin, and the extension is ready.

Label printing

To print labels on a local or network printer, install our printing software from here, then follow Installing and configuring el-Print.

Hyva Theme and Hyva Checkout

Storefronts on Hyva need one more package:

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

The integration replaces one Hyva template, view/frontend/templates/checkout/shipping/method-list.phtml. If your theme already overrides that file, merge the changes rather than replacing it.

Trying it before you buy

You can ask for a 30-day demo of this extension and install it exactly as above — same package, same repository, same commands. How demos work.

Installing without Composer

The archive can be unpacked into app/code/Extmag/ instead, but that leaves the extension outside dependency management: its shared packages have to be installed by hand and updates never reach it. Use Composer for any store you run, demo included.

For any question about the installation, please contact our technical support.

TForce Freight is set up from the Extmag menu in the Adobe Commerce (Magento) admin. Add the carrier account, the addresses you ship from, the boxes you pack into and the shipping methods customers see, then tune the carrier configuration.

TForce Account

1. If you do not have TForce Freight API credentials yet, request them from tforcefreight.com.
2. Go to Admin Main Menu -> Extmag -> Settings -> Shipper Accounts.
   
3. Click the “Add New Shipper Account” button.
4. Pick TForce Freight as the carrier, enter your Client ID, Client Secret and Shipper Number, then click “Save”. Leave Live Account set to No while you test against the TForce sandbox.

Addresses

1. Go to Admin Main Menu -> Extmag -> Settings -> Addresses.
   
2. Click the “Add New Address” button.
3. Fill in the company name, contact, phone and full address, then click “Save”. Add one address per location you ship from — they are selected separately as the billing address and the ship-from address.

Package Boxes

1. Go to Admin Main Menu -> Extmag -> Settings -> Package Boxes.
   
2. Click the “Add New Box” button.
3. Enter the inner and outer dimensions, the empty weight and the maximum load, then click “Save”. The packer uses these boxes to work out how an order is split across packages, so the more of your real boxes are listed the closer the quoted rate is to what you are charged.

Shipping Methods

1. Go to Admin Main Menu -> Extmag -> Shipping Methods.
   
2. Click the “Add New Shipping Method” button.
3. Choose TForce Freight as the carrier, decide which of its services to show — all of them, a specific list, or only the cheapest or the most expensive — and restrict the method by website and customer group if you need to. Click “Save”.

Configuration

1. Go to Admin Main Menu -> Extmag -> Settings -> TForce Configuration.
2. Open the General tab first and select the shipper account, the billing address and the ship-from address you created above.
   
3. Work through the remaining tabs, filling in what applies to your account.

The tabs cover:

• General — account, addresses, destination type, priority shipping method and shipping instructions.
• Packaging — handling unit type, packaging type, freight class and NMFC commodity code.
• References — the reference numbers written onto the Bill of Lading and their bar codes.
• Payments — who is billed for the shipment and the payer’s account details.
• Notification — the events TForce notifies about and the recipients.
• Printing — document formats and the printer used for each document type.
• Pickups — whether pickups are booked automatically after a label is created or scheduled manually.
• Tracking — how often parcels are polled and how statuses are written back to the order.
• Automatic, Mass Actions and Manual Actions — when labels are created without an operator, in bulk from the order grid, or one at a time.
• Other Options — logging and the remaining carrier-level switches.

Every setting can be applied per website and per destination country, so a rule that only makes sense for one market does not have to affect the rest.

The full field-by-field reference, including the exact configuration paths, is in the Reference Manual supplied with the extension.

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