How to Set Up FlavorCloud


FlavorCloud provides international shipping and return services door to door worldwide including guaranteed landed costs inclusive of all duties and taxes. Connecting your ShipperHQ account to FlavorCloud allows you to offer FlavorCloud’s competitive international shipping rates to customers and ensure no surprises for delivery. When you’re ready to ship, FlavorCloud’s dashboard allows you to print and process orders and generate all customs paperwork and commercial invoices required.

Learn more about FlavorCloud on the ShipperHQ Marketplace.

This document will cover how to add FlavorCloud to your ShipperHQ account. You will create a FlavorCloud “App ID” and “API Key”. The instructions below will tell you where to go and how to get them.


Follow these directions to obtain/set-up the necessary credentials and add the FlavorCloud carrier in ShipperHQ.

Register for FlavorCloud Credentials

  1. If you do not yet have a FlavorCloud account, you’ll need to sign up for an account at If you already have an account, contact FlavorCloud to obtain your API credentials.
  2. You should receive an “App ID” and “API Key” which will be used to install FlavorCloud on your ShipperHQ account.

Update Product Classification and HS Codes

In order to receive accurate duties & tax calculation for a fully landed cost you will need to ensure all SKUs you intend to ship internationally in your eCommerce platform’s product catalog have been updated with 6-digit HS Codes (Harmonized System codes of the Harmonized Tariff Schedule or HST used to classify imports and exports). FlavorCloud offers classification services to help you ensure your catalog is properly classified, contact them directly for more information.

Once you have your product HS Codes, you’ll need to update your products with these codes to ensure ShipperHQ can retrieve them when generating shipping rates.

HS Codes in Magento 1, Magento 2, or WooCommerce

When the ShipperHQ extension is installed, it adds a new HS Code product attribute. If this attribute is not available, ensure you’re running the latest version of the ShipperHQ extension.

More about ShipperHQ Attributes for Magento
More about ShipperHQ Attributes for WooCommerce

HS Codes in Shopify

HS Codes can be set on products or product variants using the “Edit Shipping Properties” option when editing a product within Shopify or via any other Metafields editor. Learn More

HS Codes in BigCommerce

HS Codes can be set as values of the Shipping Group field on products and product options in BigCommerce by prefixing the HS Code with “^HS:”. For example, “^HS:03.07.40” for HS Code 03.07.40. Learn More


Delivered Duty Unpaid (DDU) indicates that the seller is responsible for all associated costs of transport, but when a product arrives at the destination the buyer becomes responsible for paying import duties and taxes. In ShipperHQ, If customers are using DDP then they MUST have hs-codes on their products.

Delivered Duties Paid (DDP) indicates that the seller pays for all duties, import clearance, and taxes. In ShipperHQ If they are using DDU then hs codes are not required.

Steps To Add the FlavorCloud Carrier

  1. Go to the carriers page in the ShipperHQ dashboard
  2. Click Add New to add a new carrier
  3. Select Small Package carrier type
  4. Select install carrier to begin installing Flavorcloud carrier
  5. Search for the FlavorCloud Carrier under ‘Small Package Carriers’
    • You can filter by carrier type or by installation status using the dropdown menus near the search bar
    • Begin to install and validate a selected carrier by clicking the “install” button directly on the listing or click anywhere else on the listing to view a detailed page with more information about the carrier including information required for validating the carrier.
  6. Review required information required to complete installation and click Continue

  7. Enter the App ID and API Key provided to you by FlavorCloud and ensure the Unit of Weight and Unit of Measure are correct for your site then click Continue when complete
    Note: Successful installation depends on the accurate entry of the account information required by each carrier. If you do not have the correct information you will not be able to validate your carrier and receive live rates. 
  8. Once installation is complete, you will be presented with:
    1. The option to enable your carrier right away. (Enabling your carrier at this time will turn its rates on immediately even before you have made any configuration adjustments to it)
    2. Begin to configure. Continuing with this button will take you to the carrier’s configuration page.


Installed but not validated

Your carrier can be installed and configured, but not validate. Successful validation depends on the accurate entry of the account information required by each carrier. If you do not have the correct information you will not be able to validate your carrier and receive live rates.


Was this doc helpful?