Magento how to create shipping label dynamically

Magento how to create shipping label dynamically

September 25, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento how to create shipping label dynamically

Creating Shipping Labels Dynamically in Magento

In this guide, we’ll walk you through the process of generating shipping labels dynamically after an order is placed in your Magento store. We’ll focus on using the FedEx shipping method as an example, but these principles can be applied to other methods as well.

Understanding the Current Setup

Firstly, let’s clarify what we have currently:

  • The FedEx shipping method is configured and functional.
  • When an order is placed, the order status changes to ‘shipped’.
  • From the admin panel, you can manually create a shipping label which generates a PDF for printing.

The goal now is to automate this manual process of creating shipping labels. We want the system to generate the label automatically as soon as the order is shipped.

The Approach: Event Observers

Magento uses an event-driven architecture that allows us to hook into specific actions, like the ‘sales_order_ship’ event which fires when an order status changes to ‘shipped’. By creating a custom observer for this event, we can trigger our shipping label generation process automatically.

Here’s a high-level overview of the steps:

  1. Create the Observer Model: In your custom module, create a file called FedexShippingLabelObserver.php and define your observer model that implements Magento\Framework\Event\ObserverInterface.
class FedexShippingLabelObserver implements \Magento\Framework\Event\ObserverInterface
{
    public function execute(\Magento\Framework\Event\Observer $observer)
    {
        // Your label generation code goes here
    }
}
  1. Configure the Event: In your module’s etc/events.xml file, define the observer configuration to listen for the ‘sales_order_ship’ event.
<event name="sales_order_ship">
    <observer name="your_module_fedex_shipping_label_generator" instance="YourCompany\ShippingLabelGenerator\Model\FedexShippingLabelObserver"/>
</event>
  1. Generate the Shipping Label: Inside your execute method in the observer model, use the FedEx API to generate the label for the shipped order.

The exact implementation will depend on how you’ve configured your FedEx integration, but it typically involves:

  • Retrieving the necessary shipping information from the order.
  • Creating a new shipping request object with this data.
  • Sending the request to the FedEx server using their SOAP API.
  • Handling the response and saving the generated PDF.

Remember that working directly with external APIs requires handling various edge cases, error checking, and possibly retries. It’s recommended to create a separate service class for managing these interactions.

Best Practices and Further Optimization

While this approach should work for most scenarios, there are some best practices to consider:

  • Asynchronous Processing: If your label generation process takes a long time (due to slow network connections or high server load), you might want to use Magento’s async queue for better performance. This involves wrapping the heavy processing in a cron job that runs at regular intervals.

  • Error Handling and Retry Logic: Implement a robust error handling mechanism, including retry logic if the API call fails due to temporary issues like network glitches or high load on the FedEx server.

Conclusion

Automating the shipping label generation process is a powerful way to streamline your fulfillment workflow. By hooking into Magento’s event system and leveraging the FedEx API (or any other carrier’s API), you can create a seamless, automated experience for your customers while reducing manual effort.

Remember that working with external APIs requires careful testing and documentation of all possible error states and edge cases. It’s also important to monitor your queue and log files regularly to ensure everything is running smoothly.

At Laravel Company, our team specializes in Magento development and can help you implement complex integrations like this one with minimal disruption to your existing systems. Reach out if you need expert assistance!

Extensions Admin Configuration Orders

Our network