TForce Universal Shipping para Magento® 2.x

A extensão é instalada com o Composer. Qual repositório você adiciona depende de onde a comprou — a instalação em si é a mesma nos dois casos.

1. Conectar o repositório

Comprada na extmag.com. A página da sua conta mostra o endereço do repositório e suas credenciais pessoais, junto com os dois comandos composer config para colar. Execute-os uma vez por projeto; depois disso, toda extensão que você possui fica disponível no mesmo repositório.

Comprada no Adobe Commerce Marketplace. O pacote é servido de repo.magento.com, que a maioria das lojas já tem configurado. Se não for o caso, adicione as access keys da sua conta Adobe em My Profile -> Access Keys.

2. Instalar a extensão

Execute na raiz do projeto:

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

O Composer resolve os pacotes Extmag compartilhados dos quais a extensão depende, então não há mais nada a exigir manualmente.

Saia do admin e entre novamente: a extensão está pronta.

Impressão de etiquetas

Para imprimir etiquetas em uma impressora local ou de rede, instale nosso software de impressão aqui e depois siga Instalação e configuração do el-Print.

Hyva Theme e Hyva Checkout

Lojas em Hyva precisam de um pacote a mais:

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

A integração substitui um template do Hyva, view/frontend/templates/checkout/shipping/method-list.phtml. Se o seu tema já sobrescreve esse arquivo, mescle as alterações em vez de substituí-lo.

Testar antes de comprar

Você pode pedir uma demonstração de 30 dias desta extensão e instalá-la exatamente como acima: mesmo pacote, mesmo repositório, mesmos comandos. Como funcionam as demonstrações.

Instalar sem o Composer

O arquivo pode ser descompactado em app/code/Extmag/, mas isso deixa a extensão fora do gerenciamento de dependências: os pacotes compartilhados precisam ser instalados à mão e as atualizações nunca chegam até ela. Use o Composer em qualquer loja que você opere, inclusive na demonstração.

Para qualquer dúvida sobre a instalação, fale com nosso suporte técnico.

O TForce Freight é configurado pelo menu Extmag no admin do Adobe Commerce (Magento). Cadastre a conta da transportadora, os endereços de onde você envia, as caixas em que embala e os métodos de envio que os clientes veem, e depois ajuste a configuração da transportadora.

Conta TForce

1. Se ainda não tem credenciais da API do TForce Freight, solicite-as em tforcefreight.com.
2. Vá em Admin Main Menu -> Extmag -> Settings -> Shipper Accounts.
   
3. Clique no botão «Add New Shipper Account».
4. Escolha TForce Freight como transportadora, informe Client ID, Client Secret e Shipper Number e clique em «Save». Deixe Live Account em No enquanto testa no ambiente de testes da TForce.

Endereços

1. Vá em Admin Main Menu -> Extmag -> Settings -> Addresses.
   
2. Clique no botão «Add New Address».
3. Preencha razão social, contato, telefone e endereço completo e clique em «Save». Cadastre um endereço para cada local de onde você envia — o endereço de cobrança e o de origem são escolhidos separadamente.

Caixas de embalagem

1. Vá em Admin Main Menu -> Extmag -> Settings -> Package Boxes.
   
2. Clique no botão «Add New Box».
3. Informe as medidas internas e externas, o peso vazio e a carga máxima e clique em «Save». O empacotador distribui o pedido entre volumes a partir dessas caixas: quanto mais das suas caixas reais estiverem cadastradas, mais perto a tarifa exibida fica da que será cobrada de você.

Métodos de envio

1. Vá em Admin Main Menu -> Extmag -> Shipping Methods.
   
2. Clique no botão «Add New Shipping Method».
3. Escolha TForce Freight como transportadora, decida quais serviços dela mostrar — todos, uma lista específica, ou apenas o mais barato ou o mais caro — e restrinja o método por site e grupo de clientes se precisar. Clique em «Save».

Configuração

1. Vá em Admin Main Menu -> Extmag -> Settings -> TForce Configuration.
2. Abra primeiro a aba General e selecione a conta de remetente, o endereço de cobrança e o endereço de origem criados acima.
   
3. Percorra as demais abas preenchendo o que se aplica à sua conta.

As abas cobrem:

• General — conta, endereços, tipo de destino, método de envio prioritário e instruções de envio.
• Packaging — tipo de unidade de manuseio, tipo de embalagem, classe de frete e código de mercadoria NMFC.
• References — os números de referência gravados no Bill of Lading e seus códigos de barras.
• Payments — quem é cobrado pelo envio e os dados da conta do pagador.
• Notification — os eventos que a TForce notifica e os destinatários.
• Printing — formatos de documento e a impressora usada em cada tipo.
• Pickups — se as coletas são agendadas automaticamente após criar a etiqueta ou marcadas à mão.
• Tracking — com que frequência os volumes são consultados e como os status voltam para o pedido.
• Automatic, Mass Actions e Manual Actions — quando as etiquetas são criadas sem operador, em lote pela grade de pedidos, ou uma de cada vez.
• Other Options — logs e os demais interruptores no nível da transportadora.

Cada ajuste pode ser aplicado por site e por país de destino, de modo que uma regra que só faz sentido em um mercado não afeta os demais.

A referência completa campo a campo, com os caminhos exatos de configuração, está no Reference Manual que acompanha a extensão.

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