/module-shipper

Base ShipperHQ Repo

Primary LanguagePHPOpen Software License 3.0OSL-3.0

ShipperHQ

Integrate Magento 2 with ShipperHQ to provide highly flexible shipping rate management. More information on ShipperHQ capabilities are available at www.shipperhq.com

Facts

Description

ShipperHQ will install as a simple shipping carrier in Magento 2. To get started you'll need to sign up for a ShipperHQ account at ShipperHQ.

There's no cost for the extension and ShipperHQ is free for 15 days.

Once installed, you can configure with your ShipperHQ platform credentials to provide multiple carrier rates and manage complex shipping rules via our ShipperHQ dashboard.

Compatibility

  • Magento >= 2.3

  • Supports both Magento Opensource (Community) and Magento Commerce (Enterprise)

Installation Instructions

Install using composer by adding to your composer file using commands:

  1. composer require shipperhq/module-shipper
  2. composer update
  3. bin/magento setup:upgrade

We recommend you also install our logging module

  1. composer require shipperhq/module-logger
  2. composer update
  3. bin/magento setup:upgrade

Configure ShipperHQ for shipping rates on your Magento 2 Store

If you don't have a ShipperHQ account:

  1. Sign up for a free trial at www.shipperhq.com
  2. After you have signed up to ShipperHQ, follow the steps of the basic configuration wizard

Connect your ShipperHQ account and get shipping rates:

  1. In your ShipperHQ account, navigate to > Websites > edit your existing site or Add a New one
  2. In the “eCommerce Configuration” panel, copy your API Key and Generate your Authentication Code
  3. In your Magento 2 admin, navigate to Stores > Configuration > Sales > Shipping Methods > ShipperHQ
  4. Enter the API Key and the Authentication Code you have copied from step 2
  5. Make sure to update the Enabled dropdown to “Yes”
  6. Save the store configuration settings
  7. You should see "1 carriers have been updated from ShipperHQ"

Your ShipperHQ account is now connected to your Magento 2 store, and you will now be able to show ShipperHQ shipping rates in your cart and checkout.

To continue setting up your ShipperHQ account to match your shipping requirements, see ShipperHQ documentation

Support

If you have any issues with this extension, open an issue on GitHub. Alternatively you can contact us via email at support@shipperhq.com or via our website https://shipperhq.com/contact

Magento Issues Impacting ShipperHQ

  1. Magento v2.1.3 - Website specific shipping rates or configuration are not working
  2. "Malformed Request" error when saving configuration or attempting to synchronize - environment is PHP 7
  3. Only country, region and postcode are included in shipping request at checkout - you may not see correct rates returned if filtering on city or PO box addresses
    • Github Issue: magento/magento2#3789
    • Resolved in Magento 2.1 and above for Guest checkout, logged in customers will still only see region/state, postcode and country
  4. Error thrown when using Elastic search and Magento Enterprise " error: MapperParsingException[No handler for type [array] declared on field [shipperhq_master_boxes]]"
    • Magento issue number/patch reference: MDVA-791 - contact Enterprise support for patch
  5. Error thrown when placing an order with some shipping methods. Root cause is that some shipping methods have shipping method codes longer than the column length on quote for shipping_method field. Field is truncating the code and order cannot be placed.
  6. Free shipping via cart rules are never removed once they have been applied, even if conditions are no longer met
  7. Shipping step of checkout times out and returns multiple blank radio buttons. Specific to PHP5.x. Ensure you have set always_populate_raw_post_data to -1 in your php.ini file

Contribution

Any contribution is highly appreciated. The best way to contribute code is to open a pull request on GitHub.

License

See license files

Copyright

Copyright (c) 2015 Zowta LLC (http://www.ShipperHQ.com)