Overview of Shiptheory App

Shiptheory connects your business directly to your carriers, allowing the app to send goods out notes to your integrated carriers for you. Through use of flexible shipping rules, you can even do this automatically!

shiptheory overview

If you have turned the relevant setting on, once the items have been shipped by your carrier, Shiptheory will update Brightpearl to mark the goods out notes as shipped in Brightpearl; reducing time spent on manual processes.

Getting started with Shiptheory

First, you will need to install the Shiptheory App via App Store > Turn on, which will take you to the getting started with / login screen for Shiptheory.

shiptheory app

Signing up for Shiptheory

You will need to sign up for a Shiptheory account if you haven't got one already by clicking Register for free on the Shiptheory website.

shiptheory register

This will ask you to create some login details for Shiptheory:

shiptheory get started

Connecting Brightpearl to Shiptheory

In order to connect Shiptheory and Brightpearl together, you will need to Enable the Brightpearl channel upon setup.    

shiptheory channels

Once you’ve enabled Brightpearl, you will then need to enter your Brightpearl account details and test your connection to Brightpearl:

shiptheory step1

shiptheory step2

You can then set up Shiptheory to work with the goods out note workflows you have, as below.

First, you will need to choose your weight unit preference (either Grams or Kilograms). This is the measurement unit you use in Brightpearl.

shiptheory step3

You can then decide when Shiptheory should send a goods out note to a carrier. You can choose from when it is Created, Printed, Picked or Packed. Please note that you can only choose one option here.

shiptheory step4a

If you try to choose more than one option, you will be faced with an error:

shiptheory step4b

There are also some Advanced Options you can set up. These can be accessed by clicking on the gear icon towards the bottom of the page:

shiptheory advanced

The first of these Advanced Options is to decide whether Shiptheory should mark your Brightpearl goods out notes as shipped when the shipment is completed in Shiptheory.

shiptheory mark shipped

Please note that shipping in Brightpearl cannot be undone; so it is worth deciding whether this option would work for your business or not. If you don’t want your accounting records to be updated when Shiptheory marks an order as shipped; then it would be wise to keep this option switched off.

Which carriers do you ship with?

You can currently integrate Shiptheory with the following UK carriers (and more being added every month!):

shiptheory carriers

When setting up Shiptheory, you can Enable the carriers you use and Enter the relevant details the carriers require.

Alternatively, you can select Manage Carriers from the drop-down next to your name when signed into Shiptheory. This is useful for if you start using other carriers after setting up Shiptheory.

shiptheory manage carriers

This will take you to the same screen you saw upon sign-up asking you to Enable the carriers you use:

shiptheory select carriers

You will then be prompted to enter details that differ for each carrier. Some of these carriers will require you to get in contact with them to retrieve the necessary details.

We recommend taking a look at the following help guides Shiptheory have put together for you:

Set up shipping address

Upon completing this initial setup for Shiptheory, you will be greeted with the following message:

shiptheory setup message

You can click on the link to enter your shipping address details. This is the address that your carrier will collect the parcels from; so is likely to be your warehouse address.

Your Shiptheory dashboard

Your Dashboard is where you can find all labels that are ready to print and any shipments that have had problems with them. You can search for orders by customer address, customer name or the reference / order ID number.

Tip - type today in the search box to see all orders from today or yesterday to see all orders from yesterday.

shiptheory search shipments

From your dashboard, you can view your shipments and print labels.

View shipments

From your dashboard, you can select View from the Action dropdown:

shiptheory view shipment

This will show you the current details for that shipment - customer address, selected carrier, and shipping method to be used. If you are using shipping rules, then the carrier and shipping details would have been automatically selected for you.

If you have chosen not to set up shipping rules, then you can choose the carrier and shipping method you wish to use ready for printing your label.

Print labels

From your dashboard, you can select Print from the Action dropdown:

shiptheory print shipment

If you need to create your shipping labels manually (for instance, when not using shipping rules); then you can even bulk print your labels using the Actions > Print dropdown; after selecting the orders you wish to print labels for.

shiptheory actions print

Please note that customer postcode is a mandatory field when printing labels.

Shiptheory shipping label

This label is generated by the carrier you are using, which means that it cannot be edited.

Here is an example generated by DPD:

shiptheory label

You can also embed this label within your Brightpearl templates. As Shiptheory receive labels back from carriers, the label is pushed back to Brightpearl's shipping label field.

By default this label is hidden; however you can include the label field in your templates in Brightpearl to automatically display your labels in line following the steps below:

How to add your Shiptheory label to your Brightpearl templates

  1. View a goods out note in Brightpearl, and click the Edit template link:

    shiptheory edit template

  2. Click the mouse at the point in the template you would like the label to be shown. Then click on the Insert field at cursor dropdown menu and select 'Delivery label’.

    shiptheory template

  3. Save your template.
  4. Now, when you view a goods out note that has been processed by Shiptheory, you will see an integrated shipping label:

    shiptheory label template

Updating Brightpearl orders to be marked as shipped

Once you’ve printed your labels, Shiptheory will mark that order as complete:

shiptheory customer

If you have asked Shiptheory to update your Brightpearl order to shipped, then the order will be marked as shipped at this point.

shiptheory ship timestamp

Additionally, all and any actions performed by Shiptheory (including any errors) will be added as a note to the Brightpearl order:

shiptheory order notes

Retry shipments

If you have changed any details that affect the Brightpearl order (such as changing customer address, product weights or order totals), then you will need to select Retry from the Action dropdown:

shiptheory customer actions

