ShipStation as a Shipping Service

ShipStation can be connected to DEAR both as a store and as a shipping service. See here for more information about connecting ShipStation as a store. Store and Shipping Service are mutually exclusive and cannot be connected at the same time. If you attempt to connect both, you will receive a message in DEAR asking if you wish to change the integration type.

NOTE: Take extra care to make sure weight units, dimension units and currency match those of your ShipStation account to ensure correct shipping rates in DEAR.  


  • Familiarity with Processing a Sale
  • Familiarity with Product and Service Management
  • ShipStation account settings currency MUST match with DEAR base currency, set via Settings General Settings

  • ShipStation account settings units MUST match with DEAR default units, set via Settings General Settings.

Table of Contents

Connect ShipStation as a Shipping Service

[back to top]

To connect ShipStation as a Shipping Service:

  1. Go to Integration ShipStation.
  2. Click + to make a new connection.
  3. Enter your API key and API secret key (you can get these from the API settings on your ShipStation account).
  4. Click Connect ShipStation as a Shipping Service.
  5. You can then proceed to choose the parameters of your settings.

ShipStation Settings

[back to top]

Connecting ShipStation will take you to the integration settings page. From there, click the Shipping Service tab. Some ShipStation Integration settings can be customised. If you make any changes to the default settings, make sure to click Save Changes upon completing them. If more than one shipping service is connected, you can click Set Default to set ShipStation as your default service.

Default Ship From Address: If a shipping location does not have an address specified, this address will be used instead. Available options for this field are the default company address or the default location for your business. 

Use Tax Rate From: This setting determines which tax rule will be applied to the shipping charge. Option 1 is to use Default tax rule for all customers and select from the drop-down of available tax rules (Tax Rule for Shipping). Option 2 is to use Customer tax rule, which is determined from customer details.

Weight Units in ShipStation: This sets the weight units to be used in ShipStation. This MUST match the weight units set under Settings General Settings in DEAR.

Dimension Units in ShipStation: This sets the dimension units to be used in ShipStation. This MUST match the dimension units set under Settings General Settings in DEAR.

Currency in ShipStation: This sets the currency to be used in ShipStation. This MUST match the currency value set under Settings General Settings in DEAR.

Additional Shipping Margin: If margin value is set to Relative, it means that margin will be calculated using a percentage amount. If set as Absolute a fixed amount will be applied on top of the shipping cost. (E.g., Additional Shipping Margin = 20. If Relative is selected, a margin of 20% will be added to the shipping rate. If Absolute is selected, 20 units of the ShipStation currency will be added to the rate.)

Send Notification on Shipping Label Generation: Enable to trigger an internal notification on the generation of a shipping label. 

From Contact on Shipping Label: This is auto-filled with your company name by default, but can be changed. This will appear on the shipping label.

Set Default: Set ShipStation as your default shipping service. Label printing will be done through ShipStation (relevant if multiple shipping services are connected). This option is not visible if ShipStation has already been set as your default shipping service.

Disconnect from ShipStation as a Shipping Service:  Click this button to disconnect and stop using ShipStation. 


[back to top]

There are some steps to set up before you can start using ShipStation to calculate rates. These can be skipped if you have done them already.

Set up addresses in DEAR

[back to top]

To correctly calculate shipping rates, you must first define where you are shipping from. Add addresses to all of your locations to make sure your shipping rates are accurate. Shipping addresses must be valid in order to calculate rates. 

To set up addresses in DEAR:

  1. Go to Settings Reference Books Stock Locations & Bins.
  2. You can add more locations with + or Add more items.
  3. Enter a name and address for each location.
  4. Save your changes.

Set up product dimensions

[back to top]

To correctly estimate shipping rates using shipping services, the correct dimensions must be added to the product in DEAR. See Product and Service Management for more information about setting up products.

To set up dimensions in DEAR:

  1. Go to Inventory View All Products.
  2. Select the product in question and at the bottom of the page, select the Dimensions tab.
  3. Enter the dimensions and dimension units of measure and Save the product.

Using Shipping Rate Estimates

[back to top]

Once the setup steps are complete, you can begin to estimate shipping rates on sale orders. This takes place at the quote/order stage of a sale. The rate is based from the location specified in the document to the customer's shipping address. Shipping rate quotes can only be generated for real addresses and for products that have dimensions and weight listed. 

If DEAR receives an error during shipping rate estimate generation, an error message will appear with a downloadable .txt file with the error data. If the error is unexpected, the user will also see an email dialog box with attached error data log file which can be sent to the shipping service provider customer support. 

Using Shipping Rate Estimates in DEAR

[back to top]

Shipping rate estimates in DEAR can be calculated at the Quote or Order stage of a sale order.

To get shipping rate estimates in DEAR:

  1. Create a sale order using Simple Sale or Advanced Sale.
  2. Add products to the order.
  3. Click Get Shipping Rates.
  4. Select ShipStation from the drop-down menu.
  5. A dialogue box will appear where you will need to select the CARRIER and SERVICE type, then click OK. Carriers and Services details are imported from ShipStation. The estimated shipping rate is shown next to each service.
  6. Select a service and click OK to add the shipping rate estimate to the additional charges section. You can now continue with the sale process until the Ship stage, where you will generate and print the shipping label.

NOTE: Make sure the shipping service currency is specified correctly in the Integration Settings. The shipping rate is imported into DEAR and, if necessary, a currency conversion applied to convert the shipping rate to the sale order currency. 

Using Shipping Rate Estimates in B2B Portal

[back to top]

Only one shipping service can be selected to use with B2B Portal. 

To get Shipping Rate Estimates in B2B Portal:

  1. Go to Integrations DEAR B2B Portal.
  2. In the Setup tab, scroll down to Shipping Service and select ShipStation from the drop-down. Click Save.

  3. During CHECKOUT, the shipping methods from the selected shipping service will be automatically shown for the customer to select from in Step 3: Shipping Method

Print Shipping Labels

[back to top]

At the Ship stage, you can use the shipping service to generate a shipping label for the carrier and receive a tracking number. 

If DEAR receives an error during shipping label generation, an error message will appear with a downloadable .txt file with the error data. If the error is unexpected, the user will also see an email dialog box with attached error data log file which can be sent to the shipping service provider customer support.

NOTE: Label Printing is not available for international shipping. The countries in the Shipping From and Shipping To addresses must match.

NOTE: ShipStation integration can be connected as a Shipping Service or as a Custom Store. Only one of the types should be enabled, or double labels will be printed.

To generate shipping labels using a shipping service:

  1. Use the normal sales process to create a sale order. 
  2. In the document header, enter the shipping address.
    • NOTE: Make sure the shipping address field and the location address are correct as they will be used by external integration for address verification.
  3. In the Ship tab, click Shipping Label
  4. Enter all the required fields marked with the red asterisk and click Generate Label.
  5. The carrier info will then be automatically filled in including the tracking number.

  6. The Shipping Label will be generated automatically via PDF and saved to the Attachments tab. You can also print the label by clicking on 'Shipping Label', and using the drop-down menu to select which shipment to print the label for.

NOTE: The template used to print the shipping label is generated on ShipStation side. DEAR just downloads the pdf from their API, it is not possible to change the shipping label template through DEAR. 

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.