DHL Express Comprehensive Shipping XML 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/dhlshipping2
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 DHL Express é 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 DHL Express

1. Se ainda não tem credenciais do DHL Express, obtenha-as na DHL Express. Você vai precisar de Site ID, senha e número de conta da DHL.
2. Vá em Admin Main Menu -> Extmag -> Settings -> Shipper Accounts.
   
3. Clique no botão «Add New Shipper Account».
4. Informe suas credenciais e clique em «Save». Deixe Live Account em No enquanto testa no ambiente de testes da transportadora.

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 DHL Express 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 -> DHL Express 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 padrão e instruções de envio.
• Packaging — tipo de embalagem, dimensões e divisão do pedido entre volumes.
• Returns — etiquetas de devolução e tratamento de RMA.
• References — os números de referência impressos na etiqueta e seus códigos de barras.
• Payments — quem paga o frete e os impostos, e os dados da conta do pagador.
• Notification — os eventos que a transportadora 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.
• International Invoice — a fatura comercial sem papel, sua imagem de assinatura e o conteúdo aduaneiro.
• Automatic — quando as etiquetas são criadas sem operador.
• Mass Actions — criação de etiquetas em lote pela grade de pedidos.
• Manual Actions — criação de uma etiqueta avulsa a partir de um pedido.
• 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.

3.4.6

Shiplab: Made log retention configurable and sped up the cleanup cron.

3.4.5

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

3.4.4

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

3.4.3

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

3.4.2

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.4.1

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

3.4.0

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

3.3.10

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

3.3.9

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

3.3.8

Initialized service array at each loop iteration 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

3.3.7

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

3.3.6

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

3.3.5

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.3.4

Fixed undefined array key warnings and minimum weight validation

Added proper null coalescing for street address lines to prevent undefined array key warnings

Added minimum weight validation (0.1) in Rate and Ship requests to avoid API errors with zero weight

3.3.3

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

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

3.3.2

Fixed reference_id empty check and test rate URL

3.3.1

Refactored code.

3.3.0

Added support for PHP 8.4

3.2.9

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

3.2.8

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

3.2.7

Fixed a bug with the Schedule New Update form on the category page

3.2.6

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

3.2.5

Added support Magento 2.4.8 and Adobe Commerce 2.4.8

3.2.4

Fixed a bug when the order has only virtual products

3.2.3

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

3.2.2

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

3.2.1

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

3.2.0

Fixed logs for shipping rates

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

3.1.9

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

Improved the integration with the Hyva Theme.

3.1.8

Fixed a bug with division by zero

3.1.7

Fixed a bug with a recursive function for shipping rates

3.1.6

Fixed a bug with shipping rates debugging.

Fixed CSP for printing by websocket.

3.1.5

Fixed a bug with the deactivating module

3.1.4

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.1.3

Fixed Dutiable option for International Invoice

3.1.2

Fixed a bug with printing_template

3.1.1

Fixed error with archive_doc

3.1.0

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

3.0.9

Fixed cache for shipping rates

3.0.8

The issue with printing return labels on the customer side has been fixed.

3.0.7

Fixed the packaging box selector

3.0.6

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.0.5

The issue related to the customer group and guest order creation in the admin panel has been fixed

3.0.4

Added support Magento 2.4.7 and Adobe Commerce 2.4.7

3.0.3

Integration with Hyva Theme and Hyva Checkout has been added

3.0.2

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

3.0.1

Improve cache for the shipping rate request

3.0.0

Improve the speed of calculating rules

2.9.9

Fixed the JS bug with placing the order

2.9.8

Updated linked modules

2.9.7

Added the ability to rename original courier shipping methods

2.9.6

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

2.9.5

Fixed the packer for packages of the shipment

2.9.4

Fixed a bug with downloading shipping logs

2.9.3

Added two options "Show Method if Not Applicable" and "Displayed Error Message" in the Extmag Shipping method configuration

2.9.2

Fixed a bug when it was impossible to save the Shiplab configuration in Magento 2.4.6-p1

2.9.1

Fixed PDP printing with the QZ Tray program

2.9.0

Support the QZ Tray program for printing labels.

2.8.9

Fixed a bug with Sales Rules.

Removed deprecated code.

2.8.8

Fixed sources for orders after saving the tracking number

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

2.8.7

Fixed calculating prices for shipping methods.

Fixed shipping price rules.

2.8.6

Fixed bug with shipping price rules

2.8.5

Fixed bug with session and manual label creation

2.8.4

Improved selection of Websites and Customer Groups for Shipping Methods

2.8.3

Fixed bugs on the checkout page of the admin panel

2.8.2

Added support Adobe Commerce 2.4.6-p1

2.8.1

Fix bug with musltiselect fields and values as type integer

2.8.0

Fixed ACL resources

2.7.9

Fixed a bug with the time of the Pickup

2.7.8

Fixed bug with the Volume Weight switcher

2.7.7

Support Adobe Commerce (Magento) 2.4.6

Fixed some minor bugs

2.7.6

Fixed some bugs for PHP 8.1 support

2.7.5

Added max volumetric weight for a package.

Added type of volumetric weight value.

Fixed some bugs with volumetric weight.

2.7.4

Fixed bugs in dependencies libs.

2.7.3

Fixed a bug with volumetric weight

2.7.2

Updated dependencies.

Fixed some minor bugs.

2.7.1

Fixed bug with deprecated functionality in the dependent extension

2.7.0

Added support for Product Volumetric Weight

2.6.3

Fixed PHP warnings

2.6.2

Support Adobe Commerce (Magento) 2.4.5-p1

2.6.1

Fixed the country_id condition type for the 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

2.5.4

Added "Direct Signature" option for Delivery confirmation

2.5.3

Added support for PHP 8.1 and Magento 2.4.4

2.5.2

Improve PHP code.

Removed the json_request_data field from the form of creating labels.

2.5.1

Fixed js for form step two

2.5.0

Go to subscription

2.4.2

Fix showing error with converting pdf to image

Fix folders creation for media data

2.4.1

Cut product name to 75 symbols for International Invoice

2.4.0

Added the ability to display shipping costs both with tax and without tax

2.3.5

Fix bug with scheduleb_code

2.3.2

Sending email with creating return labels and added a new email template

Optimizing code

Refactoring code

2.3.0

DHL API version updated from v6.2 to v10

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.

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.

Refactoring PHP code

2.0.0

Added EORI Number

Fixed some bugs

Refactoring PHP code

1.9.0

A new parameter Allowed areas have been added that allows you to show the delivery method only in the admin panel

"Country from" and "country to" was added in the Directions column on the labels grid page

1.8.0

Added Consignee VAT/Tax/EORI ID

Support UK Brexit

1.7.0

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

1.6.0

Added dependency from Core module

Fixed bug with system configuration

Fixed bug with access control list

1.5.1

Fixed access control list and admin menu

1.5.0

Added additional print button on order and shipment page in admin

1.4.1

Added PHP library textalk/websocket.

1.4.0

Added print by the network.

Added auto print.