This will update Shiptheory with the new details; giving you an accurate shipping label.

Product weights

When connecting Brightpearl and Shiptheory, you can choose whether you use Grams or Kilograms as the weight unit measurement in your Brightpearl account.

Shiptheory will use kilograms (as most carrier’s prefer this), but will convert any gram weights into kilograms for you.

Shipping rules

You can set up shipping rules that allow Shiptheory to automatically send goods out notes to your carriers for you, depending on the rules you are using. There are no limits regarding how many shipping rules you can create and use. These shipping rules are mapped to your Brightpearl shipping methods.

You can create these by selecting Shipping Rules from your settings dropdown; and click Add Shipping Rule to start creating them.

shiptheory add shipping rules

Rule options

Each rule you create can consist of any combination of the below, or all of them.

Like-for-like shipping method matching

If you would like to map your Brightpearl shipping methods to Shiptheory, you will want to create a rule based on that shipping method. This effectively maps your Brightpearl shipping methods directly to carrier shipping methods.

shiptheory step4 map method

Maximum/minimum weight

It is possible to use the weight of the shipment as a condition. For example; you may want all shipments between 5 and 30 kilograms to be sent with a specific carrier delivery service.

shiptheory step1 weights

Maximum/minimum value

It is possible to use the monetary value of the shipment as a condition. For example; you may want all shipments between £10 and £20 to be sent with a specific carrier delivery service.

shiptheory step2 value limits

Destination rules

Rules can also be used to set carrier shipping methods based on the destination of the shipment. You can explicitly exclude and/or include countries and continents from rules.

shiptheory step3 locations

You can also add postcodes or postcode ranges in your shipping rule. See from below how you can include all postcodes using an asterisk(*) mark or specify postcode ranges using a hyphen(-) symbol. If you would like to be able to ship to all postcodes, then you should leave this blank. However, if you’re shipping to the Highlands in Scotland; then you should add their postcode ranges here in order to successfully ship to them.

shiptheory postcodes

If you do not set up any shipping rules; or if your goods out note is not covered by one of your rules, then your goods out notes will be ignored when sent to Shiptheory (indicated by an Ignored status):

shiptheory ignored

In this situation, you can create the shipping label manually by selecting the carrier and shipping method details.

User settings

There are various settings that you can control from Shiptheory. These can be accessed at any time by clicking the drop-down arrow next to your name:

shiptheory user menu

Available settings/actions

  • Dashboard

    This takes you to your Shiptheory dashboard displaying all goods out notes that have been pushed to Shiptheory, which can be filtered by date.

  • Shipping rules

    This allows you to set up shipping rules, which will select carrier and shipment details automatically for you.

  • Carrier settings

    You will have separate settings for each of your integrated carriers; which will vary from carrier to carrier.

  • Manage carriers

    This will take you to the same screen you saw upon setup, allowing you to enable the carriers you want to integrate with.

  • Brightpearl

    This allows you to change all of the Shiptheory settings that relate to your Brightpearl account.

  • Magento

    This allows you to change all of the Shiptheory settings that relate to your Magento store. Please note that this will only be displayed if you have integrated Magento with Shiptheory.

  • Company details

    This page allows you to update your company name as displayed within Shiptheory.

  • Manage users

    This page allows you to add new Shiptheory users.

  • Shipping location

    You can update your shipping address here - remember, this is where your carriers will be collecting parcels from.

  • Billing address

    You can update your billing address from here.

  • Change password

    This allows you to change the password you use to sign in to Shiptheory with.

  • Change email

    This allows you to change the email address you use to sign in to Shiptheory with.

  • Logout

    Use this to officially log out of Shiptheory, which will close your current session.

ID numbers used in Shiptheory

Throughout Shiptheory, you will find ID numbers like the one below:

shiptheory dates

This ID number is the Brightpearl order ID, followed by the Brightpearl goods out note ID. Our Brightpearl Support team might need you to provide them with this for any troubleshooting you require them to do.

Billing & subscriptions

For information on how to pay for the Shiptheory app, please contact our Customer Success team via

Help & support

For most queries, you will contact Brightpearl Support to receive the help you need.

However, for any help with setting up carriers in Shiptheory, please contact Shiptheory directly so that they can point you in the right direction.


I used to use the DPD/Interlink/Parcelforce/Royal Mail (DMO) automation integration apps. How do I migrate over to using Shiptheory?

You will need to follow the guide above to connect Brightpearl to Shiptheory. If you need any help with this, please contact Brightpearl Support via

I currently use the Hermes/Fedex automation integration apps. Does Shiptheory integrate with these carriers?

Currently, Shiptheory do not support Hermes or Fedex carriers. However, they are always looking to increase their supported carriers, so please do get in touch with Shiptheory to submit your request.

I can see that Shiptheory integrates directly with Magento too - should I contact them for help with setting up Shiptheory?

No. You should contact Brightpearl Support at for any help with setting up Shiptheory and connecting Brightpearl to it.

However, for any help with setting up carriers in Shiptheory, please contact Shiptheory directly so that they can point you in the right direction.

When trying to create a shipping label manually, it has failed. Why is this?

Check that you have filled in all of the mandatory fields, such as customer address (including postcode). If you find that there are address details missing, then you should update these details within Brightpearl and retry the goods out note in Shiptheory. This ‘retry’ will push over the updated details to Shiptheory, allowing you to process the note.

You should also use the Shipment History to identify what might have caused the shipment to fail. This can be found at the bottom of the screen when viewing any shipment.

shiptheory history

Have more questions? Submit a request