Shiptheory is a shipping integration application. It connects your business directly to carriers, allows you to set shipping rules to control how orders are sent with your carriers, and print shipping labels. By integrating Shiptheory with DEAR, you can import the tracking number to DEAR and print automatically generated shipping labels during the DEAR ship process. 

NOTE: Shiptheory API does not support consolidated shipments. Generating shipping label will return a label per package.

For more information, please refer to Shiptheory.

Prerequisites

• Familiarity with the Processing a Sale process (necessary)
• Familiarity with Products and Product Management (necessary)
• User permissions
  • User will need the Integrations → Shiptheory permission enabled to access the integration settings. 
  • User will need the Sale → Sale Task – Pack view: Sales List & Tasks permission to enter package information and shipping instructions. 
  • User will need the Sale → Sale Task – Ship view: Sales List & Tasks permission is required to generate the shipping label. 

Table of Contents

• Shiptheory Integration Setup
  • Integration Settings
• Shipping Label Printing
• Disconnecting from Shiptheory

Shiptheory Integration Setup

[back to top]

1. Navigate to DEAR Systems → Integration → Shiptheory. The Shiptheory login screen will be displayed.
2. Use your Shiptheory login credentials.
3. Click Connect Shiptheory. The Shiptheory integration settings screen will be displayed. 

Integration Settings

[back to top]

Connecting Shiptheory will take you to the integration settings page. Some Shiptheory 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 Shiptheory as your default service.

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

Use as Document Number: Orders are passed from DEAR to Shiptheory with a reference number which is printed on Shiptheory shipping labels. Select whether to use invoice number or sale order number as the reference number. 

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

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

Disconnect from your Shiptheory

Click this button to disconnect and stop using Shiptheory.

Printing Shipping Labels

[back to top]

DEAR allows printing of shipping labels from Shiptheory. This option appears at the Ship tab of the sales process for Simple Sales and Advanced Sales. You can also print shipping labels from the DEAR Warehouse Management Solution (WMS) app. 

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.

1. Use the normal sales process to create a sales order in either Simple Sale or Advanced Sale. 
2. On the document header, enter the shipping address.
   • NOTE: Make sure the shipping address field is correct as it will be used by external integration for address verification.
3. The sale process remains the same as far as the Pack tab, which must be authorised.
   
4. From here, click the Shipping Instructions sub-tab. This sub-tab is for shipping information that applies all packages. Click Enter Shipping instructions to open a pop-up window.
   
5. The pop up window is dynamically generated according to the connected shipping service. Enter the information and save your changes.
   
6. This will add the shipping instructions to the display. Click To Package details to continue.
   
7.  This sub-tab is for entering package dimensions for all packages within a sale order. Click Enter package details to open a pop-up window.
8. The pop up window is dynamically generated according to the connected shipping service. Select which boxes to include and enter the weight and dimensions. Save your changes.
   
9. This will add the shipment to the display. Continue to the Ship tab.
   
10. On the Ship tab, press Copy from Pack to enter the package details and select your Carrier. Click Generate Shipping Label to send package information and shipping instructions to the shipping service provider and generate the shipping label. 
    • Shiptheory does not support consolidated shipments. Generating shipping label will return a label per package.
11. The carrier info, including the tracking number, will then be automatically entered into the Ship tab. The Shipping Label will be generated automatically via PDF. You can also print the label by selecting the shipment from the list. From here, Authorise the ship tab to complete the fulfilment.
    

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

Disconnecting from Shiptheory

[back to top]

If you stop using Shiptheory, it is easy to disable the integration. Go to Integrations → Shiptheory, click Disconnect to disconnect Shiptheory from DEAR Systems.