How to Connect ShipperHQ to Shopware
Advanced shipping rating on Shopware
ShipperHQ’s integration with Shopware delivers enterprise-grade shipping management directly at checkout. Unlock advanced features including delivery dates, configurable shipping rules, dimensional packing, multi-origin support, and real-time small package and LTL freight quotes. ShipperHQ empowers you to fully control shipping rates and methods beyond Shopware’s default capabilities, ensuring a seamless, transparent experience for your customers.
Table of Contents
Requirements
- A Shopware install at version 6.5.x or higher
- PHP 8.1 or higher
- An active ShipperHQ account on Advanced or Enterprise plan
Installation
Installing the ShipperHQ Shopware App follows standard Shopware processes for new app installation.
- Contact ShipperHQ to request access to the ShipperHQ Shopware App
- Unzip the provided archive and rename the extracted folder to
SHQRateProvider - Upload the folder to
custom/plugins/SHQRateProvider/in your Shopware root directory cdinto the plugin directory and runcomposer install- Ensure the plugin shows up in the Shopware Plugin list by running
bin/console plugin:refresh - If the plugin shows up, install it by running
bin/console plugin:install -- activate SHQRateProvider - Clear the cache using
bin/console cache:clear
Configuration
- Retrieve your API Key and Authentication Code from the ShipperHQ dashboard by editing your Website
- In Shopware, go to Extensions > My Extensions
- Find and click on ShipperHQ Shipping Rates
- Enter your API Key and Authentication Code retrieved from ShipperHQ and save the settings
- Click Reload Shipping Methods to retrieve Shipping Methods from ShipperHQ
- Clear the Shopware cache again by running
bin/console cache:clear
Next Steps
Once you have the ShipperHQ Shopware App installed and configured, you can proceed to configure your ShipperHQ account to achieve your shipping goals! Getting started with ShipperHQ is a great place to begin.
Troubleshooting
All Shipping Methods Shown at Checkout (Including Unavailable Ones)
Issue: At checkout, every shipping method appears, even those that should not be available. When selecting an unavailable method, you may see an error such as:
USPS Priority Mail is blocked for your current shopping cart
Solution:
- Go to the ShipperHQ app settings in Shopware
- Click the Reload Shipping Methods button
- Clear the Shopware cache by running
bin/console cache:clear
This will refresh the list of available shipping methods and resolve the error.